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