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>