8e225ea4526e4b7620d6967e59140d7f490430c3
[scilab.git] / scilab / modules / graphics / help / pt_BR / 2d_plot / Matplot.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) ENPC - Jean-Philippe Chancelier
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"
17           xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml"
18           xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
19           xmlns:scilab="http://www.scilab.org" xml:id="Matplot" xml:lang="pt">
20     <refnamediv>
21         <refname>Matplot</refname>
22         <refpurpose>esboço 2d de uma matriz utilizando-se cores</refpurpose>
23     </refnamediv>
24     <refsynopsisdiv>
25         <title>Seqüência de Chamamento</title>
26         <synopsis>Matplot(a,[strf,rect,nax])
27             Matplot(a,&lt;opt_args&gt;)
28         </synopsis>
29     </refsynopsisdiv>
30     <refsection>
31         <title>Parâmetros</title>
32         <variablelist>
33             <varlistentry>
34                 <term>a</term>
35                 <listitem>
36                     <para>matriz de reais de tamanho (n1,n2).</para>
37                 </listitem>
38             </varlistentry>
39             <varlistentry>
40                 <term>&lt;opt_args&gt;</term>
41                 <listitem>
42                     <para>
43                         representa uma seqüência de declarações <literal>key1=value1,
44                             key2=value2
45                         </literal>
46                         ,... onde <literal>key1</literal>,
47                         <literal>key2,...</literal> podem ser um dos seguintes:
48                     </para>
49                     <variablelist>
50                         <varlistentry>
51                             <term>rect</term>
52                             <listitem>
53                                 <para>ajusta as fronteiras do esboço. Se esta chave é
54                                     fornecida, nem <literal>frameflag</literal> ou
55                                     <literal>strf</literal> é fornecido, então o caractere
56                                     <literal>y</literal> de <literal>strf</literal> é suposto como
57                                     <literal>7</literal>. Ver valores abaixo.
58                                 </para>
59                             </listitem>
60                         </varlistentry>
61                         <varlistentry>
62                             <term>nax</term>
63                             <listitem>
64                                 <para>ajusta a definição dos grides. Se esta chave é
65                                     fornecida, nem <literal>axesflag</literal> ou
66                                     <literal>strf</literal> é fornecido, então o caractere
67                                     <literal>z</literal> cd <literal>strf</literal> é suposto como
68                                     <literal>1</literal>. Ver valores abaixo.
69                                 </para>
70                             </listitem>
71                         </varlistentry>
72                         <varlistentry>
73                             <term>frameflag</term>
74                             <listitem>
75                                 <para>especifica como a moldura do esboço é computado. O valor
76                                     é um inteiro entre 0 e 8. Corresponde ao caractere
77                                     <literal>y</literal> de <literal>strf</literal>. Ver
78                                     abaixo.
79                                 </para>
80                             </listitem>
81                         </varlistentry>
82                         <varlistentry>
83                             <term>axesflag</term>
84                             <listitem>
85                                 <para>especifica que tipo de eixos são desenhados ao redor do
86                                     esboço. O valor é um inteiro entre 0 e 5. Corresponde ao
87                                     caractere <literal>z</literal> de <literal>strf</literal>. Ver
88                                     abaixo.
89                                 </para>
90                             </listitem>
91                         </varlistentry>
92                     </variablelist>
93                 </listitem>
94             </varlistentry>
95             <varlistentry>
96                 <term>strf</term>
97                 <listitem>
98                     <para>
99                         é um string de comprimento 3 <literal>"xyz"</literal>.
100                     </para>
101                     <variablelist>
102                         <varlistentry>
103                             <term>default</term>
104                             <listitem>
105                                 <para>
106                                     o padrão é <literal>"081"</literal>.
107                                 </para>
108                             </listitem>
109                         </varlistentry>
110                         <varlistentry>
111                             <term>x</term>
112                             <listitem>
113                                 <para>controls the display of captions.</para>
114                                 <variablelist>
115                                     <varlistentry>
116                                         <term>x=0</term>
117                                         <listitem>
118                                             <para>sem legendas.</para>
119                                         </listitem>
120                                     </varlistentry>
121                                     <varlistentry>
122                                         <term>x=1</term>
123                                         <listitem>
124                                             <para>legendas são exibidas. Elas são dadas pelo
125                                                 argumento opcional <literal>leg</literal>.
126                                             </para>
127                                         </listitem>
128                                     </varlistentry>
129                                 </variablelist>
130                             </listitem>
131                         </varlistentry>
132                         <varlistentry>
133                             <term>y</term>
134                             <listitem>
135                                 <para>controla a computação dos intervalos de coordenadas
136                                     reais a partir dos valores mínimos requeridos. Intervalos
137                                     reais podem ser maiores que os requerimentos mínimos.
138                                 </para>
139                                 <variablelist>
140                                     <varlistentry>
141                                         <term>y=0</term>
142                                         <listitem>
143                                             <para>sem computação, o esboço utiliza a escala anterior
144                                                 (ou padrão)
145                                             </para>
146                                         </listitem>
147                                     </varlistentry>
148                                     <varlistentry>
149                                         <term>y=1</term>
150                                         <listitem>
151                                             <para>a partir do argumento rect</para>
152                                         </listitem>
153                                     </varlistentry>
154                                     <varlistentry>
155                                         <term>y=2</term>
156                                         <listitem>
157                                             <para>a partir dos valores mínimo/máximo dos dados x e
158                                                 y
159                                             </para>
160                                         </listitem>
161                                     </varlistentry>
162                                     <varlistentry>
163                                         <term>y=3</term>
164                                         <listitem>
165                                             <para>constrói uma escala isométrica a partir do
166                                                 argumento rect
167                                             </para>
168                                         </listitem>
169                                     </varlistentry>
170                                     <varlistentry>
171                                         <term>y=4</term>
172                                         <listitem>
173                                             <para>constrói um esboço em escala isométrica a partir
174                                                 dos valores mínimo/máximo dos dados x e y
175                                             </para>
176                                         </listitem>
177                                     </varlistentry>
178                                     <varlistentry>
179                                         <term>y=5</term>
180                                         <listitem>
181                                             <para>aumentados para obtenção de bons eixos a partir do
182                                                 argumento rect
183                                             </para>
184                                         </listitem>
185                                     </varlistentry>
186                                     <varlistentry>
187                                         <term>y=6</term>
188                                         <listitem>
189                                             <para>aumentados para obtenção de bons eixos a partir
190                                                 dos valores mínimo/máximo dos dados x e y
191                                             </para>
192                                         </listitem>
193                                     </varlistentry>
194                                     <varlistentry>
195                                         <term>y=7</term>
196                                         <listitem>
197                                             <para>como y= 1 mas os anteriores são redesenhados para
198                                                 se utilizar a nova escala
199                                             </para>
200                                         </listitem>
201                                     </varlistentry>
202                                     <varlistentry>
203                                         <term>y=8</term>
204                                         <listitem>
205                                             <para>como y= 2 mas os anteriores são redesenhados para
206                                                 se utilizar a nova escala
207                                             </para>
208                                         </listitem>
209                                     </varlistentry>
210                                 </variablelist>
211                             </listitem>
212                         </varlistentry>
213                         <varlistentry>
214                             <term>z</term>
215                             <listitem>
216                                 <para>controla a exibição de informação na moldura ao redor do
217                                     esboço. Se eixos são requeridos, o número de tiques pode ser
218                                     especificado pelo argumento opcional
219                                     <literal>nax</literal>.
220                                 </para>
221                                 <variablelist>
222                                     <varlistentry>
223                                         <term>z=0</term>
224                                         <listitem>
225                                             <para>nada é desenhado ao redor do esboço.</para>
226                                         </listitem>
227                                     </varlistentry>
228                                     <varlistentry>
229                                         <term>z=1</term>
230                                         <listitem>
231                                             <para>eixos são desenhados, o eixo y é exibido à
232                                                 esquerda.
233                                             </para>
234                                         </listitem>
235                                     </varlistentry>
236                                     <varlistentry>
237                                         <term>z=2</term>
238                                         <listitem>
239                                             <para>o esboço é cercado por uma caixa sem
240                                                 tiques.
241                                             </para>
242                                         </listitem>
243                                     </varlistentry>
244                                     <varlistentry>
245                                         <term>z=3</term>
246                                         <listitem>
247                                             <para>eixos são desenhados, o eixo y é exibido à
248                                                 direita.
249                                             </para>
250                                         </listitem>
251                                     </varlistentry>
252                                     <varlistentry>
253                                         <term>z=4</term>
254                                         <listitem>
255                                             <para>eixos são desenhados centrados no meio da caixa de
256                                                 moldura.
257                                             </para>
258                                         </listitem>
259                                     </varlistentry>
260                                     <varlistentry>
261                                         <term>z=5</term>
262                                         <listitem>
263                                             <para>eixos são desenhados cruzando-se no ponto
264                                                 <literal>(0,0)</literal>. Se o ponto
265                                                 <literal>(0,0)</literal> não estiver dentro da moldura,
266                                                 os eixos não aparecerão no gráfico.
267                                             </para>
268                                         </listitem>
269                                     </varlistentry>
270                                 </variablelist>
271                             </listitem>
272                         </varlistentry>
273                     </variablelist>
274                 </listitem>
275             </varlistentry>
276             <varlistentry>
277                 <term>rect</term>
278                 <listitem>
279                     <para>este argumento é utilizado quando o segundo caractere y do
280                         argumento <literal>strf</literal> é 1, 3 ou 5. É um vetor linha de
281                         tamanho quatro e fornece a dimensão da moldura:
282                         <literal>rect=[xmin,ymin,xmax,ymax]</literal>.
283                     </para>
284                 </listitem>
285             </varlistentry>
286             <varlistentry>
287                 <term>nax</term>
288                 <listitem>
289                     <para>este argumento opcional é utilizado quando o terceiro
290                         caractere z do argumento <literal>strf</literal> é 1. É um vetor
291                         linha de quatro entradas <literal>[nx,Nx,ny,Ny]</literal> onde
292                         <literal>nx</literal> (<literal>ny</literal>) é o número de
293                         sub-graduações no eixo x (y) axis e <literal>Nx</literal>
294                         (<literal>Ny</literal>) é o número de graduações no eixo x
295                         (y).
296                     </para>
297                 </listitem>
298             </varlistentry>
299         </variablelist>
300     </refsection>
301     <refsection>
302         <title>Descrição</title>
303         <para>
304             As entradas da matriz <literal>int(a)</literal> são utilizadas como
305             entradas do mapa de cor no mapa de cores corrente. A cor associada a
306             <literal>a(i,j)</literal> é utilizada para desenhar um pequeno quadrado de
307             lado 1 com centro localizado em
308             <literal>(x=j,y=(n1-i+1))</literal>.
309         </para>
310         <para>
311             Entre com o comando <literal>Matplot()</literal> para visualizar uma
312             demonstração.
313         </para>
314     </refsection>
315     <refsection>
316         <title>Exemplos</title>
317         <programlisting role="example"><![CDATA[
318 Matplot([1 2 3;4 5 6])
319 clf()
320 // desenhando o mapa de cores corrente
321 nbcolors = size(gcf().color_map, 1);
322 Matplot(1:nbcolors)
323  ]]></programlisting>
324         <scilab:image>
325             nbcol = size(gcf().color_map, 1);
326             Matplot(1:nbcol)
327         </scilab:image>
328     </refsection>
329     <refsection role="see also">
330         <title>Ver Também</title>
331         <simplelist type="inline">
332             <member>
333                 <link linkend="colormap">colormap</link>
334             </member>
335             <member>
336                 <link linkend="plot2d">plot2d</link>
337             </member>
338             <member>
339                 <link linkend="Matplot1">Matplot1</link>
340             </member>
341             <member>
342                 <link linkend="Matplot_properties">Matplot_properties</link>
343             </member>
344         </simplelist>
345     </refsection>
346 </refentry>