14e6dc909506c90403f267035a2aedb317ef5fc6
[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(.., "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>as last optional argument: displays the Bode plot versus Angular frequencies
102                       in rad/s, instead of versus frequencies in Hz.
103                     </para>
104                 </listitem>
105             </varlistentry>
106         </variablelist>
107     </refsection>
108     <refsection>
109         <title>説明</title>
110         <para>
111             ボード線図,すなわち,<literal>sl</literal>の周波数応答の
112             ゲインと位相.
113         </para>
114         <para>
115             <literal>sl</literal> は,連続時間系または離散時間系の SIMOシステム
116             (<literal>syslin</literal>参照)とすることができます.
117             多出力系の場合,各出力は異なる記号でプロットされます.
118         </para>
119         <para>
120             周波数は範囲の境界値 <literal>fmin,fmax</literal> (単位: Hz)
121             または行ベクトル (多出力系の場合は行列) <literal>frq</literal>で
122             指定します.
123         </para>
124         <para>
125             <literal>step</literal> は(指数単位の)離散化増分です.
126             (デフォルト値の選定方法については,<literal>calfrq</literal> を参照).
127         </para>
128         <para>
129             <literal>db,phi</literal> はゲイン(単位:dB)及び
130             位相(単位:度)の行列です(各行が各応答に対応します).
131         </para>
132         <para>
133             <literal>repf</literal>は複素数の行列です.
134             各行が各応答に対応します.
135         </para>
136         <para>
137             <literal>fmin</literal> および<literal>fmax</literal> のデフォルト値は,
138             <literal>sl</literal> が連続時間系の場合に
139             <literal>1.d-3</literal>,<literal>1.d+3</literal>,
140             <literal>sl</literal> が離散時間系の場合に<literal>1.d-3</literal>,
141             <literal>0.5</literal>/sl.dt (ナイキスト周波数)
142             となります.
143             周波数の自動離散化は<literal>calfrq</literal>により
144             行われます.
145         </para>
146         <para>
147             位相/ゲイン曲線に沿ったデータを表示するために
148             <member>
149                 <link linkend="datatips">データティップ</link>
150             </member>
151             ツールを使用することができます.
152         </para>
153     </refsection>
154     <refsection>
155         <title>例</title>
156         <programlisting role="example"><![CDATA[
157 s = poly(0, 's');
158 h = syslin('c', (s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01));
159
160 clf
161 bode(h, 0.01, 100);
162  ]]></programlisting>
163         <para>
164             <scilab:image localized="true">
165                 s=poly(0,'s')
166                 h=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01))
167                 clf();bode(h,0.01,100);
168             </scilab:image>
169         </para>
170         <programlisting role="example"><![CDATA[
171 s = poly(0, 's');
172 h1 = syslin('c', (s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01));
173 num = 22801+4406.18*s+382.37*s^2+21.02*s^3+s^4;
174 den = 22952.25+4117.77*s+490.63*s^2+33.06*s^3+s^4;
175 h2 = syslin('c', num/den);
176
177 clf
178 bode([h1; h2], 0.01, 100, ['h1'; 'h2']);
179  ]]></programlisting>
180         <para>
181             <scilab:image localized="true">
182                 s=poly(0,'s')
183                 h1=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01))
184                 num=22801+4406.18*s+382.37*s^2+21.02*s^3+s^4;
185                 den=22952.25+4117.77*s+490.63*s^2+33.06*s^3+s^4
186                 h2=syslin('c',num/den);
187                 clf();bode([h1;h2],0.01,100,['h1';'h2'])
188              </scilab:image>
189         </para>
190         <programlisting role="example"><![CDATA[
191 s = %s;
192 G = (10*(s+3)) / (s*(s+2)*(s^2+s+2)); // A rational matrix
193 sys = syslin('c', G); // A continuous-time linear system in transfer matrix representation.
194 f_min = .0001; f_max = 16; // Frequencies in Hz
195
196 clf
197 bode(sys, f_min, f_max, "rad"); // Converts Hz to rad/s
198  ]]></programlisting>
199         <para>
200             <scilab:image localized="true">
201                 s = %s;
202                 G = (10*(s+3))/(s*(s+2)*(s^2+s+2)); // A rational matrix
203                 sys = syslin('c', G); // A continuous-time linear system in transfer matrix representation.
204                 f_min = .0001; f_max = 16; // Frequencies in Hz
205                 clf(); bode(sys, f_min, f_max, "rad"); // Converts Hz to rad/s
206             </scilab:image>
207         </para>
208     </refsection>
209     <refsection role="see also">
210         <title>参照</title>
211         <simplelist type="inline">
212             <member>
213                 <link linkend="black">black</link>
214             </member>
215             <member>
216                 <link linkend="nyquist">nyquist</link>
217             </member>
218             <member>
219                 <link linkend="gainplot">gainplot</link>
220             </member>
221             <member>
222                 <link linkend="repfreq">repfreq</link>
223             </member>
224             <member>
225                 <link linkend="g_margin">g_margin</link>
226             </member>
227             <member>
228                 <link linkend="p_margin">p_margin</link>
229             </member>
230             <member>
231                 <link linkend="calfrq">calfrq</link>
232             </member>
233             <member>
234                 <link linkend="phasemag">phasemag</link>
235             </member>
236             <member>
237                 <link linkend="datatips">datatips</link>
238             </member>
239         </simplelist>
240     </refsection>
241     <refsection role="history">
242         <title>履歴</title>
243         <revhistory>
244             <revision>
245                 <revnumber>5.5.0</revnumber>
246                 <revdescription>
247                   <para><literal>"rad"</literal> option added.</para>
248                 </revdescription>
249             </revision>
250             <revision>
251                 <revnumber>6.0</revnumber>
252                 <revdescription>
253                     <para>handling zpk representation</para>
254                 </revdescription>
255             </revision>
256         </revhistory>
257     </refsection>
258 </refentry>