ccb6d4898d4eff2dfd22f7ea77aa550c0fc5dfc1
[scilab.git] / scilab / modules / elementary_functions / help / fr_FR / setoperations / unique.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="unique" xml:lang="fr">
3     <refnamediv>
4         <refname>unique</refname>
5         <refpurpose>extrait les composantes distinctes d'un vecteur ou d'une
6             matrice
7         </refpurpose>
8     </refnamediv>
9     <refsynopsisdiv>
10         <title>Séquence d'appel</title>
11         <synopsis>
12             [N [,k]]=unique(M)
13             [N [,k]]=unique(M,orient)
14         </synopsis>
15     </refsynopsisdiv>
16     <refsection>
17         <title>Paramètres</title>
18         <variablelist>
19             <varlistentry>
20                 <term>M</term>
21                 <listitem>
22                     <para>vecteur ou matrice de nombres ou de chaînes de
23                         caractères
24                     </para>
25                 </listitem>
26             </varlistentry>
27             <varlistentry>
28                 <term>orient</term>
29                 <listitem>
30                     <para>flag qui peut prendre les valeurs : 1 ou "r", 2 ou "c"</para>
31                 </listitem>
32             </varlistentry>
33             <varlistentry>
34                 <term>N</term>
35                 <listitem>
36                     <para>vecteur ou matrice de nombres ou de chaînes de
37                         caractères
38                     </para>
39                 </listitem>
40             </varlistentry>
41             <varlistentry>
42                 <term>k</term>
43                 <listitem>
44                     <para>vecteur d'entiers</para>
45                 </listitem>
46             </varlistentry>
47         </variablelist>
48     </refsection>
49     <refsection>
50         <title>Description</title>
51         <para>
52             <literal>unique(M)</literal> renvoie un vecteur contenant les
53             valeurs distinctes contenues dans les termes de <literal>M</literal>
54             classées par ordre croissant.
55         </para>
56         <para>
57             <literal>unique(M,"r")</literal> ou
58             <literal>unique(M,1)</literal>retourne les lignes uniques de
59             <literal>M</literal> triées dans l'ordre lexicographique croissant.
60         </para>
61         <para>
62             <literal>unique(M,"c")</literal> or
63             <literal>unique(M,2)</literal>retourne les colonnes uniques
64             <literal>M</literal> triées dans l'ordre lexicographique croissant.
65         </para>
66         <para>
67             S'il est présent l'argument de sortie <literal>k</literal> contient
68             la position de la première occurrence de chaque valeur distincte dans
69             <literal>M</literal>.
70         </para>
71     </refsection>
72     <refsection>
73         <title>Exemples</title>
74         <programlisting role="example"><![CDATA[ 
75 M=round(2*rand(20,1));
76
77 unique(M)
78 [N,k]=unique(M)
79
80 unique(string(M))
81 [N,k]=unique(string(M))
82
83 A = [0,0,1,1;
84      0,1,1,1;
85      2,0,1,1;
86      0,2,2,2;
87      2,0,1,1;
88      0,0,1,1];
89 T='x'+string(A);
90
91 //unique rows
92
93 [m,k]=unique(A,'r')
94 unique(T,'r')
95
96 //unique columns
97 [m,k]=unique(T,'c')
98 unique(A,'c')
99  ]]></programlisting>
100     </refsection>
101     <refsection role="see also">
102         <title>Voir aussi</title>
103         <simplelist type="inline">
104             <member>
105                 <link linkend="union">union</link>
106             </member>
107             <member>
108                 <link linkend="intersect">intersect</link>
109             </member>
110             <member>
111                 <link linkend="gsort">gsort</link>
112             </member>
113             <member>
114                 <link linkend="lex_sort">lex_sort</link>
115             </member>
116         </simplelist>
117     </refsection>
118 </refentry>