f97e071d2b032366cf56f25876dd57271c8680e2
[scilab.git] / scilab / modules / elementary_functions / help / pt_BR / signalprocessing / syslin.xml
1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) 2008 - 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 version="5.0-subset Scilab" xml:id="syslin" xml:lang="en"
14           xmlns="http://docbook.org/ns/docbook"
15           xmlns:xlink="http://www.w3.org/1999/xlink"
16           xmlns:svg="http://www.w3.org/2000/svg"
17           xmlns:ns3="http://www.w3.org/1999/xhtml"
18           xmlns:mml="http://www.w3.org/1998/Math/MathML"
19           xmlns:db="http://docbook.org/ns/docbook">
20   <info>
21     <pubdate>$LastChangedDate$</pubdate>
22   </info>
23
24   <refnamediv>
25     <refname>syslin</refname>
26
27     <refpurpose>definição de sistemas lineares</refpurpose>
28   </refnamediv>
29
30   <refsynopsisdiv>
31     <title>Seqüência de Chamamento</title>
32
33     <synopsis>[sl]=syslin(dom,A,B,C [,D [,x0] ])
34 [sl]=syslin(dom,N,D)
35 [sl]=syslin(dom,H)</synopsis>
36   </refsynopsisdiv>
37
38   <refsection>
39     <title>Parâmetros</title>
40
41     <variablelist>
42       <varlistentry>
43         <term>dom</term>
44
45         <listitem>
46           <para>string (<literal>'c'</literal>, <literal>'d'</literal>), ou
47           <literal>[]</literal> ou um escalar.</para>
48         </listitem>
49       </varlistentry>
50
51       <varlistentry>
52         <term>A,B,C,D</term>
53
54         <listitem>
55           <para>matrizes em representação de espaço de estados
56           (<literal>D</literal> opcional com valor padrão matriz nula). para
57           sistemas impróprios, <literal>D</literal> é uma matriz de
58           polinômios.</para>
59         </listitem>
60       </varlistentry>
61
62       <varlistentry>
63         <term>x0</term>
64
65         <listitem>
66           <para>vetor (estado inicial; valor padrão é
67           <literal>0</literal>)</para>
68         </listitem>
69       </varlistentry>
70
71       <varlistentry>
72         <term>N, D</term>
73
74         <listitem>
75           <para>matrizes de polinômios</para>
76         </listitem>
77       </varlistentry>
78
79       <varlistentry>
80         <term>H</term>
81
82         <listitem>
83           <para>matriz de razões de polinômios ou representação de espaço de
84           estados linear</para>
85         </listitem>
86       </varlistentry>
87
88       <varlistentry>
89         <term>sl</term>
90
91         <listitem>
92           <para>tlist (lista "<literal>syslin</literal>") representando o
93           sistema linear</para>
94         </listitem>
95       </varlistentry>
96     </variablelist>
97   </refsection>
98
99   <refsection>
100     <title>Descrição</title>
101
102     <para><literal>syslin</literal> define um sistema linear como uma lista e
103     verifica a consistência dos dados.</para>
104
105     <para><literal>dom</literal> especifica o domínio de tempo do sistema e
106     pode ter um dos seguintes valores:</para>
107
108     <para><literal>dom='c'</literal> para um sistema de tempo contínuo,
109     <literal>dom='d'</literal> para um sistema de tempo discreto,
110     <literal>n</literal> para um sistema amostrado com período de amostragem
111     <literal>n</literal> (em segundos).</para>
112
113     <para><literal>dom=[]</literal> se o domínio de tempo é indefinido.</para>
114
115     <para>Representação em espaço de estados:</para>
116
117     <programlisting role = ""><![CDATA[ 
118 sl=syslin(dom,A,B,C [,D [,x0] ])
119  ]]></programlisting>
120
121     <para>Representa o sistema :</para>
122
123     <programlisting role = ""><![CDATA[ 
124       s x  = A*x + B*u
125         y  = C*x + D*u
126       x(0) = x0
127  ]]></programlisting>
128
129     <para>A saída de <literal>syslin</literal> é uma lista da seguinte forma:
130     <literal>sl=tlist(['lss','A','B','C','D','X0','dt'],A,B,C,D,x0,dom)</literal>
131     . Note que <literal>D</literal> pode ser uma matriz de polinômios
132     (sistemas impróprios).</para>
133
134     <para>Representação de matriz de transferência:</para>
135
136     <programlisting role = ""><![CDATA[ 
137 sl=syslin(dom,N,D) 
138 sl=syslin(dom,H)
139  ]]></programlisting>
140
141     <para>A saída de <literal>syslin</literal> é uma lista da seguinte forma:
142     <literal>sl=tlist(['r','num','den','dt'],N,D,dom)</literal> ou
143     <literal>sl=tlist(['r','num','den','dt'],H(2),H(3),dom)</literal>.</para>
144
145     <para>Sistemas lineares definidos como <literal>syslin</literal> podem ser
146     manipulados como matrizes usuais (concatenação, extração, transposição,
147     multiplicação, etc.) ambos em estado-espaço ou representação de
148     transferência.</para>
149
150     <para>A maior parte das funções de controle de estado-espaço recebem uma
151     lista <literal>syslin</literal> como entrada, ao invés de quatro matrizes
152     definindo o sistema.</para>
153   </refsection>
154
155   <refsection>
156     <title>Exemplos</title>
157
158     <programlisting role="example"><![CDATA[ 
159 A=[0,1;0,0];B=[1;1];C=[1,1];
160 S1=syslin('c',A,B,C)   //Definição de sistema linear
161 S1("A")    //Exibição da matriz A
162 S1("X0"), S1("dt") // Exibição de X0 e domínio de tempo 
163 s=poly(0,'s');
164 D=s;
165 S2=syslin('c',A,B,C,D)
166 H1=(1+2*s)/s^2, S1bis=syslin('c',H1)
167 H2=(1+2*s+s^3)/s^2, S2bis=syslin('c',H2)
168 S1+S2
169 [S1,S2]
170 ss2tf(S1)-S1bis
171 S1bis+S2bis
172 S1*S2bis
173 size(S1)
174  ]]></programlisting>
175   </refsection>
176
177   <refsection role="see also">
178 <title>Ver Também</title>
179
180     <simplelist type="inline">
181       <member><link linkend="tlist">tlist</link></member>
182
183       <member><link linkend="lsslist">lsslist</link></member>
184
185       <member><link linkend="rlist">rlist</link></member>
186
187       <member><link linkend="ssrand">ssrand</link></member>
188
189       <member><link linkend="ss2tf">ss2tf</link></member>
190
191       <member><link linkend="tf2ss">tf2ss</link></member>
192
193       <member><link linkend="dscr">dscr</link></member>
194
195       <member><link linkend="abcd">abcd</link></member>
196     </simplelist>
197   </refsection>
198 </refentry>