Typo fixes
[scilab.git] / scilab / modules / graphics / help / fr_FR / bar_histogram / barhomogenize.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="fr" xml:id="barhomogenize">
3     <refnamediv>
4         <refname>barhomogenize</refname>
5         <refpurpose>homogeneise toutes les barres contenues dans les axes courrants de travail</refpurpose>
6     </refnamediv>
7     <refsynopsisdiv>
8         <title>Séquence d'appel</title>
9         <synopsis>barhomogenize()
10             barhomogenize([h[,'style'[,'width']]])
11         </synopsis>
12     </refsynopsisdiv>
13     <refsection>
14         <title>Paramètres</title>
15         <variablelist>
16             <varlistentry>
17                 <term>h</term>
18                 <listitem>
19                     <para>un pointeur sur les axes, (par defaut: h=gca() ).</para>
20                 </listitem>
21             </varlistentry>
22             <varlistentry>
23                 <term>style:</term>
24                 <listitem>
25                     <para>une chaine, 'grouped' ou 'stacked' (par defaut: 'grouped').</para>
26                 </listitem>
27             </varlistentry>
28             <varlistentry>
29                 <term>width</term>
30                 <listitem>
31                     <para>(optionnel), un scalaire, qui defini l'epaisseur des barres
32                         (un pourcentage de l'epaisseur maximun autorisé pour une barre) (par
33                         defaut: width=0.8, i.e 80%).
34                     </para>
35                 </listitem>
36             </varlistentry>
37         </variablelist>
38     </refsection>
39     <refsection>
40         <title>Description</title>
41         <para>S'il y a plusieurs appels à la fonction bar, la fonction
42             <literal>barhomogenize</literal> permet d'homogeneiser l'epaisseur et le style
43             de toutes les barres (i.e de type <literal>polyline_style</literal> 6) contenues
44             dans les axes de travail. Ces barres doivent avoir les meme abscisses (x
45             data).
46         </para>
47         <para>
48             <literal>barhomogenize( ) :</literal> prends les valeurs suivantes par
49             defaut: h=gca(), width=0.8, style='grouped'.
50         </para>
51         <para>
52             <literal>barhomogenize(h,...) :</literal> definit les axes courants dans
53             lesquels le dessin sera réalisé.
54         </para>
55         <para>
56             <literal>barhomogenize(...,width,...) :</literal> definit l'epaisseur des
57             barres, en pourcentage (generallement : 0&lt;width&lt;=1).
58         </para>
59         <para>
60             <literal>barhomogenize(...,style,...) :</literal> definit la façon dont les
61             barres sont positionnées les unes par rapport aux autres. L'option style
62             fixée à 'grouped' permet de centrer les polylines par rapport à leurs
63             abscisses, et l'option style fixée à 'stacked' permet de les empiler.
64         </para>
65     </refsection>
66     <refsection>
67         <title>Exemples</title>
68         <programlisting role="example"><![CDATA[ 
69 // Premier exemple : creation d'une barre jaune(i.e une polyline de type polyline_style=6) et de 3 barres(i.e 3 polylines de type polyline_style=6)
70 subplot(2,3,1)
71 xtitle('ex1: creation of 1 yellow bar and  3 bars')
72 x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
73 bar(x,y1,'yellow');bar(x,y2);
74 // homogeneisation des 4 barres avec l'option style fixée à 'grouped' (par défaut)
75 subplot(2,3,2)
76 xtitle('grouped homogenization')
77 x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
78 bar(x,y1,'yellow');bar(x,y2);
79 barhomogenize();
80 // homogeneisation des 4 barres avec l'option style fixée à 'stacked'
81 subplot(2,3,3)
82 xtitle('stacked homogenization')
83 x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
84 bar(x,y1,'yellow');bar(x,y2);
85 barhomogenize('stacked',1);
86 ]]></programlisting>
87         <scilab:image>
88             subplot(2,3,1)
89             xtitle('ex1: creation of 1 yellow bar and 3 bars')
90             x=1:3;
91             y1=1:3;
92             y2=[4 3 5;6 7 8;9 10 11];
93             bar(x,y1,'yellow');bar(x,y2);
94             
95             subplot(2,3,2) 
96             xtitle('grouped homogenization')
97             x=1:3;
98             y1=1:3;
99             y2=[4 3 5;6 7 8;9 10 11];
100             bar(x,y1,'yellow');bar(x,y2);
101             barhomogenize();
102             
103             subplot(2,3,3)
104             xtitle('stacked homogenization')
105             x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
106             bar(x,y1,'yellow');bar(x,y2);
107             barhomogenize('stacked',1);
108         </scilab:image>
109         <programlisting role="example"><![CDATA[ 
110
111 // Deuxieme exemple
112 // creation d'une barre (i.e une polyline de type polyline_style=6, avec un appel à la fonction bar) et deux polylines (i.e 2 polylines de type polyline_style=1, avec un appel à la fonction plot)
113 subplot(2,3,4)
114 xtitle('ex2: creation of 1 bar and 2 polylines')
115 x=1:10; y=sin(x)/2;
116 bar(x,y,'red')
117 x1=1:10;y1=[sin(x);cos(x)]
118 plot(x1,y1)
119 // modification du type polyline_style à 6 de la deuxieme polyline construite par plot (cette polyline devient une barre)
120 subplot(2,3,5)
121 xtitle('transformation of the second polyline to bar')
122 x=1:10; y=sin(x)/2;
123 bar(x,y,'red')
124 x1=1:10;y1=[sin(x);cos(x)]
125 plot(x1,y1)
126 e=gce(); e2=e.children(2); e2.polyline_style=6;
127 // homogeneisation de la première barre (construite par appel à la fonction bar) et de la deuxieme barre (issue de la modification). 
128 subplot(2,3,6)
129 xtitle('grouped homogenization')
130 x=1:10; y=sin(x)/2;
131 bar(x,y,'red')
132 x1=1:10;y1=[sin(x);cos(x)]
133 plot(x1,y1)
134 e=gce(); e2=e.children(2); e2.polyline_style=6;
135 barhomogenize();
136 // change the style and the width
137 //barhomogenize('stacked',0.5);
138 //barhomogenize('stacked',1);
139  ]]></programlisting>
140         <scilab:image>
141             // Second example : creation of 1 red bar (i.e 1 polyline with polyline_style=6) and 2 polylines with type=1 (calling plot function)
142             subplot(2,3,4)
143             xtitle('ex2: creation of 1 bar and 2 polylines')
144             x=1:10;
145             y=sin(x)/2;
146             bar(x,y,'red')
147             x1=1:10;
148             y1=[sin(x);cos(x)]
149             plot(x1',y1')
150             
151             // modify the polyline_style type of the second polyline from plot (this polyline becomes a bar)
152             subplot(2,3,5)
153             xtitle('transformation of the second polyline to bar')
154             x=1:10;
155             y=sin(x)/2;
156             bar(x,y,'red')
157             x1=1:10;
158             y1=[sin(x);cos(x)]
159             plot(x1',y1')
160             e=gce();
161             e2=e.children(2);
162             e2.polyline_style=6;
163             
164             // homogenization of the first bar (from bar function) and second bar (from the modification).
165             subplot(2,3,6)
166             xtitle('grouped homogenization')
167             x=1:10;
168             y=sin(x)/2;
169             bar(x,y,'red')
170             x1=1:10;
171             y1=[sin(x);cos(x)]
172             plot(x1',y1')
173             e=gce();
174             e2=e.children(2);
175             e2.polyline_style=6;
176             barhomogenize();
177             // change the style and the width
178             //barhomogenize('stacked',0.5);
179             //barhomogenize('stacked',1);
180         </scilab:image>
181         
182     </refsection>
183     <refsection role="see also">
184         <title>Voir aussi</title>
185         <simplelist type="inline">
186             <member>
187                 <link linkend="bar">bar</link>
188             </member>
189             <member>
190                 <link linkend="polyline_properties">polyline_properties</link>
191             </member>
192         </simplelist>
193     </refsection>
194 </refentry>