7b2f063fab159d1fe0ecdeb3bba80762ecf10ccf
[scilab.git] / scilab / modules / elementary_functions / help / pt_BR / signalprocessing / bloc2exp.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 - Serge STEER
5  * Copyright (C) 2008 - INRIA - Francois DELEBECQUE
6  * 
7  * This file must be used under the terms of the CeCILL.
8  * This source file is licensed as described in the file COPYING, which
9  * you should have received as part of this distribution.  The terms
10  * are also available at    
11  * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
12  *
13  -->
14 <refentry version="5.0-subset Scilab" xml:id="bloc2exp" xml:lang="en"
15           xmlns="http://docbook.org/ns/docbook"
16           xmlns:xlink="http://www.w3.org/1999/xlink"
17           xmlns:svg="http://www.w3.org/2000/svg"
18           xmlns:ns5="http://www.w3.org/1999/xhtml"
19           xmlns:mml="http://www.w3.org/1998/Math/MathML"
20           xmlns:db="http://docbook.org/ns/docbook">
21   <info>
22     <pubdate>$LastChangedDate$</pubdate>
23   </info>
24
25   <refnamediv>
26     <refname>bloc2exp</refname>
27
28     <refpurpose>retorna a avaliação simbólica de um diagrama de
29     blocos</refpurpose>
30   </refnamediv>
31
32   <refsynopsisdiv>
33     <title>Seqüência de Chamamento</title>
34
35     <synopsis>[str]=bloc2exp(blocd)
36 [str,names]=bloc2exp(blocd)</synopsis>
37   </refsynopsisdiv>
38
39   <refsection>
40     <title>Parâmetros</title>
41
42     <variablelist>
43       <varlistentry>
44         <term>blocd</term>
45
46         <listitem>
47           <para>lista</para>
48         </listitem>
49       </varlistentry>
50
51       <varlistentry>
52         <term>str</term>
53
54         <listitem>
55           <para>string </para>
56         </listitem>
57       </varlistentry>
58
59       <varlistentry>
60         <term>names</term>
61
62         <listitem>
63           <para>string</para>
64         </listitem>
65       </varlistentry>
66     </variablelist>
67   </refsection>
68
69   <refsection>
70     <title>Descrição</title>
71
72     <para>Dada uma representação em diagrama de blocos de um sistema linear
73     <literal>bloc2exp</literal> retorna sua avaliação simbólica. O primeiro
74     elemento da lista <literal>blocd</literal> deve ser o string (cadeia de
75     caracteres) <literal>'blocd'</literal>. Cada outro elemento desta lista
76     <literal>(blocd(2),blocd(3),...)</literal> é, por si mesmo, uma lista de
77     um dos seguintes tipos :</para>
78
79     <programlisting role = ""><![CDATA[ 
80 list('transfer','nome_do_sistema_linear')
81  ]]></programlisting>
82
83     <programlisting role = ""><![CDATA[ 
84 list('link','nome_da_ligação',
85                [número_de_caixa_de_fluxo_superior,porta_da_caixa_de_fluxo_superior],
86                [caixa_de_fluxo_inferior_1,número_de_porta_da_caixa_inferior_1],
87                [caixa_de_fluxo_inferior_2,número_de_porta_da_caixa_inferior_2],
88                ...)
89  ]]></programlisting>
90
91     <para>Os strings <literal>'transfer'</literal> e
92     <literal>'links'</literal> são palavras-chaves as quais indicam o tipo de
93     elemento no diagrama de blocos ("transfer"=transferência, "link"=
94     ligação).</para>
95
96     <para>Caso 1: o segundo parâmetro da lista é um string que pode se referir
97     (para uma possível avaliação posterior) ao nome Scilab de um sistema
98     linear dado em representação de estado-espaço (lista<literal>
99     syslin</literal> ) ou em forma de trasnferência (matriz de razões de
100     polinômios).</para>
101
102     <para>A cada bloco de transferência é associado um inteiro. A cada entrada
103     e saída de um bloco de transferência, também é associado seu número, um
104     inteiro (ver exemplos).</para>
105
106     <para>Caso 2: O segundo tipo de elemento em uma representação de diagrama
107     de blocos é um link. Um link liga uma saída de um bloco representado pelo
108     par <literal>[
109     número_de_caixa_de_fluxo_superior,porta_da_caixa_de_fluxo_superior]</literal>,
110     a diferentes entradas de outros blocos. Cada tal entrada é representada
111     pelo par [caixa_de_fluxo_inferior_i,número_de_porta_da_caixa_inferior_i]
112     .</para>
113
114     <para>Os diferentes elementos de um diagrama de blocos podem ser definidos
115     em ordem arbitrária.</para>
116
117     <para>Por exemplo:</para>
118
119     <para>[1] <literal>S1*S2</literal> com feedback (resposta) de
120     unidade.</para>
121
122     <para>Há 3 transferências <literal>S1</literal> (número
123     <literal>n_s1=2</literal>) , <literal>S2</literal> (número
124     <literal>n_s2=3</literal>) e um adicionador ("adder") (número
125     <literal>n_add=4</literal>) com função de transferência simbólica
126     <literal>['1','1']</literal>.</para>
127
128     <para>Há 4 ligações. O primeiro (de nome <literal>'U'</literal>) liga a
129     entrada (porta 0 de bloco fictício -1, omitido) à porta 1 do adicionador.
130     Os segundo e terceiro ligam respectivamente a porta (de saída) 1 do
131     adicionador à porta (de entrada) 1 do sistema <literal>S1</literal>, e a
132     porta (de saída) 1 de <literal>S1</literal> à porta (de entrada) 1 de
133     <literal>S2</literal>. A quarta ligação (de nome <literal>'Y'</literal>)
134     liga a porta (de saída) 1 de <literal>S2</literal> à saída (porta 0 do
135     bloco fictício -1, omitido) e à porta (de entrada) 2 do
136     adicionador.</para>
137
138     <programlisting role = "example"><![CDATA[ 
139 //Inicialização
140 syst=list('blocd'); l=1;
141 //
142 //Sistemas
143 l=l+1;n_s1=l;syst(l)=list('transfer','S1');  //Sistema 1
144 l=l+1;n_s2=l;syst(l)=list('transfer','S2');  //Sistema 2
145 l=l+1;n_adder=l;syst(l)=list('transfer',['1','1']);  //adicionador
146 //
147 //Links
148 // Entradas  -1 --> entrada 1
149 l=l+1;syst(l)=list('link','U',[-1],[n_adder,1]);
150 // Internal 
151 l=l+1;syst(l)=list('link',' ',[n_adder,1],[n_s1,1]);
152 l=l+1;syst(l)=list('link',' ',[n_s1,1],[n_s2,1]);
153 // Saídas // -1 -> saída 1
154 l=l+1;syst(l)=list('link','Y',[n_s2,1],[-1],[n_adder,2]);
155 //Chamada de avaliação
156 w=bloc2exp(syst);
157  ]]></programlisting>
158
159     <para>O resultado é o string:
160     <literal>w=-(s2*s1-eye())\s2*s1</literal>.</para>
161
162     <para>Perceba que, chamado com dois agumentos de saída,
163     <literal>[str,names]= blocd(syst)</literal> retorna em
164     <literal>names</literal> a lista de nomes simbólicos dos links nomeados.
165     Isto é útil para definir nomes de entradas e saídas.</para>
166
167     <para>[2] segundo exemplo</para>
168
169     <programlisting role = "example"><![CDATA[ 
170 //Inicialização
171 syst=list('blocd'); l=1;
172
173 //Sistema (planta de blocos 2x2)
174 l=l+1;n_s=l;syst(l)=list('transfer',['P11','P12';'P21','P22']);  
175
176 //Controlador
177 l=l+1;n_k=l;syst(l)=list('transfer','k'); 
178
179 //Links
180 l=l+1;syst(l)=list('link','w',[-1],[n_s,1]);
181 l=l+1;syst(l)=list('link','z',[n_s,1],[-1]);
182 l=l+1;syst(l)=list('link','u',[n_k,1],[n_s,2]);
183 l=l+1;syst(l)=list('link','y',[n_s,2],[n_k,1]);
184
185 //Chamada de avaliação
186 w=bloc2exp(syst);
187  ]]></programlisting>
188
189     <para>Neste caso, o resultado é uma fórmula equivalente à usual:</para>
190
191     <para><literal>P11+P12*invr(eye()-K*P22)*K*P21;</literal></para>
192   </refsection>
193
194   <refsection role="see also">
195 <title>Ver Também</title>
196
197     <simplelist type="inline">
198       <member><link linkend="bloc2ss">bloc2ss</link></member>
199     </simplelist>
200   </refsection>
201
202   <refsection>
203     <title>Autores</title>
204
205     <para>S. S., F. D. (INRIA)</para>
206   </refsection>
207 </refentry>