42560eb69f14a70bafce792aad4f6ed4bd230b12
[scilab.git] / scilab / modules / cacsd / help / ja_JP / linear_analysis / freq_domain / bode.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  * Copyright (C) 2012 - 2016 - Scilab Enterprises
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="bode" xml:lang="ja">
20     <refnamediv>
21         <refname>bode</refname>
22         <refpurpose>ボード線図</refpurpose>
23     </refnamediv>
24     <refsynopsisdiv>
25         <title>呼び出し手順</title>
26         <synopsis>
27             bode(sl)
28             bode(sl, fmin, fmax)
29             bode(sl, fmin, fmax, step)
30             bode(sl, frq)
31             bode(frq, db, phi)
32             bode(frq, repf)
33             bode(.., Captions)
34             bode(.., Captions, "rad")
35         </synopsis>
36     </refsynopsisdiv>
37     <refsection>
38         <title>引数</title>
39         <variablelist>
40             <varlistentry>
41                 <term>sl</term>
42                 <listitem>
43                     <para> 連続時間系または離散時間系の
44                         <literal>syslin</literal> リスト (SISO または SIMO 線形システム).
45                     </para>
46                 </listitem>
47             </varlistentry>
48             <varlistentry>
49                 <term>fmin,fmax</term>
50                 <listitem>
51                     <para>real (周波数範囲 (単位: Hz))</para>
52                 </listitem>
53             </varlistentry>
54             <varlistentry>
55                 <term>step</term>
56                 <listitem>
57                     <para>real (対数単位の増分ステップ.)</para>
58                 </listitem>
59             </varlistentry>
60             <varlistentry>
61                 <term>frq</term>
62                 <listitem>
63                     <para>行ベクトルまたは行列 (周波数 (単位:Hz) )
64                         (各行が各SISOサブシステムに対応).
65                     </para>
66                 </listitem>
67             </varlistentry>
68             <varlistentry>
69                 <term>db</term>
70                 <listitem>
71                     <para>行ベクトルまたは行列 ( ゲイン (単位:dB)).
72                         (各行が各SISOサブシステムに対応).
73                     </para>
74                 </listitem>
75             </varlistentry>
76             <varlistentry>
77                 <term>phi</term>
78                 <listitem>
79                     <para>行ベクトルまたは行列 ( 位相 (単位:度))
80                         (各行が各SISOサブシステムに対応).
81                     </para>
82                 </listitem>
83             </varlistentry>
84             <varlistentry>
85                 <term>repf</term>
86                 <listitem>
87                     <para>
88                         複素数(複素数を含む周波数応答)の行ベクトルまたは行列.
89                     </para>
90                 </listitem>
91             </varlistentry>
92             <varlistentry>
93                 <term>Captions</term>
94                 <listitem>
95                     <para>文字列のベクトル (キャプション).</para>
96                 </listitem>
97             </varlistentry>
98             <varlistentry>
99                 <term>"rad"</term>
100                 <listitem>
101                     <para>converts the frequency from Hz into rad/s (multiplies by 2π)
102                     </para>
103                 </listitem>
104             </varlistentry>
105         </variablelist>
106     </refsection>
107     <refsection>
108         <title>説明</title>
109         <para>
110             ボード線図,すなわち,<literal>sl</literal>の周波数応答の
111             ゲインと位相.
112         </para>
113         <para>
114             <literal>sl</literal> は,連続時間系または離散時間系の SIMOシステム
115             (<literal>syslin</literal>参照)とすることができます.
116             多出力系の場合,各出力は異なる記号でプロットされます.
117         </para>
118         <para>
119             周波数は範囲の境界値 <literal>fmin,fmax</literal> (単位: Hz)
120             または行ベクトル (多出力系の場合は行列) <literal>frq</literal>で
121             指定します.
122         </para>
123         <para>
124             <literal>step</literal> は(指数単位の)離散化増分です.
125             (デフォルト値の選定方法については,<literal>calfrq</literal> を参照).
126         </para>
127         <para>
128             <literal>db,phi</literal> はゲイン(単位:dB)及び
129             位相(単位:度)の行列です(各行が各応答に対応します).
130         </para>
131         <para>
132             <literal>repf</literal>は複素数の行列です.
133             各行が各応答に対応します.
134         </para>
135         <para>
136             <literal>fmin</literal> および<literal>fmax</literal> のデフォルト値は,
137             <literal>sl</literal> が連続時間系の場合に
138             <literal>1.d-3</literal>,<literal>1.d+3</literal>,
139             <literal>sl</literal> が離散時間系の場合に<literal>1.d-3</literal>,
140             <literal>0.5</literal>/sl.dt (ナイキスト周波数)
141             となります.
142             周波数の自動離散化は<literal>calfrq</literal>により
143             行われます.
144         </para>
145         <para>
146             位相/ゲイン曲線に沿ったデータを表示するために
147             <member>
148                 <link linkend="datatips">データティップ</link>
149             </member>
150             ツールを使用することができます.
151         </para>
152     </refsection>
153     <refsection>
154         <title>例</title>
155         <programlisting role="example"><![CDATA[
156 s = poly(0, 's');
157 h = syslin('c', (s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01));
158
159 clf
160 bode(h, 0.01, 100);
161  ]]></programlisting>
162         <para>
163             <scilab:image localized="true">
164                 s=poly(0,'s')
165                 h=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01))
166                 clf();bode(h,0.01,100);
167             </scilab:image>
168         </para>
169         <programlisting role="example"><![CDATA[
170 s = poly(0, 's');
171 h1 = syslin('c', (s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01));
172 num = 22801+4406.18*s+382.37*s^2+21.02*s^3+s^4;
173 den = 22952.25+4117.77*s+490.63*s^2+33.06*s^3+s^4;
174 h2 = syslin('c', num/den);
175
176 clf
177 bode([h1; h2], 0.01, 100, ['h1'; 'h2']);
178  ]]></programlisting>
179         <para>
180             <scilab:image localized="true">
181                 s=poly(0,'s')
182                 h1=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01))
183                 num=22801+4406.18*s+382.37*s^2+21.02*s^3+s^4;
184                 den=22952.25+4117.77*s+490.63*s^2+33.06*s^3+s^4
185                 h2=syslin('c',num/den);
186                 clf();bode([h1;h2],0.01,100,['h1';'h2'])
187              </scilab:image>
188         </para>
189         <programlisting role="example"><![CDATA[
190 s = %s;
191 G = (10*(s+3)) / (s*(s+2)*(s^2+s+2)); // A rational matrix
192 sys = syslin('c', G); // A continuous-time linear system in transfer matrix representation.
193 f_min = .0001; f_max = 16; // Frequencies in Hz
194
195 clf
196 bode(sys, f_min, f_max, "rad"); // Converts Hz to rad/s
197  ]]></programlisting>
198         <para>
199             <scilab:image localized="true">
200                 s = %s;
201                 G = (10*(s+3))/(s*(s+2)*(s^2+s+2)); // A rational matrix
202                 sys = syslin('c', G); // A continuous-time linear system in transfer matrix representation.
203                 f_min = .0001; f_max = 16; // Frequencies in Hz
204                 clf(); bode(sys, f_min, f_max, "rad"); // Converts Hz to rad/s
205             </scilab:image>
206         </para>
207     </refsection>
208     <refsection role="see also">
209         <title>参照</title>
210         <simplelist type="inline">
211             <member>
212                 <link linkend="black">black</link>
213             </member>
214             <member>
215                 <link linkend="nyquist">nyquist</link>
216             </member>
217             <member>
218                 <link linkend="gainplot">gainplot</link>
219             </member>
220             <member>
221                 <link linkend="repfreq">repfreq</link>
222             </member>
223             <member>
224                 <link linkend="g_margin">g_margin</link>
225             </member>
226             <member>
227                 <link linkend="p_margin">p_margin</link>
228             </member>
229             <member>
230                 <link linkend="calfrq">calfrq</link>
231             </member>
232             <member>
233                 <link linkend="phasemag">phasemag</link>
234             </member>
235             <member>
236                 <link linkend="datatips">datatips</link>
237             </member>
238         </simplelist>
239     </refsection>
240     <refsection role="history">
241         <title>履歴</title>
242         <revhistory>
243             <revision>
244                 <revnumber>5.5.0</revnumber>
245                 <revdescription>
246                   <para><literal>"rad"</literal> option added.</para>
247                 </revdescription>
248             </revision>
249             <revision>
250                 <revnumber>6.0</revnumber>
251                 <revdescription>
252                     <para>handling zpk representation</para>
253                 </revdescription>
254             </revision>
255         </revhistory>
256     </refsection>
257 </refentry>