* Bug 16026 fixed: atanh() page and m2sci updated
[scilab.git] / scilab / modules / elementary_functions / help / ru_RU / trigonometry / atanh.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) 2019 - 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="atanh" xml:lang="ru">
20     <refnamediv>
21         <refname>atanh</refname>
22         <refpurpose>гиперболический арктангенс</refpurpose>
23     </refnamediv>
24     <refsynopsisdiv>
25         <title>Синтаксис</title>
26         <synopsis>t = atanh(x)</synopsis>
27     </refsynopsisdiv>
28     <refsection>
29         <title>Аргументы</title>
30         <variablelist>
31             <varlistentry>
32                 <term>x, t</term>
33                 <listitem>
34                     <para>вещественный или комплексный вектор/матрица.</para>
35                 </listitem>
36             </varlistentry>
37         </variablelist>
38     </refsection>
39     <refsection>
40         <title>Описание</title>
41         <para>
42             Компоненты вектора  <varname>t</varname> являются гиперболическим арктангенсом
43             соответствующих элементов вектора <varname>x</varname>.
44             Область определения для вещественной функции <literal>[-1,1]</literal>.
45         </para>
46     </refsection>
47     <refsection>
48         <title>Примеры</title>
49         <para>
50             С вещественными числами на входе:
51         </para>
52         <programlisting role="example"><![CDATA[
53 x = [-%inf -2 -1 -0.5 0 0.5 1 2 3 %inf];
54 [x ; atanh(tanh(x))]
55 atanh(x')
56  ]]></programlisting>
57     <screen><![CDATA[
58 --> [x ; atanh(tanh(x))]
59  ans  =
60   -Inf  -2.  -1.  -0.5   0.   0.5   1.   2.   3.   Inf
61   -Inf  -2.  -1.  -0.5   0.   0.5   1.   2.   3.   Inf
62
63 --> atanh(x')
64  ans  =
65    0.        + 1.5707963i
66   -0.5493061 + 1.5707963i
67   -Inf       + 0.i       
68   -0.5493061 + 0.i       
69    0.        + 0.i       
70    0.5493061 + 0.i       
71    Inf       + 0.i       
72    0.5493061 + 1.5707963i
73    0.3465736 + 1.5707963i
74    0.        + 1.5707963i
75 ]]></screen>
76         <para>
77             С комплексными числами на входе:
78         </para>
79         <programlisting role="example"><![CDATA[
80 x = [-1-%i, -%i, 0, %i, %i+1];
81 [tanh(atanh(x)) ; atanh(tanh(x))]
82 atanh(x.')
83  ]]></programlisting>
84     <screen><![CDATA[
85 --> [x; tanh(atanh(x)) ; atanh(tanh(x))]
86  ans  =
87
88   -1. - i     0. - i     0. + 0.i   0. + i     1. + i  
89   -1. - i     0. - i     0. + 0.i   0. + i     1. + i  
90   -1. - i     0. - i     0. + 0.i   0. + i     1. + i  
91
92 --> atanh(x.')
93  ans  =
94
95   -0.4023595 - 1.017222i
96    0.        - 0.7853982i
97    0.        + 0.i      
98    0.        + 0.7853982i
99    0.4023595 + 1.017222i
100 ]]></screen>
101     </refsection>
102     <refsection role="see also">
103         <title>Смотрите также</title>
104         <simplelist type="inline">
105             <member>
106                 <link linkend="tanh">tanh</link>
107             </member>
108         </simplelist>
109     </refsection>
110     <refsection role="history">
111         <title>История</title>
112         <revhistory>
113             <revision>
114                 <revnumber>6.0</revnumber>
115                 <revdescription>
116                     <itemizedlist>
117                         <listitem>
118                             <literal>atanh(-1)</literal> теперь всегда <literal>-Inf</literal>, а
119                             <literal>atanh(1)</literal> всегда <literal>Inf</literal>.
120                         </listitem>
121                         <listitem>
122                             Теперь для любого вещественного x>1 imag(atanh(x)) > 0.
123                         </listitem>
124                     </itemizedlist>
125                 </revdescription>
126             </revision>
127         </revhistory>
128     </refsection>
129 </refentry>