* Bug 16290: %sn() set obsolete
[scilab.git] / scilab / modules / special_functions / help / ja_JP / percentsn.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="percentsn">
3     <refnamediv>
4         <refname>%sn</refname>
5         <refpurpose>ヤコビ楕円関数 <emphasis role="bold">(obsolete)</emphasis></refpurpose>
6     </refnamediv>
7     <refsynopsisdiv>
8         <title>呼び出し手順</title>
9         <synopsis>y = %sn(x, m)</synopsis>
10     </refsynopsisdiv>
11     <refsection>
12         <title>パラメータ</title>
13         <variablelist>
14             <varlistentry>
15                 <term>x</term>
16                 <listitem>
17                     <para>
18                         楕円積分により定義される基本矩形の中の点;
19                         <literal>x</literal> は複素数ベクトル
20                     </para>
21                 </listitem>
22             </varlistentry>
23             <varlistentry>
24                 <term>m</term>
25                 <listitem>
26                     <para>
27                         楕円積分のパラメータ (<literal>0&lt;m&lt;1</literal>)
28                     </para>
29                 </listitem>
30             </varlistentry>
31             <varlistentry>
32                 <term>y</term>
33                 <listitem>
34                     <para>結果</para>
35                 </listitem>
36             </varlistentry>
37         </variablelist>
38     </refsection>
39     <refsection>
40         <title>説明</title>
41         <warning>
42             <para>
43                 %sn() is obsolete and will be removed from Scilab 6.1.x. Please use ellipj() instead.
44             </para>
45         </warning>
46         <para>
47             パラメータ<literal>m</literal>を指定した
48             ヤコビの楕円関数:
49             パラメータ<literal>m</literal>の楕円積分の逆.
50         </para>
51         <para>
52             ゲインamはFortran形式で計算され,
53             楕円関数用の加算式が適用されます.
54         </para>
55     </refsection>
56     <refsection>
57         <title>例</title>
58         <programlisting role="example"><![CDATA[
59 m=0.36;
60 K=%k(m);
61 P=4*K; //実周期
62 real_val=0:(P/50):P;
63 plot(real_val,real(%sn(real_val,m)))
64 clf();
65 KK=%k(1-m);
66 Ip=2*KK;
67 ima_val1=0:(Ip/50):KK-0.001;
68 ima_val2=(KK+0.05):(Ip/25):(Ip+KK);
69 z1=%sn(%i*ima_val1,m);z2=%sn(%i*ima_val2,m);
70 plot2d([ima_val1',ima_val2'],[imag(z1)',imag(z2)']);
71 xgrid(3)
72  ]]></programlisting>
73     </refsection>
74     <refsection role="see also">
75         <title>参照</title>
76         <simplelist type="inline">
77             <member>
78                 <link linkend="ellipj">ellipj</link>
79             </member>
80             <member>
81                 <link linkend="delip">delip</link>
82             </member>
83             <member>
84                 <link linkend="percentk">%k</link>
85             </member>
86         </simplelist>
87     </refsection>
88     <refsection role="history">
89         <title>履歴</title>
90         <revhistory>
91             <revision>
92                 <revnumber>6.1.0</revnumber>
93                 <revdescription>
94                     %sn() is declared obsolete. ellipj() must be used instead.
95                 </revdescription>
96             </revision>
97         </revhistory>
98     </refsection>
99 </refentry>