a48fe0e4ceb49a3500523cb3e866964172185960
[scilab.git] / scilab / modules / graphics / help / pt_BR / 2d_plot / histplot.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 - Serge Steer
5  * 
6  * This file must be used under the terms of the CeCILL.
7  * This source file is licensed as described in the file COPYING, which
8  * you should have received as part of this distribution.  The terms
9  * are also available at    
10  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
11  *
12  -->
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: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="histplot" xml:lang="en">
14     <refnamediv>
15         <refname>histplot</refname>
16         <refpurpose>esboça um histograma</refpurpose>
17     </refnamediv>
18     <refsynopsisdiv>
19         <title>Seqüência de Chamamento</title>
20         <synopsis>histplot(n, data, &lt;opt_args&gt;)
21             histplot(x, data, &lt;opt_args&gt;)
22         </synopsis>
23     </refsynopsisdiv>
24     <refsection>
25         <title>Parâmetros</title>
26         <variablelist>
27             <varlistentry>
28                 <term>n</term>
29                 <listitem>
30                     <para>inteiro positivo (número de classes) </para>
31                 </listitem>
32             </varlistentry>
33             <varlistentry>
34                 <term>x</term>
35                 <listitem>
36                     <para>
37                         vetor crescente definindo as classes (<literal>x</literal>
38                         pode ter pelo menos dois componentes) 
39                     </para>
40                 </listitem>
41             </varlistentry>
42             <varlistentry>
43                 <term>data</term>
44                 <listitem>
45                     <para>vetor (dados a serem analisados) </para>
46                 </listitem>
47             </varlistentry>
48             <varlistentry>
49                 <term>&lt;opt_args&gt;</term>
50                 <listitem>
51                     <para>representa uma seqüência de declarações
52                         <literal>key1=value1,key2=value2</literal> ,... onde
53                         <literal>key1</literal>, <literal>key2,...</literal> pode ser
54                         qualquer normalização ou parâmetro de <link linkend="plot2d">plot2d</link> opcional (<literal>style,strf,leg,
55                             rect,nax, logflag,frameflag, axesflag
56                         </literal>
57                         )No caso de
58                         normalização, o valor correspondente deve ser um escalar booleano
59                         (valor padrão %t). 
60                     </para>
61                 </listitem>
62             </varlistentry>
63         </variablelist>
64     </refsection>
65     <refsection>
66         <title>Descrição</title>
67         <para>
68             Esta função esboça um histograma do vetor <literal>data</literal>
69             utilizando classes <literal>x</literal>. Quando o número
70             <literal>n</literal> de classes é fornecido ao invés de
71             <literal>x</literal>, as classes são escolhidas de modo igualmente
72             espaçado e <emphasis>x(1) = min(data) &lt; x(2) = x(1) + dx &lt; ... &lt;
73                 x(n+1) = max(data)
74             </emphasis>
75             com <emphasis>dx =
76                 (x(n+1)-x(1))/n
77             </emphasis>
78             .
79         </para>
80         <para>As classes são definidas por C1 = [x(1), x(2)] e Ci = ( x(i),
81             x(i+1)] para i &gt;= 2. Notando Nmax o número total de
82             <literal>data</literal> (Nmax = comprimento de data) e Ni o número de
83             componentes de <literal>data</literal> em Ci, o valor do histograma para x
84             em Ci é igual a <emphasis>Ni/(Nmax (x(i+1)-x(i)))</emphasis> quando
85             <literal>normalization</literal> (normalização) for verdadeiro (caso
86             padrão) senão, é simplesmente igual a Ni. Quando a normalização ocorre, o
87             histograma verifica: 
88         </para>
89         <para>
90             <latex style="display"><![CDATA[
91     \int_{x(1)}^{x(n+1)}h(x)\,\mathrm{d}x=1
92     ]]></latex>
93         </para>
94         <para>
95             quando <emphasis>x(1)&lt;=min(data)</emphasis> e <emphasis>max(data) &lt;= x(n+1)</emphasis>
96         </para>
97         <para>
98             Qualquer <link linkend="plot2d">plot2d</link> parâmetro (opcional)
99             pode ser fornecido; por exemplo, para esboçar um histograma com a cor
100             número 2 (azul, se o mapa de cores padrão for utilizado) e para restringir
101             o esboço ao retângulo [-3,3]x[0,0.5], você pode utilizar
102             <literal>histplot(n,data, style=2, rect=[-3,0,3,0.5])</literal>.
103         </para>
104         <para>
105             Entre com o comando <literal>histplot()</literal> para visualizar
106             uma demonstração.
107         </para>
108     </refsection>
109     <refsection>
110         <title>Exemplos</title>
111         <simplelist>
112             <member>
113                 Exemplo #1: variações ao redor de um histograma de uma amostra gaussiana aleatória
114                 <programlisting role="example"><![CDATA[ 
115 d=rand(1,10000,'normal');  // a amostra gaussiana aleatória
116 clf();histplot(20,d)
117 clf();histplot(20,d,normalization=%f)
118 clf();histplot(20,d,leg='rand(1,10000,''normal'')',style=5)
119 clf();histplot(20,d,leg='rand(1,10000,''normal'')',style=16, rect=[-3,0,3,0.5]); 
120 ]]></programlisting>
121             </member>
122             <member>
123                 Exemplo #2: histograma de uma amsostra binomial (B(6,0.5)) aleatória
124                 <programlisting role="example"><![CDATA[
125 d = grand(1000,1,"bin", 6, 0.5);
126 c = linspace(-0.5,6.5,8);
127 clf()
128 subplot(2,1,1)
129 histplot(c, d, style=2)
130 xtitle("histograma normalizado")
131 subplot(2,1,2)
132 histplot(c, d, normalization=%f, style=5)
133 xtitle("histograma não normalizado")
134 ]]></programlisting>
135             </member>
136             <member>
137                 Exemplo #3: histograma de uma amostra exponencial aleatória
138                 <programlisting role="example"><![CDATA[
139 lambda = 2;
140 X = grand(100000,1,"exp", 1/lambda);
141 Xmax = max(X);
142 clf()
143 histplot(40, X, style=2)
144 x = linspace(0,max(Xmax),100)';
145 plot2d(x,lambda*exp(-lambda*x),strf="000",style=5)
146 legend(["histograma de amostra exponencial aleatória" "curva de densidade exata"]);
147 ]]></programlisting>
148             </member>
149         </simplelist>
150     </refsection>
151     <refsection>
152         <title>Ver Também </title>
153         <simplelist type="inline">
154             <member>
155                 <link linkend="hist3d">hist3d</link>
156             </member>
157             <member>
158                 <link linkend="plot2d">plot2d</link>
159             </member>
160             <member>
161                 <link linkend="dsearch">dsearch</link>
162             </member>
163         </simplelist>
164     </refsection>
165 </refentry>