* fcontour2d tagged as obsolete. Will be removed for Scilab 5.5.0.
[scilab.git] / scilab / modules / graphics / help / pt_BR / 2d_plot / contour2di.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" 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="contour2di" xml:lang="en">
17     <refnamediv>
18         <refname>contour2di</refname>
19         <refpurpose>Computa curvas de nível em um esboço 2d</refpurpose>
20     </refnamediv>
21     <refsynopsisdiv>
22         <title>Seqüência de Chamamento</title>
23         <synopsis>[xc,yc]=contour2di(x,y,z,nz)</synopsis>
24     </refsynopsisdiv>
25     <refsection role="parameters">
26         <title>Parâmetros</title>
27         <variablelist>
28             <varlistentry>
29                 <term>x,y</term>
30                 <listitem>
31                     <para>dois vetores de reais de tamanhos n1 e n2 definindo o grid.
32                     </para>
33                 </listitem>
34             </varlistentry>
35             <varlistentry>
36                 <term>z</term>
37                 <listitem>
38                     <para>matriz de reais de tamanho (n1,n2), os valores da função.
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/>
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 z= zmin + (1:nz)*(zmax-zmin)/(nz+1)
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 de
62                                 </para>
63                                 <programlisting role=""><![CDATA[
64 [im,jm] = find(z == zmin);     // ou zmax
65 plot2d(x(im)',y(jm)',-9,"000")
66  ]]></programlisting>
67                             </listitem>
68                         </varlistentry>
69                         <varlistentry>
70                             <term/>
71                             <listitem>
72                                 <para>
73                                     Se <literal>nz</literal> for um vetor,
74                                     <literal>nz(i)</literal> fornece o valor da i-ésima curva de
75                                     nível.
76                                 </para>
77                             </listitem>
78                         </varlistentry>
79                     </variablelist>
80                 </listitem>
81             </varlistentry>
82             <varlistentry>
83                 <term>xc,yc</term>
84                 <listitem>
85                     <para>vetores de tamanhos idênticos contendo as definições dos
86                         contornos. Ver detalhes abaixo.
87                     </para>
88                 </listitem>
89             </varlistentry>
90         </variablelist>
91     </refsection>
92     <refsection role="description">
93         <title>Descrição</title>
94         <para>
95             <literal>contour2di</literal> computa as curvas de nível de uma
96             superfície <literal>z=f(x,y)</literal> em um esboço 2d. Os valores de
97             <literal>f(x,y)</literal> asão dados pela matriz <literal>z</literal> nos
98             pontos de grid definidos por <literal>x</literal> e
99             <literal>y</literal>.
100         </para>
101         <para>
102             <literal>xc(1)</literal> contém o nível associado ao primeiro
103             caminho de contorno, <literal>yc(1)</literal> contém o número
104             <literal>N1</literal> de pontos definindo este caminho de contorno e
105             (<literal>xc(1+(1:N1))</literal>, <literal>yc(1+(1:N1))</literal> ) contém
106             as coordenadas dos pontos do caminho. O segundo caminho começa em
107             <literal>xc(2+N1)</literal> e <literal>yc(2+N1)</literal> e assim por
108             diante.
109         </para>
110     </refsection>
111     <refsection role="examples">
112         <title>Exemplos</title>
113         <programlisting role="example"><![CDATA[
114 [xc,yc]=contour2di(1:10,1:10,rand(10,10),5);
115 k=1;n=yc(k);c=1;
116 while k+yc(k)<size(xc,'*')
117   n=yc(k);
118   plot2d(xc(k+(1:n)),yc(k+(1:n)),c)
119   c=c+1;
120   k=k+n+1;
121 end
122  ]]></programlisting>
123     </refsection>
124     <refsection role="see also">
125         <title>Ver Também </title>
126         <simplelist type="inline">
127             <member>
128                 <link linkend="contour">contour</link>
129             </member>
130             <member>
131                 <link linkend="fcontour">fcontour</link>
132             </member>
133             <member>
134                 <link linkend="contour2d">contour2d</link>
135             </member>
136             <member>
137                 <link linkend="plot2d">plot2d</link>
138             </member>
139             <member>
140                 <link linkend="xset">xset</link>
141             </member>
142         </simplelist>
143     </refsection>
144 </refentry>