← Back to branch summary

~ubuntu-branches/ubuntu/raring/scilab/raring-proposed

« back to all changes in this revision

Viewing changes to modules/graphics/help/pt_BR/3d_plot/contour.xml

  • Committer: Package Import Robot
  • Author(s): Sylvestre Ledru
  • Date: 2012-08-30 14:42:38 UTC
  • mfrom: (1.4.7)
  • Revision ID: package-import@ubuntu.com-20120830144238-c1y2og7dbm7m9nig
Tags: 5.4.0-beta-3-1~exp1
* New upstream release
* Update the scirenderer dep
* Get ride of libjhdf5-java dependency

Show diffs side-by-side

added added

removed removed

Lines of Context:
modules/graphics/help/pt_BR/3d_plot/contour.xml
11
11
 *
12
12
 -->
13
13
<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" version="5.0-subset Scilab" xml:id="contour" xml:lang="en">
14
 
  <refnamediv>
15
 
    <refname>contour</refname>
16
 
    <refpurpose>curvas de n�vel em uma superf�cie 3d</refpurpose>
17
 
  </refnamediv>
18
 
  <refsynopsisdiv>
19
 
    <title>Seq��ncia de Chamamento</title>
20
 
    <synopsis>contour(x,y,z,nz,[theta,alpha,leg,flag,ebox,zlev])
21
 
      contour(x,y,z,nz,&lt;opt_args&gt;)
22
 
    </synopsis>
23
 
  </refsynopsisdiv>
24
 
  <refsection>
25
 
    <title>Par�metros</title>
26
 
    <variablelist>
27
 
      <varlistentry>
28
 
        <term>x,y</term>
29
 
        <listitem>
30
 
          <para>vetores de reais de tamanhos n1 e n2.</para>
31
 
        </listitem>
32
 
      </varlistentry>
33
 
      <varlistentry>
34
 
        <term>z</term>
35
 
        <listitem>
36
 
          <para>matriz de reais de tamanho (n1,n2), os valores da fun��o sobre
37
 
            o gride ou uma fun��o Scilab que define uma superf�cie
38
 
            <literal>z=f(x,y)</literal>.
39
 
          </para>
40
 
        </listitem>
41
 
      </varlistentry>
42
 
      <varlistentry>
43
 
        <term>nz</term>
44
 
        <listitem>
45
 
          <para>os valores de n�vel ou o n�mero de n�veis.</para>
46
 
          <variablelist>
47
 
            <varlistentry>
48
 
              <term>-</term>
49
 
              <listitem>
50
 
                <para>
51
 
                  Se <literal>nz</literal> for um inteiro, seu valor
52
 
                  fornece o n�mero de n�veis igualmente espa�ados de zmin a zmax
53
 
                  como segue:
54
 
                </para>
55
 
                <programlisting role=""><![CDATA[ 
 
14
    <refnamediv>
 
15
        <refname>contour</refname>
 
16
        <refpurpose>curvas de n�vel em uma superf�cie 3d</refpurpose>
 
17
    </refnamediv>
 
18
    <refsynopsisdiv>
 
19
        <title>Seq��ncia de Chamamento</title>
 
20
        <synopsis>contour(x,y,z,nz,[theta,alpha,leg,flag,ebox,zlev])
 
21
            contour(x,y,z,nz,&lt;opt_args&gt;)
 
22
        </synopsis>
 
23
    </refsynopsisdiv>
 
24
    <refsection>
 
25
        <title>Par�metros</title>
 
26
        <variablelist>
 
27
            <varlistentry>
 
28
                <term>x,y</term>
 
29
                <listitem>
 
30
                    <para>vetores de reais de tamanhos n1 e n2.</para>
 
31
                </listitem>
 
32
            </varlistentry>
 
33
            <varlistentry>
 
34
                <term>z</term>
 
35
                <listitem>
 
36
                    <para>matriz de reais de tamanho (n1,n2), os valores da fun��o sobre
 
37
                        o gride ou uma fun��o Scilab que define uma superf�cie
 
38
                        <literal>z=f(x,y)</literal>.
 
39
                    </para>
 
40
                </listitem>
 
41
            </varlistentry>
 
42
            <varlistentry>
 
43
                <term>nz</term>
 
44
                <listitem>
 
45
                    <para>os valores de n�vel ou o n�mero de n�veis.</para>
 
46
                    <variablelist>
 
47
                        <varlistentry>
 
48
                            <term>-</term>
 
49
                            <listitem>
 
50
                                <para>
 
51
                                    Se <literal>nz</literal> for um inteiro, seu valor
 
52
                                    fornece o n�mero de n�veis igualmente espa�ados de zmin a zmax
 
53
                                    como segue:
 
54
                                </para>
 
55
                                <programlisting role=""><![CDATA[ 
56
56
z= zmin + (1:nz)*(zmax-zmin)/(nz+1)
57
57
 ]]></programlisting>
58
 
                <para>
59
 
                  Note que os n�veis <literal>zmin</literal> e
60
 
                  <literal>zmax</literal> n�o s�o desenhados (genericamente eles
61
 
                  s�o reduzidos a pontos) mas podem ser adicionados atrav�s
62
 
                  de
63
 
                </para>
64
 
                <programlisting role=""><![CDATA[ 
 
58
                                <para>
 
59
                                    Note que os n�veis <literal>zmin</literal> e
 
60
                                    <literal>zmax</literal> n�o s�o desenhados (genericamente eles
 
61
                                    s�o reduzidos a pontos) mas podem ser adicionados atrav�s
 
62
                                    de
 
63
                                </para>
 
64
                                <programlisting role=""><![CDATA[ 
65
65
[im,jm] = find(z == zmin);     // ou zmax 
66
66
plot2d(x(im)',y(jm)',-9,"000")
67
67
 ]]></programlisting>
68
 
              </listitem>
69
 
            </varlistentry>
70
 
            <varlistentry>
71
 
              <term>-</term>
72
 
              <listitem>
73
 
                <para>
74
 
                  Se <literal>nz</literal> for um vetor,
75
 
                  <literal>nz(i)</literal> fornece o valor da i-�sima curva de
76
 
                  n�vel. Note que isto pode ser �til para se visualizar as
77
 
                  curvas de n�vel <literal>zmin</literal> e
78
 
                  <literal>zmax</literal> para se adicionar uma toler�ncia eps:
79
 
                  <literal>nz=[zmin+%eps,..,zmax-%eps]</literal>.
80
 
                </para>
81
 
              </listitem>
82
 
            </varlistentry>
83
 
          </variablelist>
84
 
        </listitem>
85
 
      </varlistentry>
86
 
      <varlistentry>
87
 
        <term>&lt;opt_args&gt;</term>
88
 
        <listitem>
89
 
          <para>
90
 
            uma seq��ncia de declara��es <literal>key1=value1,
91
 
              key2=value2
92
 
            </literal>
93
 
            ,... onde keys podem ser
94
 
            <literal>theta</literal>,<literal>alpha</literal>,<literal>leg</literal>,<literal>flag</literal>,
95
 
            <literal>ebox</literal>,<literal>zlev</literal> (ver abaixo). Neste
96
 
            caso, a ordem n�o possui significado especial.
97
 
          </para>
98
 
        </listitem>
99
 
      </varlistentry>
100
 
      <varlistentry>
101
 
        <term>theta, alpha</term>
102
 
        <listitem>
103
 
          <para>valores reais de dados em graus, as coordenadas esf�ricas do
104
 
            ponto de observa��o.
105
 
          </para>
106
 
        </listitem>
107
 
      </varlistentry>
108
 
      <varlistentry>
109
 
        <term>leg</term>
110
 
        <listitem>
111
 
          <para>string definindo os r�tulos para cada eixo com @ como um
112
 
            separador de campos, por exemplo "X@Y@Z".
113
 
          </para>
114
 
        </listitem>
115
 
      </varlistentry>
116
 
      <varlistentry>
117
 
        <term>flag</term>
118
 
        <listitem>
119
 
          <para>um vetor real de tamanho tr�s.
120
 
            <literal>flag=[mode,type,box]</literal>.
121
 
          </para>
122
 
          <variablelist>
123
 
            <varlistentry>
124
 
              <term>mode</term>
125
 
              <listitem>
126
 
                <para>string de representa��o de modo.</para>
127
 
                <variablelist>
128
 
                  <varlistentry>
129
 
                    <term>mode=0:</term>
130
 
                    <listitem>
131
 
                      <para>as curvas s�o desenhadas na superf�cie definida
132
 
                        por (x,y,z).
133
 
                      </para>
134
 
                    </listitem>
135
 
                  </varlistentry>
136
 
                  <varlistentry>
137
 
                    <term>mode=1:</term>
138
 
                    <listitem>
139
 
                      <para>as curvas s�o desenhadas em um esbo�o 3d e sobre o
140
 
                        plano definido pela equa��o z=zlev.
141
 
                      </para>
142
 
                    </listitem>
143
 
                  </varlistentry>
144
 
                  <varlistentry>
145
 
                    <term>mode=2:</term>
146
 
                    <listitem>
147
 
                      <para>as curvas s�o desenhadas em um esbo�o 2D.</para>
148
 
                    </listitem>
149
 
                  </varlistentry>
150
 
                </variablelist>
151
 
              </listitem>
152
 
            </varlistentry>
153
 
            <varlistentry>
154
 
              <term>type</term>
155
 
              <listitem>
156
 
                <para>um inteiro (tipo de escala)</para>
157
 
                <variablelist>
158
 
                  <varlistentry>
159
 
                    <term>type=0</term>
160
 
                    <listitem>
161
 
                      <para>o esbo�o � feito utilizando-se a escala 3d
162
 
                        corrente (definida por uma chamada anterior a
163
 
                        <literal>param3d</literal>, <literal>plot3d</literal>,
164
 
                        <literal>contour</literal> ou
165
 
                        <literal>plot3d1</literal>).
166
 
                      </para>
167
 
                    </listitem>
168
 
                  </varlistentry>
169
 
                  <varlistentry>
170
 
                    <term>type=1</term>
171
 
                    <listitem>
172
 
                      <para>re-escala automaticamente caixas 3d com rela��o de
173
 
                        aspecto extrema, as fronteiras s�o especificadas pelo
174
 
                        valor do argumento opcional
175
 
                        <literal>ebox</literal>.
176
 
                      </para>
177
 
                    </listitem>
178
 
                  </varlistentry>
179
 
                  <varlistentry>
180
 
                    <term>type=2</term>
181
 
                    <listitem>
182
 
                      <para>re-escala automaticamente caixas 3d com rela��o de
183
 
                        aspecto extrema, as fronteiras s�o computadas
184
 
                        utilizando-se dados fornecidos.
185
 
                      </para>
186
 
                    </listitem>
187
 
                  </varlistentry>
188
 
                  <varlistentry>
189
 
                    <term>type=3</term>
190
 
                    <listitem>
191
 
                      <para>fronteiras 3d isom�tricas com fronteiras da caixa
192
 
                        dadas por <literal>ebox</literal>, de modo semelhante a
193
 
                        <literal>type=1</literal>
194
 
                      </para>
195
 
                    </listitem>
196
 
                  </varlistentry>
197
 
                  <varlistentry>
198
 
                    <term>type=4</term>
199
 
                    <listitem>
200
 
                      <para>fronteiras 3d isom�tricas derivadas dos dados, de
201
 
                        modo semelhante a <literal>type=2</literal>
202
 
                      </para>
203
 
                    </listitem>
204
 
                  </varlistentry>
205
 
                  <varlistentry>
206
 
                    <term>type=5</term>
207
 
                    <listitem>
208
 
                      <para>fronteiras 3d isom�tricas expandidas com
209
 
                        fronteiras fornecidas por <literal>ebox</literal>, de
210
 
                        modo semelhante a <literal>type=1</literal>
211
 
                      </para>
212
 
                    </listitem>
213
 
                  </varlistentry>
214
 
                  <varlistentry>
215
 
                    <term>type=6</term>
216
 
                    <listitem>
217
 
                      <para>fronteiras 3d isom�tricas expandidas derivadas dos
218
 
                        dados, de modo semelhante a
219
 
                        <literal>type=2</literal>
220
 
                      </para>
221
 
                    </listitem>
222
 
                  </varlistentry>
223
 
                </variablelist>
224
 
              </listitem>
225
 
            </varlistentry>
226
 
            <varlistentry>
227
 
              <term>box</term>
228
 
              <listitem>
229
 
                <para>um inteiro (moldura ao redor do esbo�o).</para>
230
 
                <variablelist>
231
 
                  <varlistentry>
232
 
                    <term>box=0</term>
233
 
                    <listitem>
234
 
                      <para>nada � desenhado ao redor do esbo�o.</para>
235
 
                    </listitem>
236
 
                  </varlistentry>
237
 
                  <varlistentry>
238
 
                    <term>box=1</term>
239
 
                    <listitem>
240
 
                      <para>n�o implementado (� como box=0).</para>
241
 
                    </listitem>
242
 
                  </varlistentry>
243
 
                  <varlistentry>
244
 
                    <term>box=2</term>
245
 
                    <listitem>
246
 
                      <para>apenas os eixos atr�s da superf�cie s�o
247
 
                        desenhados.
248
 
                      </para>
249
 
                    </listitem>
250
 
                  </varlistentry>
251
 
                  <varlistentry>
252
 
                    <term>box=3</term>
253
 
                    <listitem>
254
 
                      <para>uma caixa cercando a superf�cie � desenhada e
255
 
                        legendas s�o adicionadas.
256
 
                      </para>
257
 
                    </listitem>
258
 
                  </varlistentry>
259
 
                  <varlistentry>
260
 
                    <term>box=4</term>
261
 
                    <listitem>
262
 
                      <para>uma caixa cercando a superf�cie � desenhada e
263
 
                        legendas e eixos s�o adicionados.
264
 
                      </para>
265
 
                    </listitem>
266
 
                  </varlistentry>
267
 
                </variablelist>
268
 
              </listitem>
269
 
            </varlistentry>
270
 
          </variablelist>
271
 
        </listitem>
272
 
      </varlistentry>
273
 
      <varlistentry>
274
 
        <term>ebox</term>
275
 
        <listitem>
276
 
          <para>
277
 
            usado quando <literal>type</literal> em
278
 
            <literal>flag</literal> � 1. Especifica as fronteiras do esbo�o
279
 
            atrav�s do vetor
280
 
            <literal>[xmin,xmax,ymin,ymax,zmin,zmax]</literal>.
281
 
          </para>
282
 
        </listitem>
283
 
      </varlistentry>
284
 
      <varlistentry>
285
 
        <term>zlev</term>
286
 
        <listitem>
287
 
          <para>n�mero real.</para>
288
 
        </listitem>
289
 
      </varlistentry>
290
 
    </variablelist>
291
 
  </refsection>
292
 
  <refsection>
293
 
    <title>Descri��o</title>
294
 
    <para>
295
 
      <literal>contour</literal> desenha curvas de n�vel de uma superf�cie
296
 
      z= f(x,y). As curvas de n�vel s�o desenhadas sobre uma superf�cie 3d. Os
297
 
      argumentos opcionais s�o os mesmos que os da fun��o
298
 
      <literal>plot3d</literal> (exceto por <literal>zlev</literal>)e seus
299
 
      significados s�o os mesmos. Eles controlam o desenho das curva de n�vel em
300
 
      um esbo�o 3d. Apenas <literal>flag(1)=mode</literal> tem significado
301
 
      especial.
302
 
    </para>
303
 
    <variablelist>
304
 
      <varlistentry>
305
 
        <term>mode=0</term>
306
 
        <listitem>
307
 
          <para>as curvas s�o desenhadas na superf�cie definida por
308
 
            (x,y,z).
309
 
          </para>
310
 
        </listitem>
311
 
      </varlistentry>
312
 
      <varlistentry>
313
 
        <term>mode=1</term>
314
 
        <listitem>
315
 
          <para>as curvas s�o desenhadas em um esbo�o 3d e sobre o plano
316
 
            definido pela equa��o z=zlev.
317
 
          </para>
318
 
        </listitem>
319
 
      </varlistentry>
320
 
      <varlistentry>
321
 
        <term>mode=2</term>
322
 
        <listitem>
323
 
          <para>as curvas s�o desenhadas em um esbo�o 2D.</para>
324
 
        </listitem>
325
 
      </varlistentry>
326
 
    </variablelist>
327
 
    <para>Voc� pode modificar o formato dos pontos flutuantes impressos sobre
328
 
      os n�veis utilizando <literal>xset("fpf",string)</literal> onde
329
 
      <literal>string</literal> fornece o formato em na sintaxe de formato C
330
 
      (por exemplo <literal>string="%.3f"</literal>). Use
331
 
      <literal>string=""</literal> para voltar ao formato padr�o e use
332
 
      <literal>string=" "</literal> para suprimir a impress�o.
333
 
    </para>
334
 
    <para>
335
 
      Geralmente � usado <literal>contour2d</literal> para se esbo�ar
336
 
      curvas de n�vel em um esbo�o 2d.
337
 
    </para>
338
 
    <para>
339
 
      Entre com o comando <literal>contour()</literal> para visualizar uma
340
 
      demonstra��o.
341
 
    </para>
342
 
  </refsection>
343
 
  <refsection>
344
 
    <title>Exemplos</title>
345
 
    <programlisting role="example"><![CDATA[ 
 
68
                            </listitem>
 
69
                        </varlistentry>
 
70
                        <varlistentry>
 
71
                            <term>-</term>
 
72
                            <listitem>
 
73
                                <para>
 
74
                                    Se <literal>nz</literal> for um vetor,
 
75
                                    <literal>nz(i)</literal> fornece o valor da i-�sima curva de
 
76
                                    n�vel. Note que isto pode ser �til para se visualizar as
 
77
                                    curvas de n�vel <literal>zmin</literal> e
 
78
                                    <literal>zmax</literal> para se adicionar uma toler�ncia eps:
 
79
                                    <literal>nz=[zmin+%eps,..,zmax-%eps]</literal>.
 
80
                                </para>
 
81
                            </listitem>
 
82
                        </varlistentry>
 
83
                    </variablelist>
 
84
                </listitem>
 
85
            </varlistentry>
 
86
            <varlistentry>
 
87
                <term>&lt;opt_args&gt;</term>
 
88
                <listitem>
 
89
                    <para>
 
90
                        uma seq��ncia de declara��es <literal>key1=value1,
 
91
                            key2=value2
 
92
                        </literal>
 
93
                        ,... onde keys podem ser
 
94
                        <literal>theta</literal>,<literal>alpha</literal>,<literal>leg</literal>,<literal>flag</literal>,
 
95
                        <literal>ebox</literal>,<literal>zlev</literal> (ver abaixo). Neste
 
96
                        caso, a ordem n�o possui significado especial.
 
97
                    </para>
 
98
                </listitem>
 
99
            </varlistentry>
 
100
            <varlistentry>
 
101
                <term>theta, alpha</term>
 
102
                <listitem>
 
103
                    <para>valores reais de dados em graus, as coordenadas esf�ricas do
 
104
                        ponto de observa��o.
 
105
                    </para>
 
106
                </listitem>
 
107
            </varlistentry>
 
108
            <varlistentry>
 
109
                <term>leg</term>
 
110
                <listitem>
 
111
                    <para>string definindo os r�tulos para cada eixo com @ como um
 
112
                        separador de campos, por exemplo "X@Y@Z".
 
113
                    </para>
 
114
                </listitem>
 
115
            </varlistentry>
 
116
            <varlistentry>
 
117
                <term>flag</term>
 
118
                <listitem>
 
119
                    <para>um vetor real de tamanho tr�s.
 
120
                        <literal>flag=[mode,type,box]</literal>.
 
121
                    </para>
 
122
                    <variablelist>
 
123
                        <varlistentry>
 
124
                            <term>mode</term>
 
125
                            <listitem>
 
126
                                <para>string de representa��o de modo.</para>
 
127
                                <variablelist>
 
128
                                    <varlistentry>
 
129
                                        <term>mode=0:</term>
 
130
                                        <listitem>
 
131
                                            <para>as curvas s�o desenhadas na superf�cie definida
 
132
                                                por (x,y,z).
 
133
                                            </para>
 
134
                                        </listitem>
 
135
                                    </varlistentry>
 
136
                                    <varlistentry>
 
137
                                        <term>mode=1:</term>
 
138
                                        <listitem>
 
139
                                            <para>as curvas s�o desenhadas em um esbo�o 3d e sobre o
 
140
                                                plano definido pela equa��o z=zlev.
 
141
                                            </para>
 
142
                                        </listitem>
 
143
                                    </varlistentry>
 
144
                                    <varlistentry>
 
145
                                        <term>mode=2:</term>
 
146
                                        <listitem>
 
147
                                            <para>as curvas s�o desenhadas em um esbo�o 2D.</para>
 
148
                                        </listitem>
 
149
                                    </varlistentry>
 
150
                                </variablelist>
 
151
                            </listitem>
 
152
                        </varlistentry>
 
153
                        <varlistentry>
 
154
                            <term>type</term>
 
155
                            <listitem>
 
156
                                <para>um inteiro (tipo de escala)</para>
 
157
                                <variablelist>
 
158
                                    <varlistentry>
 
159
                                        <term>type=0</term>
 
160
                                        <listitem>
 
161
                                            <para>o esbo�o � feito utilizando-se a escala 3d
 
162
                                                corrente (definida por uma chamada anterior a
 
163
                                                <literal>param3d</literal>, <literal>plot3d</literal>,
 
164
                                                <literal>contour</literal> ou
 
165
                                                <literal>plot3d1</literal>).
 
166
                                            </para>
 
167
                                        </listitem>
 
168
                                    </varlistentry>
 
169
                                    <varlistentry>
 
170
                                        <term>type=1</term>
 
171
                                        <listitem>
 
172
                                            <para>re-escala automaticamente caixas 3d com rela��o de
 
173
                                                aspecto extrema, as fronteiras s�o especificadas pelo
 
174
                                                valor do argumento opcional
 
175
                                                <literal>ebox</literal>.
 
176
                                            </para>
 
177
                                        </listitem>
 
178
                                    </varlistentry>
 
179
                                    <varlistentry>
 
180
                                        <term>type=2</term>
 
181
                                        <listitem>
 
182
                                            <para>re-escala automaticamente caixas 3d com rela��o de
 
183
                                                aspecto extrema, as fronteiras s�o computadas
 
184
                                                utilizando-se dados fornecidos.
 
185
                                            </para>
 
186
                                        </listitem>
 
187
                                    </varlistentry>
 
188
                                    <varlistentry>
 
189
                                        <term>type=3</term>
 
190
                                        <listitem>
 
191
                                            <para>fronteiras 3d isom�tricas com fronteiras da caixa
 
192
                                                dadas por <literal>ebox</literal>, de modo semelhante a
 
193
                                                <literal>type=1</literal>
 
194
                                            </para>
 
195
                                        </listitem>
 
196
                                    </varlistentry>
 
197
                                    <varlistentry>
 
198
                                        <term>type=4</term>
 
199
                                        <listitem>
 
200
                                            <para>fronteiras 3d isom�tricas derivadas dos dados, de
 
201
                                                modo semelhante a <literal>type=2</literal>
 
202
                                            </para>
 
203
                                        </listitem>
 
204
                                    </varlistentry>
 
205
                                    <varlistentry>
 
206
                                        <term>type=5</term>
 
207
                                        <listitem>
 
208
                                            <para>fronteiras 3d isom�tricas expandidas com
 
209
                                                fronteiras fornecidas por <literal>ebox</literal>, de
 
210
                                                modo semelhante a <literal>type=1</literal>
 
211
                                            </para>
 
212
                                        </listitem>
 
213
                                    </varlistentry>
 
214
                                    <varlistentry>
 
215
                                        <term>type=6</term>
 
216
                                        <listitem>
 
217
                                            <para>fronteiras 3d isom�tricas expandidas derivadas dos
 
218
                                                dados, de modo semelhante a
 
219
                                                <literal>type=2</literal>
 
220
                                            </para>
 
221
                                        </listitem>
 
222
                                    </varlistentry>
 
223
                                </variablelist>
 
224
                            </listitem>
 
225
                        </varlistentry>
 
226
                        <varlistentry>
 
227
                            <term>box</term>
 
228
                            <listitem>
 
229
                                <para>um inteiro (moldura ao redor do esbo�o).</para>
 
230
                                <variablelist>
 
231
                                    <varlistentry>
 
232
                                        <term>box=0</term>
 
233
                                        <listitem>
 
234
                                            <para>nada � desenhado ao redor do esbo�o.</para>
 
235
                                        </listitem>
 
236
                                    </varlistentry>
 
237
                                    <varlistentry>
 
238
                                        <term>box=1</term>
 
239
                                        <listitem>
 
240
                                            <para>n�o implementado (� como box=0).</para>
 
241
                                        </listitem>
 
242
                                    </varlistentry>
 
243
                                    <varlistentry>
 
244
                                        <term>box=2</term>
 
245
                                        <listitem>
 
246
                                            <para>apenas os eixos atr�s da superf�cie s�o
 
247
                                                desenhados.
 
248
                                            </para>
 
249
                                        </listitem>
 
250
                                    </varlistentry>
 
251
                                    <varlistentry>
 
252
                                        <term>box=3</term>
 
253
                                        <listitem>
 
254
                                            <para>uma caixa cercando a superf�cie � desenhada e
 
255
                                                legendas s�o adicionadas.
 
256
                                            </para>
 
257
                                        </listitem>
 
258
                                    </varlistentry>
 
259
                                    <varlistentry>
 
260
                                        <term>box=4</term>
 
261
                                        <listitem>
 
262
                                            <para>uma caixa cercando a superf�cie � desenhada e
 
263
                                                legendas e eixos s�o adicionados.
 
264
                                            </para>
 
265
                                        </listitem>
 
266
                                    </varlistentry>
 
267
                                </variablelist>
 
268
                            </listitem>
 
269
                        </varlistentry>
 
270
                    </variablelist>
 
271
                </listitem>
 
272
            </varlistentry>
 
273
            <varlistentry>
 
274
                <term>ebox</term>
 
275
                <listitem>
 
276
                    <para>
 
277
                        usado quando <literal>type</literal> em
 
278
                        <literal>flag</literal> � 1. Especifica as fronteiras do esbo�o
 
279
                        atrav�s do vetor
 
280
                        <literal>[xmin,xmax,ymin,ymax,zmin,zmax]</literal>.
 
281
                    </para>
 
282
                </listitem>
 
283
            </varlistentry>
 
284
            <varlistentry>
 
285
                <term>zlev</term>
 
286
                <listitem>
 
287
                    <para>n�mero real.</para>
 
288
                </listitem>
 
289
            </varlistentry>
 
290
        </variablelist>
 
291
    </refsection>
 
292
    <refsection>
 
293
        <title>Descri��o</title>
 
294
        <para>
 
295
            <literal>contour</literal> desenha curvas de n�vel de uma superf�cie
 
296
            z= f(x,y). As curvas de n�vel s�o desenhadas sobre uma superf�cie 3d. Os
 
297
            argumentos opcionais s�o os mesmos que os da fun��o
 
298
            <literal>plot3d</literal> (exceto por <literal>zlev</literal>)e seus
 
299
            significados s�o os mesmos. Eles controlam o desenho das curva de n�vel em
 
300
            um esbo�o 3d. Apenas <literal>flag(1)=mode</literal> tem significado
 
301
            especial.
 
302
        </para>
 
303
        <variablelist>
 
304
            <varlistentry>
 
305
                <term>mode=0</term>
 
306
                <listitem>
 
307
                    <para>as curvas s�o desenhadas na superf�cie definida por
 
308
                        (x,y,z).
 
309
                    </para>
 
310
                </listitem>
 
311
            </varlistentry>
 
312
            <varlistentry>
 
313
                <term>mode=1</term>
 
314
                <listitem>
 
315
                    <para>as curvas s�o desenhadas em um esbo�o 3d e sobre o plano
 
316
                        definido pela equa��o z=zlev.
 
317
                    </para>
 
318
                </listitem>
 
319
            </varlistentry>
 
320
            <varlistentry>
 
321
                <term>mode=2</term>
 
322
                <listitem>
 
323
                    <para>as curvas s�o desenhadas em um esbo�o 2D.</para>
 
324
                </listitem>
 
325
            </varlistentry>
 
326
        </variablelist>
 
327
        <para>Voc� pode modificar o formato dos pontos flutuantes impressos sobre
 
328
            os n�veis utilizando <literal>xset("fpf",string)</literal> onde
 
329
            <literal>string</literal> fornece o formato em na sintaxe de formato C
 
330
            (por exemplo <literal>string="%.3f"</literal>). Use
 
331
            <literal>string=""</literal> para voltar ao formato padr�o e use
 
332
            <literal>string=" "</literal> para suprimir a impress�o.
 
333
        </para>
 
334
        <para>
 
335
            Geralmente � usado <literal>contour2d</literal> para se esbo�ar
 
336
            curvas de n�vel em um esbo�o 2d.
 
337
        </para>
 
338
        <para>
 
339
            Entre com o comando <literal>contour()</literal> para visualizar uma
 
340
            demonstra��o.
 
341
        </para>
 
342
    </refsection>
 
343
    <refsection>
 
344
        <title>Exemplos</title>
 
345
        <programlisting role="example"><![CDATA[ 
346
346
t=linspace(-%pi,%pi,30);
347
347
function z=my_surface(x,y),z=x*sin(x)^2*cos(y),endfunction
348
348
 
356
356
z=feval(t,t,my_surface);
357
357
plot3d(t,t,z);contour(t,t,z+0.2*abs(z),20,flag=[0 2 4]);
358
358
 ]]></programlisting>
359
 
  </refsection>
360
 
  <refsection role="see also">
361
 
    <title>Ver Tamb�m</title>
362
 
    <simplelist type="inline">
363
 
      <member>
364
 
        <link linkend="contour2d">contour2d</link>
365
 
      </member>
366
 
      <member>
367
 
        <link linkend="plot3d">plot3d</link>
368
 
      </member>
369
 
    </simplelist>
370
 
  </refsection>
 
359
    </refsection>
 
360
    <refsection role="see also">
 
361
        <title>Ver Tamb�m</title>
 
362
        <simplelist type="inline">
 
363
            <member>
 
364
                <link linkend="contour2d">contour2d</link>
 
365
            </member>
 
366
            <member>
 
367
                <link linkend="plot3d">plot3d</link>
 
368
            </member>
 
369
        </simplelist>
 
370
    </refsection>
371
371
</refentry>