* Bug #12795 fixed - Cacsd doc: typo fixes
[scilab.git] / scilab / modules / cacsd / help / ja_JP / plot_display / phaseplot.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) 2011 - INRIA - Serge Steer <serge.steer@inria.fr>
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="phaseplot">
14     <refnamediv>
15         <refname>phaseplot</refname>
16         <refpurpose>周波数位相プロット</refpurpose>
17     </refnamediv>
18     <refsynopsisdiv>
19         <title>呼び出し手順</title>
20         <synopsis>
21             phaseplot(sl)
22             phaseplot(sl,fmin,fmax [,step] [,comments] )
23             phaseplot(frq,db,phi [,comments])
24             phaseplot(frq, repf [,comments])
25         </synopsis>
26     </refsynopsisdiv>
27     <refsection>
28         <title>引数</title>
29         <variablelist>
30             <varlistentry>
31                 <term>sl</term>
32                 <listitem>
33                     <para>
34                         一入力多出力 (SIMO) 線形動的システム (<link linkend="syslin">syslin</link>参照).
35                     </para>
36                 </listitem>
37             </varlistentry>
38             <varlistentry>
39                 <term>fmin</term>
40                 <listitem>
41                     <para>実スカラー: 表示する最小周波数 (単位:Hz) .</para>
42                 </listitem>
43             </varlistentry>
44             <varlistentry>
45                 <term>fmax</term>
46                 <listitem>
47                     <para>実スカラー: 表示する最大周波数 (単位:Hz).</para>
48                 </listitem>
49             </varlistentry>
50             <varlistentry>
51                 <term>step</term>
52                 <listitem>
53                     <para>実スカラー: 周波数離散化刻み (指数スケール)).
54                         指定しない場合、このアルゴリズムは、
55                         適用型周波数刻みを使用します.
56                     </para>
57                 </listitem>
58             </varlistentry>
59             <varlistentry>
60                 <term>comments</term>
61                 <listitem>
62                     <para>文字列ベクトル: 各曲線に付随する凡例ラベル.
63                         オプションの値は空の配列です.
64                     </para>
65                 </listitem>
66             </varlistentry>
67             <varlistentry>
68                 <term>frq</term>
69                 <listitem>
70                     <para>行ベクトルまたは n x m 配列: 周波数離散化(Hz).</para>
71                 </listitem>
72             </varlistentry>
73             <varlistentry>
74                 <term>db</term>
75                 <listitem>
76                     <para>n x m 配列:
77                         <literal>frq</literal>に対応する大きさ. この引数が使用されない場合、
78                         <literal>phaseplot</literal>は<literal>gainplot</literal>および
79                         <literal>bode</literal>と同じ呼び出し手順となります.
80                     </para>
81                 </listitem>
82             </varlistentry>
83             <varlistentry>
84                 <term>phi</term>
85                 <listitem>
86                     <para>
87                         n x m 配列:  <literal>frq</literal>に対応する位相[deg].
88                         <literal>phaseplot</literal>関数は曲線
89                         <literal>phi(i,:)</literal> 対 <literal>frq(i,:)</literal>
90                         をプロットします.
91                     </para>
92                 </listitem>
93             </varlistentry>
94             <varlistentry>
95                 <term>repf</term>
96                 <listitem>
97                     <para>n x m 複素数配列.
98                         <literal>phaseplot</literal> 関数は,曲線
99                         <literal>phase(repf(i,:))</literal> 対
100                         <literal>frq(i,:)</literal> をプロットします.
101                     </para>
102                 </listitem>
103             </varlistentry>
104         </variablelist>
105     </refsection>
106     <refsection>
107         <title>説明</title>
108         <para>
109             この関数はシステムの周波数応答の位相を描画します.
110             このシステムは異なる表現で指定することができます:
111         </para>
112         <itemizedlist>
113             <listitem>
114                 <para>
115                     <literal>phaseplot(sl,...)</literal> の場合,
116                 </para>
117                 <para>
118                     <literal>sl</literal>
119                     は連続系または離散系SIMOとすることができます.
120                     多出力の場合,出力は異なる記号でプロットされます.
121                 </para>
122                 <para>この場合,周波数は以下のように指定できます:</para>
123                 <itemizedlist mark="point">
124                     <listitem>
125                         <para>
126                             上限および下限周波数[Hz]
127                             <literal>fmin</literal>, <literal>fmax</literal>および
128                             周波数刻み(オプション) <literal>step</literal>.
129                             <literal>fmin</literal> および
130                             <literal>fmax</literal>のデフォルト値は,
131                             <literal>sl</literal>が連続系の場合
132                             <literal>1.e-3</literal>および
133                             <literal>1.e3</literal>,
134                             離散系の場合 <literal>1.e-3</literal>,
135                             <literal>0.5/sl.dt</literal> (ナイキスト周波数) です.
136                             引数<literal>step</literal> が省略された場合,
137                             この関数は適用型周波数刻み
138                             (<link linkend="calfrq">calfrq</link>参照)を使用します.
139                         </para>
140                     </listitem>
141                     <listitem>
142                         <para>
143                             行ベクトルまたは二次元配列 <literal>frq</literal>は
144                             周波数をHzで指定します.
145                             2次元配列は多出力系において各入出力の組について
146                             異なる周波数刻みを適用する場合に使用されます.
147                         </para>
148                     </listitem>
149                 </itemizedlist>
150             </listitem>
151             <listitem>
152                 <para>
153                     <literal>phaseplot(frq,...)</literal> の場合
154                 </para>
155                 <para>
156                     この場合,事前に計算された周波数応答により周波数位相プロットを
157                     描画することができます.
158                     周波数応答は複素数表現<literal>repf</literal>または
159                     ゲイン/位相表現<literal>db</literal>,
160                     <literal>phi</literal>で指定できます.
161                 </para>
162                 <para>
163                     <literal>frq</literal> および <literal>repf</literal> は,
164                     行ベクトルまたは(各行が入出力の組みを表わす) n x m 配列です.
165                 </para>
166             </listitem>
167         </itemizedlist>
168         <para>
169             The <link linkend="datatips">データティップ</link>ツールは位相曲線に沿ってデータを表示する際に使用できます.
170         </para>
171     </refsection>
172     <refsection>
173         <title>例</title>
174         <programlisting role="example"><![CDATA[
175     s=poly(0,'s')
176     h1=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01))
177     h2=syslin('c',(s^2+2*0.1*15.1*s+228.01)/(s^2+2*0.9*15*s+225))
178     clf();phaseplot([h1;h2],0.01,100,..
179                        ["$\frac{s^2+18 s+100}{s^2+6.06 s+102.1}$";
180                         "$\frac{s^2+3.02 s+228.01}{s^2+27 s+225}$"])
181     title('Phaseplot')
182
183     ]]></programlisting>
184         <para>
185             <scilab:image localized="true">
186                 s=poly(0,'s')
187                 h1=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01))
188                 h2=syslin('c',(s^2+2*0.1*15.1*s+228.01)/(s^2+2*0.9*15*s+225))
189                 clf();phaseplot([h1;h2],0.01,100,..
190                 ["$\frac{s^2+18 s+100}{s^2+6.06 s+102.1}$";
191                 "$\frac{s^2+3.02 s+228.01}{s^2+27 s+225}$"])
192                 title('Phaseplot')
193             </scilab:image>
194         </para>
195     </refsection>
196     <refsection role="see also">
197         <title>参照</title>
198         <simplelist type="inline">
199             <member>
200                 <link linkend="bode">bode</link>
201             </member>
202             <member>
203                 <link linkend="gainplot">gainplot</link>
204             </member>
205             <member>
206                 <link linkend="repfreq">repfreq</link>
207             </member>
208             <member>
209                 <link linkend="calfrq">calfrq</link>
210             </member>
211             <member>
212                 <link linkend="datatips">datatips</link>
213             </member>
214         </simplelist>
215     </refsection>
216     <refsection>
217         <title>ヒストリ</title>
218         <revhistory>
219             <revision>
220                 <revnumber>5.4.0</revnumber>
221                 <revremark>Function phaseplot introduced.</revremark>
222             </revision>
223         </revhistory>
224     </refsection>
225 </refentry>