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>