scilab/modules/cacsd/help/ja_JP/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-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" version="5.0-subset Scilab" 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         <synopsis/>
  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             <inlinemediaobject>
  76                 <imageobject>
  77                     <imagedata fileref="../images/nicholschart.svg"/>
  78                 </imageobject>
  79             </inlinemediaobject>
  80         </para>
  81         <programlisting role="example"><![CDATA[
  82     //ニコルス線図のグリッドを付けたブラック図
  83     s=poly(0,'s');
  84     Plant=syslin('c',16000/((s+1)*(s+10)*(s+100)));
  85     // 2自由度PID
  86     tau=0.2;xsi=1.2;
  87     PID=syslin('c',(1/(2*xsi*tau*s))*(1+2*xsi*tau*s+tau^2*s^2));
  88     clf();
  89     black([Plant;Plant*PID ],0.01,100,["Plant";"Plant and PID corrector"]);
  90     // 右下隅にキャプションを移動
  91     ax=gca();Leg=ax.children(1);
  92     Leg.legend_location="in_lower_right";
  93     nicholschart(colors=color('light gray')*[1 1])
  94     ]]></programlisting>
  95         <para>
  96             <inlinemediaobject>
  97                 <imageobject>
  98                     <imagedata fileref="../images/black2.svg"/>
  99                 </imageobject>
 100             </inlinemediaobject>
 101         </para>
 102     </refsection>
 103     <refsection role="see also">
 104         <title>参照</title>
 105         <simplelist type="inline">
 106             <member>
 107                 <link linkend="black">black</link>
 108             </member>
 109             <member>
 110                 <link linkend="nyquist">nyquist</link>
 111             </member>
 112             <member>
 113                 <link linkend="hallchart">hallchart</link>
 114             </member>
 115         </simplelist>
 116     </refsection>
 117 </refentry>