852acbf9ab86032d7eaca5168e9c5b0aeafea213
[scilab.git] / scilab / modules / graphics / help / pt_BR / 3d_plot / hist3d.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 - Serge Steer
5  * Copyright (C) ENPC - Jean-Philippe Chancelier
6  *
7  * Copyright (C) 2012 - 2016 - Scilab Enterprises
8  *
9  * This file is hereby licensed under the terms of the GNU GPL v2.0,
10  * pursuant to article 5.3.4 of the CeCILL v.2.1.
11  * This file was originally licensed under the terms of the CeCILL v2.1,
12  * and continues to be available under such terms.
13  * For more information, see the COPYING file which you should have received
14  * along with this program.
15  *
16  -->
17 <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="hist3d" xml:lang="pt">
18     <refnamediv>
19         <refname>hist3d</refname>
20         <refpurpose>representação 3d de um histograma</refpurpose>
21     </refnamediv>
22     <refsynopsisdiv>
23         <title>Seqüência de Chamamento</title>
24         <synopsis>hist3d(mtx,[theta,alpha,leg,flag,ebox])
25             hist3d(mtx,&lt;opt_args&gt;)
26             hist3d(list(mtx,x,y),[theta,alpha,leg,flag,ebox])
27             hist3d(list(mtx,x,y),&lt;opt_args&gt;)
28         </synopsis>
29     </refsynopsisdiv>
30     <refsection>
31         <title>Parâmetros</title>
32         <variablelist>
33             <varlistentry>
34                 <term>mtx</term>
35                 <listitem>
36                     <para>matriz de tamanho (m,n) definindo o histograma
37                         <literal>mtx(i,j)=F(x(i),y(j))</literal>, onde <literal>x</literal>
38                         e <literal>y</literal> asão tomados como <literal>0:m</literal> e
39                         <literal>0:n</literal>.
40                     </para>
41                 </listitem>
42             </varlistentry>
43             <varlistentry>
44                 <term>list(mtx,x,y)</term>
45                 <listitem>
46                     <para>onde f é uma matriz de tamanho (m,n) definindo o histograma
47                         <literal>mtx(i,j)=F(x(i),y(j))</literal>, com vetores
48                         <literal>x</literal> e <literal>y</literal> de tamanho (1,n+1) e
49                         (1,m+1).
50                     </para>
51                 </listitem>
52             </varlistentry>
53             <varlistentry>
54                 <term>theta,alpha,leg,flag,ebox</term>
55                 <listitem>
56                     <para>
57                         ver <literal>plot3d</literal>.
58                     </para>
59                 </listitem>
60             </varlistentry>
61         </variablelist>
62     </refsection>
63     <refsection>
64         <title>Descrição</title>
65         <para>
66             <literal>hist3d</literal> representa um histograma 2d como um esboço
67             3d. Os valores são associados aos intervalos <literal>[x(i) x(i+1)[ X
68                 [y(i) y(i+1)[
69             </literal>
70             .
71         </para>
72         <para>
73             Entre com o comando <literal>hist3d()</literal> para visualizar uma
74             demonstração.
75         </para>
76     </refsection>
77     <refsection>
78         <title>Exemplos</title>
79         <programlisting role="example"><![CDATA[
80         hist3d();
81  ]]></programlisting>
82         <scilab:image localized="true">hist3d();</scilab:image>
83         <programlisting role="example"><![CDATA[
84 hist3d(10*rand(10,10));
85  ]]></programlisting>
86         <scilab:image>hist3d(10*rand(10,10));</scilab:image>
87         <programlisting role="example"><![CDATA[
88 Z = zeros(100,5);
89 A = abs(rand(40,5));
90 Z(1:40,:) = A;
91 scf();
92 hist3d(Z);
93  ]]></programlisting>
94         <scilab:image>
95             Z = zeros(100,5);
96             A = abs(rand(40,5));
97             Z(1:40,:) = A;
98             scf();
99             hist3d(Z);
100         </scilab:image>
101         <programlisting role="example"><![CDATA[
102 Z = zeros(100,5);
103 A = abs(rand(40,5));
104 Z(1:40,:) = A;
105 Index = find(Z==0);
106 Z(Index) = %nan;
107 scf();
108 hist3d(Z);
109  ]]></programlisting>
110         <scilab:image>
111             Z = zeros(100,5);
112             A = abs(rand(40,5));
113             Z(1:40,:) = A;
114             Index = find(Z==0);
115             Z(Index) = %nan;
116             scf();
117             hist3d(Z);
118         </scilab:image>
119         <programlisting role="example"><![CDATA[
120 Z = zeros(100,5);
121 A = abs(rand(40,5));
122 Z(1:40,:) = A;
123 A = abs(rand(10,5));
124 Z(91:100,:) = A;
125 scf();
126 hist3d(Z);
127  ]]></programlisting>
128         <scilab:image>
129             Z = zeros(100,5);
130             A = abs(rand(40,5));
131             Z(1:40,:) = A;
132             A = abs(rand(10,5));
133             Z(91:100,:) = A;
134             scf();
135             hist3d(Z);
136         </scilab:image>
137     </refsection>
138     <refsection>
139         <title>Ver Também</title>
140         <simplelist type="inline">
141             <member>
142                 <link linkend="histplot">histplot</link>
143             </member>
144             <member>
145                 <link linkend="plot3d">plot3d</link>
146             </member>
147         </simplelist>
148     </refsection>
149     <refsection>
150         <title>Autores</title>
151         <para>Steer S. &amp; JPhilippe C.</para>
152     </refsection>
153 </refentry>