complex() extended to sparses
[scilab.git] / scilab / modules / elementary_functions / help / ru_RU / complex / complex.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) 2011 - DIGITEO - Michael Baudin
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="complex" xml:lang="ru">
20     <refnamediv>
21         <refname>complex</refname>
22         <refpurpose>Построение массива комплексных чисел по их частям</refpurpose>
23     </refnamediv>
24     <refsynopsisdiv>
25         <title>Синтаксис</title>
26         <synopsis>
27             c = complex(u)
28             c = complex(a, b)
29         </synopsis>
30     </refsynopsisdiv>
31     <refsection>
32         <title>Аргументы</title>
33         <variablelist>
34             <varlistentry>
35                 <term>u, a, b</term>
36                 <listitem>
37                     скаляры, векторы, матрицы и гиперматрицы вещественных чисел.
38                     Если оба <varname>a</varname> и <varname>b</varname> не скаляры,
39                     то они должны быть одинакового размера.
40                     <para/>
41                 </listitem>
42             </varlistentry>
43             <varlistentry>
44                 <term>c</term>
45                 <listitem>
46                     Array of complex numbers, of the size of <varname>u</varname> or of
47                     <varname>a</varname> and <varname>b</varname>.
48                     If <varname>u</varname> is sparse, or if <varname>a</varname> and
49                     <varname>b</varname> have the same sizes and both are sparse,
50                     то <varname>c</varname> является также разрежённой.
51                     В противном случае <varname>c</varname> является плотной.
52                     <para/>
53                 </listitem>
54             </varlistentry>
55         </variablelist>
56     </refsection>
57     <refsection>
58         <title>Описание</title>
59         <para>
60             <emphasis role="bold">c = complex(u)</emphasis> создаёт комплексное число из
61             его реальной части <varname>u</varname> и нуля в качестве мнимой части.
62         </para>
63         <para>
64             <emphasis role="bold">c = complex(a, b)</emphasis> создаёт комплексное число из его реальной части
65             <varname>a</varname> и мнимой части <varname>b</varname>.
66         </para>
67         <para>
68             Эта функция эквивалентна <literal>a + imult(b)</literal>, и должным
69             образом управляет специальными Inf и NaN вещественной и мнимой частями.
70         </para>
71     </refsection>
72     <refsection>
73         <title>Примеры</title>
74         <para>
75             В следующем примере мы создадим комплексное число из его реальной и мнимой части.
76         </para>
77         <programlisting role="example"><![CDATA[
78 complex(1,2)
79 complex([1 2],[3 4])
80  ]]></programlisting>
81         <para>
82             Если определено только <varname>a</varname>, то мнимая часть устанавливается равной нулю.
83         </para>
84         <programlisting role="example"><![CDATA[
85 complex([1 2 3])
86  ]]></programlisting>
87         <para>
88             Если <varname>a</varname> является скаляром, а <varname>b</varname>
89             является матрицей, то результат <varname>c</varname> имеет тот же размер, что и
90             <varname>b</varname>.
91             Аналогично, если <varname>a</varname> является матрицей, а <varname>b</varname> является
92             скаляром, то результат <varname>c</varname> имеет тот же размер, что и
93             <varname>a</varname>.
94         </para>
95         <programlisting role="example"><![CDATA[
96 c = complex([1 2 3], 4)
97 c = complex(1, [2 3 4])
98  ]]></programlisting>
99         <para>
100             Если <varname>a</varname> и <varname>b</varname> являются матрицами разных размеров,
101             то сформируется ошибка, как в следующем примере.
102         </para>
103         <screen><![CDATA[
104 -->complex(ones(2,3),ones(4,5))
105  !--error 10000
106 complex: Несовместимые входные параметры №1 и №2: ожидались одинаковые размеры.
107 at line      33 of function complex called by :
108 complex(ones(2,3),ones(4,5))
109  ]]></screen>
110         <para>
111             При специальных вещественной или/и мнимой частях:
112         </para>
113         <programlisting role="example"><![CDATA[
114 r = [0   0    0 %inf %inf %inf %nan %nan %nan].';
115 i = [0 %inf %nan  0  %inf %nan   0  %inf %nan].';
116 [r, i]
117
118 // Затем сравним complex(r, i) и r + i*%i :
119 [complex(r,i), r+i*%i]
120  ]]></programlisting>
121         <screen><![CDATA[
122 --> [r, i]
123  ans  =
124    0.    0.
125    0.    Inf
126    0.    Nan
127    Inf   0.
128    Inf   Inf
129    Inf   Nan
130    Nan   0.
131    Nan   Inf
132    Nan   Nan
133
134 // Затем сравним complex(r, i) и r + i*%i :
135 --> [complex(r,i), r+i*%i]
136  ans  =
137    0.  + 0.i    0.  + 0.i
138    0.  + Infi   Nan + Infi
139    0.  + Nani   Nan + Nani
140    Inf + 0.i    Inf + 0.i
141    Inf + Infi   Nan + Infi
142    Inf + Nani   Nan + Nani
143    Nan + 0.i    Nan + 0.i
144    Nan + Infi   Nan + Infi
145    Nan + Nani   Nan + Nani
146  ]]></screen>
147     </refsection>
148     <refsection role="see also">
149         <title>Смотрите также</title>
150         <simplelist type="inline">
151             <member>
152                 <link linkend="percenti">%i</link>
153             </member>
154             <member>
155                 <link linkend="imult">imult</link>
156             </member>
157         </simplelist>
158     </refsection>
159     <refsection role="history">
160         <title>История</title>
161         <revhistory>
162             <revision>
163                 <revnumber>6.1.1</revnumber>
164                 <revdescription>
165                     Расширение до разрежённых массивов.
166                 </revdescription>
167             </revision>
168         </revhistory>
169     </refsection>
170 </refentry>