License Header change: Removed the LICENSE_END before beta
[scilab.git] / scilab / modules / cacsd / help / pt_BR / plot_display / bode.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) INRIA
5  * 
6  * Copyright (C) 2012 - 2016 - Scilab Enterprises
7  *
8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
10  * This file was originally licensed under the terms of the CeCILL v2.1,
11  * and continues to be available under such terms.
12  * For more information, see the COPYING file which you should have received
13  * along with this program.
14  *
15  -->
16 <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" xmlns:scilab="http://www.scilab.org"  xml:id="bode" xml:lang="en">
17     <refnamediv>
18         <refname>bode</refname>
19         <refpurpose>diagrama de Bode</refpurpose>
20     </refnamediv>
21     <refsynopsisdiv>
22         <title>Seqüência de Chamamento</title>
23         <synopsis>bode(sl,[fmin,fmax] [,step] [,comments] )
24             bode(sl,frq [,comments] )
25             bode(frq,db,phi [,comments])
26             bode(frq, repf [,comments])
27         </synopsis>
28     </refsynopsisdiv>
29     <refsection>
30         <title>Parâmetros</title>
31         <variablelist>
32             <varlistentry>
33                 <term>sl</term>
34                 <listitem>
35                     <para>
36                         <literal>syslin</literal> lista (sistema linear SISO ou
37                         SIMO) em tempo contínuo ou discreto 
38                     </para>
39                 </listitem>
40             </varlistentry>
41             <varlistentry>
42                 <term>fmin,fmax</term>
43                 <listitem>
44                     <para>real (limites de freqüência (em Hz)) </para>
45                 </listitem>
46             </varlistentry>
47             <varlistentry>
48                 <term>step</term>
49                 <listitem>
50                     <para>real (passo logarítmico.) </para>
51                 </listitem>
52             </varlistentry>
53             <varlistentry>
54                 <term>comments</term>
55                 <listitem>
56                     <para>vetor de strings (legendas). </para>
57                 </listitem>
58             </varlistentry>
59             <varlistentry>
60                 <term>frq</term>
61                 <listitem>
62                     <para>vetor linha ou matriz (freqüências (em Hz) ) (uma linha para
63                         cada subsistema SISO). 
64                     </para>
65                 </listitem>
66             </varlistentry>
67             <varlistentry>
68                 <term>db</term>
69                 <listitem>
70                     <para>vetor linha ou matriz ( magnitudes (em Db)). (um para cada
71                         subsistema SISO). 
72                     </para>
73                 </listitem>
74             </varlistentry>
75             <varlistentry>
76                 <term>phi</term>
77                 <listitem>
78                     <para>vetor linha ou matriz ( fases (em graus)) (um para cada
79                         subsistema SISO ). 
80                     </para>
81                 </listitem>
82             </varlistentry>
83             <varlistentry>
84                 <term>repf</term>
85                 <listitem>
86                     <para>vetor linha ou matriz de números complexos (freqüência de
87                         resposta complexa).
88                     </para>
89                 </listitem>
90             </varlistentry>
91         </variablelist>
92     </refsection>
93     <refsection>
94         <title>Descrição</title>
95         <para>Diagrama de bode , i.e magnitude e fase da freqüência de resposta de
96             <literal>sl</literal>.
97         </para>
98         <para>
99             <literal>sl</literal> pode ser um sistema SIMO de tempo contínuo ou
100             discreto (ver <literal>syslin</literal>). No caso de múltiplas saídas,
101             elas são esboçadas com símbolos diferentes.
102         </para>
103         <para>
104             As freqüências são dadas pelos limites <literal>fmin,fmax</literal>
105             (em Hz) ou por um vetor linha (ou uma matriz para múltiplas saídas)
106             <literal>frq</literal>.
107         </para>
108         <para>
109             <literal>step</literal> é o passo de discretização ( logarítmica).
110             (ver <literal>calfrq</literal> para escolha do valor padrão).
111         </para>
112         <para>
113             <literal>comments</literal> é um vetor de strings (legendas).
114         </para>
115         <para>
116             <literal>db,phi</literal> são matrizes de módulos (em Db) e fases
117             (em graus). (Uma linha para cada resposta).
118         </para>
119         <para>
120             <literal>repf</literal> matriz de números complexos. Uma linha para
121             cada resposta.
122         </para>
123         <para>
124             Valores padrões para <literal>fmin</literal> e
125             <literal>fmax</literal> são <literal>1.d-3</literal>,
126             <literal>1.d+3</literal> se <literal>sl</literal> for de tempo contínuo ou
127             <literal>1.d-3</literal>, <literal>0.5</literal>/sl.dt (freqüência de
128             Nyquist) se <literal>sl</literal> for de tempo discreto. Discretização
129             automática das freqüências é feita por <literal>calfrq</literal>.
130         </para>
131     </refsection>
132     <refsection>
133         <title>Exemplos</title>
134         <programlisting role="example"><![CDATA[ 
135 s=poly(0,'s')
136 h=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01))
137 clf();bode(h,0.01,100);
138  ]]></programlisting>
139         <para>
140             <scilab:image localized="true">
141                 s=poly(0,'s')
142                 h=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01))
143                 clf();bode(h,0.01,100);
144             </scilab:image>
145         </para>
146         <programlisting role="example"><![CDATA[ 
147 s=poly(0,'s')
148 h1=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01))
149 num=22801+4406.18*s+382.37*s^2+21.02*s^3+s^4;
150 den=22952.25+4117.77*s+490.63*s^2+33.06*s^3+s^4
151 h2=syslin('c',num/den);
152
153 clf();bode([h1;h2],0.01,100,['h1';'h2'])
154  ]]></programlisting>
155         <para>
156             <scilab:image localized="true">
157                 s=poly(0,'s')
158                 h1=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01))
159                 num=22801+4406.18*s+382.37*s^2+21.02*s^3+s^4;
160                 den=22952.25+4117.77*s+490.63*s^2+33.06*s^3+s^4
161                 h2=syslin('c',num/den);
162                 
163                 clf();bode([h1;h2],0.01,100,['h1';'h2'])
164             </scilab:image>
165         </para>
166     </refsection>
167     <refsection>
168         <title>Ver Também</title>
169         <simplelist type="inline">
170             <member>
171                 <link linkend="black">black</link>
172             </member>
173             <member>
174                 <link linkend="nyquist">nyquist</link>
175             </member>
176             <member>
177                 <link linkend="gainplot">gainplot</link>
178             </member>
179             <member>
180                 <link linkend="repfreq">repfreq</link>
181             </member>
182             <member>
183                 <link linkend="g_margin">g_margin</link>
184             </member>
185             <member>
186                 <link linkend="p_margin">p_margin</link>
187             </member>
188             <member>
189                 <link linkend="calfrq">calfrq</link>
190             </member>
191             <member>
192                 <link linkend="phasemag">phasemag</link>
193             </member>
194         </simplelist>
195     </refsection>
196 </refentry>