Help check: validate the help files on compilation against a derivated docbook schema
[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 xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="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="bloc2exp" xml:lang="en">
15   <info>
16     <pubdate>$LastChangedDate$</pubdate>
17   </info>
18   <refnamediv>
19     <refname>bloc2exp</refname>
20     <refpurpose>retorna a avaliação simbólica de um diagrama de
21     blocos</refpurpose>
22   </refnamediv>
23   <refsynopsisdiv>
24     <title>Seqüência de Chamamento</title>
25     <synopsis>[str]=bloc2exp(blocd)
26 [str,names]=bloc2exp(blocd)</synopsis>
27   </refsynopsisdiv>
28   <refsection>
29     <title>Parâmetros</title>
30     <variablelist>
31       <varlistentry>
32         <term>blocd</term>
33         <listitem>
34           <para>lista</para>
35         </listitem>
36       </varlistentry>
37       <varlistentry>
38         <term>str</term>
39         <listitem>
40           <para>string </para>
41         </listitem>
42       </varlistentry>
43       <varlistentry>
44         <term>names</term>
45         <listitem>
46           <para>string</para>
47         </listitem>
48       </varlistentry>
49     </variablelist>
50   </refsection>
51   <refsection>
52     <title>Descrição</title>
53     <para>Dada uma representação em diagrama de blocos de um sistema linear
54     <literal>bloc2exp</literal> retorna sua avaliação simbólica. O primeiro
55     elemento da lista <literal>blocd</literal> deve ser o string (cadeia de
56     caracteres) <literal>'blocd'</literal>. Cada outro elemento desta lista
57     <literal>(blocd(2),blocd(3),...)</literal> é, por si mesmo, uma lista de
58     um dos seguintes tipos :</para>
59     <programlisting><![CDATA[ 
60 list('transfer','nome_do_sistema_linear')
61  ]]></programlisting>
62     <programlisting><![CDATA[ 
63 list('link','nome_da_ligação',
64                [número_de_caixa_de_fluxo_superior,porta_da_caixa_de_fluxo_superior],
65                [caixa_de_fluxo_inferior_1,número_de_porta_da_caixa_inferior_1],
66                [caixa_de_fluxo_inferior_2,número_de_porta_da_caixa_inferior_2],
67                ...)
68  ]]></programlisting>
69     <para>Os strings <literal>'transfer'</literal> e
70     <literal>'links'</literal> são palavras-chaves as quais indicam o tipo de
71     elemento no diagrama de blocos ("transfer"=transferência, "link"=
72     ligação).</para>
73     <para>Caso 1: o segundo parâmetro da lista é um string que pode se referir
74     (para uma possível avaliação posterior) ao nome Scilab de um sistema
75     linear dado em representação de estado-espaço (lista<literal>
76     syslin</literal> ) ou em forma de trasnferência (matriz de razões de
77     polinômios).</para>
78     <para>A cada bloco de transferência é associado um inteiro. A cada entrada
79     e saída de um bloco de transferência, também é associado seu número, um
80     inteiro (ver exemplos).</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]</literal>,
85     a diferentes entradas de outros blocos. Cada tal entrada é representada
86     pelo par [caixa_de_fluxo_inferior_i,número_de_porta_da_caixa_inferior_i]
87     .</para>
88     <para>Os diferentes elementos de um diagrama de blocos podem ser definidos
89     em ordem arbitrária.</para>
90     <para>Por exemplo:</para>
91     <para>[1] <literal>S1*S2</literal> com feedback (resposta) de
92     unidade.</para>
93     <para>Há 3 transferências <literal>S1</literal> (número
94     <literal>n_s1=2</literal>) , <literal>S2</literal> (número
95     <literal>n_s2=3</literal>) e um adicionador ("adder") (número
96     <literal>n_add=4</literal>) com função de transferência simbólica
97     <literal>['1','1']</literal>.</para>
98     <para>Há 4 ligações. O primeiro (de nome <literal>'U'</literal>) liga a
99     entrada (porta 0 de bloco fictício -1, omitido) à porta 1 do adicionador.
100     Os segundo e terceiro ligam respectivamente a porta (de saída) 1 do
101     adicionador à porta (de entrada) 1 do sistema <literal>S1</literal>, e a
102     porta (de saída) 1 de <literal>S1</literal> à porta (de entrada) 1 de
103     <literal>S2</literal>. A quarta ligação (de nome <literal>'Y'</literal>)
104     liga a porta (de saída) 1 de <literal>S2</literal> à saída (porta 0 do
105     bloco fictício -1, omitido) e à porta (de entrada) 2 do
106     adicionador.</para>
107     <programlisting role="example"><![CDATA[ 
108 //Inicialização
109 syst=list('blocd'); l=1;
110 //
111 //Sistemas
112 l=l+1;n_s1=l;syst(l)=list('transfer','S1');  //Sistema 1
113 l=l+1;n_s2=l;syst(l)=list('transfer','S2');  //Sistema 2
114 l=l+1;n_adder=l;syst(l)=list('transfer',['1','1']);  //adicionador
115 //
116 //Links
117 // Entradas  -1 --> entrada 1
118 l=l+1;syst(l)=list('link','U',[-1],[n_adder,1]);
119 // Internal 
120 l=l+1;syst(l)=list('link',' ',[n_adder,1],[n_s1,1]);
121 l=l+1;syst(l)=list('link',' ',[n_s1,1],[n_s2,1]);
122 // Saídas // -1 -> saída 1
123 l=l+1;syst(l)=list('link','Y',[n_s2,1],[-1],[n_adder,2]);
124 //Chamada de avaliação
125 w=bloc2exp(syst);
126  ]]></programlisting>
127     <para>O resultado é o string:
128     <literal>w=-(s2*s1-eye())\s2*s1</literal>.</para>
129     <para>Perceba que, chamado com dois agumentos de saída,
130     <literal>[str,names]= blocd(syst)</literal> retorna em
131     <literal>names</literal> a lista de nomes simbólicos dos links nomeados.
132     Isto é útil para definir nomes de entradas e saídas.</para>
133     <para>[2] segundo exemplo</para>
134     <programlisting role="example"><![CDATA[ 
135 //Inicialização
136 syst=list('blocd'); l=1;
137
138 //Sistema (planta de blocos 2x2)
139 l=l+1;n_s=l;syst(l)=list('transfer',['P11','P12';'P21','P22']);  
140
141 //Controlador
142 l=l+1;n_k=l;syst(l)=list('transfer','k'); 
143
144 //Links
145 l=l+1;syst(l)=list('link','w',[-1],[n_s,1]);
146 l=l+1;syst(l)=list('link','z',[n_s,1],[-1]);
147 l=l+1;syst(l)=list('link','u',[n_k,1],[n_s,2]);
148 l=l+1;syst(l)=list('link','y',[n_s,2],[n_k,1]);
149
150 //Chamada de avaliação
151 w=bloc2exp(syst);
152  ]]></programlisting>
153     <para>Neste caso, o resultado é uma fórmula equivalente à usual:</para>
154     <para>
155       <literal>P11+P12*invr(eye()-K*P22)*K*P21;</literal>
156     </para>
157   </refsection>
158   <refsection role="see also">
159     <title>Ver Também</title>
160     <simplelist type="inline">
161       <member>
162         <link linkend="bloc2ss">bloc2ss</link>
163       </member>
164     </simplelist>
165   </refsection>
166   <refsection>
167     <title>Autores</title>
168     <para>S. S., F. D. (INRIA)</para>
169   </refsection>
170 </refentry>