barhomogenize() page: subplot images fixed + improvements 28/19528/3
Samuel GOUGEON [Thu, 9 Nov 2017 13:23:28 +0000 (14:23 +0100)]
Despite their localized titles, actual images are not localized on purpose.

Change-Id: I9c326669434edd1a46f732ee300715cb132b813d

scilab/CHANGES.md
scilab/modules/graphics/help/en_US/bar_histogram/barhomogenize.xml
scilab/modules/graphics/help/fr_FR/bar_histogram/barhomogenize.xml
scilab/modules/graphics/help/ja_JP/bar_histogram/barhomogenize.xml
scilab/modules/graphics/help/pt_BR/bar_histogram/barhomogenize.xml
scilab/modules/helptools/etc/images_md5.txt
scilab/modules/helptools/images/barhomogenize_1.png
scilab/modules/helptools/images/barhomogenize_2.png

index bab5ae7..f5fae99 100644 (file)
@@ -235,7 +235,7 @@ Help pages:
 * fixed / improved:  `members`, `part`, `ode`, `ode_optional_output`, `ode_roots`, `plot2d`, `roots`,
   `printf`, `sprintf`, `iconvert`, `stdev`, `xlabel`, `and_op`, `or_op`, `permute`, `tree2code`, `%helps`,
   `scilab|scilex`, `flipdim`, `Matplot_properties`, `meshgrid`, `ismatrix`, `xget`, `xset`, `ieee`, `evstr`,
-  `uigetfont`, `uigetdir`, `uigetfile`, `uiputfile`, `cat`, `makecell`, `xstring`, `norm`
+  `uigetfont`, `uigetdir`, `uigetfile`, `uiputfile`, `cat`, `makecell`, `xstring`, `norm`, `barhomogenize`
 * rewritten: `consolebox`, `double`, `isoview`, `pixel_drawing_mode`, `householder`, `or`, `|,||`,
 `and`, `&,&&`, `format`, `typeof`, `brackets`, `setlanguage`, `sleep`, `isinf`,
 `bitor`, `bitxor`, `bitand`, `macr2tree`, `geomean`, `clf`, `getPreferencesValue`, `gcd`, `isglobal`, `whereis`, `mode`
index 0b5334b..7564efc 100644 (file)
  * along with this program.
  *
  -->
-<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="en" xml:id="barhomogenize">
+<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="en" xml:id="barhomogenize">
     <refnamediv>
         <refname>barhomogenize</refname>
         <refpurpose>homogenize all the bars included in the current working axes</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Syntax</title>
-        <synopsis>barhomogenize()
-            barhomogenize([h[,'style'[,'width']]])
+        <synopsis>
+            barhomogenize()
+            barhomogenize(h)
+            barhomogenize([h,] style)
+            barhomogenize([h,] width)
+            barhomogenize([h,] style, width)
         </synopsis>
     </refsynopsisdiv>
     <refsection>
             <varlistentry>
                 <term>h</term>
                 <listitem>
-                    <para>an axes handle, (default: h=gca() ).</para>
+                    <para>
+                    an axes handle: The axes where barhomogenize() must be applied. Default
+                    <literal>h=gca()</literal>.
+                    </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>style</term>
                 <listitem>
-                    <para>a string, 'grouped' or 'stacked' (default: 'grouped').</para>
+                    <para>
+                        word <literal>'grouped'</literal> (default) or <literal>'stacked'</literal>
+                    </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>width</term>
                 <listitem>
-                    <para>(optional), a real scalar, defines the width (a percentage of
-                        the available room) for the bar (default: 0.8).
+                    <para>a decimal number <literal>0 &lt; width &lt;= 1</literal>, setting the
+                    width of bars, as a fraction of the maximum allowed width. Default: 0.8.
                     </para>
                 </listitem>
             </varlistentry>
             These bars must have the same x data.
         </para>
         <para>
-            <literal>barhomogenize( ) :</literal> takes the default values, h=gca(),
-            width=0.8, style='grouped'. <literal/>
+            <literal>barhomogenize( ) :</literal> takes the default values <literal>h=gca(),
+            width=0.8, style='grouped'.</literal>
         </para>
         <para>
             <literal>barhomogenize(h,...) :</literal> defines the current axes where the
             drawing is performed.
         </para>
         <para>
-            <literal>barhomogenize(...,width,...) :</literal> defines the width of the
-            bar(s) in percentage (generally: 0&lt;width&lt;=1).
-        </para>
-        <para>
             <literal>barhomogenize(...,style,...) :</literal> defines how the bars are
             drawn. The 'grouped' option allows to center the M polylines versus each
             components of x, and the 'stacked' option allows to stack them.
         </para>
+        <para>
+            <literal>barhomogenize(...,width) :</literal> defines the width of the
+            bar(s) in percentage (generally: 0&lt;width&lt;=1).
+        </para>
     </refsection>
     <refsection>
         <title>Examples</title>
+        <para>
+        <emphasis role="bold">First example:</emphasis> creation of 1 yellow bar (i.e 1 polyline
+        with polyline_style=6) and 3 bars (i.e 3 polylines with polyline_style=6)
+        </para>
         <programlisting role="example"><![CDATA[
-// First example: creation of 1 yellow bar (i.e 1 polyline with polyline_style=6) and 3 bars (i.e 3 polylines with polyline_style=6)
-subplot(2,3,1)
-xtitle('ex1: creation of 1 yellow bar and 3 bars')
-x=1:3;
-y1=1:3;
-y2=[4 3 5;6 7 8;9 10 11];
-bar(x,y1,'yellow');bar(x,y2);
+            subplot(2,3,1)
+            xtitle('ex1: creation of 1 yellow bar and 3 bars')
+            x=1:3;
+            y1=1:3;
+            y2=[4 3 5;6 7 8;9 10 11];
+            bar(x,y1,'yellow');bar(x,y2);
 
-// grouped homogenization of these 4 bars
-subplot(2,3,2)
-xtitle('grouped homogenization')
-x=1:3;
-y1=1:3;
-y2=[4 3 5;6 7 8;9 10 11];
-bar(x,y1,'yellow');bar(x,y2);
-barhomogenize();
+            // grouped homogenization of these 4 bars
+            subplot(2,3,2)
+            xtitle('grouped homogenization')
+            x=1:3;
+            y1=1:3;
+            y2=[4 3 5;6 7 8;9 10 11];
+            bar(x,y1,'yellow');bar(x,y2);
+            barhomogenize();
 
-// stacked homogenization of the 4 bars
-subplot(2,3,3)
-xtitle('stacked homogenization')
-x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
-bar(x,y1,'yellow');bar(x,y2);
-barhomogenize('stacked',1);
+            // stacked homogenization of the 4 bars
+            subplot(2,3,3)
+            xtitle('stacked homogenization')
+            x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
+            bar(x,y1,'yellow');bar(x,y2);
+            barhomogenize('stacked',1);
 ]]></programlisting>
         <scilab:image>
-            subplot(2,3,1)
+            gcf().axes_size = [800 270];
+            subplot(1,3,1)
             xtitle('ex1: creation of 1 yellow bar and 3 bars')
             x=1:3;
             y1=1:3;
             y2=[4 3 5;6 7 8;9 10 11];
             bar(x,y1,'yellow');bar(x,y2);
 
-            subplot(2,3,2)
+            subplot(1,3,2)
             xtitle('grouped homogenization')
             x=1:3;
             y1=1:3;
@@ -118,57 +134,61 @@ barhomogenize('stacked',1);
             bar(x,y1,'yellow');bar(x,y2);
             barhomogenize();
 
-            subplot(2,3,3)
+            subplot(1,3,3)
             xtitle('stacked homogenization')
             x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
             bar(x,y1,'yellow');bar(x,y2);
             barhomogenize('stacked',1);
         </scilab:image>
-
+        <para>
+            <emphasis role="bold">Second example : </emphasis>creation of 1 red bar (i.e 1 polyline
+            with polyline_style=6) and 2 polylines with type=1 (calling plot function).
+        </para>
         <programlisting role="example"><![CDATA[
-// Second example : creation of 1 red bar (i.e 1 polyline with polyline_style=6) and 2 polylines with type=1 (calling plot function)
-subplot(2,3,4)
-xtitle('ex2: creation of 1 bar and 2 polylines')
-x=1:10;
-y=sin(x)/2;
-bar(x,y,'red')
-x1=1:10;
-y1=[sin(x);cos(x)]
-plot(x1',y1')
+            subplot(2,3,4)
+            xtitle('ex2: creation of 1 bar and 2 polylines')
+            x=1:10;
+            y=sin(x)/2;
+            bar(x,y,'red')
+            x1=1:10;
+            y1=[sin(x);cos(x)]
+            plot(x1',y1')
 
-// modify the polyline_style type of the second polyline from plot (this polyline becomes a bar)
-subplot(2,3,5)
-xtitle('transformation of the second polyline to bar')
-x=1:10;
-y=sin(x)/2;
-bar(x,y,'red')
-x1=1:10;
-y1=[sin(x);cos(x)]
-plot(x1',y1')
-e=gce();
-e2=e.children(2);
-e2.polyline_style=6;
+            // modify the polyline_style type of the second polyline from plot (this polyline becomes a bar)
+            subplot(2,3,5)
+            xtitle('transformation of the second polyline to bar')
+            x=1:10;
+            y=sin(x)/2;
+            bar(x,y,'red')
+            x1=1:10;
+            y1=[sin(x);cos(x)]
+            plot(x1',y1')
+            e=gce();
+            e2=e.children(2);
+            e2.polyline_style=6;
 
-// homogenization of the first bar (from bar function) and second bar (from the modification).
-subplot(2,3,6)
-xtitle('grouped homogenization')
-x=1:10;
-y=sin(x)/2;
-bar(x,y,'red')
-x1=1:10;
-y1=[sin(x);cos(x)]
-plot(x1',y1')
-e=gce();
-e2=e.children(2);
-e2.polyline_style=6;
-barhomogenize();
-// change the style and the width
-//barhomogenize('stacked',0.5);
-//barhomogenize('stacked',1);
+            // homogenization of the first bar (from bar function) and second bar (from the modification).
+            subplot(2,3,6)
+            xtitle('grouped homogenization')
+            x=1:10;
+            y=sin(x)/2;
+            bar(x,y,'red')
+            x1=1:10;
+            y1=[sin(x);cos(x)]
+            plot(x1',y1')
+            e=gce();
+            e2=e.children(2);
+            e2.polyline_style=6;
+            barhomogenize();
+            // change the style and the width
+            //barhomogenize('stacked',0.5);
+            //barhomogenize('stacked',1);
  ]]></programlisting>
         <scilab:image>
-            // Second example : creation of 1 red bar (i.e 1 polyline with polyline_style=6) and 2 polylines with type=1 (calling plot function)
-            subplot(2,3,4)
+            gcf().axes_size = [800 270];
+            // Second example : creation of 1 red bar (i.e 1 polyline with polyline_style=6)
+            //  and 2 polylines with type=1 (calling plot function)
+            subplot(1,3,1)
             xtitle('ex2: creation of 1 bar and 2 polylines')
             x=1:10;
             y=sin(x)/2;
@@ -178,7 +198,7 @@ barhomogenize();
             plot(x1',y1')
 
             // modify the polyline_style type of the second polyline from plot (this polyline becomes a bar)
-            subplot(2,3,5)
+            subplot(1,3,2)
             xtitle('transformation of the second polyline to bar')
             x=1:10;
             y=sin(x)/2;
@@ -191,7 +211,7 @@ barhomogenize();
             e2.polyline_style=6;
 
             // homogenization of the first bar (from bar function) and second bar (from the modification).
-            subplot(2,3,6)
+            subplot(1,3,3)
             xtitle('grouped homogenization')
             x=1:10;
             y=sin(x)/2;
@@ -215,6 +235,9 @@ barhomogenize();
                 <link linkend="bar">bar</link>
             </member>
             <member>
+                <link linkend="histplot">histplot</link>
+            </member>
+            <member>
                 <link linkend="polyline_properties">polyline_properties</link>
             </member>
         </simplelist>
index 84ddaf8..3948277 100644 (file)
@@ -1,13 +1,34 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<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">
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) INRIA - Farid Belahcene
+ *
+ * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ *
+ * This file is hereby licensed under the terms of the GNU GPL v2.0,
+ * pursuant to article 5.3.4 of the CeCILL v.2.1.
+ * This file was originally licensed under the terms of the CeCILL v2.1,
+ * and continues to be available under such terms.
+ * For more information, see the COPYING file which you should have received
+ * along with this program.
+ *
+ -->
+<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">
     <refnamediv>
         <refname>barhomogenize</refname>
-        <refpurpose>homogeneise toutes les barres contenues dans les axes courrants de travail</refpurpose>
+        <refpurpose>uniformise le style des barres dessinées dans un repère graphique</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Séquence d'appel</title>
-        <synopsis>barhomogenize()
-            barhomogenize([h[,'style'[,'width']]])
+        <synopsis>
+            barhomogenize()
+            barhomogenize(h)
+            barhomogenize([h,] style)
+            barhomogenize([h,] width)
+            barhomogenize([h,] style, width)
         </synopsis>
     </refsynopsisdiv>
     <refsection>
             <varlistentry>
                 <term>h</term>
                 <listitem>
-                    <para>un pointeur sur les axes, (par defaut: h=gca() ).</para>
+                    <para>identifiant d'un repère graphique (gca() par défaut).</para>
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>style:</term>
+                <term>style</term>
                 <listitem>
-                    <para>une chaine, 'grouped' ou 'stacked' (par defaut: 'grouped').</para>
+                    <para>une chaine, <literal>'grouped'</literal> (par défaut), ou
+                        <literal>'stacked'</literal>.
+                    </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>width</term>
                 <listitem>
-                    <para>(optionnel), un scalaire, qui defini l'epaisseur des barres
-                        (un pourcentage de l'epaisseur maximun autorisé pour une barre) (par
-                        defaut: width=0.8, i.e 80%).
+                    <para>nombre décimal <literal>0 &lt; width &lt;= 1</literal> : définit la
+                        largeur des barres, = fraction de la largeur maximale autorisée.
+                        Par défaut: width=0.8.
                     </para>
                 </listitem>
             </varlistentry>
     </refsection>
     <refsection>
         <title>Description</title>
-        <para>S'il y a plusieurs appels à la fonction bar, la fonction
-            <literal>barhomogenize</literal> permet d'homogeneiser l'epaisseur et le style
+        <para>S'il y a plusieurs appels à la fonction bar(), la fonction
+            <literal>barhomogenize</literal> permet d'homogénéiser l'epaisseur et le style
             de toutes les barres (i.e de type <literal>polyline_style</literal> 6) contenues
-            dans les axes de travail. Ces barres doivent avoir les meme abscisses (x
+            dans le repère graphique actif. Ces barres doivent avoir les meme abscisses (x
             data).
         </para>
         <para>
-            <literal>barhomogenize( ) :</literal> prends les valeurs suivantes par
-            defaut: h=gca(), width=0.8, style='grouped'.
-        </para>
-        <para>
-            <literal>barhomogenize(h,...) :</literal> definit les axes courants dans
-            lesquels le dessin sera réalisé.
+            <literal>barhomogenize( )</literal> prends les valeurs suivantes par
+            défaut: <literal>h=gca(), width=0.8, style='grouped'</literal>.
         </para>
         <para>
-            <literal>barhomogenize(...,width,...) :</literal> definit l'epaisseur des
-            barres, en pourcentage (generallement : 0&lt;width&lt;=1).
+            <literal>barhomogenize(h,...)</literal> définit le repère graphique dans
+            lequel la fonction doit être appliquée.
         </para>
         <para>
-            <literal>barhomogenize(...,style,...) :</literal> definit la façon dont les
+            <literal>barhomogenize(...,style,...)</literal> définit la façon dont les
             barres sont positionnées les unes par rapport aux autres. L'option style
             fixée à 'grouped' permet de centrer les polylines par rapport à leurs
             abscisses, et l'option style fixée à 'stacked' permet de les empiler.
         </para>
+        <para>
+            <literal>barhomogenize(...,width)</literal> définit l'épaisseur des
+            barres, en pourcentage (généralement : 0&lt;width&lt;=1).
+        </para>
     </refsection>
     <refsection>
         <title>Exemples</title>
+        <para>
+        <emphasis role="bold">Exemple n°1 :</emphasis> 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)
+        </para>
         <programlisting role="example"><![CDATA[
-// 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)
-subplot(2,3,1)
-xtitle('ex1: creation of 1 yellow bar and  3 bars')
-x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
-bar(x,y1,'yellow');bar(x,y2);
-// homogeneisation des 4 barres avec l'option style fixée à 'grouped' (par défaut)
-subplot(2,3,2)
-xtitle('grouped homogenization')
-x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
-bar(x,y1,'yellow');bar(x,y2);
-barhomogenize();
-// homogeneisation des 4 barres avec l'option style fixée à 'stacked'
-subplot(2,3,3)
-xtitle('stacked homogenization')
-x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
-bar(x,y1,'yellow');bar(x,y2);
-barhomogenize('stacked',1);
-]]></programlisting>
-        <scilab:image>
             subplot(2,3,1)
             xtitle('ex1: creation of 1 yellow bar and 3 bars')
             x=1:3;
@@ -92,6 +100,7 @@ barhomogenize('stacked',1);
             y2=[4 3 5;6 7 8;9 10 11];
             bar(x,y1,'yellow');bar(x,y2);
 
+            // homogeneisation des 4 barres avec l'option style fixée à 'grouped' (par défaut)
             subplot(2,3,2)
             xtitle('grouped homogenization')
             x=1:3;
@@ -100,46 +109,88 @@ barhomogenize('stacked',1);
             bar(x,y1,'yellow');bar(x,y2);
             barhomogenize();
 
+            // homogeneisation des 4 barres avec l'option style fixée à 'stacked'
             subplot(2,3,3)
             xtitle('stacked homogenization')
             x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
             bar(x,y1,'yellow');bar(x,y2);
             barhomogenize('stacked',1);
+]]></programlisting>
+        <scilab:image>
+            gcf().axes_size = [800 270];
+            subplot(1,3,1)
+            xtitle('ex1: creation of 1 yellow bar and 3 bars')
+            x=1:3;
+            y1=1:3;
+            y2=[4 3 5;6 7 8;9 10 11];
+            bar(x,y1,'yellow');bar(x,y2);
+
+            subplot(1,3,2)
+            xtitle('grouped homogenization')
+            x=1:3;
+            y1=1:3;
+            y2=[4 3 5;6 7 8;9 10 11];
+            bar(x,y1,'yellow');bar(x,y2);
+            barhomogenize();
+
+            subplot(1,3,3)
+            xtitle('stacked homogenization')
+            x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
+            bar(x,y1,'yellow');bar(x,y2);
+            barhomogenize('stacked',1);
         </scilab:image>
+        <para>
+            <emphasis role="bold">Exemple n°2 :</emphasis> creation d'une barre (polyline de type
+            polyline_style=6, avec un appel à la fonction bar), et deux polylines (2 polylines de
+            type polyline_style=1, avec un appel à la fonction plot).
+        </para>
         <programlisting role="example"><![CDATA[
+            subplot(2,3,4)
+            xtitle('ex2: creation of 1 bar and 2 polylines')
+            x=1:10;
+            y=sin(x)/2;
+            bar(x,y,'red')
+            x1=1:10;
+            y1=[sin(x);cos(x)]
+            plot(x1',y1')
+
+            // Modification du type polyline_style à 6 de la deuxième polyline construite
+            //  par plot (cette polyline devient une barre)
+            subplot(2,3,5)
+            xtitle('transformation of the second polyline to bar')
+            x=1:10;
+            y=sin(x)/2;
+            bar(x,y,'red')
+            x1=1:10;
+            y1=[sin(x);cos(x)]
+            plot(x1',y1')
+            e=gce();
+            e2=e.children(2);
+            e2.polyline_style=6;
 
-// Deuxieme exemple
-// 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)
-subplot(2,3,4)
-xtitle('ex2: creation of 1 bar and 2 polylines')
-x=1:10; y=sin(x)/2;
-bar(x,y,'red')
-x1=1:10;y1=[sin(x);cos(x)]
-plot(x1,y1)
-// modification du type polyline_style à 6 de la deuxieme polyline construite par plot (cette polyline devient une barre)
-subplot(2,3,5)
-xtitle('transformation of the second polyline to bar')
-x=1:10; y=sin(x)/2;
-bar(x,y,'red')
-x1=1:10;y1=[sin(x);cos(x)]
-plot(x1,y1)
-e=gce(); e2=e.children(2); e2.polyline_style=6;
-// homogeneisation de la première barre (construite par appel à la fonction bar) et de la deuxieme barre (issue de la modification).
-subplot(2,3,6)
-xtitle('grouped homogenization')
-x=1:10; y=sin(x)/2;
-bar(x,y,'red')
-x1=1:10;y1=[sin(x);cos(x)]
-plot(x1,y1)
-e=gce(); e2=e.children(2); e2.polyline_style=6;
-barhomogenize();
-// change the style and the width
-//barhomogenize('stacked',0.5);
-//barhomogenize('stacked',1);
+            // Homogénéisation de la première barre (construite par appel à la fonction bar)
+            //  et de la deuxième barre (issue de la modification).
+            subplot(2,3,6)
+            xtitle('grouped homogenization')
+            x=1:10;
+            y=sin(x)/2;
+            bar(x,y,'red')
+            x1=1:10;
+            y1=[sin(x);cos(x)]
+            plot(x1',y1')
+            e=gce();
+            e2=e.children(2);
+            e2.polyline_style=6;
+            barhomogenize();
+            // change the style and the width
+            //barhomogenize('stacked',0.5);
+            //barhomogenize('stacked',1);
  ]]></programlisting>
         <scilab:image>
-            // Second example : creation of 1 red bar (i.e 1 polyline with polyline_style=6) and 2 polylines with type=1 (calling plot function)
-            subplot(2,3,4)
+            gcf().axes_size = [800 270];
+            // Second example : creation of 1 red bar (i.e 1 polyline with polyline_style=6)
+            //  and 2 polylines with type=1 (calling plot function)
+            subplot(1,3,1)
             xtitle('ex2: creation of 1 bar and 2 polylines')
             x=1:10;
             y=sin(x)/2;
@@ -149,7 +200,7 @@ barhomogenize();
             plot(x1',y1')
 
             // modify the polyline_style type of the second polyline from plot (this polyline becomes a bar)
-            subplot(2,3,5)
+            subplot(1,3,2)
             xtitle('transformation of the second polyline to bar')
             x=1:10;
             y=sin(x)/2;
@@ -162,7 +213,7 @@ barhomogenize();
             e2.polyline_style=6;
 
             // homogenization of the first bar (from bar function) and second bar (from the modification).
-            subplot(2,3,6)
+            subplot(1,3,3)
             xtitle('grouped homogenization')
             x=1:10;
             y=sin(x)/2;
@@ -178,7 +229,6 @@ barhomogenize();
             //barhomogenize('stacked',0.5);
             //barhomogenize('stacked',1);
         </scilab:image>
-
     </refsection>
     <refsection role="see also">
         <title>Voir aussi</title>
@@ -187,6 +237,9 @@ barhomogenize();
                 <link linkend="bar">bar</link>
             </member>
             <member>
+                <link linkend="histplot">histplot</link>
+            </member>
+            <member>
                 <link linkend="polyline_properties">polyline_properties</link>
             </member>
         </simplelist>
index b3cb9f6..77148e8 100644 (file)
@@ -1,14 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
 <!--
-
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
-
  * Copyright (C) INRIA - Farid Belahcene
-
  *
-
-
  * Copyright (C) 2012 - 2016 - Scilab Enterprises
  *
  * This file is hereby licensed under the terms of the GNU GPL v2.0,
  * and continues to be available under such terms.
  * For more information, see the COPYING file which you should have received
  * along with this program.
-
  *
-
  -->
-
-<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="ja" xml:id="barhomogenize">
-
+<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="ja" xml:id="barhomogenize">
     <refnamediv>
-
         <refname>barhomogenize</refname>
-
         <refpurpose>カレントの軸に含まれる棒グラフを均質化する</refpurpose>
-
     </refnamediv>
-
     <refsynopsisdiv>
-
         <title>呼び出し手順</title>
-
-        <synopsis>barhomogenize()
-
-            barhomogenize([h[,'style'[,'width']]])
-
+        <synopsis>
+            barhomogenize()
+            barhomogenize(h)
+            barhomogenize([h,] style)
+            barhomogenize([h,] width)
+            barhomogenize([h,] style, width)
         </synopsis>
-
     </refsynopsisdiv>
-
     <refsection>
-
         <title>パラメータ</title>
-
         <variablelist>
-
             <varlistentry>
-
                 <term>h</term>
-
                 <listitem>
-
                     <para>軸ハンドル, (デフォルト: h=gca() ).</para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>style</term>
-
                 <listitem>
-
-                    <para>文字列, 'grouped' または 'stacked' (デフォルト: 'grouped').</para>
-
+                    <para>
+                        文字列, <literal>'grouped'</literal> (デフォルト), または <literal>'stacked'</literal>.
+                    </para>
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>width</term>
-
                 <listitem>
-
                     <para>(オプション), 実数スカラー, bar の幅 (利用可能な空間の割合) を定義
-
                         (デフォルト: 0.8).
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
         </variablelist>
-
     </refsection>
-
     <refsection>
-
         <title>説明</title>
-
         <para>
-
             bar を複数回コールする場合,
-
             <literal>barhomogenize</literal> 関数は,カレントの軸に含まれる
-
             全ての棒(すなわち,<literal>polyline_style</literal> 6型)の幅とスタイルを
-
             均質化します.
-
             これらの棒は同じxデータを有する必要があります
-
         </para>
-
         <para>
-
-            <literal>barhomogenize( ) :</literal> この場合,
-
-            デフォルト値,h=gca(),
-
-            width=0.8, style='grouped' が使用されます. <literal/>
-
+            <literal>barhomogenize( )</literal> : この場合,
+            デフォルト値,<literal>h=gca(), width=0.8, style='grouped'</literal> が使用されます.
         </para>
-
         <para>
-
-            <literal>barhomogenize(h,...) :</literal>
-
+            <literal>barhomogenize(h,...)</literal> :
             描画対象のカレントの軸を定義します.
-
-        </para>
-
-        <para>
-
-            <literal>barhomogenize(...,width,...) :</literal>
-
-            棒の幅をパーセント単位で定義します
-
-            (通常: 0&lt;width&lt;=1).
-
         </para>
-
         <para>
-
-            <literal>barhomogenize(...,style,...) :</literal>
-
+            <literal>barhomogenize(...,style,...)</literal> :
             棒の描画方法を定義します.
-
             オプション = 'grouped'により,
-
             M個のポリラインをxの各要素に対して中心に置くことができ,
-
             そして, オプション 'stacked' によりこれらをスタックすることができます.
-
         </para>
-
+        <para>
+            <literal>barhomogenize(...,width)</literal> :
+            棒の幅をパーセント単位で定義します
+            (通常: 0&lt;width&lt;=1).
+        </para>
     </refsection>
-
     <refsection>
-
         <title>例</title>
-
-        <scilab:image>
-
+        <para>
+            <emphasis role="bold">最初の例:</emphasis> 黄色の棒を1つ (polyline_style=6のポリラインを1本)と棒を3つ
+            (polyline_style=6のポリラインを3本)
+        </para>
+        <programlisting role="example"><![CDATA[
             subplot(2,3,1)
+            xtitle('ex1: creation of 1 yellow bar and 3 bars ')
+            x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
+            bar(x,y1,'yellow');bar(x,y2);
 
-            xtitle('ex1: creation of 1 yellow bar and 3 bars')
+            // これら4本の棒のグループとして均質化
+            subplot(2,3,2)
+            xtitle('grouped homogenization')
+            x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
+            bar(x,y1,'yellow');bar(x,y2);
+            barhomogenize('grouped',1);
 
+            // これら4本の棒のスタックとして統一化
+            subplot(2,3,3)
+            xtitle('stacked homogenization')
+            x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
+            bar(x,y1,'yellow');bar(x,y2);
+            barhomogenize('stacked',1);
+ ]]></programlisting>
+        <scilab:image>
+            gcf().axes_size = [800 270];
+            subplot(1,3,1)
+            xtitle('ex1: creation of 1 yellow bar and 3 bars')
             x=1:3;
-
             y1=1:3;
-
             y2=[4 3 5;6 7 8;9 10 11];
-
             bar(x,y1,'yellow');bar(x,y2);
 
-
-
-            subplot(2,3,2)
-
+            subplot(1,3,2)
             xtitle('grouped homogenization')
-
             x=1:3;
-
             y1=1:3;
-
             y2=[4 3 5;6 7 8;9 10 11];
-
             bar(x,y1,'yellow');bar(x,y2);
-
             barhomogenize();
 
-
-
-            subplot(2,3,3)
-
+            subplot(1,3,3)
             xtitle('stacked homogenization')
-
             x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
-
             bar(x,y1,'yellow');bar(x,y2);
-
             barhomogenize('stacked',1);
-
         </scilab:image>
-
-    </refsection>
-
-    <refsection>
-
-        <title>例</title>
-
+        <para>
+            <emphasis role="bold">第2の例 :</emphasis> 赤色の棒を1つ (polyline_style=6のポリラインを1本) と
+            type=1のポリラインを2本 (plot 関数をコール)
+        </para>
         <programlisting role="example"><![CDATA[
-
-// 最初の例: 黄色の棒を1つ (polyline_style=6のポリラインを1本)と棒を3つ (polyline_style=6のポリラインを3本)
-
-subplot(2,3,1)
-
-xtitle('ex1: creation of 1 yellow bar and 3 bars ')
-
-x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
-
-bar(x,y1,'yellow');bar(x,y2);
-
-// これら4本の棒のグループとして均質化
-
-subplot(2,3,2)
-
-xtitle('grouped homogenization')
-
-x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
-
-bar(x,y1,'yellow');bar(x,y2);
-
-barhomogenize('grouped',1);
-
-// これら4本の棒のスタックとして統一化
-
-subplot(2,3,3)
-
-xtitle('stacked homogenization')
-
-x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
-
-bar(x,y1,'yellow');bar(x,y2);
-
-barhomogenize('stacked',1);
-
-
-
-// 第2の例 : 赤色の棒を1つ (polyline_style=6のポリラインを1本) と type=1のポリラインを2本 (plot 関数をコール)
-
-subplot(2,3,4)
-
-xtitle('ex2: creation of 1 bar and 2 polylines')
-
-x=1:10; y=sin(x)/2;
-
-bar(x,y,'red')
-
-x1=1:10;y1=[sin(x);cos(x)]
-
-plot(x1,y1)
-
-// 2本目のポリラインのpolyline_style 型をplotから修正 (このポリラインは棒になります)
-
-subplot(2,3,5)
-
-xtitle('transformation of the second polyline to bar')
-
-x=1:10; y=sin(x)/2;
-
-bar(x,y,'red')
-
-x1=1:10;y1=[sin(x);cos(x)]
-
-plot(x1,y1)
-
-e=gce(); e2=e.children(2); e2.polyline_style=6;
-
-// (bar 関数による)最初の棒(修正による)と2個目の棒の均質化.
-
-subplot(2,3,6)
-
-xtitle('grouped homogenization')
-
-x=1:10; y=sin(x)/2;
-
-bar(x,y,'red')
-
-x1=1:10;y1=[sin(x);cos(x)]
-
-plot(x1,y1)
-
-e=gce(); e2=e.children(2); e2.polyline_style=6;
-
-barhomogenize();
-
-// 幅とスタイルを変更
-
-//barhomogenize('stacked',0.5);
-
-//barhomogenize('stacked',1);
-
+            subplot(2,3,4)
+            xtitle('ex2: creation of 1 bar and 2 polylines')
+            x=1:10; y=sin(x)/2;
+            bar(x,y,'red')
+            x1=1:10;y1=[sin(x);cos(x)]
+            plot(x1,y1)
+
+            // 2本目のポリラインのpolyline_style 型をplotから修正 (このポリラインは棒になります)
+            subplot(2,3,5)
+            xtitle('transformation of the second polyline to bar')
+            x=1:10; y=sin(x)/2;
+            bar(x,y,'red')
+            x1=1:10;y1=[sin(x);cos(x)]
+            plot(x1,y1)
+            e=gce(); e2=e.children(2); e2.polyline_style=6;
+
+            // (bar 関数による)最初の棒(修正による)と2個目の棒の均質化.
+            subplot(2,3,6)
+            xtitle('grouped homogenization')
+            x=1:10; y=sin(x)/2;
+            bar(x,y,'red')
+            x1=1:10;y1=[sin(x);cos(x)]
+            plot(x1,y1)
+            e=gce(); e2=e.children(2); e2.polyline_style=6;
+            barhomogenize();
+            // 幅とスタイルを変更
+            //barhomogenize('stacked',0.5);
+            //barhomogenize('stacked',1);
  ]]></programlisting>
-
+        <scilab:image>
+            gcf().axes_size = [800 270];
+            // Second example : creation of 1 red bar (i.e 1 polyline with polyline_style=6)
+            //  and 2 polylines with type=1 (calling plot function)
+            subplot(1,3,1)
+            xtitle('ex2: creation of 1 bar and 2 polylines')
+            x=1:10;
+            y=sin(x)/2;
+            bar(x,y,'red')
+            x1=1:10;
+            y1=[sin(x);cos(x)]
+            plot(x1',y1')
+
+            // modify the polyline_style type of the second polyline from plot (this polyline becomes a bar)
+            subplot(1,3,2)
+            xtitle('transformation of the second polyline to bar')
+            x=1:10;
+            y=sin(x)/2;
+            bar(x,y,'red')
+            x1=1:10;
+            y1=[sin(x);cos(x)]
+            plot(x1',y1')
+            e=gce();
+            e2=e.children(2);
+            e2.polyline_style=6;
+
+            // homogenization of the first bar (from bar function) and second bar (from the modification).
+            subplot(1,3,3)
+            xtitle('grouped homogenization')
+            x=1:10;
+            y=sin(x)/2;
+            bar(x,y,'red')
+            x1=1:10;
+            y1=[sin(x);cos(x)]
+            plot(x1',y1')
+            e=gce();
+            e2=e.children(2);
+            e2.polyline_style=6;
+            barhomogenize();
+            // change the style and the width
+            //barhomogenize('stacked',0.5);
+            //barhomogenize('stacked',1);
+        </scilab:image>
     </refsection>
-
     <refsection role="see also">
-
         <title>参照</title>
-
         <simplelist type="inline">
-
             <member>
-
                 <link linkend="bar">bar</link>
-
             </member>
-
             <member>
-
+                <link linkend="histplot">histplot</link>
+            </member>
+            <member>
                 <link linkend="polyline_properties">polyline_properties</link>
-
             </member>
-
         </simplelist>
-
     </refsection>
-
-</refentry>
-
+</refentry>
\ No newline at end of file
index 9895188..92c5869 100644 (file)
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
+<?xml version="1.0" encoding="UTF-8"?>
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) INRIA - Farid Belahcene
  * along with this program.
  *
  -->
-<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="barhomogenize" xml:lang="pt">
+<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="barhomogenize" xml:lang="pt">
     <refnamediv>
         <refname>barhomogenize</refname>
-        <refpurpose>Homogeniza todas as barras inclusas nos eixos
-            correntes
+        <refpurpose>
+            Homogeniza todas as barras inclusas nos eixos correntes
         </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
-        <title>Seqüência de Chamamento</title>
-        <synopsis>barhomogenize()
-            barhomogenize([h[,'style'[,'width']]])
+        <title>Seqüência de Chamamento</title>
+        <synopsis>
+            barhomogenize()
+            barhomogenize(h)
+            barhomogenize([h,] style)
+            barhomogenize([h,] width)
+            barhomogenize([h,] style, width)
         </synopsis>
     </refsynopsisdiv>
     <refsection>
-        <title>Parâmetros</title>
+        <title>Parâmetros</title>
         <variablelist>
             <varlistentry>
                 <term>h</term>
                 <listitem>
-                    <para>manipulador de eixos, (padrão: h=gca() ). </para>
+                    <para>manipulador de eixos, (padrão: h=gca() ). </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>style</term>
                 <listitem>
-                    <para>string, 'grouped' ou 'stacked' (padrão: 'grouped'). </para>
+                    <para>
+                        string, <literal>'grouped'</literal> (padrão), ou <literal>'stacked'</literal>
+                        .
+                    </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>width</term>
                 <listitem>
-                    <para>(opcional) escalar real, define a largura (uma porcentagem do
-                        espaço disponível) para a barra (padrão: 0.8).
+                    <para>escalar real, define a largura (uma porcentagem do
+                        espaço disponível) para a barra (padrão: 0.8).
                     </para>
                 </listitem>
             </varlistentry>
         </variablelist>
     </refsection>
     <refsection>
-        <title>Descrição</title>
-        <para>Se há várias chamadas a bar, a função
+        <title>Descrição</title>
+        <para>Se há várias chamadas a bar, a função
             <literal>barhomogenize</literal> permite homogeneizar a largura e estilo
-            de todas as barras (i.e que têm <literal>polyline_style</literal> tipo 6)
+            de todas as barras (i.e que têm <literal>polyline_style</literal> tipo 6)
             inclusas nos eixos correntes. Estas barras devem ter os mesmos dados
             x.
         </para>
         <para>
-            <literal>barhomogenize( ) :</literal> toma os valores padrões,
-            h=gca(), width=0.8, style='grouped'.
+            <literal>barhomogenize( )</literal> : toma os valores padrões,
+            <literal>h=gca(), width=0.8, style='grouped'</literal>.
         </para>
         <para>
-            <literal>barhomogenize(h,...) :</literal> define os eixos correntes
-            onde o desenho é realizado.
+            <literal>barhomogenize(h,...)</literal> : define os eixos correntes
+            onde o desenho é realizado.
         </para>
         <para>
-            <literal>barhomogenize(...,width,...) :</literal> define a largura
-            da(s) barra(s) em porcentagem(geralmente: 0&lt;width&lt;=1).
+            <literal>barhomogenize(...,style,...)</literal> : define como as
+            barras são desenhadas. A opção <literal>"grouped"</literal> permite centrar as M poligonais
+            versus cada componente de x, e a opção <literal>"stacked"</literal> permite
+            empilhá-las.
         </para>
         <para>
-            <literal>barhomogenize(...,style,...) :</literal> define como as
-            barras são desenhadas. A opção 'grouped' permite centrar as M poligonais
-            versus cada componente de x, e a opção 'stacked' permite
-            empilhá-las.
+            <literal>barhomogenize(...,width)</literal> : define a largura
+            da(s) barra(s) em porcentagem(geralmente: 0&lt;width&lt;=1).
         </para>
     </refsection>
     <refsection>
         <title>Exemplos</title>
+        <para>
+            <emphasis role="bold">Primeiro exemplo: </emphasis> criação de uma barra amarela
+            (i.e uma poligonal com polyline_style=6) e  três barras (i.e três poligonais com
+            polyline_style=6) do esboço).
+        </para>
         <programlisting role="example"><![CDATA[
-// Primeiro exemplo: criação de uma barra amarela (i.e uma poligonal com polyline_style=6) e  três barras (i.e três poligonais com polyline_style=6)
-subplot(2,3,1)
-xtitle('ex1: criação de uma barra amarela e três barras')
-x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
-bar(x,y1,'yellow');bar(x,y2);
-// homogeneização dessas quatro barras
-subplot(2,3,2)
-xtitle('homogenização agrupada')
-x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
-bar(x,y1,'yellow');bar(x,y2);
-barhomogenize();
-// homogenização empilhada dessas quatro barras
-subplot(2,3,3)
-xtitle('homogenização empilhada')
-x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
-bar(x,y1,'yellow');bar(x,y2);
-barhomogenize('stacked',1);
+            subplot(2,3,1)
+            xtitle('ex1: criação de uma barra amarela e três barras')
+            x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
+            bar(x,y1,'yellow');bar(x,y2);
 
-// Segundo exemplo: criação de uma barra vermelha (i.e uma poligonal com polyline_style=6) e duas poligonais com type=1 (função de chamamento do esboço)
-subplot(2,3,4)
-xtitle('ex2: criação de uma barra e duas poligonais')
-x=1:10; y=sin(x)/2;
-bar(x,y,'red')
-x1=1:10;y1=[sin(x);cos(x)]
-plot(x1,y1)
-// modificando o polyline_style da segunda poligonal do esboço (esta poligonal se torna em uma barra)
-subplot(2,3,5)
-xtitle('transformação da segunda poligonal em uma barra')
-x=1:10; y=sin(x)/2;
-bar(x,y,'red')
-x1=1:10;y1=[sin(x);cos(x)]
-plot(x1,y1)
-e=gce(); e2=e.children(2); e2.polyline_style=6;
-// homogenização da primeira barra (da função bar) e da segunda barra (da modificação).
-subplot(2,3,6)
-xtitle('homogeneização em grupo')
+            // homogeneização dessas quatro barras
+            subplot(2,3,2)
+            xtitle('homogenização agrupada')
+            x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
+            bar(x,y1,'yellow');bar(x,y2);
+            barhomogenize();
 
-x=1:10; y=sin(x)/2;
-bar(x,y,'red')
-x1=1:10;y1=[sin(x);cos(x)]
-plot(x1,y1)
-e=gce(); e2=e.children(2); e2.polyline_style=6;
-barhomogenize();
-// mudança de estilo e largura
-//barhomogenize('stacked',0.5);
-//barhomogenize('stacked',1);
+            // homogenização empilhada dessas quatro barras
+            subplot(2,3,3)
+            xtitle('homogenização empilhada')
+            x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
+            bar(x,y1,'yellow');bar(x,y2);
+            barhomogenize('stacked',1);
  ]]></programlisting>
+        <scilab:image>
+            gcf().axes_size = [800 270];
+            subplot(1,3,1)
+            xtitle('ex1: creation of 1 yellow bar and 3 bars')
+            x=1:3;
+            y1=1:3;
+            y2=[4 3 5;6 7 8;9 10 11];
+            bar(x,y1,'yellow');bar(x,y2);
+
+            subplot(1,3,2)
+            xtitle('grouped homogenization')
+            x=1:3;
+            y1=1:3;
+            y2=[4 3 5;6 7 8;9 10 11];
+            bar(x,y1,'yellow');bar(x,y2);
+            barhomogenize();
+
+            subplot(1,3,3)
+            xtitle('stacked homogenization')
+            x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
+            bar(x,y1,'yellow');bar(x,y2);
+            barhomogenize('stacked',1);
+        </scilab:image>
+        <para>
+            <emphasis role="bold">Segundo exemplo: </emphasis>criação de uma barra vermelha (i.e
+            uma poligonal com polyline_style=6) e duas poligonais com type=1 (função de chamamento
+            do esboço).
+        </para>
+        <programlisting role="example"><![CDATA[
+            subplot(2,3,4)
+            xtitle('ex2: criação de uma barra e duas poligonais')
+            x=1:10; y=sin(x)/2;
+            bar(x,y,'red')
+            x1=1:10;y1=[sin(x);cos(x)]
+            plot(x1,y1)
+
+            // modificando o polyline_style da segunda poligonal do esboço (esta poligonal se torna em uma barra)
+            subplot(2,3,5)
+            xtitle('transformação da segunda poligonal em uma barra')
+            x=1:10; y=sin(x)/2;
+            bar(x,y,'red')
+            x1=1:10;y1=[sin(x);cos(x)]
+            plot(x1,y1)
+            e=gce(); e2=e.children(2); e2.polyline_style=6;
+            // homogenização da primeira barra (da função bar) e da segunda barra (da modificação).
+            subplot(2,3,6)
+            xtitle('homogeneização em grupo')
+
+            x=1:10; y=sin(x)/2;
+            bar(x,y,'red')
+            x1=1:10;y1=[sin(x);cos(x)]
+            plot(x1,y1)
+            e=gce(); e2=e.children(2); e2.polyline_style=6;
+            barhomogenize();
+            // mudança de estilo e largura
+            //barhomogenize('stacked',0.5);
+            //barhomogenize('stacked',1);
+ ]]></programlisting>
+        <scilab:image>
+            gcf().axes_size = [800 270];
+            // Second example : creation of 1 red bar (i.e 1 polyline with polyline_style=6)
+            //  and 2 polylines with type=1 (calling plot function)
+            subplot(1,3,1)
+            xtitle('ex2: creation of 1 bar and 2 polylines')
+            x=1:10;
+            y=sin(x)/2;
+            bar(x,y,'red')
+            x1=1:10;
+            y1=[sin(x);cos(x)]
+            plot(x1',y1')
+
+            // modify the polyline_style type of the second polyline from plot (this polyline becomes a bar)
+            subplot(1,3,2)
+            xtitle('transformation of the second polyline to bar')
+            x=1:10;
+            y=sin(x)/2;
+            bar(x,y,'red')
+            x1=1:10;
+            y1=[sin(x);cos(x)]
+            plot(x1',y1')
+            e=gce();
+            e2=e.children(2);
+            e2.polyline_style=6;
+
+            // homogenization of the first bar (from bar function) and second bar (from the modification).
+            subplot(1,3,3)
+            xtitle('grouped homogenization')
+            x=1:10;
+            y=sin(x)/2;
+            bar(x,y,'red')
+            x1=1:10;
+            y1=[sin(x);cos(x)]
+            plot(x1',y1')
+            e=gce();
+            e2=e.children(2);
+            e2.polyline_style=6;
+            barhomogenize();
+            // change the style and the width
+            //barhomogenize('stacked',0.5);
+            //barhomogenize('stacked',1);
+        </scilab:image>
     </refsection>
     <refsection>
-        <title>Ver Também </title>
+        <title>Ver Também </title>
         <simplelist type="inline">
             <member>
                 <link linkend="bar">bar</link>
             </member>
             <member>
+                <link linkend="histplot">histplot</link>
+            </member>
+            <member>
                 <link linkend="polyline_properties">polyline_properties</link>
             </member>
         </simplelist>
index 4fe4f65..9b8f23d 100644 (file)
@@ -756,8 +756,8 @@ barh_1.png=b708acffc2f268acecbfc73aa846675
 barh_2.png=b0c9fd105c8654d8bd29d5653638e090
 barh_3.png=3c8e049a779aa39557f06c0f1100d9de
 barh_4.png=d512ecebeca33e008379e73a9b7e4ee0
-barhomogenize_1.png=7aa36029b0680d3d91e8071fe92555d2
-barhomogenize_2.png=dbc9e4ccd2c57ac43463dbcd069c5133
+barhomogenize_1.png=be26fcf2379896a04bcdb3e05f43df1e
+barhomogenize_2.png=7a71570219dfa35d04bcfd96ed3659df
 bessel_1.png=a99ebb6beeb99537ca3ab9d1b15f707c
 bessel_2.png=b812fd51dfafe021ced32d86d51c792
 bessel_3.png=cbce4edf613965d74ad8327f769ef4e8
index f675e81..57844af 100644 (file)
Binary files a/scilab/modules/helptools/images/barhomogenize_1.png and b/scilab/modules/helptools/images/barhomogenize_1.png differ
index 668cc44..743bf76 100644 (file)
Binary files a/scilab/modules/helptools/images/barhomogenize_2.png and b/scilab/modules/helptools/images/barhomogenize_2.png differ