* Bug 10668 fixed: bloc2ss() page was inaccurate
[scilab.git] / scilab / modules / elementary_functions / help / pt_BR / signalprocessing / bloc2ss.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) 2008 - INRIA - Serge STEER
5  * Copyright (C) 2008 - INRIA - Francois DELEBECQUE
6  *
7  * Copyright (C) 2012 - 2016 - Scilab Enterprises
8  *
9  * This file is hereby licensed under the terms of the GNU GPL v2.0,
10  * pursuant to article 5.3.4 of the CeCILL v.2.1.
11  * This file was originally licensed under the terms of the CeCILL v2.1,
12  * and continues to be available under such terms.
13  * For more information, see the COPYING file which you should have received
14  * along with this program.
15  *
16  -->
17 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
18           xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="http://www.w3.org/1999/xhtml"
19           xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
20           xmlns:scilab="http://www.scilab.org" xml:id="bloc2ss" xml:lang="pt">
21     <refnamediv>
22         <refname>bloc2ss</refname>
23         <refpurpose>conversão de diagrama de blocos para espaço de estados
24         </refpurpose>
25     </refnamediv>
26     <refsynopsisdiv>
27         <title>Seqüência de Chamamento</title>
28         <synopsis>sl = bloc2ss(blocd)</synopsis>
29     </refsynopsisdiv>
30     <refsection>
31         <title>Parâmetros</title>
32         <variablelist>
33             <varlistentry>
34                 <term>blocd</term>
35                 <listitem>
36                     <para>lista</para>
37                 </listitem>
38             </varlistentry>
39             <varlistentry>
40                 <term>sl</term>
41                 <listitem>
42                     <para>lista</para>
43                 </listitem>
44             </varlistentry>
45         </variablelist>
46     </refsection>
47     <refsection>
48         <title>Descrição</title>
49         <para>Dada uma representação em diagrama de blocos de um sistema linear,
50             <literal>bloc2ss</literal> converte esta representação em um sistema
51             linear de espaço de estados. O primeiro elemento da lista
52             <literal>blocd</literal> deve ser o string (cadeia de caracteres)
53             <literal>'blocd'</literal>. Cada outro elemento desta lista é, por si
54             mesmo, uma lista de um dos seguintes tipos :
55         </para>
56         <programlisting role=""><![CDATA[
57 list('transfer','nome_do_sistema_linear')
58  ]]></programlisting>
59         <programlisting role=""><![CDATA[
60 list('link','nome_do_link', [número_de_caixa_de_fluxo_superior,porta_da_caixa_de_fluxo_superior],
61                [caixa_de_fluxo_inferior_1,número_de_porta_da_caixa_inferior_1],
62                [caixa_de_fluxo_inferior_2,número_de_porta_da_caixa_inferior_2],
63                ...)
64  ]]></programlisting>
65         <para>
66             Os strings <literal>'transfer'</literal> e
67             <literal>'link'</literal> são palavras-chaves as quais indicam o tipo de
68             elemento no diagrama de blocos ("transfer"=transferência, "link"=
69             ligação).
70         </para>
71         <para>Caso 1: o segundo parâmetro da lista é um string que pode se referir
72             (para uma possível avaliação posterior) ao nome Scilab de um sistema
73             linear dado em representação de espaço de estados (lista
74             <literal>syslin</literal>) ou em forma de trasnferência (matriz de razões
75             de polinômios).
76         </para>
77         <para>A cada bloco de transferência é associado um inteiro. A cada entrada
78             e saida de um bloco de transferência, também é associado seu número, um
79             inteiro (ver exemplos).
80         </para>
81         <para>Caso 2: O segundo tipo de elemento em uma representação de diagrama
82             de blocos é um link. Um link liga uma saída de um bloco representado pelo
83             par <literal>[
84                 número_de_caixa_de_fluxo_superior,porta_da_caixa_de_fluxo_superior]
85             </literal>
86             ,
87             a diferentes entradas de outros blocos. Cada tal entrada é representada
88             pelo par [caixa_de_fluxo_inferior_i,número_de_porta_da_caixa_inferior_i]
89             .
90         </para>
91         <para>Os diferentes elementos de um diagrama de blocos podem ser definidos
92             em ordem arbitrária.
93         </para>
94         <para>Por exmeplo:</para>
95         <para>
96             [1] <literal>S1*S2</literal> com feedback (resposta) de
97             unidade.
98         </para>
99         <para>
100             Há 3 transferências <literal>S1</literal> (número
101             <literal>n_s1=2</literal>) , <literal>S2</literal> (número
102             <literal>n_s2=3</literal>) e um adicionador ("adder") (número
103             <literal>n_add=4</literal>) com função de transferência simbólica
104             <literal>['1','1']</literal>.
105         </para>
106         <para>
107             Há 4 links :
108             <itemizedlist>
109                 <listitem>
110                   O primeiro (de nome <literal>'U'</literal>) liga a entrada (porta 0 de bloco
111                   fictício -1, omitido) à porta 1 do adicionador.
112               </listitem>
113               <listitem>
114                 Os segundo liga a porta (de saída) 1 do  adicionador à porta (de entrada) 1 do
115                 sistema <literal>S1</literal>.
116               </listitem>
117               <listitem>
118                 Os terceiro liga a porta (de saída)  1 de <literal>S1</literal> à porta
119                 (de entrada) 1 de <literal>S2</literal>.
120               </listitem>
121               <listitem>
122                 O quarto link (de nome <literal>'Y'</literal>) liga  a porta (de saída) 1 de
123                 <literal>S2</literal> à saída (porta 0 do bloco fictício -1, omitido) e à porta
124                 (de entrada) 2 do adicionador.
125               </listitem>
126            </itemizedlist>
127         </para>
128         <programlisting role="example"><![CDATA[
129 //Inicialização
130 syst=list('blocd'); l=1;
131
132 //Sistemas
133 l=l+1;n_s1=l;syst(l)=list('transfer','S1');  //Sistema 1
134 l=l+1;n_s2=l;syst(l)=list('transfer','S2');  //Sistema 2
135 l=l+1;n_adder=l;syst(l)=list('transfer',['1','1']);  //adicionador
136
137 //Links
138 // Entradas  -1 --> entrada 1
139 l=l+1;syst(l)=list('link','U1',[-1],[n_adder,1]);
140
141 // Internal
142 l=l+1;syst(l)=list('link',' ',[n_adder,1],[n_s1,1]);
143 l=l+1;syst(l)=list('link',' ',[n_s1,1],[n_s2,1]);
144
145 // Saídas // -1 -> saída 1
146 l=l+1;syst(l)=list('link','Y',[n_s2,1],[-1],[n_adder,2]);
147  ]]></programlisting>
148         <para>
149             Com <literal>s=poly(0,'s');S1=1/(s+1);S2=1/s;</literal> o resultado
150             da avaliação de chamada <literal>sl=bloc2ss(syst);</literal> é uma
151             representação em estado-espaço para <literal>1/(s^2+s-1)</literal>.
152         </para>
153         <para>[2] exemplo da transformação linear fracional (TLF e, em inglês
154             LFT):
155         </para>
156         <programlisting role="example"><![CDATA[
157 //Inicialização
158 syst=list('blocd'); l=1;
159
160 //Sistema (planta de blocos 2x2)
161 l=l+1;n_s=l;syst(l)=list('transfer',['P11','P12';'P21','P22']);
162
163 //Controlador
164 l=l+1;n_k=l;syst(l)=list('transfer','k');
165
166 //Links
167 l=l+1;syst(l)=list('link','w',[-1],[n_s,1]);
168 l=l+1;syst(l)=list('link','z',[n_s,1],[-1]);
169 l=l+1;syst(l)=list('link','u',[n_k,1],[n_s,2]);
170 l=l+1;syst(l)=list('link','y',[n_s,2],[n_k,1]);
171  ]]></programlisting>
172         <para>Com</para>
173         <programlisting role="example"><![CDATA[
174 A=[0,1;0,0];
175 B=[1;1];
176 C=[1,1];
177 D=poly(0,'s');
178 P=syslin('c',A,B,C,D);
179  ]]></programlisting>
180     </refsection>
181     <refsection role="see also">
182         <title>Ver Também</title>
183         <simplelist type="inline">
184             <member>
185                 <link linkend="poly">poly</link>
186             </member>
187         </simplelist>
188     </refsection>
189     <refsection>
190         <title>Autores</title>
191         <para>S. S., F. D. (INRIA)</para>
192     </refsection>
193 </refentry>