Graphics tests: fix histrogram references
[scilab.git] / scilab / modules / graphics / help / pt_BR / bar_histogram / bar.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 - Farid Belahcene
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="bar" xml:lang="en">
14     <refnamediv>
15         <refname>bar</refname>
16         <refpurpose>Histograma de barras</refpurpose>
17     </refnamediv>
18     <refsynopsisdiv>
19         <title>Seqüência de Chamamento</title>
20         <synopsis>bar(y)
21             bar(x,y)
22             bar([h],x,y [,width [,color [,style]]])
23         </synopsis>
24     </refsynopsisdiv>
25     <refsection>
26         <title>Parâmetros </title>
27         <variablelist>
28             <varlistentry>
29                 <term>h</term>
30                 <listitem>
31                     <para>manipulador de eixos, (padrão: h=gca() ). </para>
32                 </listitem>
33             </varlistentry>
34             <varlistentry>
35                 <term>y</term>
36                 <listitem>
37                     <para>escalar real, vetor de tamanho N ou uma matriz NxM.</para>
38                 </listitem>
39             </varlistentry>
40             <varlistentry>
41                 <term>x</term>
42                 <listitem>
43                     <para>escalar real ou um vetor de tamanho N, (padrão: se y é um
44                         vetor, então x is é um vetor e o comprimento de x é igual ao
45                         comprimento de y. Se y é uma matriz, então x é um vetor e o
46                         comprimento de x é igual ao número de linhas de y)
47                     </para>
48                 </listitem>
49             </varlistentry>
50             <varlistentry>
51                 <term>width</term>
52                 <listitem>
53                     <para>(opcional), escalar real, define a largura (uma porcentagem do
54                         espaço disponível) para a barra (padrão: 0.8, i.e 80%).
55                     </para>
56                 </listitem>
57             </varlistentry>
58             <varlistentry>
59                 <term>color</term>
60                 <listitem>
61                     <para>(opcional), um string (padrão: 'blue'), especificando a cor da
62                         barra.
63                     </para>
64                 </listitem>
65             </varlistentry>
66             <varlistentry>
67                 <term>style:</term>
68                 <listitem>
69                     <para>string, 'grouped' ou 'stacked' (padrão: 'grouped').</para>
70                 </listitem>
71             </varlistentry>
72         </variablelist>
73     </refsection>
74     <refsection>
75         <title>Descrição</title>
76         <para>
77             <literal>bar(y,...) :</literal> se y é um vetor então a função bar
78             desenha uma poligonal que tem <literal>polyline_style</literal> tipo 6. Se
79             y for um vetor, desenha o vetor y versus o vetor 1:size(y,'*') . Se y for
80             uma matriz N*M, bar desenha M poligonais (tipo 6), cada poligonal
81             corresponde a uma coluna de y versus o vetor x=1:size(y,1).
82         </para>
83         <para>
84             <literal>bar(x,y,...) :</literal> se y for um vetor, então a função
85             bar desenha uma poligonal que tem <literal>polyline_style</literal> tipo
86             6, onde comprimento de x = comprimento de y. Se y é uma matriz NxM então a
87             função bar desenha M poligonais que possuem tipo 6. Cada poligonal
88             corresponde a uma coluna de y versus o vetor x.
89         </para>
90         <para>
91             <literal>bar(h,...) :</literal> define os eixos correntes onde o
92             desenho é feito.
93         </para>
94         <para>
95             <literal>bar(...,width,...) :</literal> define a largura da(s)
96             barra(s) em porcentagem (geralmente: 0&lt;width&lt;=1).
97         </para>
98         <para>
99             <literal>bar(...,style,...) :</literal> define como as barras serão
100             desenhadas. Se y é uma matriz NxM (então temos M poligonais de tipo 6),
101             então há dois modos de se desenhar as M barras. A opção style= 'grouped'
102             permite centrar as M poligonais versus cada componente de x, e a opção
103             style = 'stacked' permite empilhá-las.
104         </para>
105         <para>
106             <literal>bar(...,color,...) : </literal>define a cor da barra.
107             Funções de barra utilizam o mesmo mapa de cores que na função
108         </para>
109         <para>Se há várias chamadas a bar, a função
110             <literal>barhomogenize</literal> permite homogeneizar a largura e estilo
111             de todas as barras (i.e poligonais do tipo 6) inclusas nos eixos
112             correntes.
113         </para>
114     </refsection>
115     <refsection>
116         <title>Exemplos</title>
117         <programlisting role="example"><![CDATA[
118 // primeiro exemplo: desenhando uma barra (i.e uma poligonal com polyline_style =6) com
119 // width=0.5 e color='yellow' e style='grouped', x=1:length(y).
120 scf(0);
121 y=[1 -3 5];
122 bar(y,0.5,'yellow');
123
124 // segundo exemplo: desenhando 3 barras (i.e três poligonais com polyline_style =6), style='grouped'
125 scf(1);
126 x=[1 2 5]; y=[1  -5 6;3 -2 7;4  -3 8];
127 bar(x,y);
128
129 // terceiro exemplo: style='stacked'.
130 scf(2);
131 x=[1 2 5]; y=[1 4 7;2 5 8;3 6  9];
132 bar(x,y,'stacked');
133
134 // quarto exemplo: width=0.2;color='green', style='grouped'
135 scf(3);
136 x=[1 2 5]; y=[1 4 7;2 5 8;3 6 9];
137 bar(x,y,0.2,'green');
138  ]]></programlisting>
139     </refsection>
140     <refsection role="see also">
141         <title>Ver Também</title>
142         <simplelist type="inline">
143             <member>
144                 <link linkend="barh">barh</link>
145             </member>
146             <member>
147                 <link linkend="barhomogenize">barhomogenize</link>
148             </member>
149             <member>
150                 <link linkend="plot">plot</link>
151             </member>
152             <member>
153                 <link linkend="histplot">histplot</link>
154             </member>
155             <member>
156                 <link linkend="polyline_properties">polyline_properties</link>
157             </member>
158         </simplelist>
159     </refsection>
160 </refentry>