fa285b12031ea6b87a7b0b2a9fdd5335f667caf4
[scilab.git] / scilab / modules / graphics / help / pt_BR / 2d_plot / plot.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) INRIA - Fabrice Leray
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: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="plot" xml:lang="pt">
17     <refnamediv>
18         <refname>plot</refname>
19         <refpurpose>Esboço 2d</refpurpose>
20     </refnamediv>
21     <refsynopsisdiv>
22         <title>Seqüência de Chamamento</title>
23         <synopsis>plot(y,&lt;LineSpec&gt;,&lt;GlobalProperty&gt;)
24             plot(x,y,&lt;LineSpec&gt;,&lt;GlobalProperty&gt;)
25             plot(x1,y1,&lt;LineSpec1&gt;,x2,y2,&lt;LineSpec2&gt;,...xN,yN,&lt;LineSpecN&gt;,&lt;GlobalProperty1&gt;,&lt;GlobalProperty2&gt;,..&lt;GlobalPropertyM&gt;)
26             plot(&lt;axes_handle&gt;,...)
27         </synopsis>
28     </refsynopsisdiv>
29     <refsection role="parameters">
30         <title>Parâmetros</title>
31         <variablelist>
32             <varlistentry>
33                 <term>x</term>
34                 <listitem>
35                     <para>uma matriz ou vetor de reais. Se omitido, é assumido como
36                         sendo o vetor <literal>1:n</literal> onde <literal>n</literal> é o
37                         número de pontos de curva dado pelo parâmetro
38                         <literal>y</literal>.
39                     </para>
40                 </listitem>
41             </varlistentry>
42             <varlistentry>
43                 <term>y</term>
44                 <listitem>
45                     <para>
46                         uma matriz de reais ou um vetor. <literal>y</literal> também
47                         pode ser uma função definida como um macro ou uma primitiva.
48                     </para>
49                 </listitem>
50             </varlistentry>
51             <varlistentry>
52                 <term>&lt;LineSpec&gt;</term>
53                 <listitem>
54                     <para>este argumento opcional deve ser usado como um atalho para
55                         especificar um modo de desenhar uma linha. Podemos ter um
56                         <literal>LineSpec</literal> por<literal> y</literal> ou
57                         <literal>{x,y}</literal> previamente entrados. As opções
58                         <literal>LineSpec</literal> lidam com os especificadores LineStyle,
59                         Marker e Color (ver <link linkend="LineSpec">LineSpec</link>). Estes
60                         especificadores determinam o estilo de linha, de marcas e a cor das
61                         linhas esboçadas.
62                     </para>
63                 </listitem>
64             </varlistentry>
65             <varlistentry>
66                 <term>&lt;GlobalProperty&gt;</term>
67                 <listitem>
68                     <para>este argumento opcional representa uma seqüência de pares de
69                         declarações <literal>{PropertyName,PropertyValue}</literal> tque
70                         define propriedades globais de objetos a serem aplicadas a todas as
71                         curvas criadas pelo esboço. Para uma visualização completa de das
72                         propriedades disponíveis veja <link linkend="GlobalProperty">GlobalProperty</link>.
73                     </para>
74                 </listitem>
75             </varlistentry>
76             <varlistentry>
77                 <term>&lt;axes_handle&gt;</term>
78                 <listitem>
79                     <para>este argumento opcional força o esboço a aparecer dentro dos
80                         eixos selecionados fornecidos por <literal>axes_handle</literal> ao
81                         invés dos eixos correntes (ver <link linkend="gca">gca</link>).
82                     </para>
83                 </listitem>
84             </varlistentry>
85         </variablelist>
86     </refsection>
87     <refsection role="description">
88         <title>Descrição</title>
89         <para>
90             <literal>plot</literal> esboça um conjunto de curvas 2d.
91             <literal>plot</literal> foi reconstruído para lidar melhor com a sintaxe
92             do Matlab. Para melhorar a compatibilidade gráfica com o Matlab, utilize
93             <literal>plot</literal> (ao invés de <link linkend="plot2d">plot2d</link>).
94         </para>
95         <para>Especificação de entrada de dados:</para>
96         <para>Neste parágrafo, para sermos mais claros, não mencionaremos os
97             argumentos opcionais <literal>LineSpec</literal> ou
98             <literal>GlobalProperty</literal> já que eles não interferem na entrada de
99             dados (exceto pelas propriedades <literal>"Xdata"</literal>,
100             <literal>"Ydata"</literal> e <literal>"Zdata"</literal>, ver <link linkend="GlobalProperty">GlobalProperty</link>). É assumido que todos
101             estes argumentos podem estar presentes também.
102         </para>
103         <para>
104             Se <literal>y</literal> é um vetor, plot(y) esboça um vetor
105             <literal>y</literal> versus o vetor
106             <literal>1:size(y,'*')</literal>.
107         </para>
108         <para>
109             Se <literal>y</literal> é uma matriz, plot(y) esboça cada coluna de
110             <literal>y</literal> versus o vetor <literal>1:size(y,1)</literal>.
111         </para>
112         <para>
113             Se <literal>x</literal> e <literal>y</literal> são vetores,
114             plot(x,y) esboça o vetor <literal>y</literal> versus o vetor
115             <literal>x</literal>. Os vetores <literal>x</literal> e
116             <literal>y</literal> devem ter o mesmo número de entradas.
117         </para>
118         <para>
119             Se <literal>x</literal> é um vetor e <literal>y</literal> uma matriz
120             plot(x,y) esboça cada coluna de <literal>y</literal> versus o vetor
121             <literal>x</literal>. Neste caso, o número de colunas de
122             <literal>y</literal> deve ser igual ao número de entradas de
123             <literal>x</literal>.
124         </para>
125         <para>
126             Se <literal>x</literal> e <literal>y</literal> são matrizes,
127             plot(x,y) esboça cada coluna de <literal>y</literal> versus a coluna
128             correspondente de <literal>x</literal>. Neste caso, os tamanhos
129             <literal>x</literal> e <literal>y</literal> devem ser os mesmos.
130         </para>
131         <para>
132             Finalmente, se apenas <literal>x</literal> ou <literal>y</literal> é
133             uma matriz, o vetor é esboçado versus cada linha ou cada coluna da matriz.
134             A escolha é feita dependendo se a dimensão de linha ou coluna do vetor
135             coincide com a dimensão de linha ou coluna da matriz. No caso de uma
136             matriz quadrada (apenas <literal>x</literal> ou penas
137             <literal>y</literal>), a prioridade é dada a colunas ao invés de linhas
138             (ver exemplos abaixo).
139         </para>
140         <para>
141             <literal>y</literal> também pode ser uma função definida como um
142             macro ou uma primitiva. Neste caso, os dados <literal>x</literal> devem
143             ser fornecidos (como um vetor ou uma matriz) e a computação correspondente
144             de <literal>y(x)</literal> é feita implicitamente.
145         </para>
146         <para>
147             Os argumentos <literal>LineSpec</literal> e
148             <literal>GlobalProperty</literal> devem ser utilizados para customizar o
149             esboço. Aqui está uma lista completa das opções disponíveis.
150         </para>
151         <variablelist>
152             <varlistentry>
153                 <term>LineSpec</term>
154                 <listitem>
155                     <para>esta opção pode ser utilizada para se especificar, de um modo
156                         curto e fácil, como as curvas são desenhadas. Deve sempre ser um
157                         string contendo referências aos especificadores LineStyle, Marker e
158                         Color.
159                     </para>
160                     <para>Essas referências devem ser ajustadas denro do string (a ordem
161                         não é importante) de modo a não ter ambigüidades. Por exemplo, para
162                         especificar uma linha vermelha de traço longo com marcas de rombos,
163                         pode-se escrever : <literal>'r--d'</literal> ou
164                         <literal>'--dire'</literal> ou <literal>'--reddiam'</literal> ou
165                         outra sentença sem ambigüidade... ou de modo completo
166                         <literal>'diamondred--'</literal> (ver <link linkend="LineSpec">LineSpec</link>).
167                     </para>
168                     <para>Note que os estilos de linha e marcas (e tamanhos) e as cores,
169                         podem ser (re*)ajustados através das propriedades da entidade
170                         poligonal (ver <link linkend="polyline_properties">polyline_properties</link>).
171                     </para>
172                 </listitem>
173             </varlistentry>
174             <varlistentry>
175                 <term>GlobalProperty</term>
176                 <listitem>
177                     <para>esta opção pode ser utilizada para especificar como as linhas
178                         serão desenhadas com mais opções que via
179                         <literal>LineSpec</literal>. Deve sempre ser um par de declarações
180                         constituidos de um string definindo <literal>PropertyName</literal>,
181                         (nome da propriedade) e seu valor associado
182                         <literal>PropertyValue</literal> (que pode ser um string, um inteiro
183                         ou qualquer outra coisa... dependendo do tipo de
184                         <literal>PropertyName</literal>). Utilizando-se
185                         <literal>GlobalProperty</literal>, pode-se ajustar várias
186                         propriedades : todas as propriedades disponíveis via LineSpec e
187                         mais: a cor da marca (plano de fundo e primeiro plano), a
188                         visibilidade, o recorte e a espessura das curvas. (ver <link linkend="GlobalProperty">GlobalProperty</link>)
189                     </para>
190                     <para>Note que todas as propriedades podem ser (re-)ajustadas
191                         através das propriedades de entidades poligonais (ver <link linkend="polyline_properties">polyline_properties</link>).
192                     </para>
193                 </listitem>
194             </varlistentry>
195         </variablelist>
196     </refsection>
197     <refsection role="description">
198         <title>Observações </title>
199         <para>Por padrão, esboços sucessivos são superpostos. Para limpar o esboço
200             anterior, use <literal>clf()</literal>. Para habilitar o modo
201             <literal>auto_clear</literal> (limpeza automática) como modo padrão, edite
202             seus eixos fazendo o seguinte:
203         </para>
204         <para>da=gda();</para>
205         <para>da.auto_clear = 'on'</para>
206         <para>
207             Para uma melhor exibição, a função <literal>plot</literal> pode
208             modificar a propriedade <literal>box</literal> de seu Axes (eixos) raíze.
209             Isto acontece quando uma entidade Axes é criada por uma chamada a
210             <literal>plot</literal> ou é vazia antes da chamada. Se um dos eixos é
211             centrado na origem, box é desabilitado. Em caso contrário, box é
212             habilitado.
213         </para>
214         <para>Para mais informações sobre a propriedade box e sobre o
215             posicionamento dos eixos, veja <link linkend="axes_properties">axes_properties</link>
216         </para>
217         <para>Uma tabela de cores padrão é utilizada para colorir as curvas
218             esboçadas quando você não especifica as cores. Ao desenhar linhas
219             múltiplas, o comando plot automaticamente atribui as cores abaixo de modo
220             cíclico. Aqui estão as cores utilizadas:
221         </para>
222         <informaltable border="1">
223             <tr>
224                 <td>
225                     <literal>R</literal>
226                 </td>
227                 <td>
228                     <literal>G</literal>
229                 </td>
230                 <td>
231                     <literal>B</literal>
232                 </td>
233             </tr>
234             <tr>
235                 <td>0.</td>
236                 <td>0.</td>
237                 <td>1.</td>
238             </tr>
239             <tr>
240                 <td>0.</td>
241                 <td>0.5</td>
242                 <td>0.</td>
243             </tr>
244             <tr>
245                 <td>1.</td>
246                 <td>0.</td>
247                 <td>0.</td>
248             </tr>
249             <tr>
250                 <td>0.</td>
251                 <td>0.75</td>
252                 <td>0.75</td>
253             </tr>
254             <tr>
255                 <td>0.75</td>
256                 <td>0.</td>
257                 <td>0.75</td>
258             </tr>
259             <tr>
260                 <td>0.75</td>
261                 <td>0.75</td>
262                 <td>0.</td>
263             </tr>
264             <tr>
265                 <td>0.25</td>
266                 <td>0.25</td>
267                 <td>0.25</td>
268             </tr>
269         </informaltable>
270         <para/>
271         <para>
272             Entre com o comando <literal>plot</literal> para visualizar uma
273             demonstração.
274         </para>
275     </refsection>
276     <refsection role="examples">
277         <title>Exemplos</title>
278         <programlisting role="example"><![CDATA[
279 // inicialização de x
280 x=[0:0.1:2*%pi]';
281 //esboço simples
282 plot(sin(x))
283 clf()
284 plot(x,sin(x))
285 //esboços múltiplos
286 clf()
287 plot(x,[sin(x) sin(2*x) sin(3*x)])
288 clf()
289
290 // eixo à direita
291 plot(x,sin(x))
292 a=gca(); // manipulador da entidade Axes
293 a.y_location ="right";
294 clf()
295
296 // eixo centrado em (0,0)
297 plot(x-4,sin(x),x+2,cos(x))
298 a=gca(); // manipulador da entidade Axes
299 a.x_location = "middle";
300 a.y_location = "middle";
301
302 // algumas operações em entidades criadas por plot...
303 isoview()
304 a=gca();
305 a.children // listando os galhos da entidade Axes: aqui, é um galho Compound composto por duas entidades
306 poly1= a.children.children(2); //armazenando um manipulador Polyline em poly1
307 poly1.foreground = 4; // outro modo de se mudar o estilo...
308 poly1.thickness = 3;  // ...e a espessura de uma curva.
309 poly1.clip_state='off' // controle de recorte
310 isoview("off")
311
312 //exemplos com LineSpec e GlobalProperty:
313 clf();
314 t=0:%pi/20:2*%pi;
315 plot(t,sin(t),'ro-.',t,cos(t),'cya+',t,abs(sin(t)),'--mo')
316 scf(2)
317 plot([t ;t],[sin(t) ;cos(t)],'xdat',[1:2])
318 scf(3)
319 axfig3 = gca();
320 scf(4) // deveria permanecer em branco
321 plot(axfig3,[t ;t],[sin(t) ;cos(t)],'zdat',[1:2],'marker','d','markerfac','green','markeredg','yel')
322 xdel(winsid())
323
324 //especificação de dados
325 t=-%pi:0.1:%pi;
326 size(t)
327 plot(t) // esboços simples de y versus tamanho do vetor t
328 clf(); // limpando figura
329
330 plot(t,sin(t)); // esboça sin(t) versus t
331 clf();
332
333 t=[1     1     1     1
334    2     3     4     5
335    3     4     5     6
336    4     5     6     7];
337
338 plot(t) // esboça cada coluna t column versus tamanho de linha
339 clf();
340
341 subplot(221)
342 plot(t,sin(t)); // esboça sin(t) versus t coluna por coluna desta vez
343 xtitle("sin(t) versus t")
344 subplot(222)
345 plot(t,sin(t)')
346 xtitle("sin(t)'' versus t")
347 subplot(223)
348 plot(t',sin(t))
349 a=gca();
350 a.data_bounds=[0 -1;7 1]; // para ver a linha vertical escondida pelo eixo y
351 xtitle("sin(t) versus t''")
352 subplot(224)
353 plot(t',sin(t)')
354 xtitle("sin(t)'' versus t''")
355
356 clf();
357
358 //caso especial 1
359 //x : vector ([5 6 7 8]) and y : matrix (t)
360 x=[5 6 7 8]
361 plot(x,t);
362 plot(x',t); // idem, x é automaiticamente transposto para corresponder a t (aqui as colunas)
363 clf()
364
365 // apenas um caso de possibilidade de correspondência: como realizar quatro esboços idênticos 4 de quatro maneiras 4...
366 // x é um vetor 1x4 (vector) y is uma matriz não-quadrada 4x5
367 subplot(221);
368 plot(x,[t [8;9;10;12]]');
369 subplot(222);
370 plot(x',[t [8;9;10;12]]');
371 subplot(223);
372 plot(x,[t [8;9;10;12]]');
373 subplot(224);
374 plot(x',[t [8;9;10;12]]');
375 clf()
376
377 //caso especial 2
378 // caso onde apenas x ou y é uma matriz quadrada
379 //x : matrix (t) e y  : vetor ([1 2 3 4])
380 plot(t,[1 2 3 4]) // equivalente a plot(t,[1 1 1 1;2 2 2 2;3 3 3 3;4 4 4 4])
381 plot(t,[1;2;3;4]) // o mesmo esboço
382 clf();
383
384 // t é transposto: note a prioridade dada ao tratamento das colunas
385 plot(t',[1 2 3 4]) // equivalente a plot(t',[1 1 1 1;2 2 2 2;3 3 3 3;4 4 4 4])
386 plot(t',[1 2 3 4]') // o mesmo esboço
387 clf();
388
389 // y é uma função definida por...
390 // ..uma primitiva
391 plot(1:0.1:10,sin) // equivalente a plot(1:0.1:10,sin(1:0.1:10))
392 clf();
393
394 // ...uma macro:
395 deff('[y]=toto(x)','y=x.*x')
396 plot(1:10,toto)
397  ]]></programlisting>
398     </refsection>
399     <refsection role="see also">
400         <title>Ver Também</title>
401         <simplelist type="inline">
402             <member>
403                 <link linkend="plot2d">plot2d</link>
404             </member>
405             <member>
406                 <link linkend="surf">surf</link>
407             </member>
408             <member>
409                 <link linkend="scf">scf</link>
410             </member>
411             <member>
412                 <link linkend="clf">clf</link>
413             </member>
414             <member>
415                 <link linkend="xdel">xdel</link>
416             </member>
417             <member>
418                 <link linkend="delete">delete</link>
419             </member>
420             <member>
421                 <link linkend="LineSpec">LineSpec</link>
422             </member>
423             <member>
424                 <link linkend="GlobalProperty">GlobalProperty</link>
425             </member>
426         </simplelist>
427     </refsection>
428 </refentry>