c5d71973420f20b1621c9aaba40098ee0d3da09a
[scilab.git] / scilab / modules / cacsd / help / ja_JP / plot_display / nicholschart.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) INRIA
5  *
6  * This file must be used under the terms of the CeCILL.
7  * This source file is licensed as described in the file COPYING, which
8  * you should have received as part of this distribution.  The terms
9  * are also available at
10  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
11  *
12  -->
13 <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="nicholschart">
14     <refnamediv>
15         <refname>nicholschart</refname>
16         <refpurpose>ニコルス線図</refpurpose>
17     </refnamediv>
18     <refsynopsisdiv>
19         <title>呼び出し手順</title>
20         <synopsis>nicholschart([ modules [,args [,colors]]])</synopsis>
21         
22     </refsynopsisdiv>
23     <refsection>
24         <title>引数</title>
25         <variablelist>
26             <varlistentry>
27                 <term>modules</term>
28                 <listitem>
29                     <para>実数ベクトル (モジュール (単位: dB))</para>
30                 </listitem>
31             </varlistentry>
32             <varlistentry>
33                 <term>args</term>
34                 <listitem>
35                     <para>r実数ベクトル (位相 (単位: 度))</para>
36                 </listitem>
37             </varlistentry>
38             <varlistentry>
39                 <term>colorss</term>
40                 <listitem>
41                     <para>スカラーまたはベクトル, 等ゲインまたは等位相曲線の色インデックスs</para>
42                 </listitem>
43             </varlistentry>
44         </variablelist>
45     </refsection>
46     <refsection>
47         <title>説明</title>
48         <para>
49             ニコルス線図をプロット: <literal>y</literal>の位相/ゲイン平面への
50             <literal>y/(1+y)</literal>の等モジュールおよび等引数等高線をプロット
51         </para>
52         <para>
53             <literal>nicholschart</literal> は,<link linkend="black">black</link>
54             と組み合わせて使用することができます.
55         </para>
56         <para>
57             <literal>modules</literal>および<literal>args</literal>の
58             デフォルト値はそれぞれ次のようになります :
59         </para>
60         <para>
61             <literal>[-12 -8 -6 -5 -4 -3 -2 -1.4 -1 -.5 0.25 0.5 0.7 1 1.4 2 2.3 3 4 5 6 8 12]</literal>
62         </para>
63         <para>
64             <literal>[-(1:10) , -(20:10:160)]</literal>
65         </para>
66     </refsection>
67     <refsection>
68         <title>例</title>
69         <programlisting role="example"><![CDATA[
70     //ニコルス線図
71     clf()
72     nicholschart(modules=[-6 -3 -1 1 3 6], args=[-1 -20 20 40 80 160 180]);
73     ]]></programlisting>
74         <para>
75             <scilab:image localized="true">
76                 nicholschart(modules=[-6 -3 -1 1 3 6], args=[-1 -20 20 40 80 160 180]);
77             </scilab:image>
78         </para>
79         <programlisting role="example"><![CDATA[
80     //ニコルス線図のグリッドを付けたブラック図
81     s=poly(0,'s');
82     Plant=syslin('c',16000/((s+1)*(s+10)*(s+100)));
83     // 2自由度PID
84     tau=0.2;xsi=1.2;
85     PID=syslin('c',(1/(2*xsi*tau*s))*(1+2*xsi*tau*s+tau^2*s^2));
86     clf();
87     black([Plant;Plant*PID ],0.01,100,["Plant";"Plant and PID corrector"]);
88     // 右下隅にキャプションを移動
89     ax=gca();Leg=ax.children(1);
90     Leg.legend_location="in_lower_right";
91     nicholschart(colors=color('light gray')*[1 1])
92     ]]></programlisting>
93         <para>
94             <scilab:image localized="true">
95                 s=poly(0,'s');
96                 Plant=syslin('c',16000/((s+1)*(s+10)*(s+100)));
97                 tau=0.2;xsi=1.2;
98                 PID=syslin('c',(1/(2*xsi*tau*s))*(1+2*xsi*tau*s+tau^2*s^2));
99                 clf();
100                 black([Plant;Plant*PID ],0.01,100,["Plant";"Plant and PID corrector"]);
101                 ax=gca();Leg=ax.children(1);
102                 Leg.legend_location="in_lower_right";
103                 nicholschart(colors=color('light gray')*[1 1])
104             </scilab:image>
105         </para>
106     </refsection>
107     <refsection role="see also">
108         <title>参照</title>
109         <simplelist type="inline">
110             <member>
111                 <link linkend="black">black</link>
112             </member>
113             <member>
114                 <link linkend="nyquist">nyquist</link>
115             </member>
116             <member>
117                 <link linkend="hallchart">hallchart</link>
118             </member>
119         </simplelist>
120     </refsection>
121 </refentry>