* Bug 6070 fixed [doc]: Documenting How to make multiscaled plots 21/20921/3
Samuel GOUGEON [Thu, 4 Apr 2019 23:34:14 +0000 (01:34 +0200)]
  http://bugzilla.scilab.org/6070
  PDF version: http://bugzilla.scilab.org/attachment.cgi?id=4928

Change-Id: Ic3ae34ffa36a2b32536cfd5d896b1e908d0eea97

14 files changed:
scilab/CHANGES.md
scilab/modules/graphics/help/en_US/axes_operations/newaxes.xml
scilab/modules/graphics/help/en_US/axis/drawaxis.xml
scilab/modules/graphics/help/en_US/plot_multiscaled.xml [new file with mode: 0644]
scilab/modules/graphics/help/fr_FR/axis/drawaxis.xml
scilab/modules/graphics/help/ja_JP/axes_operations/newaxes.xml
scilab/modules/graphics/help/ja_JP/axis/drawaxis.xml
scilab/modules/graphics/help/pt_BR/axes_operations/newaxes.xml
scilab/modules/graphics/help/pt_BR/axis/drawaxis.xml
scilab/modules/helptools/etc/images_md5.txt
scilab/modules/helptools/images/plot_multiscaled_1.png [new file with mode: 0644]
scilab/modules/helptools/images/plot_multiscaled_2.png [new file with mode: 0644]
scilab/modules/helptools/images/plot_multiscaled_3.png [new file with mode: 0644]
scilab/modules/helptools/images/plot_multiscaled_4.png [new file with mode: 0644]

index 239ccca..d1ecdad 100644 (file)
@@ -195,6 +195,7 @@ Bug Fixes
 
 ### Bugs fixed in 6.1.0:
 * [#2694](http://bugzilla.scilab.org/show_bug.cgi?id=2694): `bitget` did not accept positive integers of types int8, int16 or int32.
+* [#6070](http://bugzilla.scilab.org/show_bug.cgi?id=6070): Making multiscaled plots was not documented.
 * [#7657](http://bugzilla.scilab.org/show_bug.cgi?id=7657): `lstsize` was a duplicate of `size` and should be removed.
 * [#7724](http://bugzilla.scilab.org/show_bug.cgi?id=7724): When a figure is created in .auto_resize="on" mode, its .axes_size sets its .figure_size accordingly, not the reverse. But this was not documented.
 * [#7765](http://bugzilla.scilab.org/show_bug.cgi?id=7765): `champ1()` is useless. `champ().colored` is available for a long time.
index 0a1a85e..8d0f2d0 100644 (file)
@@ -121,6 +121,9 @@ title(a_bt, "the exponential");
         <title>See also</title>
         <simplelist type="inline">
             <member>
+                <link linkend="plot_multiscaled">Multiscaled plots</link>
+            </member>
+            <member>
                 <link linkend="subplot">subplot</link>
             </member>
             <member>
index d6f94fe..1a7024f 100644 (file)
@@ -210,6 +210,9 @@ drawaxis(x=2:7,y=4,dir='u',tics='v',fontsize=10,textcolor=9,ticscolor=7,seg=0,su
         <title>See also</title>
         <simplelist type="inline">
             <member>
+                <link linkend="plot_multiscaled">Multiscaled plots</link>
+            </member>
+            <member>
                 <link linkend="axis_properties">axis_properties</link>
             </member>
         </simplelist>
diff --git a/scilab/modules/graphics/help/en_US/plot_multiscaled.xml b/scilab/modules/graphics/help/en_US/plot_multiscaled.xml
new file mode 100644 (file)
index 0000000..108e668
--- /dev/null
@@ -0,0 +1,328 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2019 - Samuel GOUGEON
+ *
+ * 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"
+        version="5.0-subset Scilab" xml:lang="en" xml:id="plot_multiscaled">
+    <refnamediv>
+        <refname>multiscaled plots</refname>
+        <refpurpose>How to set several axes for one curve or for curves with distinct scales</refpurpose>
+    </refnamediv>
+    <refnamediv xml:id="plotyy"/>
+    <refnamediv xml:id="yyaxis"/>
+    <refsection>
+        <title>Description</title>
+        <para>
+            Several situations may need to use and set several cartesian X axes or several
+            cartesian Y axes, as for instance:
+            <orderedlist>
+                <listitem>
+                    We want to read the same curve according to distinct scales along
+                    multiple X or Y axes:
+                    <itemizedlist>
+                        <listitem>
+                            <para>
+                            If the relationship between both scales is affine (such as y'=a.y+b)
+                            and linear axes must be rendered,
+                            <link linkend="drawaxis">drawaxis</link>() can be used.
+                            </para>
+                        </listitem>
+                        <listitem>
+                            <para>
+                            If the relationship between both scales is a power law (such as y'=a.y^b),
+                            using logarithmic axes and <link linkend="newaxes">newaxes</link>()
+                            will be required.
+                            </para>
+                        </listitem>
+                    </itemizedlist>
+                    Anyway, both scales are here tightly related. In order to insure that
+                    it's also the case for their drawing, the <literal>gca().tight_limits</literal>
+                    property will have to be set to "on" in the considered direction
+                </listitem>
+                <listitem>
+                    <para>
+                    We want to overplot several curves sharing the same X abscissae but according
+                    to distinct uncorrelated Y scales. Then, one or several overlaying axes will
+                    be set using <link linkend="newaxes">newaxes</link>().
+                    </para>
+                </listitem>
+            </orderedlist>
+        </para>
+    </refsection>
+    <refsection role="examples">
+        <title>Examples</title>
+        <para>
+            Water density: Two X linear scales for the same curve
+        </para>
+        <programlisting role="example"><![CDATA[
+t = linspace(0,10,100);
+tf = t*1.8+32;
+d = -6.863e-3*t.^2 + 0.05463*t + 999.84;
+clf
+// Main plot
+plot(t,d)
+xgrid(color("grey70")*[1 1],[1 1], [7 7])
+title("Water density","fontsize",3)
+xlabel("Temperature [°C]")
+ylabel("$kg.m^{-3}$", "fontsize",3)
+
+// Making some space for the 2nd X-label
+ax = gca();
+ax.margins(3) = 0.2;
+ax.title.position(2) = 1000.0;
+
+// Drawing the 2nd temperature axis in °F, + labelling it:
+xf = 32:50;
+atf = drawaxis(dir='u', tics="v", x=(xf-32)/1.8, y=999.96, val=msprintf("%d\n",xf') )
+c = color("magenta");
+set(atf, "tics_color",c, "labels_font_color",c)
+xstring(5,999.99,"Temperature [°F]")
+set(gce(), "clip_state", "off", "text_box_mode", "centered","font_foreground",c);
+gcf().axes_size = [610 510];
+     ]]></programlisting>
+        <scilab:image>
+            t = linspace(0,10,100);
+            tf = t*1.8+32;
+            d = -6.863e-3*t.^2 + 0.05463*t + 999.84;
+            clf
+            // Main plot
+            plot(t,d)
+            xgrid(color("grey70")*[1 1],[1 1], [7 7])
+            xlabel("Temperature [°C]")
+            ylabel("$kg.m^{-3}$", "fontsize",3)
+
+            // Making some space for the 2nd X-label
+            ax = gca();
+            ax.margins(3) = 0.2;
+            ax.title.position(2) = 1000.0;
+
+            // Drawing the 2nd temperature axis in °F, + labelling it:
+            xf = 32:50;
+            atf = drawaxis(dir='u', tics="v", x=(xf-32)/1.8, y=999.96, val=msprintf("%d\n",xf') )
+            c = color("magenta");
+            set(atf, "tics_color",c, "labels_font_color",c)
+            xstring(5,999.99,"Temperature [°F]")
+            set(gce(), "clip_state", "off", "text_box_mode", "centered","font_foreground",c);
+            title("Water density","fontsize",3)
+            gcf().axes_size = [610 510];
+        </scilab:image>
+        <para/>
+        <para>
+            Light spectrum, versus both wavelengths and frequencies: two correlated logarithmic X scales.
+        </para>
+        <programlisting role="example"><![CDATA[
+function r = Planck(T, lambda)
+    h = 6.626e-34;        // Planck constant    [J.s]
+    c = 298792458;        // light speed [m/s]
+    k = 1.381e-23;        // Boltzmann constant [J/K]
+    // stef = 5.670374e-8 // Stefan constant [W/m2/K4]
+    r = 2*h*c^2 ./ lambda.^5 ./ (exp(h*c./(lambda*k*T))-1);
+endfunction
+
+clf
+lambda = (100:10000);
+plot2d("ll", lambda, Planck(5700, lambda*1e-9)*1e-6)
+xlabel("Wavelength [nm]", "fontsize",2)
+ylabel("$\text{Luminance }[W.m^{-2}.sr^{-1}.µm^{-1}]$", "fontsize", 2)
+xgrid(color("grey70")*[1 1],[1 1],[7 7])
+a1 = gca();
+a1.margins(3) = 0.20;
+a1.sub_tics(2) = 8;
+
+// 2nd axes, superimposed to the first one
+a2 = newaxes();
+a2.data_bounds = [3e13,0;3e15 ,1];
+a2.Axes_reverse(1) = "on";
+a2.axes_visible(1) = "on";
+set(a2, "filled", "off", "log_flags","lnn", "x_location","top")
+a2.tight_limits(1) = "on";
+a2.margins(3) = 0.20;
+xlabel("Wave frequency [Hz]", "fontsize",2)
+title("Black Body spectrum : Planck law (T = 5700 K)", "fontsize",3)
+     ]]></programlisting>
+        <scilab:image>
+            function r = Planck(T, lambda)
+                h = 6.626e-34;        // Planck constant    [J.s]
+                c = 298792458;        // light speed [m/s]
+                k = 1.381e-23;        // Boltzmann constant [J/K]
+                // stef = 5.670374e-8 // Stefan constant [W/m2/K4]
+                r = 2*h*c^2 ./ lambda.^5 ./ (exp(h*c./(lambda*k*T))-1);
+            endfunction
+
+            clf
+            lambda = (100:10000);
+            plot2d("ll", lambda, Planck(5700, lambda*1e-9))
+            xlabel("Wavelength [nm]", "fontsize",2)
+            ylabel("$\text{Luminance }[W.m^{-2}.sr^{-1}.m^{-1}]$", "fontsize", 2)
+            xgrid(color("grey70")*[1 1],[1 1],[7 7])
+            a1 = gca();
+            a1.margins(3) = 0.20;
+            a1.sub_tics(2) = 8;
+
+            // 2nd axes, superimposed to the first one
+            a2 = newaxes();
+            a2.data_bounds = [3e13,0;3e15 ,1];
+            a2.Axes_reverse(1) = "on";
+            a2.axes_visible(1) = "on";
+            set(a2, "filled", "off", "log_flags","lnn", "x_location","top")
+            a2.tight_limits(1) = "on";
+            a2.margins(3) = 0.20;
+            xlabel("Wave frequency [Hz]", "fontsize",2)
+            title("Black Body spectrum : Planck law (T = 5700 K)", "fontsize",3)
+        </scilab:image>
+        <para/>
+        <para>
+            pH: A single curve, with two correlated Y scales: one linear, one logarithmic.
+        </para>
+        <programlisting role="example"><![CDATA[
+pH1 = 1.5;      // v1 = 10 mL of acid solution
+pH2 = 12.5;     // v2 mL of basic solution
+v2 = logspace(0,4,200);
+// naive raw pH estimation after mixing
+pH = -log10((10*(10.^-pH1) + v2*(10.^-pH2))./(10+v2));
+
+clf
+plot2d("ln",v2, pH)
+ax1 = gca();
+ax1.tight_limits(2) = "on";
+ax1.sub_ticks(1) = 8;
+xgrid(color("grey70")*[1 1],[1 1],[7 7])
+title("Acidity after mixing V mL of pH=13.5 to 10 mL of pH=1.5", "fontsize",3)
+xlabel("V (mL)", "fontsize",3)
+ylabel("pH", "fontsize",3);
+
+// [H^+] logarithmic 2nd scale
+ax2 = newaxes();
+ax2.data_bounds([4 3]) = 10.^(-ax1.data_bounds([3 4]));
+set(ax2, "filled","off", "y_location","right", "log_flags","nln")
+ax2.tight_limits(2) = "on";
+ax2.axes_visible(2) = "on";
+ax2.axes_reverse(2) = "on";
+ylabel("$[H^+]\text{ concentration }(mol.L^{-1})$","fontsize",3)
+ax2.y_label.font_angle = 90;
+     ]]></programlisting>
+        <scilab:image>
+            pH1= 1.5;       // v1 = 10 mL of acid solution
+            pH2 = 12.5;     // v2 mL of basic solution
+            v2 = logspace(0,4,200);
+            // naive raw pH estimation after mixing
+            pH = -log10((10*(10.^-pH1) + v2*(10.^-pH2))./(10+v2));
+
+            clf
+            plot2d("ln",v2, pH)
+            ax1 = gca();
+            ax1.tight_limits(2) = "on";
+            ax1.sub_ticks(1) = 8;
+            xgrid(color("grey70")*[1 1],[1 1],[7 7])
+            title("Acidity after mixing V mL of pH=13.5 to 10 mL of pH=1.5", "fontsize",3)
+            xlabel("V (mL)", "fontsize",3)
+            ylabel("pH", "fontsize",3);
+
+            // [H^+] logarithmic 2nd scale
+            ax2 = newaxes();
+            ax2.data_bounds([4 3]) = 10.^(-ax1.data_bounds([3 4]));
+            set(ax2, "filled","off", "y_location","right", "log_flags","nln")
+            ax2.tight_limits(2) = "on";
+            ax2.axes_visible(2) = "on";
+            ax2.axes_reverse(2) = "on";
+            ylabel("$[H^+]\text{ concentration }(mol.L^{-1})$","fontsize",3)
+            ax2.y_label.font_angle = 90;
+        </scilab:image>
+        <para/>
+        <para>
+            Three overplotted curves sharing the same X axis, with 3 independent Y scales:
+        </para>
+        <programlisting role="example"><![CDATA[
+// Preparing data
+x  = linspace(1,30,200);
+y2 = exp(x/6).*(sin(x)+1.5);
+y3 = 1+x.^2;
+
+clf
+
+// Black curve => y1 scale (left axis)
+y1 = sin(x/2);
+plot2d(x, y1)
+title(_("Plot with 3 independent Y scales at shared X"), "fontsize",3);
+xlabel(_("Common X axis"), "fontsize",2);
+ylabel(_("Scale #1"), "fontsize",2);
+xgrid(color("grey70")*[1 1], [1 1], [7 7])
+
+// Blue curve => y2 scale (middle axis)
+c = color("blue");
+ax2 = newaxes();
+set(ax2, "filled", "off", "foreground", c, "font_color", c);
+plot2d(x, y3, logflag="nl", style=c)
+gce().children.thickness = 2;
+ax2.axes_visible(1) = "off";
+ax2.y_location = "middle";
+
+// Red curve => y3 scale (right axis)
+c = color("red");
+ax3 = newaxes();
+set(ax3, "filled", "off", "foreground", c, "font_color", c);
+plot2d(x,y2,style=c);
+ylabel(_("Scale #3"),"color",[1 0 0])
+gce().children.thickness = 2;
+ax3.axes_visible(1) = "off";
+ax3.y_location = "right";
+     ]]></programlisting>
+        <scilab:image>
+            // Preparing data
+            x  = linspace(1,30,200);
+            y2 = exp(x/6).*(sin(x)+1.5);
+            y3 = 1+x.^2;
+
+            clf
+
+            // Black curve => y1 scale (left axis)
+            y1 = sin(x/2);
+            plot2d(x, y1)
+            title("Plot with 3 independent Y scales at shared X", "fontsize",3);
+            xlabel("Common X axis", "fontsize",2);
+            ylabel("Scale #1", "fontsize",2);
+            xgrid(color("grey70")*[1 1], [1 1], [7 7])
+
+            // Blue curve => y2 scale (middle axis)
+            c = color("blue");
+            ax2 = newaxes();
+            set(ax2, "filled", "off", "foreground", c, "font_color", c);
+            plot2d(x, y3, logflag="nl", style=c)
+            gce().children.thickness = 2;
+            ax2.axes_visible(1) = "off";
+            ax2.y_location = "middle";
+
+            // Red curve => y3 scale (right axis)
+            c = color("red");
+            ax3 = newaxes();
+            set(ax3, "filled", "off", "foreground", c, "font_color", c);
+            plot2d(x,y2,style=c);
+            ylabel("Scale #3", "color",[1 0 0])
+            gce().children.thickness = 2;
+            ax3.axes_visible(1) = "off";
+            ax3.y_location = "right";
+        </scilab:image>
+    </refsection>
+    <refsection role="see also">
+        <title>See also</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="drawaxis">drawaxis</link>
+            </member>
+            <member>
+                <link linkend="newaxes">newaxes</link>
+            </member>
+        </simplelist>
+    </refsection>
+</refentry>
index 13d16a8..348d2b0 100644 (file)
@@ -195,6 +195,9 @@ drawaxis(x=2:7,y=4,dir='u',tics='v',fontsize=10,textcolor=9,ticscolor=7,seg=0,su
         <title>Voir aussi</title>
         <simplelist type="inline">
             <member>
+                <link linkend="plot_multiscaled">Multiscaled plots</link>
+            </member>
+            <member>
                 <link linkend="axis_properties">axis_properties</link>
             </member>
         </simplelist>
index 0f524f0..8f1ca56 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 - Serge Steer
-
  *
-
-
  * 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="newaxes">
-
     <refnamediv>
-
         <refname>newaxes</refname>
-
         <refpurpose>新しいAxesエンティティを作成 </refpurpose>
-
     </refnamediv>
-
     <refsynopsisdiv>
-
         <title>呼び出し手順</title>
-
         <synopsis>
             a = newaxes()
             a = newaxes(h)
         </synopsis>
-
     </refsynopsisdiv>
-
     <refsection>
-
         <title>引数</title>
-
         <variablelist>
             <varlistentry>
                 <term>h</term>
                   </para>
                 </listitem>
             </varlistentry>
-
             <varlistentry>
-
                 <term>a</term>
-
                 <listitem>
-
                     <para>ハンドル, 新たに作成された Axesエンティティのハンドル</para>
-
                 </listitem>
-
             </varlistentry>
-
         </variablelist>
-
     </refsection>
-
     <refsection>
-
         <title>説明</title>
-
         <para>
-
             <literal>newaxes()</literal> は,カレントの図に新しい<literal>Axes</literal>
-
             エンティティ(
-
             <link linkend="graphics_entities">graphics_entities</link>参照)を
-
             作成する際に使用されます.
-
             このエンティティのプロパティは<literal>default_axes</literal>
-
             (<link linkend="gda">gda</link>参照)
-
             から継承されます.
-
         </para>
-
     </refsection>
-
     <refsection>
-
         <title>例</title>
-
         <programlisting role="example"><![CDATA[
 clf()
 a1 = newaxes();
@@ -159,11 +116,13 @@ title(a_tr, "a cosine");
 title(a_bt, "the exponential");
     ]]></programlisting>
     </refsection>
-
     <refsection role="see also">
         <title>参照</title>
         <simplelist type="inline">
             <member>
+                <link linkend="plot_multiscaled">Multiscaled plots</link>
+            </member>
+            <member>
                 <link linkend="subplot">subplot</link>
             </member>
             <member>
@@ -188,6 +147,4 @@ title(a_bt, "the exponential");
             </revision>
         </revhistory>
     </refsection>
-
-</refentry>
-
+</refentry>
\ No newline at end of file
index 4b6627e..0ad42e6 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) ENPC - Jean-Philippe Chancelier
-
  *
-
-
  * 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="drawaxis">
-
     <refnamediv>
-
         <refname>drawaxis</refname>
-
         <refpurpose>軸を描画</refpurpose>
-
     </refnamediv>
-
     <refsynopsisdiv>
-
         <title>呼び出し手順</title>
-
         <synopsis>drawaxis([options])
-
             // options: x,y,dir,sub_int,fontsize,format_n,seg,textcolor,ticscolor,tics
-
         </synopsis>
-
     </refsynopsisdiv>
-
     <refsection>
-
         <title>引数</title>
-
         <variablelist>
-
             <varlistentry>
-
                 <term>dir=文字列</term>
-
                 <listitem>
-
                     <para>メモリの方向を指定するために使用されます.
-
                         <literal>string</literal> には'u','r','d','l'のどれかを指定し,
-
                         'l'がデフォルト値です.
-
                         値  'u','r','d','l' はそれぞれ up, right, down, leftを意味します.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>tics=文字列</term>
-
                 <listitem>
-
                     <para>
-
                         目盛の指定方法を記述するフラグ.
-
                         <literal>string</literal> には'v','r', および 'i'のどれかを指定し,
-
                         'v'がデフォルト値です
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>x,y</term>
-
                 <listitem>
-
                     <para>目盛の位置を指定するベクトル.</para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>val= 文字列行列</term>
-
                 <listitem>
-
                     <para>文字列行列で, 指定された場合,
-
                         目盛の位置で軸に沿って描画される文字列を指定します.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>fontsize=整数</term>
-
                 <listitem>
-
                     <para>
-
                         軸に沿って表示される数値で使用されるフォントの大きさを指定します.
-
                         デフォルト値はカレントのフォントサイズを意味する <literal>-1</literal> です
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>format_n=文字列</term>
-
                 <listitem>
-
                     <para>
-
                         軸に沿って表示される数値のフォーマットで,<literal>string</literal>には
-
                         C言語のprintf関数の構文形式に基づくフォーマット(例えば<literal>string="%.3f"</literal>)を指定します.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>seg= 1 または 0</term>
-
                 <listitem>
-
                     <para>
-
                         軸のベースセグメントの表示を制御するフラグ (デフォルト値は 1です).
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
-
             <varlistentry>
-
                 <term>sub_int=整数</term>
-
                 <listitem>
-
                     <para>
-
                         大きな目盛の間に描画されるサブ間隔(目盛)の数を指定する整数.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>textcolor=整数</term>
-
                 <listitem>
-
                     <para>
-
                         軸に沿って表示される値で使用される色を指定します.
-
                         デフォルト値はカレントの色を意味する <literal>-1</literal> です.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>ticscolor=整数</term>
-
                 <listitem>
-
                     <para>目盛の描画で使用される色を指定します. デフォルト値はカレントの色を意味する
-
                         <literal>-1</literal> です.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
         </variablelist>
-
     </refsection>
-
     <refsection>
-
         <title>説明</title>
-
         <para>
-
             <literal>drawaxis</literal> は垂直または水平方向の
-
             軸を描画する際に使用されます.
-
             軸の方向は dir で指定され,
-
             <literal>dir = 'u'</literal> または <literal>'d'</literal>は
-
             目盛が増加 (<literal>'u'</literal>)または減少(<literal>'d'</literal>)
-
             する水平軸を指定します.
-
-
-
             <literal>dir = 'r'</literal> または <literal>'l'</literal>は
-
             右方向(<literal>'r'</literal>) または左方向 (<literal>'l'</literal>)の
-
             目盛を有する垂直軸を指定します.
-
         </para>
-
         <para>
-
             <literal>x</literal> および <literal>y</literal> は軸の目盛の位置を指定します.
-
             軸が水平軸の場合,<literal>y</literal> はスカラーまたは省略する必要があり,
-
             <literal>x</literal> はScilabベクトルとします.
-
             <literal>x</literal>の意味は<literal>tics</literal>で制御されます.
-
         </para>
-
         <para>
-
             <literal>tics='v'</literal>の場合, <literal>x</literal> は x軸方向の目盛の
-
             位置を指定します.
-
         </para>
-
         <para>
-
             <literal>tics='r'</literal>の場合, <literal>x</literal> の大きさは3である必要があります.
-
             <literal>x=[xmin,xmax,n]</literal>で,
-
             <literal>n</literal> は間隔の数を指定します.
-
         </para>
-
         <para>
-
             <literal>tics='i'</literal>の場合, <literal>x</literal> は大きさ4の
-
             <literal>x=[k1,k2,a,n]</literal>とします.
-
             <literal>xmin=k1*10^a</literal>, <literal>xmax=k2*10^a</literal>で,
-
             <literal>n</literal> は間隔の数を指定します.
-
         </para>
-
         <para>
-
             <literal>y</literal> が省略された場合,軸は,<literal>dir='u'</literal>の場合に
-
             フレームの上部,<literal>dir='d'</literal>の場合にフレームの下部
-
             に配置されます.
-
         </para>
-
         <para>
-
             デフォルトで,軸に沿って数値が描画されます.
-
             これらの数値はデフォルトのフォーマットで描画されますが,
-
             このフォーマットは<literal>format_n</literal>で変更可能です.
-
             数値ではなく文字列を表示することも可能で,
-
             <literal>val</literal>を指定した場合に文字列が表示されます.
-
             <literal>val</literal> の大きさは目盛の数に一致する必要があります.
-
         </para>
-
     </refsection>
-
     <refsection>
-
         <title>例</title>
-
         <programlisting role="example"><![CDATA[
-
 plot2d(1:10,1:10,1,"020")
-
 // 水平軸
-
 drawaxis(x=2:7,y=4,dir='u',tics='v')
-
 // フレームの上部に水平軸
-
 drawaxis(x=2:7,dir='u',tics='v')
-
 // フレームの下部に水平軸
-
 drawaxis(x=2:7,dir='d',tics='v')
 
-
-
 // 範囲で指定した水平軸
-
 drawaxis(x=[2,7,3],y=4,dir='d',tics='r')
 
-
-
 // 垂直軸
-
 drawaxis(x=4,y=2:7,dir='r',tics='v')
-
 drawaxis(x=2,y=[2,7,3],dir='l',tics='r')
-
 drawaxis(y=2:7,dir='r',tics='v')
-
 drawaxis(y=2:7,dir='l',tics='v')
 
-
-
 // 目盛位置に表示する文字列を指定した水平軸
-
 drawaxis(x=2:7,y=8,dir='u',tics='v',val='A'+string(1:6));
-
 // vertical axis with strings displayed at tics positions
-
 drawaxis(x=8,y=2:7,dir='r',tics='v',val='B'+string(1:6));
 
-
-
 // 'i' 範囲で指定した水平軸.
-
 drawaxis(x=[2,5,0,3],y=9,dir='u',tics='i');
-
 drawaxis(x=9,y=[2,5,0,3],dir='r',tics='i',sub_int=5);
 
-
-
 // 再び水平軸
-
 drawaxis(x=2:7,y=4,dir='u',tics='v',fontsize=10,textcolor=9,ticscolor=7,seg=0,sub_int=20)
-
  ]]></programlisting>
-
         <scilab:image>
-
             plot2d(1:10,1:10,1,"020")
-
             drawaxis(x=2:7,y=4,dir='u',tics='v')
-
             drawaxis(x=2:7,dir='u',tics='v')
-
             drawaxis(x=2:7,dir='d',tics='v')
-
-
-
             drawaxis(x=[2,7,3],y=4,dir='d',tics='r')
-
-
-
             drawaxis(x=4,y=2:7,dir='r',tics='v')
-
             drawaxis(x=2,y=[2,7,3],dir='l',tics='r')
-
             drawaxis(y=2:7,dir='r',tics='v')
-
             drawaxis(y=2:7,dir='l',tics='v')
-
-
-
             drawaxis(x=2:7,y=8,dir='u',tics='v',val='A'+string(1:6));
-
             drawaxis(x=8,y=2:7,dir='r',tics='v',val='B'+string(1:6));
-
-
-
             drawaxis(x=[2,5,0,3],y=9,dir='u',tics='i');
-
             drawaxis(x=9,y=[2,5,0,3],dir='r',tics='i',sub_int=5);
-
-
-
             drawaxis(x=2:7,y=4,dir='u',tics='v',fontsize=10,textcolor=9,ticscolor=7,seg=0,sub_int=20)
-
         </scilab:image>
-
     </refsection>
-
     <refsection role="see also">
-
         <title>参照</title>
-
         <simplelist type="inline">
-
             <member>
-
+                <link linkend="plot_multiscaled">Multiscaled plots</link>
+            </member>
+            <member>
                 <link linkend="axis_properties">axis_properties</link>
-
             </member>
-
         </simplelist>
-
     </refsection>
-
-</refentry>
-
-
-
+</refentry>
\ No newline at end of file
index aaf689c..affd104 100644 (file)
@@ -117,6 +117,9 @@ title(a_bt, "the exponential");
         <title>Ver Também</title>
         <simplelist type="inline">
             <member>
+                <link linkend="plot_multiscaled">Multiscaled plots</link>
+            </member>
+            <member>
                 <link linkend="subplot">subplot</link>
             </member>
             <member>
index 7660749..62c73c3 100644 (file)
@@ -194,4 +194,15 @@ drawaxis(x=9,y=[2,5,0,3],dir='r',tics='i',sub_int=5);
 drawaxis(x=2:7,y=4,dir='u',tics='v',fontsize=10,textcolor=9,ticscolor=7,seg=0,sub_int=20)
  ]]></programlisting>
     </refsection>
+    <refsection role="see also">
+        <title>Ver Também</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="plot_multiscaled">Multiscaled plots</link>
+            </member>
+            <member>
+                <link linkend="axis_properties">axis_properties</link>
+            </member>
+        </simplelist>
+    </refsection>
 </refentry>
index ecd6f48..1a6f36a 100644 (file)
@@ -968,6 +968,10 @@ plot_6.png=6530b1526ca007d68c095bb76295eade
 plot_7.png=df9a6a6decb537fae8a8adde2304a85a
 plot_8.png=7892b92465386a710d20d0a30cf46304
 plot_9.png=bead04d3923168e8291932e665abffa0
+plot_multiscaled_1.png=139dc4c6fd62728b6f08e4529fc775fa
+plot_multiscaled_2.png=8ea6f9394968a8d02d09e1a66064c718
+plot_multiscaled_3.png=97b20f253d676c6d66fe322172b960ac
+plot_multiscaled_4.png=b30c7820c6e5d9d5e418f1638be429bd
 polarplot_1.png=92b1189dd351372e587b472bad213e09
 polarplot_2.png=7a5f1cd3ef07687170c0de62231a2b5c
 polarplot_3.png=f11a25552a72c4454001c29b97073379
diff --git a/scilab/modules/helptools/images/plot_multiscaled_1.png b/scilab/modules/helptools/images/plot_multiscaled_1.png
new file mode 100644 (file)
index 0000000..70692cf
Binary files /dev/null and b/scilab/modules/helptools/images/plot_multiscaled_1.png differ
diff --git a/scilab/modules/helptools/images/plot_multiscaled_2.png b/scilab/modules/helptools/images/plot_multiscaled_2.png
new file mode 100644 (file)
index 0000000..6a51245
Binary files /dev/null and b/scilab/modules/helptools/images/plot_multiscaled_2.png differ
diff --git a/scilab/modules/helptools/images/plot_multiscaled_3.png b/scilab/modules/helptools/images/plot_multiscaled_3.png
new file mode 100644 (file)
index 0000000..b4eef28
Binary files /dev/null and b/scilab/modules/helptools/images/plot_multiscaled_3.png differ
diff --git a/scilab/modules/helptools/images/plot_multiscaled_4.png b/scilab/modules/helptools/images/plot_multiscaled_4.png
new file mode 100644 (file)
index 0000000..bb08711
Binary files /dev/null and b/scilab/modules/helptools/images/plot_multiscaled_4.png differ