* Bug 15535 fixed: sign(int8(0)) was wrong. sign() page improved
[scilab.git] / scilab / modules / elementary_functions / help / ru_RU / matrixoperations / sign.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) 2015, 2016, 2018 - Samuel GOUGEON
6  *
7  * Copyright (C) 2012 - 2016 - Scilab Enterprises
8  *
9  * This file is hereby licensed under the terms of the GNU GPL v2.0,
10  * pursuant to article 5.3.4 of the CeCILL v.2.1.
11  * This file was originally licensed under the terms of the CeCILL v2.1,
12  * and continues to be available under such terms.
13  * For more information, see the COPYING file which you should have received
14  * along with this program.
15  *
16  -->
17 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
18         xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml"
19         xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
20         xmlns:scilab="http://www.scilab.org" xml:id="sign" xml:lang="ru">
21     <refnamediv>
22         <refname>sign</refname>
23         <refpurpose>сигнум-функция</refpurpose>
24     </refnamediv>
25     <refsynopsisdiv>
26         <title>Синтаксис</title>
27         <synopsis>X = sign(A)</synopsis>
28     </refsynopsisdiv>
29     <refsection role="parameters">
30         <title>Аргументы</title>
31         <variablelist>
32             <varlistentry>
33                 <term>А</term>
34                 <listitem>
35                     <para>
36                         матрица кодированных целых чисел, десятичных чисел или комплексных чисел.
37                         <varname>A</varname> может быть разрежённой.
38                     </para>
39                 </listitem>
40             </varlistentry>
41             <varlistentry>
42                 <term>X</term>
43                 <listitem>
44                     <para>
45                         матрица того же размера и типа данных, что и <varname>A</varname>.
46                     </para>
47                 </listitem>
48             </varlistentry>
49         </variablelist>
50     </refsection>
51     <refsection role="description">
52         <title>Описание</title>
53         <para>
54             Если <varname>X</varname> состоит из целых или вещественных чисел, то
55             <itemizedlist>
56                 <listitem>
57                     <literal>X(i) = -1</literal> где <literal>A(i)&lt;0</literal>
58                 </listitem>
59                 <listitem>
60                     <literal>X(i) = 0</literal> где <literal>A(i)==0</literal>
61                 </listitem>
62                 <listitem>
63                     <literal>X(i) = 1</literal> где <literal>A(i)>0</literal>
64                 </listitem>
65                 <listitem>
66                     <literal>X(i)= %nan</literal> где <literal>A(i)</literal> равно NaN.
67                 </listitem>
68             </itemizedlist>
69         </para>
70         <para>
71             Если <varname>X</varname> состоит из комплексных чисел: <literal>sign(A==0) = 0</literal>.
72             В противном случае <literal>sign(A) = A./abs(A)</literal>.
73         </para>
74     </refsection>
75     <refsection role="examples">
76         <title>Примеры</title>
77         <para>С десятичными числами:</para>
78         <programlisting role="example"><![CDATA[
79 m  = [ 1.25  -2.5  -%inf   2.75
80        0.     1.    0.75   %inf
81        %nan   0.   -1.5   -2.5 ]; m
82 sign(m)
83  ]]></programlisting>
84     <screen><![CDATA[
85 --> m  =
86    1.25  -2.5  -Inf    2.75
87    0.     1.    0.75   Inf
88    Nan    0.   -1.5   -2.5
89 --> sign(m)
90  ans  =
91    1.   -1.  -1.   1.
92    0.    1.   1.   1.
93    Nan   0.  -1.  -1.
94 ]]></screen>
95     <para>С комплексными числами:</para>
96     <programlisting role="example"><![CDATA[
97 i = %i;
98 c = [-1, -i, -3+4*i
99       1,  i,  3+4*i
100       3,  0,  3-4*i
101      -4, 4*i,-4-3*i ];
102 c
103 sign(c)
104  ]]></programlisting>
105     <screen><![CDATA[
106 --> c  =
107   -1.  -i     -3. + 4.i
108    1.   i      3. + 4.i
109    3.   0.     3. - 4.i
110   -4.   4.i   -4. - 3.i
111 --> sign(c)
112  ans  =
113   -1.  -i     -0.6 + 0.8i
114    1.   i      0.6 + 0.8i
115    1.   0.     0.6 - 0.8i
116   -1.   i     -0.8 - 0.6i
117 ]]></screen>
118     <para>С разряжённой матрицей:</para>
119     <programlisting role="example"><![CDATA[
120 sign(sprand(8,3,0.3,"normal"))
121  ]]></programlisting>
122     </refsection>
123     <refsection role="see also">
124         <title>Смотрите также</title>
125         <simplelist type="inline">
126             <member>
127                 <link linkend="abs">abs</link>
128             </member>
129             <member>
130                 <link linkend="csgn">csgn</link>
131             </member>
132             <member>
133                 <link linkend="signm">signm</link>
134             </member>
135         </simplelist>
136     </refsection>
137     <refsection role="history">
138         <title>История</title>
139         <revhistory>
140             <revision>
141                 <revnumber>6.0</revnumber>
142                 <revdescription>
143                   Расширение до разряжённых матриц.
144                 </revdescription>
145             </revision>
146         </revhistory>
147     </refsection>
148 </refentry>