07cd1361fb2aae039bfffbdeaa0a8f977d6b7bbd
[scilab.git] / scilab / modules / elementary_functions / help / ja_JP / trigonometry / atanh.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2
3 <!--
4  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
5  * Copyright (C) 2008 - INRIA
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
18 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="atanh" xml:lang="ja">
19
20     <refnamediv>
21
22         <refname>atanh</refname>
23
24         <refpurpose>双曲線逆正接</refpurpose>
25
26     </refnamediv>
27
28     <refsynopsisdiv>
29
30         <title>呼び出し手順</title>
31
32         <synopsis>t = atanh(x)</synopsis>
33
34     </refsynopsisdiv>
35
36     <refsection>
37
38         <title>引数</title>
39
40         <variablelist>
41
42             <varlistentry>
43
44                 <term>x</term>
45
46                 <listitem>
47
48                     <para>実数または複素数のベクトル/行列</para>
49
50                 </listitem>
51
52             </varlistentry>
53
54             <varlistentry>
55
56                 <term>t</term>
57
58                 <listitem>
59
60                     <para>実数または複素数のベクトル/行列</para>
61
62                 </listitem>
63
64             </varlistentry>
65
66         </variablelist>
67
68     </refsection>
69
70     <refsection>
71
72         <title>説明</title>
73
74         <para>
75
76             ベクトル<varname>t</varname>の要素は,
77
78             ベクトル<varname>x</varname>の対応する要素の双曲線逆正接となります.
79
80             実数関数の場合,定義域は,<literal>[-1,1]</literal>です(注記参照).
81
82         </para>
83
84     </refsection>
85
86     <refsection>
87
88         <title>注記</title>
89
90         <para>Scilab では(他の数値計算ソフトウエアと同様に)
91
92             定義域の範囲外の基本数値関数の値を計算しようとした場合に,
93
94             複素数拡張(結果は複素数)が使用されます.
95
96             より有名な例は, sqrt 関数で行われるものです
97
98             (<code>sqrt(-1)</code>を試してみてください!).
99
100             このやり方は,特異点で関数を評価する際に,
101
102             おの点が実数または複素数とみなされると,
103
104             その結果が異なってしまうという欠点があります.
105
106             <function>atanh</function>の場合,
107
108             <literal>-1</literal> および <literal>1</literal>でこれが
109
110             発生します.
111
112             これは,これらの点においては虚部は収束せず,
113
114             このため, 実際には <literal>atanh(1) = +Inf</literal> となる
115
116             時(<code>atanh(x)</code>のlim <literal>x-&gt;1</literal>ように)に,
117
118             <literal>atanh(1) = +Inf + i NaN</literal> となります.
119
120             このため,この関数をベクトル<literal>[1 2]</literal>で
121
122             評価すると,  <literal>2</literal> が定義域の外側にあるので,
123
124             そのベクトル全体に複素数拡張が使用されます.
125
126             その結果は,例えば,<literal>[1 0.5]</literal>で
127
128             <literal>atanh(1) = +Inf</literal>となるにもかかわらず,
129
130             <literal>atanh(1) = +Inf + i NaN</literal>となります.
131
132         </para>
133
134     </refsection>
135
136     <refsection>
137
138         <title>例</title>
139
140         <programlisting role="example"><![CDATA[
141 // 例 1
142 x=[0,%i,-%i]
143 tanh(atanh(x))
144
145 // 例 2
146 x = [-%inf -3 -2 -1 0 1 2 3 %inf]
147 ieee(2)
148 atanh(tanh(x))
149
150 // 例 3 (注記参照)
151 ieee(2)
152 atanh([1 2])
153 atanh([1 0.5])
154  ]]></programlisting>
155
156     </refsection>
157
158     <refsection role="see also">
159
160         <title>参照</title>
161
162         <simplelist type="inline">
163
164             <member>
165
166                 <link linkend="tanh">tanh</link>
167
168             </member>
169
170             <member>
171
172                 <link linkend="ieee">ieee</link>
173
174             </member>
175
176         </simplelist>
177
178     </refsection>
179
180 </refentry>
181