License Header change: Removed the LICENSE_END before beta
[scilab.git] / scilab / modules / cacsd / help / ja_JP / findAC.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="findAC">
17     <refnamediv>
18         <refname>findAC</refname>
19         <refpurpose>離散時間システム部分空間の同定</refpurpose>
20     </refnamediv>
21     <refsynopsisdiv>
22         <title>呼び出し手順</title>
23         <synopsis>[A,C] = findAC(S,N,L,R,METH,TOL,PRINTW)
24             [A,C,RCND] = findAC(S,N,L,R,METH,TOL,PRINTW)
25         </synopsis>
26     </refsynopsisdiv>
27     <refsection>
28         <title>パラメータ</title>
29         <variablelist>
30             <varlistentry>
31                 <term>S</term>
32                 <listitem>
33                     <para>整数, ブロックハンケル行列のブロック行の数</para>
34                 </listitem>
35             </varlistentry>
36             <varlistentry>
37                 <term>N</term>
38                 <listitem>
39                     <para>整数</para>
40                 </listitem>
41             </varlistentry>
42             <varlistentry>
43                 <term>L</term>
44                 <listitem>
45                     <para>整数</para>
46                 </listitem>
47             </varlistentry>
48             <varlistentry>
49                 <term>R</term>
50                 <listitem>
51                     <para>行列, 
52                         findrをコールすることにより計算される結合されたブロックハンケル行列
53                         のR因子に関連.
54                     </para>
55                 </listitem>
56             </varlistentry>
57             <varlistentry>
58                 <term>METH</term>
59                 <listitem>
60                     <para>整数, 使用する手法に関するオプション</para>
61                     <variablelist>
62                         <varlistentry>
63                             <term>= 1</term>
64                             <listitem>
65                                 <para> 過去の入力/出力に基づく MOESP 法;</para>
66                             </listitem>
67                         </varlistentry>
68                         <varlistentry>
69                             <term>= 2</term>
70                             <listitem>
71                                 <para> N4SID 法;</para>
72                             </listitem>
73                         </varlistentry>
74                     </variablelist>
75                     <para>
76                         デフォルト:    METH = 3.
77                     </para>
78                 </listitem>
79             </varlistentry>
80             <varlistentry>
81                 <term>TOL</term>
82                 <listitem>
83                     <para>
84                         行列ランクの推定に使用される許容誤差.
85                         TOL &gt; 0の場合, TOL に指定した値が
86                         条件数の逆数の下界として使用されます.
87                         デフォルト: prod(size(matrix))*epsilon_machine ただし, epsilon_machine
88                         は相対機械精度です.
89                     </para>
90                 </listitem>
91             </varlistentry>
92             <varlistentry>
93                 <term>PRINTW</term>
94                 <listitem>
95                     <para>整数, 警告メッセージの出力に関するスイッチ.</para>
96                     <variablelist>
97                         <varlistentry>
98                             <term>PRINTW</term>
99                             <listitem>
100                                 <para>= 1: 警告メッセージを出力;</para>
101                             </listitem>
102                         </varlistentry>
103                         <varlistentry>
104                             <term>= 0</term>
105                             <listitem>
106                                 <para>警告メッセージを出力しない.</para>
107                             </listitem>
108                         </varlistentry>
109                     </variablelist>
110                     <para>
111                         デフォルト:    PRINTW = 0.
112                     </para>
113                 </listitem>
114             </varlistentry>
115             <varlistentry>
116                 <term>A</term>
117                 <listitem>
118                     <para>行列, 状態システム行列</para>
119                 </listitem>
120             </varlistentry>
121             <varlistentry>
122                 <term>C</term>
123                 <listitem>
124                     <para>行列, 出力システム行列</para>
125                 </listitem>
126             </varlistentry>
127             <varlistentry>
128                 <term>RCND</term>
129                 <listitem>
130                     <para>長さ4のベクトル,  ランク決定に使用される行列の条件数</para>
131                 </listitem>
132             </varlistentry>
133         </variablelist>
134     </refsection>
135     <refsection>
136         <title>説明</title>
137         <para>
138             部分空間同定法(MOESP または N4SID)を使用して,
139             離散時間システムのシステム行列 A および C を見つけます.
140             この際,
141             システム次元および結合されたブロックハンケル行列のR因子の関連する部分を
142             指定します.
143         </para>
144         <itemizedlist>
145             <listitem>
146                 <para>[A,C] = findAC(S,N,L,R,METH,TOL,PRINTW)  は,
147                     システム行列 A および C を計算します.
148                     モデル構造は次のようになります:
149                     x(k+1) = Ax(k) + Bu(k) + Ke(k),   k &gt;= 1,
150                     y(k)   = Cx(k) + Du(k) + e(k)
151                     ただし, x(k) および y(k) はそれぞれ長さ N および L のベクトルです.
152                 </para>
153             </listitem>
154             <listitem>
155                 <para>[A,C,RCND] = findAC(S,N,L,R,METH,TOL,PRINTW)  は長さ4のベクトルRCNDも返します.
156                     この中には,ランク決定に使用される行列の条件数が含まれます.
157                 </para>
158             </listitem>
159         </itemizedlist>
160         <para>
161             行列 R は, findR により計算され, 適当な引数 METH および JOBD で定義
162             する必要があります.
163         </para>
164     </refsection>
165     <refsection>
166         <title>例</title>
167         <programlisting role="example"><![CDATA[ 
168 //指定した線形システムからデータを生成
169 A = [ 0.5, 0.1,-0.1, 0.2;
170       0.1, 0,  -0.1,-0.1;      
171      -0.4,-0.6,-0.7,-0.1;  
172       0.8, 0,  -0.6,-0.6];      
173 B = [0.8;0.1;1;-1];
174 C = [1 2 -1 0];
175 SYS=syslin(0.1,A,B,C);
176 nsmp=100;
177 U=prbs_a(nsmp,nsmp/5);
178 Y=(flts(U,SYS)+0.3*rand(1,nsmp,'normal'));
179 // Rを計算
180 S=15;L=1;
181 [R,N,SVAL] = findR(S,Y',U');
182 N=3;
183 METH=3;TOL=-1;
184 [A,C] = findAC(S,N,L,R,METH,TOL);
185  ]]></programlisting>
186     </refsection>
187     <refsection role="see also">
188         <title>参照</title>
189         <simplelist type="inline">
190             <member>
191                 <link linkend="findABCD">findABCD</link>
192             </member>
193             <member>
194                 <link linkend="findBD">findBD</link>
195             </member>
196             <member>
197                 <link linkend="findBDK">findBDK</link>
198             </member>
199             <member>
200                 <link linkend="findR">findR</link>
201             </member>
202             <member>
203                 <link linkend="sorder">sorder</link>
204             </member>
205             <member>
206                 <link linkend="sident">sident</link>
207             </member>
208         </simplelist>
209     </refsection>
210 </refentry>