Merge remote-tracking branch 'origin/6.1'
[scilab.git] / scilab / modules / elementary_functions / help / ru_RU / setoperations / union.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) 2008 - INRIA
5  * Copyright (C) 2012 - 2016 - Scilab Enterprises
6  * Copyright (C) 2020 - Samuel GOUGEON
7  *
8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
10  * This file was originally licensed under the terms of the CeCILL v2.1,
11  * and continues to be available under such terms.
12  * For more information, see the COPYING file which you should have received
13  * along with this program.
14  *
15  -->
16 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
17           xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml"
18           xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
19           xmlns:scilab="http://www.scilab.org" xml:id="union" xml:lang="ru">
20     <refnamediv>
21         <refname>union</refname>
22         <refpurpose>Множество всех элементов, строк или столбцов двух массивов без дубликатов</refpurpose>
23     </refnamediv>
24     <refsynopsisdiv>
25         <title>Синтаксис</title>
26         <synopsis>
27             [v, ka, kb] = union(a, b)
28             [v, ka, kb] = union(a, b, orient)
29         </synopsis>
30     </refsynopsisdiv>
31     <refsection>
32         <title>Аргументы</title>
33         <variablelist>
34             <varlistentry>
35                 <term>a, b</term>
36                 <listitem>
37                     массивы логических значений, чисел или текста. Допускаются разрежённые логические
38                     или числовые матрицы. Типы <varname>a</varname> и <varname>b</varname> могут
39                     отличаться, но должны быть совместимыми для конкатенации.
40                     <para/>
41                 </listitem>
42             </varlistentry>
43             <varlistentry>
44                 <term>orient</term>
45                 <listitem>
46                     направление обработки:
47                     <itemizedlist>
48                         <listitem>
49                             1 или "r": объединение выполняется по строкам;
50                         </listitem>
51                         <listitem>
52                             2 или "c": объеднение выполняется по столбцам.
53                         </listitem>
54                     </itemizedlist>
55                     <para/>
56                 </listitem>
57             </varlistentry>
58             <varlistentry>
59                 <term>v</term>
60                 <listitem>
61                     вектор-строка или матрица. Тип данных <varname>v</varname> является типом
62                     результата <literal>[a(:) ; b(:)]</literal>.
63                     <para/>
64                 </listitem>
65             </varlistentry>
66             <varlistentry>
67                 <term>ka</term>
68                 <listitem>
69                     вектор-строка целых чисел: индексы в <varname>a</varname> элементов/строк/столбцов
70                     <varname>v</varname>, пришедшие из <varname>a</varname>.
71                     <para/>
72                 </listitem>
73             </varlistentry>
74             <varlistentry>
75                 <term>kb</term>
76                 <listitem>
77                     вектор-строка целых чисел: индексы в <varname>b</varname> оставшихся
78                     элементов/строк/столбцов <varname>v</varname>, пришедших из <varname>b</varname>.
79                     <para/>
80                 </listitem>
81             </varlistentry>
82         </variablelist>
83     </refsection>
84     <refsection>
85         <title>Описание</title>
86         <para>
87             <literal>union(a,b)</literal> возвращает отсортированную вектор-строку, которая
88             содержит уникальные элементы <literal>[a(:);b(:)]</literal>.
89         </para>
90         <para>
91             <literal>union(a,b,"r")</literal> или <literal>union(a,b,1)</literal>
92             возвращает матрицу, сформированную объединением уникальных строк <literal>a</literal>
93             и <literal>b</literal>, отсортированную в лексикографическом порядке возрастания.
94             В этом случае матрицы <literal>a</literal> и <literal>b</literal> должны иметь
95             одинаковое количество столбцов.
96         </para>
97         <para>
98             <literal>union(a,b,"c")</literal> или <literal>union(a,b,2)</literal>
99             возвращает матрицу, сформированную объединением уникальных столбцов
100             <literal>a</literal> и <literal>b</literal>, отсортированную в лексикографическом
101             порядке возрастания. В этом случае матрицы <literal>a</literal> и <literal>b</literal>
102             должны иметь одинаковое количество строк.
103         </para>
104         <para>
105             <literal>[v,ka,kb]=union(a,b)</literal> также возвращает векторы индексов
106             <literal>ka</literal> и <literal>kb</literal> такие, что <literal>v</literal> является
107             сортированной комбинацией элементов <literal>a(ka)</literal> и
108             <literal>b(kb)</literal>.
109         </para>
110     </refsection>
111     <refsection>
112         <title>Примеры</title>
113         <programlisting role="example"><![CDATA[
114 A = [6  7  6 ; 5  8  3 ];
115 B = [1  7  1  0  6 ];
116
117 union(A, B)
118 [u, ka, kb] = union(A, B)
119      ]]></programlisting>
120      <screen><![CDATA[
121 --> union(A, B)
122  ans  =
123    0.   1.   3.   5.   6.   7.   8.
124
125 --> [u, ka, kb] = union(A, B)
126  u  =
127    0.   1.   3.   5.   6.   7.   8.
128  ka  =
129    6.   2.   1.   3.   4.
130  kb  =
131    4.   1.
132 ]]></screen>
133         <para/>
134         <programlisting role="example"><![CDATA[
135 A = ["a" "b" "a" "c" "c" "b"
136      "b" "c" "a" "b" "c" "c" ];
137 B = ["b" "a" "c" "c" "b" "a"
138      "a" "c" "b" "b" "b" "b" ];
139
140 [U, ka, kb] = union(A, B, "c")
141      ]]></programlisting>
142      <screen><![CDATA[
143 --> [U, ka, kb] = union(A, B, "c")
144  U  =
145   "a"  "a"  "a"  "b"  "b"  "b"  "c"  "c"
146   "a"  "b"  "c"  "a"  "b"  "c"  "b"  "c"
147
148  ka  =
149    3.   1.   2.   4.   5.
150
151  kb  =
152    2.   1.   5.
153 ]]></screen>
154         <para/>
155         <programlisting role="example"><![CDATA[
156 [F, T] = (%f, %t);
157 A = sparse([T T F T F T ; F F F F T T ; T F F F F T ]); full(A)
158 B = sparse([F F T T F F ; T T T T T T ; T F T T T F ]); full(B)
159
160 [U, ka, kb] = union(A, B, "c");
161 issparse(U)
162 full(U), ka, kb
163      ]]></programlisting>
164      <screen><![CDATA[
165 --> A = sparse([T T F T F T ; F F F F T T ; T F F F F T ]); full(A)
166  ans  =
167   T T F T F T
168   F F F F T T
169   T F F F F T
170
171 --> B = sparse([F F T T F F ; T T T T T T ; T F T T T F ]); full(B)
172  ans  =
173   F F T T F F
174   T T T T T T
175   T F T T T F
176
177 --> [U, ka, kb] = union(A, B, "c");
178 --> issparse(U)
179  ans  =
180   T
181
182 --> full(U), ka, kb
183  ans  =
184   F F F T T T
185   F T T F F T
186   F F T F T T
187
188  ka  =
189    3.   5.   2.   1.   6.
190  kb  =
191    1.
192 ]]></screen>
193     </refsection>
194     <refsection role="see also">
195         <title>Смотрите также</title>
196         <simplelist type="inline">
197             <member>
198                 <link linkend="brackets">квадратные скобки</link>
199             </member>
200             <member>
201                 <link linkend="unique">unique</link>
202             </member>
203         </simplelist>
204     </refsection>
205     <refsection role="history">
206         <title>История</title>
207         <revhistory>
208             <revision>
209                 <revnumber>6.1.0</revnumber>
210                 <revdescription>
211                     Расширение до логических матриц.
212                 </revdescription>
213             </revision>
214             <revision>
215                 <revnumber>6.1.1</revnumber>
216                 <revdescription>
217                     Расширение до разреженных логических, разреженных вещественных и разреженных
218                     комплексных матриц.
219                 </revdescription>
220             </revision>
221         </revhistory>
222     </refsection>
223 </refentry>