License Header change: Removed the LICENSE_END before beta
[scilab.git] / scilab / modules / cacsd / help / ja_JP / gtild.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" 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="gtild">
17     <refnamediv>
18         <refname>gtild</refname>
19         <refpurpose>チルダ処理</refpurpose>
20     </refnamediv>
21     <refsynopsisdiv>
22         <title>呼び出し手順</title>
23         <synopsis>Gt=gtild(G)
24             Gt=gtild(G,flag)
25         </synopsis>
26     </refsynopsisdiv>
27     <refsection>
28         <title>パラメータ</title>
29         <variablelist>
30             <varlistentry>
31                 <term>G</term>
32                 <listitem>
33                     <para>多項式または線形システムのどちらか
34                         (<literal>syslin</literal> リスト) または有理行列
35                     </para>
36                 </listitem>
37             </varlistentry>
38             <varlistentry>
39                 <term>Gt</term>
40                 <listitem>
41                     <para>Gと同じ</para>
42                 </listitem>
43             </varlistentry>
44             <varlistentry>
45                 <term>flag</term>
46                 <listitem>
47                     <para>
48                         文字列: <literal>'c'</literal> または
49                         <literal>'d'</literal> のどちらか (オプションのパラメータ).
50                     </para>
51                 </listitem>
52             </varlistentry>
53         </variablelist>
54     </refsection>
55     <refsection>
56         <title>説明</title>
57         <para>
58             <literal>G</literal> は多項式行列 (または多項式), <literal>Gt=gtild(G,'c')</literal>
59             は多項式行列 <literal>Gt(s)=G(-s)'</literal>を返します.
60         </para>
61         <para>
62             <literal>G</literal> が多項式行列 (または多項式)の場合,  
63             <literal>Gt=gtild(G,'d')</literal> は多項式行列
64             <literal>Gt=G(1/z)*z^n</literal> を返します.
65             ただし, n は <literal>G</literal> の最大次数です.
66         </para>
67         <para>
68             <literal>syslin</literal>リストにより状態空間で表される
69             連続時間システムの場合,
70             <literal>Gt = gtild(G,'c')</literal> は<literal>G(-s)'</literal>の
71             状態空間表現を返します.
72             すなわち, <literal>Gt</literal> の <literal>ABCD</literal> 行列は,
73             <literal>A',-C', B', D'</literal> となります.
74             <literal>G</literal> がプロパーでない場合 
75             (<literal> D= D(s)</literal>) ,
76             <literal>Gt</literal> の <literal>D</literal> 行列は 
77             <literal>D(-s)'</literal> となります.
78         </para>
79         <para>
80             <literal>syslin</literal>リストにより状態空間で表される
81             離散時間システムの場合,
82             <literal>Gt = gtild(G,'d')</literal> は<literal>G(-1/z)'</literal>
83             の状態空間表現,
84             すなわち, (プロパーでない場合もある)
85             <literal>-z*C*inv(z*A-B)*C + D(1/z) </literal>の状態空間表現,
86             を返します.
87         </para>
88         <para>
89             有理行列の場合, <literal>Gt = gtild(G,'c')</literal> は
90             誘致行列 <literal>Gt(s)=G(-s)</literal> を返し,
91             <literal>Gt = gtild(G,'d')</literal> は有理行列 
92             <literal>Gt(z)= G(1/z)'</literal> を返します.
93         </para>
94         <para>
95             パラメータ <literal>flag</literal> は,
96             多項式引数を指定して<literal>gtild</literal>がコール
97             される場合に必要です.
98         </para>
99     </refsection>
100     <refsection>
101         <title>例</title>
102         <programlisting role="example"><![CDATA[ 
103 // 連続時間
104 s=poly(0,'s');G=[s,s^3;2+s^3,s^2-5]
105 Gt=gtild(G,'c')
106 Gt-horner(G,-s)'   //連続時間解釈
107 Gt=gtild(G,'d');
108 Gt-horner(G,1/s)'*s^3  //離散時間解釈
109 G=ssrand(2,2,3);Gt=gtild(G);   //状態空間 (G はデフォルトで連続時間系)
110 clean((horner(ss2tf(G),-s))'-ss2tf(Gt))   //確認
111 // 離散時間 
112 z=poly(0,'z');
113 Gss=ssrand(2,2,3);Gss('dt')='d'; //離散時間 
114 Gss(5)=[1,2;0,1];   //定数D行列を指定
115 G=ss2tf(Gss);Gt1=horner(G,1/z)';
116 Gt=gtild(Gss);
117 Gt2=clean(ss2tf(Gt)); clean(Gt1-Gt2)  //確認
118 // プロパーでないシステム
119 z=poly(0,'z');
120 Gss=ssrand(2,2,3);Gss(7)='d'; //離散時間 
121 Gss(5)=[z,z^2;1+z,3];    //D(z) は多項式
122 G=ss2tf(Gss);Gt1=horner(G,1/z)';  //伝達形式で計算
123 Gt=gtild(Gss);    //状態空間形式で計算 
124 Gt2=clean(ss2tf(Gt));clean(Gt1-Gt2)  //確認
125  ]]></programlisting>
126     </refsection>
127     <refsection role="see also">
128         <title>参照</title>
129         <simplelist type="inline">
130             <member>
131                 <link linkend="syslin">syslin</link>
132             </member>
133             <member>
134                 <link linkend="horner">horner</link>
135             </member>
136             <member>
137                 <link linkend="factors">factors</link>
138             </member>
139         </simplelist>
140     </refsection>
141 </refentry>