* Bug 10668 fixed: bloc2ss() page was inaccurate
[scilab.git] / scilab / modules / elementary_functions / help / pt_BR / signalprocessing / bloc2ss.xml
index efd6c5a..a6aa85a 100644 (file)
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
+<?xml version="1.0" encoding="UTF-8"?>
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) 2008 - INRIA - Serge STEER
  * along with this program.
  *
  -->
-<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="bloc2ss" xml:lang="pt">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="http://www.w3.org/1999/xhtml"
+          xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
+          xmlns:scilab="http://www.scilab.org" xml:id="bloc2ss" xml:lang="pt">
     <refnamediv>
         <refname>bloc2ss</refname>
-        <refpurpose>conversão de diagrama de blocos para espaço de estados
+        <refpurpose>conversão de diagrama de blocos para espaço de estados
         </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
-        <title>Seqüência de Chamamento</title>
-        <synopsis>[sl]=bloc2ss(blocd)</synopsis>
+        <title>Seqüência de Chamamento</title>
+        <synopsis>sl = bloc2ss(blocd)</synopsis>
     </refsynopsisdiv>
     <refsection>
-        <title>Parâmetros</title>
+        <title>Parâmetros</title>
         <variablelist>
             <varlistentry>
                 <term>blocd</term>
         </variablelist>
     </refsection>
     <refsection>
-        <title>Descrição</title>
-        <para>Dada uma representação em diagrama de blocos de um sistema linear,
-            <literal>bloc2ss</literal> converte esta representação em um sistema
-            linear de espaço de estados. O primeiro elemento da lista
+        <title>Descrição</title>
+        <para>Dada uma representação em diagrama de blocos de um sistema linear,
+            <literal>bloc2ss</literal> converte esta representação em um sistema
+            linear de espaço de estados. O primeiro elemento da lista
             <literal>blocd</literal> deve ser o string (cadeia de caracteres)
-            <literal>'blocd'</literal>. Cada outro elemento desta lista é, por si
+            <literal>'blocd'</literal>. Cada outro elemento desta lista é, por si
             mesmo, uma lista de um dos seguintes tipos :
         </para>
         <programlisting role=""><![CDATA[
 list('transfer','nome_do_sistema_linear')
  ]]></programlisting>
         <programlisting role=""><![CDATA[
-list('link','nome_do_link', [número_de_caixa_de_fluxo_superior,porta_da_caixa_de_fluxo_superior],
-               [caixa_de_fluxo_inferior_1,número_de_porta_da_caixa_inferior_1],
-               [caixa_de_fluxo_inferior_2,número_de_porta_da_caixa_inferior_2],
+list('link','nome_do_link', [número_de_caixa_de_fluxo_superior,porta_da_caixa_de_fluxo_superior],
+               [caixa_de_fluxo_inferior_1,número_de_porta_da_caixa_inferior_1],
+               [caixa_de_fluxo_inferior_2,número_de_porta_da_caixa_inferior_2],
                ...)
  ]]></programlisting>
         <para>
             Os strings <literal>'transfer'</literal> e
-            <literal>'links'</literal> são palavras-chaves as quais indicam o tipo de
-            elemento no diagrama de blocos ("transfer"=transferência, "link"=
-            ligação).
+            <literal>'link'</literal> são palavras-chaves as quais indicam o tipo de
+            elemento no diagrama de blocos ("transfer"=transferência, "link"=
+            ligação).
         </para>
-        <para>Caso 1: o segundo parâmetro da lista é um string que pode se referir
-            (para uma possível avaliação posterior) ao nome Scilab de um sistema
-            linear dado em representação de espaço de estados (lista
-            <literal>syslin</literal>) ou em forma de trasnferência (matriz de razões
-            de polinômios).
+        <para>Caso 1: o segundo parâmetro da lista é um string que pode se referir
+            (para uma possível avaliação posterior) ao nome Scilab de um sistema
+            linear dado em representação de espaço de estados (lista
+            <literal>syslin</literal>) ou em forma de trasnferência (matriz de razões
+            de polinômios).
         </para>
-        <para>A cada bloco de transferência é associado um inteiro. A cada entrada
-            e saida de um bloco de transferência, também é associado seu número, um
+        <para>A cada bloco de transferência é associado um inteiro. A cada entrada
+            e saida de um bloco de transferência, também é associado seu número, um
             inteiro (ver exemplos).
         </para>
-        <para>Caso 2: O segundo tipo de elemento em uma representação de diagrama
-            de blocos é um link. Um link liga uma saída de um bloco representado pelo
+        <para>Caso 2: O segundo tipo de elemento em uma representação de diagrama
+            de blocos é um link. Um link liga uma saída de um bloco representado pelo
             par <literal>[
-                número_de_caixa_de_fluxo_superior,porta_da_caixa_de_fluxo_superior]
+                número_de_caixa_de_fluxo_superior,porta_da_caixa_de_fluxo_superior]
             </literal>
             ,
-            a diferentes entradas de outros blocos. Cada tal entrada é representada
-            pelo par [caixa_de_fluxo_inferior_i,número_de_porta_da_caixa_inferior_i]
+            a diferentes entradas de outros blocos. Cada tal entrada é representada
+            pelo par [caixa_de_fluxo_inferior_i,número_de_porta_da_caixa_inferior_i]
             .
         </para>
         <para>Os diferentes elementos de um diagrama de blocos podem ser definidos
-            em ordem arbitrária.
+            em ordem arbitrária.
         </para>
         <para>Por exmeplo:</para>
         <para>
@@ -94,24 +97,36 @@ list('link','nome_do_link', [n
             unidade.
         </para>
         <para>
-            Há 3 transferências <literal>S1</literal> (número
-            <literal>n_s1=2</literal>) , <literal>S2</literal> (número
-            <literal>n_s2=3</literal>) e um adicionador ("adder") (número
-            <literal>n_add=4</literal>) com função de transferência simbólica
+            Há 3 transferências <literal>S1</literal> (número
+            <literal>n_s1=2</literal>) , <literal>S2</literal> (número
+            <literal>n_s2=3</literal>) e um adicionador ("adder") (número
+            <literal>n_add=4</literal>) com função de transferência simbólica
             <literal>['1','1']</literal>.
         </para>
         <para>
-            Há 4 links. O primeiro (de nome <literal>'U'</literal>) liga a
-            entrada (porta 0 de bloco fictício -1, omitido) à porta 1 do adicionador.
-            Os segundo e terceiro ligam respectivamente a porta (de saída) 1 do
-            adicionador à porta (de entrada) 1 do sistema <literal>S1</literal>, e a
-            porta (de saída) 1 de <literal>S1</literal> à porta (de entrada) 1 de
-            <literal>S2</literal>. O quarto link (de nome <literal>'Y'</literal>) liga
-            a porta (de saída) 1 de <literal>S2</literal> à saída (porta 0 do bloco
-            fictício -1, omitido) e à porta (de entrada) 2 do adicionador.
+            Há 4 links :
+            <itemizedlist>
+                <listitem>
+                  O primeiro (de nome <literal>'U'</literal>) liga a entrada (porta 0 de bloco
+                  fictício -1, omitido) à porta 1 do adicionador.
+              </listitem>
+              <listitem>
+                Os segundo liga a porta (de saída) 1 do  adicionador à porta (de entrada) 1 do
+                sistema <literal>S1</literal>.
+              </listitem>
+              <listitem>
+                Os terceiro liga a porta (de saída)  1 de <literal>S1</literal> à porta
+                (de entrada) 1 de <literal>S2</literal>.
+              </listitem>
+              <listitem>
+                O quarto link (de nome <literal>'Y'</literal>) liga  a porta (de saída) 1 de
+                <literal>S2</literal> à saída (porta 0 do bloco fictício -1, omitido) e à porta
+                (de entrada) 2 do adicionador.
+              </listitem>
+           </itemizedlist>
         </para>
         <programlisting role="example"><![CDATA[
-//Inicialização
+//Inicialização
 syst=list('blocd'); l=1;
 
 //Sistemas
@@ -127,19 +142,19 @@ l=l+1;syst(l)=list('link','U1',[-1],[n_adder,1]);
 l=l+1;syst(l)=list('link',' ',[n_adder,1],[n_s1,1]);
 l=l+1;syst(l)=list('link',' ',[n_s1,1],[n_s2,1]);
 
-// Saídas // -1 -> saída 1
+// Saídas // -1 -> saída 1
 l=l+1;syst(l)=list('link','Y',[n_s2,1],[-1],[n_adder,2]);
  ]]></programlisting>
         <para>
             Com <literal>s=poly(0,'s');S1=1/(s+1);S2=1/s;</literal> o resultado
-            da avaliação de chamada <literal>sl=bloc2ss(syst);</literal> é uma
-            representação em estado-espaço para <literal>1/(s^2+s-1)</literal>.
+            da avaliação de chamada <literal>sl=bloc2ss(syst);</literal> é uma
+            representação em estado-espaço para <literal>1/(s^2+s-1)</literal>.
         </para>
-        <para>[2] exemplo da transformação linear fracional (TLF e, em inglês
+        <para>[2] exemplo da transformação linear fracional (TLF e, em inglês
             LFT):
         </para>
         <programlisting role="example"><![CDATA[
-//Inicialização
+//Inicialização
 syst=list('blocd'); l=1;
 
 //Sistema (planta de blocos 2x2)
@@ -164,7 +179,7 @@ P=syslin('c',A,B,C,D);
  ]]></programlisting>
     </refsection>
     <refsection role="see also">
-        <title>Ver Também</title>
+        <title>Ver Também</title>
         <simplelist type="inline">
             <member>
                 <link linkend="poly">poly</link>