sync with scilab 5.5.0. 39/14439/2
Rui Hirokawa [Sun, 20 Apr 2014 15:23:13 +0000 (00:23 +0900)]
Change-Id: I43c4eedc0f37db8b4fe7b51ea1bb6a22bddfe645

32 files changed:
scilab/modules/api_scilab/help/ja_JP/string/F_freeAllocatedMatrixOfString.xml
scilab/modules/cacsd/help/ja_JP/arhnk.xml
scilab/modules/cacsd/help/ja_JP/arl2.xml
scilab/modules/cacsd/help/ja_JP/armax1.xml
scilab/modules/cacsd/help/ja_JP/ccontrg.xml
scilab/modules/cacsd/help/ja_JP/cls2dls.xml
scilab/modules/cacsd/help/ja_JP/csim.xml
scilab/modules/graphics/help/ja_JP/2d_plot/Matplot.xml
scilab/modules/graphics/help/ja_JP/2d_plot/Matplot_properties.xml
scilab/modules/graphics/help/ja_JP/2d_plot/comet.xml
scilab/modules/graphics/help/ja_JP/2d_plot/grayplot.xml
scilab/modules/graphics/help/ja_JP/3d_plot/milk_drop.xml
scilab/modules/graphics/help/ja_JP/annotation/legend_properties.xml
scilab/modules/graphics/help/ja_JP/axes_operations/axes_properties.xml
scilab/modules/graphics/help/ja_JP/axes_operations/replot.xml
scilab/modules/graphics/help/ja_JP/axis/drawaxis.xml
scilab/modules/graphics/help/ja_JP/datatips/datatipGetStruct.xml
scilab/modules/graphics/help/ja_JP/datatips/datatipSetStruct.xml
scilab/modules/graphics/help/ja_JP/datatips/datatipSetStyle.xml
scilab/modules/graphics/help/ja_JP/figure_operations/clf.xml
scilab/modules/graphics/help/ja_JP/figure_operations/figure_properties.xml
scilab/modules/graphics/help/ja_JP/figure_operations/gcf.xml
scilab/modules/graphics/help/ja_JP/geometric_shapes/arc_properties.xml
scilab/modules/graphics/help/ja_JP/geometric_shapes/rectangle_properties.xml
scilab/modules/graphics/help/ja_JP/geometric_shapes/xarrows.xml
scilab/modules/graphics/help/ja_JP/handle/relocate_handle.xml
scilab/modules/graphics/help/ja_JP/property/set.xml
scilab/modules/graphics/help/ja_JP/segs_properties.xml
scilab/modules/graphics/help/ja_JP/xget.xml
scilab/modules/graphics/help/ja_JP/xgrid.xml
scilab/modules/graphics/help/ja_JP/xset.xml
scilab/modules/graphics/help/ja_JP/xsetm.xml

index 88e8432..cc9d7b6 100644 (file)
                     
                     <para>
                         
-                        freeAllocatedMatrixOfStringで確保されたポインタ"_pstData".
-                        
                         freeAllocatedWideMatrixOfStringで確保されたポインタ"_pwstData".
                         
                     </para>
index 351d58d..9add529 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) INRIA - 
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <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="arhnk">
+    
     <refnamediv>
+        
         <refname>arhnk</refname>
+        
         <refpurpose>ハンケルノルム近似</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼出し手順</title>
+        
         <synopsis>[slm]=arhnk(sl,ord,[tol])</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>sl</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         線形システム (<literal>syslin</literal> リスト)
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>ord</term>
+                
                 <listitem>
+                    
                     <para>整数, 近似の次数</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>tol</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         <literal>equil1</literal>におけるランク近似の閾値
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             行列<literal>[A,B,C,D]</literal>で定義される
+            
             安定な連続時間線形システム<literal>sl</literal>の最適ハンケルノルム近似
+            
             <literal>slm</literal>を計算します.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
 A=diag([-1,-2,-3,-4,-5]);B=rand(5,1);C=rand(1,5);
 sl=syslin('c',A,B,C);
@@ -63,19 +111,36 @@ slapprox=arhnk(sl,2);
 [nk,W]=hankelsv(sl);nk
 [nkred,Wred]=hankelsv(slapprox);nkred
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="equil">equil</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="equil1">equil1</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="hankelsv">hankelsv</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index 451c8c1..45a10fc 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) INRIA - 
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <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="arl2">
+    
     <refnamediv>
+        
         <refname>arl2</refname>
+        
         <refpurpose>L2伝達関数近似による SISO モデル実現</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>h=arl2(y,den0,n [,imp])
+            
             h=arl2(y,den0,n [,imp],'all')
+            
             [den,num,err]=arl2(y,den0,n [,imp])
+            
             [den,num,err]=arl2(y,den0,n [,imp],'all')
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>y</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         <literal>z^-1</literal>の実数ベクトルまたは多項式で, 
+                        
                         有理数システムの(インパルス応答の)フーリエ級数近似の係数を有します.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>den0</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         解の初期推定値を指定する多項式で,
+                        
                         <literal>poly(1,'z','c')</literal>とすることができます.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>n</term>
+                
                 <listitem>
+                    
                     <para>整数, 伝達関数近似の次数 (分母denの次数)</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>imp</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         整数で値は <literal>(0,1,2)</literal>のどれか (冗長モード)
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>h</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         伝達関数 <literal>num/den</literal> または<literal>'all'</literal>
+                        
                         フラグが指定された場合は伝達行列  (列ベクトル) <literal>'all'</literal>.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>den</term>
+                
                 <listitem>
+                    
                     <para>多項式または多項式ベクトル,解の分母</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>num</term>
+                
                 <listitem>
+                    
                     <para>多項式または多項式ベクトル, 解の分子</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>err</term>
+                
                 <listitem>
+                    
                     <para>実数の定数またはベクトル , 各解のL2誤差</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             <literal>[den,num,err]=arl2(y,den0,n [,imp]) </literal> は,
+            
             伝達関数<literal>num/den</literal>が安定で,そのインパルス応答が
+            
             無数のゼロ点で完結すると仮定したベクトル <literal>y</literal> を
+            
             (最小L2ノルムで)近似する
+            
             多項式対<literal>num</literal> および <literal>den</literal>を探します.
+            
         </para>
+        
         <para>
+            
             <literal>y(z)  =  y(1)(1/z)+y(2)(1/z^2)+ ...+ y(ny)(1/z^ny)</literal>の場合,
+            
         </para>
+        
         <para>
+            
             <literal>num/den - y(z)</literal>のL2ノルムは,<literal>err</literal>となります.
+            
         </para>
+        
         <para>
+            
             <literal>n</literal> は多項式 <literal>den</literal>の次数です.
+            
         </para>
+        
         <para>
+            
             伝達関数<literal>num/den</literal>は,有理システムのフーリエ級数のL2近似です.
+            
         </para>
+        
         <para>
+            
             <literal>imp</literal>の設定により様々な中間結果が出力されるようになります.
+            
         </para>
+        
         <para>
+            
             <literal>[den,num,err]=arl2(y,den0,n [,imp],'all') </literal>  は,
+            
             多項式のベクトル<literal>num</literal> および <literal>den</literal>に
+            
             問題のローカル最適解の集合を返します.
+            
             解は誤差について昇順にソートされます.
+            
             この場合, <literal>den0</literal>はすでに
+            
             <literal>poly(1,'z','c')</literal>であると仮定されます.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
 v=ones(1,20);
 clf();
@@ -137,40 +251,78 @@ plot2d1('enn',0,ldiv(n,d,100),5,'000')
 [d,n,e]=arl2(v,poly(1,'z','c'),4,'all')
 plot2d1('enn',0,ldiv(n(1),d(1),100),10,'000')
  ]]></programlisting>
+        
         <scilab:image>
+            
             v=ones(1,20);
+            
             plot2d1('enn',0,[v';zeros(80,1)],2,'051',' ',[1,-0.5,100,1.5])
             
+            
+            
             [d,n,e]=arl2(v,poly(1,'z','c'),1)
+            
             plot2d1('enn',0,ldiv(n,d,100),2,'000')
+            
             [d,n,e]=arl2(v,d,3)
+            
             plot2d1('enn',0,ldiv(n,d,100),3,'000')
+            
             [d,n,e]=arl2(v,d,8)
+            
             plot2d1('enn',0,ldiv(n,d,100),5,'000')
             
+            
+            
             [d,n,e]=arl2(v,poly(1,'z','c'),4,'all')
+            
             plot2d1('enn',0,ldiv(n(1),d(1),100),10,'000')
+            
         </scilab:image>
         
+        
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="ldiv">ldiv</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="imrep2ss">imrep2ss</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="time_id">time_id</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="armax">armax</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="frep2tf">frep2tf</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index 78a04d2..a60b3d7 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) ENPC - JPC
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <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="armax1">
+    
     <refnamediv>
+        
         <refname>armax1</refname>
+        
         <refpurpose>armax 同定</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>[arc,resid]=armax1(r,s,q,y,u [,b0f])</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>y</term>
+                
                 <listitem>
+                    
                     <para>出力信号</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>u</term>
+                
                 <listitem>
+                    
                     <para>入力信号</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>r,s,q</term>
+                
                 <listitem>
+                    
                     <para>自己回帰の次数, ただし, r &gt;=0, s &gt;=-1.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>b0f</term>
+                
                 <listitem>
+                    
                     <para>オプションのパラメータ. 
+                        
                         デフォルト値は 0で,この場合,
+                        
                         係数 b0 を同定する必要があります.
+                        
                         bof=1の場合, b0 は0であると仮定され,同定されません.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>arc</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         "ar"型のtlistおよびフィールド a,  b,  d,  ny,  nu,  sig
+                        
                     </para>
+                    
                     <variablelist>
+                        
                         <varlistentry>
+                            
                             <term>a</term>
+                            
                             <listitem>
+                                
                                 <para>
+                                    
                                     ベクトル <literal>[1,a1,...,a_r]</literal>
+                                    
                                 </para>
+                                
                             </listitem>
+                            
                         </varlistentry>
+                        
                         <varlistentry>
+                            
                             <term>b</term>
+                            
                             <listitem>
+                                
                                 <para>
+                                    
                                     ベクトル <literal>[b0,......,b_s]</literal>
+                                    
                                 </para>
+                                
                             </listitem>
+                            
                         </varlistentry>
+                        
                         <varlistentry>
+                            
                             <term>d</term>
+                            
                             <listitem>
+                                
                                 <para>
+                                    
                                     ベクトル <literal>[1,d1,....,d_q]</literal>
+                                    
                                 </para>
+                                
                             </listitem>
+                            
                         </varlistentry>
+                        
                         <varlistentry>
+                            
                             <term>sig</term>
+                            
                             <listitem>
+                                
                                 <para>  resid=[ sig*echap(1),....,];</para>
+                                
                             </listitem>
+                            
                         </varlistentry>
+                        
                     </variablelist>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             armax1 は1次元のARXプロセスの係数を同定するために使用されます:
+            
         </para>
+        
         <programlisting role=""><![CDATA[ 
 A(z^-1)y= B(z^-1)u + D(z^-1)sig*e(t)
 e(t) is a 1-dimensional white noise with variance 1.
@@ -104,36 +193,94 @@ A(z)= 1+a1*z+...+a_r*z^r; ( r=0 => A(z)=1)
 B(z)= b0+b1*z+...+b_s z^s ( s=-1 => B(z)=0)
 D(z)= 1+d1*z+...+d_q*z^q  ( q=0 => D(z)=1)
  ]]></programlisting>
+        
         <para>
+            
             この手法については,Eykhoffの96ページ,
+            
             "trends and progress in system identification"を参照ください.
+            
         </para>
+        
         <programlisting role=""><![CDATA[ 
 z(t)=[y(t-1),..,y(t-r),u(t),...,
       u(t-s),e(t-1),...,e(t-q)] 
  ]]></programlisting>
+        
         <para>
+            
             および
+            
         </para>
+        
         <programlisting role=""><![CDATA[ 
 coef= [-a1,..,-ar,b0,...,b_s,d1,...,d_q]'
 y(t)= coef'* z(t) + sig*e(t).
  ]]></programlisting>
+        
         <para>
+            
             とすると,
+            
             逐次型のAR推定(RLLS)が使用されます.
+            
             この際, e(t-i)は推定値により置換されます.
+            
             q=0の場合,この手法は逐次型のarmaxに完全に一致します.
+            
         </para>
+        
     </refsection>
+    
+    
+    
     <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[ 
+
+a = [1, -2.851, 2.717, -0.865];
+b = [0, 1, 1, 1];
+d = [1, 0.7, 0.2];
+ar = armac(a, b, d, 1, 1, 1);
+disp(_("Simulation of an ARMAX process:"));
+disp(ar);
+
+n = 300;
+u = -prbs_a(n, 1, int([2.5,5,10,17.5,20,22,27,35]*100/12));
+zd = narsimul(ar, u);
+
+// armax1を使用: 有色ノイズ同定
+// 同じ例を以下のように試すことができます
+[arc1, resid] = armax1(3,3,2,zd(1:n),u,1);
+disp(arc1);
+
+ ]]></programlisting>
+        
+    </refsection>
+    
+    
+    
+    <refsection>
+        
         <title>重要な警告</title>
+        
         <para>バージョン4.1.2までのScilabは,
+            
             <literal>sig</literal>の2乗を戻り値
+            
             <literal>arc.sig</literal>として返していました.
+            
             armaモデルの表示とarmax関数について
+            
             確認し易くするために, Scilabバージョン5.0以降では,
+            
             戻り値<literal>arc.sig</literal>は<literal>sig</literal>となっています.
+            
         </para>
+        
     </refsection>
+    
 </refentry>
+
index fb2159b..0ce9ca2 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) INRIA - P. Gahinet
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <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="ccontrg">
+    
     <refnamediv>
+        
         <refname>ccontrg</refname>
+        
         <refpurpose>H無限大コントローラの中央解</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>[K]=ccontrg(P,r,gamma);</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>P</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         <literal>syslin</literal> リスト (状態空間表現の線形システム)
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>r</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         1x2 行ベクトル, <literal>P</literal>の2,2 区域の次元
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>gamma</term>
+                
                 <listitem>
+                    
                     <para>実数</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             状態空間形式の一般標準問題の中央解であるコントローラの実現 <literal>K</literal> 
+            
             を返します.
+            
         </para>
+        
         <para>
+            
             gamma &gt; gopt (<literal>gamitg</literal>の出力)が必要なことに注意してください 
+            
         </para>
+        
         <para>
+            
             P は,以下のようなプラント実現のパラメータ <literal>(A,B,C,D)</literal>
+            
             (<literal>syslin</literal> リスト)を有します.
+            
         </para>
+        
         <programlisting role=""><![CDATA[ 
 B = ( B1 , B2 ) ,        C= ( C1 ) ,    D = ( D11  D12)
                             ( C2 )          ( D21  D22)
  ]]></programlisting>
+        
         <para>
+            
             <literal>r(1)</literal> および <literal>r(2)</literal> は,
+            
             <literal>D22</literal> の次元(行 x 列)です.
+            
         </para>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="gamitg">gamitg</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="h_inf">h_inf</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revremark>
+                    
+                    <literal>Sl</literal> は連続時間系の線形動的システムであることが確認されるようになりました.
+                    
+                    この修正は,
+                    
+                    <ulink url="http://gitweb.scilab.org/?p=scilab.git;a=commit;h=3d7083daae3339813ba747c8adcda1f9599bb80d">このcommit</ulink>
+                    
+                    により行われました.
+                    
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
 </refentry>
+
index 4299862..9565be1 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) INRIA - 
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <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="cls2dls">
+    
     <refnamediv>
+        
         <refname>cls2dls</refname>
+        
         <refpurpose>双線形変換</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>[sl1]=cls2dls(sl,T [,fp])</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>sl,sl1</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         線形システム (<literal>syslin</literal> リスト)
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>T</term>
+                
                 <listitem>
+                    
                     <para>実数, サンプリング周期</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>fp</term>
+                
                 <listitem>
+                    
                     <para>プリワープ周波数 (単位: Hz) </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             <literal>sl=[A,B,C,D]</literal> (<literal>syslin</literal> リスト),
+            
             連続時間システム
+            
             <literal>cls2dls</literal> は双線形変換<literal>s=(2/T)*(z-1)/(z+1)</literal>
+            
             により得られたサンプル値システムを返します.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
 s=poly(0,'s');z=poly(0,'z');
-sl=syslin('c',(s+1)/(s^2-5*s+2));  //Continuous-time system in transfer form
-slss=tf2ss(sl);  //Now in state-space form
-sl1=cls2dls(slss,0.2);  //sl1= output of cls2dls
-sl1t=ss2tf(sl1) // Converts in transfer form
-sl2=horner(sl,(2/0.2)*(z-1)/(z+1))   //Compare sl2 and sl1
+sl=syslin('c',(s+1)/(s^2-5*s+2));  //連続時間系伝達関数表現
+slss=tf2ss(sl);  //状態空間表現に変換
+sl1=cls2dls(slss,0.2);  //sl1= cls2dlsの出力
+sl1t=ss2tf(sl1) // 伝達関数表現に変換
+sl2=horner(sl,(2/0.2)*(z-1)/(z+1))   //sl2 と sl1を比較
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="horner">horner</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index 6fb9303..9fe021d 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) INRIA - 
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <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="csim">
+    
     <refnamediv>
+        
         <refname>csim</refname>
+        
         <refpurpose>線形システムのシミュレーション (時間応答)</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出しの手順</title>
+        
         <synopsis>[y [,x]]=csim(u,t,sl,[x0 [,tol]])</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>u</term>
+                
                 <listitem>
+                    
                     <para>関数, リストまたは文字列 (制御入力)</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>t</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         時間を指定するための実数ベクトルで、<literal>t(1)</literal> は
+                        
                         初期時間 (<literal>x0=x(t(1))</literal>)を表す.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>sl</term>
+                
                 <listitem>
+                    
                     <para>
-                        リスト (<literal>syslin</literal>)
+                        
+                        連続時間系の<literal>syslin</literal>リスト (SIMO線形システム)
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>y</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         <literal>y=[y(t(i)]</literal>, i=1,..,n となる行列
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>x</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         <literal>x=[x(t(i)]</literal>, i=1,..,n となる行列
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>tol</term>
+                
                 <listitem>
-                    <para>2つの要素 [atol rtol] からなるベクトルであり、それぞれ
+                    
+                    <para>2つの要素 [atol rtol] からなるベクトルであり、それぞれ
+                        
                         ODEソルバ(ode参照)の絶対許容誤差および相対許容誤差を定義する
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
-            線形制御系 <literal>sl</literal>のシミュレーションを行う.
-            <literal>sl</literal>は、
-            <literal>syslin</literal>リストで表された連続時間システムの
-            入力を前提とする.
+            
+            線形制御系 <literal>sl</literal>のシミュレーションを行います.
+            
+            ただし,<literal>sl</literal>は,
+            
+            <literal>syslin</literal>リストで表された連続時間システムとします.
+            
         </para>
+        
         <para>
-            <literal>u</literal> は制御入力、<literal>x0</literal> は状態量初期値である.
+            
+            <literal>u</literal> は制御入力,<literal>x0</literal> は状態量初期値です.
+            
         </para>
+        
         <para>
-            <literal>y</literal> は出力、<literal>x</literal> は状態量である.
+            
+            <literal>y</literal> は出力,<literal>x</literal> は状態量です.
+            
         </para>
+        
         <para>
-            制御入力は以下のいずれかとすることができる:
+            
+            制御入力は以下のいずれかとすることができます:
+            
         </para>
+        
         <para>
+            
             1. 関数 : <literal>[inputs]=u(t)</literal>
+            
         </para>
+        
         <para>
+            
             2. リスト : <literal>list(ut,parameter1,....,parametern)</literal>. 
+            
             ただし、<literal>inputs=ut(t,parameter1,....,parametern)</literal> (<literal>ut</literal> は関数)
+            
         </para>
+        
         <para>
-            3. インパルス応答の計算を表す文字列 <literal>"impuls"</literal> 
-            (ここで、<literal>sl</literal> は直達項を有さず、<literal>x0=0</literal>である
-            SISO系であると仮定)
+            
+            3. インパルス応答の計算を表す文字列 <literal>"impuls"</literal>
+            
+            (ここで,<literal>sl</literal>の入力は単一で<literal>x0=0</literal>が必要).
+            
+            直達項を有する系の場合, t=0における無限インパルスは無視されます.
+            
         </para>
+        
         <para>
+            
             4. ステップ応答の計算を表す文字列 <literal>"step"</literal> 
-            (ここで、<literal>sl</literal> は直達項を有さず、<literal>x0=0</literal>である
-            SISO系であると仮定)
+            
+            (ここで、<literal>sl</literal>の入力は単一で,<literal>x0=0</literal>が必要)
+            
         </para>
+        
         <para>
+            
             5. t の各値に対応する u の値を指定するベクトル.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
-        <programlisting role="example"><![CDATA[ 
-s=poly(0,'s');rand('seed',0);w=ssrand(1,1,3);w('A')=w('A')-2*eye();
+        
+        <programlisting role="example"><![CDATA[
+s=poly(0,'s');
+rand('seed',0);
+w=ssrand(1,1,3);
+w('A')=w('A')-2*eye();
 t=0:0.05:5;
 //impulse(w) = step (s * w)
-clf(0);xset("window",0);show_window();
 plot2d([t',t'],[(csim('step',t,tf2ss(s)*w))',0*t'])
-clf(1);xset("window",1);show_window();
+]]></programlisting>
+        
+        <scilab:image>
+            
+            s=poly(0,'s');
+            
+            rand('seed',0);
+            
+            w=ssrand(1,1,3);
+            
+            w('A')=w('A')-2*eye();
+            
+            t=0:0.05:5;
+            
+            plot2d([t',t'],[(csim('step',t,tf2ss(s)*w))',0*t'])
+            
+        </scilab:image>
+        
+        
+        
+        <programlisting role="example"><![CDATA[
+s=poly(0,'s');
+rand('seed',0);
+w=ssrand(1,1,3);
+w('A')=w('A')-2*eye();
+t=0:0.05:5;
 plot2d([t',t'],[(csim('impulse',t,w))',0*t'])
+]]></programlisting>
+        
+        <scilab:image>
+            
+            s=poly(0,'s');
+            
+            rand('seed',0);
+            
+            w=ssrand(1,1,3);
+            
+            w('A')=w('A')-2*eye();
+            
+            t=0:0.05:5;
+            
+            plot2d([t',t'],[(csim('impulse',t,w))',0*t'])
+            
+        </scilab:image>
+        
+        <programlisting role="example"><![CDATA[
+s=poly(0,'s');
+rand('seed',0);
+w=ssrand(1,1,3);
+w('A')=w('A')-2*eye();
+t=0:0.05:5;
 //step(w) = impulse (s^-1 * w)
-clf(3);xset("window",3);show_window();
 plot2d([t',t'],[(csim('step',t,w))',0*t'])
-clf(4);xset("window",4);show_window();
+]]></programlisting>
+        
+        <scilab:image>
+            
+            s=poly(0,'s');
+            
+            rand('seed',0);
+            
+            w=ssrand(1,1,3);
+            
+            w('A')=w('A')-2*eye();
+            
+            t=0:0.05:5;
+            
+            plot2d([t',t'],[(csim('step',t,w))',0*t'])
+            
+        </scilab:image>
+        
+        <programlisting role="example"><![CDATA[
+s=poly(0,'s');
+rand('seed',0);
+w=ssrand(1,1,3);
+w('A')=w('A')-2*eye();
+t=0:0.05:5;
 plot2d([t',t'],[(csim('impulse',t,tf2ss(1/s)*w))',0*t'])
-
+]]></programlisting>
+        
+        <scilab:image>
+            
+            s=poly(0,'s');
+            
+            rand('seed',0);
+            
+            w=ssrand(1,1,3);
+            
+            w('A')=w('A')-2*eye();
+            
+            t=0:0.05:5;
+            
+            plot2d([t',t'],[(csim('impulse',t,tf2ss(1/s)*w))',0*t'])
+            
+            
+            
+        </scilab:image>
+        
+        <programlisting role="example"><![CDATA[
+s=poly(0,'s');
+rand('seed',0);
+w=ssrand(1,1,3);
+w('A')=w('A')-2*eye();
+t=0:0.05:5;
 //input defined by a time function
-deff('u=input(t)','u=abs(sin(t))')
-clf();plot2d([t',t'],[(csim(input,t,w))',0*t'])
+deff('u=timefun(t)','u=abs(sin(t))')
+clf();plot2d([t',t'],[(csim(timefun,t,w))',0*t'])
 ]]></programlisting>
+        
+        <scilab:image>
+            
+            s=poly(0,'s');
+            
+            rand('seed',0);
+            
+            w=ssrand(1,1,3);
+            
+            w('A')=w('A')-2*eye();
+            
+            t=0:0.05:5;
+            
+            deff('u=timefun(t)','u=abs(sin(t))')
+            
+            clf();plot2d([t',t'],[(csim(timefun,t,w))',0*t'])
+            
+        </scilab:image>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="syslin">syslin</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="dsimul">dsimul</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="flts">flts</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="ltitr">ltitr</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="rtitr">rtitr</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="ode">ode</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="impl">impl</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index e6f124d..d488635 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) ENPC - Jean-Philippe Chancelier
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <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="Matplot">
+    
     <refnamediv>
+        
         <refname>Matplot</refname>
+        
         <refpurpose>行列のカラー二次元プロット</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
-        <synopsis>Matplot(a,[strf,rect,nax])
+        
+        <synopsis>
+            
+            Matplot(a,[strf,rect,nax])
+            
             Matplot(a,&lt;opt_args&gt;)
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
+        
         <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>a</term>
+                
                 <listitem>
-                    <para>大きさ (n1,n2)の実数行列.</para>
+                    
+                    <para>
+                        
+                        大きさ (<literal>n1</literal>, <literal>n2</literal>)
+                        
+                        の実数行列.
+                        
+                    </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>&lt;opt_args&gt;</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         一連の命令<literal>key1=value1,
+                            
                             key2=value2
+                            
                         </literal>
+                        
                         ,... を表し,<literal>key1</literal>,
+                        
                         <literal>key2,...</literal> には以下のどれかを指定できます:
+                        
                     </para>
+                    
                     <variablelist>
+                        
                         <varlistentry>
+                            
                             <term>rect</term>
+                            
                             <listitem>
+                                
                                 <para>
+                                    
                                     プロットの境界を設定します.
+                                    
                                     このキーが指定され,<literal>frameflag</literal> および <literal>strf</literal>
+                                    
                                     のどちらも指定されない場合,<literal>strf</literal> の文字<literal>y</literal>
+                                    
                                     は<literal>7</literal>に設定されます.
+                                    
                                     値については以下を参照ください.
+                                    
                                 </para>
+                                
                             </listitem>
+                            
                         </varlistentry>
+                        
                         <varlistentry>
+                            
                             <term>nax</term>
+                            
                             <listitem>
+                                
                                 <para>グリッドの定義を設定します.このキーが指定され,
+                                    
                                     <literal>axesflag</literal>および<literal>strf</literal>のどちらも指定されない場合,
+                                    
                                     <literal>strf</literal>の文字 <literal>z</literal>が
+                                    
                                     <literal>1</literal>に設定されます.値については以下を参照ください.
+                                    
                                 </para>
+                                
                             </listitem>
+                            
                         </varlistentry>
+                        
                         <varlistentry>
+                            
                             <term>frameflag</term>
+                            
                             <listitem>
+                                
                                 <para>プロットのフレームの計算方法を指定します.
+                                    
                                     この値は 0 から 8の整数です.<literal>strf</literal>の文字
+                                    
                                     <literal>y</literal>に対応します.以下を参照ください.
+                                    
                                 </para>
+                                
                             </listitem>
+                            
                         </varlistentry>
+                        
                         <varlistentry>
+                            
                             <term>axesflag</term>
+                            
                             <listitem>
+                                
                                 <para>プロットの周囲に描画される軸の種類を指定します.
+                                    
                                     この値は 0 から 5の整数です.<literal>strf</literal>の文字
+                                    
                                     <literal>z</literal>に対応します.以下を参照ください.
+                                    
                                 </para>
+                                
                             </listitem>
+                            
                         </varlistentry>
+                        
                     </variablelist>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>strf</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         長さ3の文字列 <literal>"xyz"</literal>です.
+                        
                     </para>
+                    
                     <variablelist>
+                        
                         <varlistentry>
+                            
                             <term>default</term>
+                            
                             <listitem>
+                                
                                 <para>
+                                    
                                     デフォルトは <literal>"081"</literal>です.
+                                    
                                 </para>
+                                
                             </listitem>
+                            
                         </varlistentry>
+                        
                         <varlistentry>
+                            
                             <term>x</term>
+                            
                             <listitem>
+                                
                                 <para>キャプションの表示を制御します.</para>
+                                
                                 <variablelist>
+                                    
                                     <varlistentry>
+                                        
                                         <term>x=0</term>
+                                        
                                         <listitem>
+                                            
                                             <para>キャプションなし.</para>
+                                            
                                         </listitem>
+                                        
                                     </varlistentry>
+                                    
                                     <varlistentry>
+                                        
                                         <term>x=1</term>
+                                        
                                         <listitem>
+                                            
                                             <para>キャプションが表示されます.
+                                                
                                                 これらはオプションの引数<literal>leg</literal>で指定されます.
+                                                
                                             </para>
+                                            
                                         </listitem>
+                                        
                                     </varlistentry>
+                                    
                                 </variablelist>
+                                
                             </listitem>
+                            
                         </varlistentry>
+                        
                         <varlistentry>
+                            
                             <term>y</term>
+                            
                             <listitem>
+                                
                                 <para>
+                                    
                                     指定された値に関する最小限の範囲をカバーする実際の座標を
+                                    
                                     計算する手法を制御します.
+                                    
                                     実際の範囲は必要最小限の値よりも大きくすることができます.
+                                    
                                 </para>
+                                
                                 <variablelist>
+                                    
                                     <varlistentry>
+                                        
                                         <term>y=0</term>
+                                        
                                         <listitem>
+                                            
                                             <para>計算せずにプロットは前(またはデフォルト)のスケールを使用します</para>
+                                            
                                         </listitem>
+                                        
                                     </varlistentry>
+                                    
                                     <varlistentry>
+                                        
                                         <term>y=1</term>
+                                        
                                         <listitem>
+                                            
                                             <para>rect引数による</para>
+                                            
                                         </listitem>
+                                        
                                     </varlistentry>
+                                    
                                     <varlistentry>
+                                        
                                         <term>y=2</term>
+                                        
                                         <listitem>
+                                            
                                             <para>x, yデータの最小値/最大値による</para>
+                                            
                                         </listitem>
+                                        
                                     </varlistentry>
+                                    
                                     <varlistentry>
+                                        
                                         <term>y=3</term>
+                                        
                                         <listitem>
+                                            
                                             <para>rect引数に基づき等軸スケールで設定</para>
+                                            
                                         </listitem>
+                                        
                                     </varlistentry>
+                                    
                                     <varlistentry>
+                                        
                                         <term>y=4</term>
+                                        
                                         <listitem>
+                                            
                                             <para>x, yデータの最小値/最大値に基づき等軸スケールで設定</para>
+                                            
                                         </listitem>
+                                        
                                     </varlistentry>
+                                    
                                     <varlistentry>
+                                        
                                         <term>y=5</term>
+                                        
                                         <listitem>
+                                            
                                             <para>rect引数の設定値から見栄えが良くなるよう軸を拡大</para>
+                                            
                                         </listitem>
+                                        
                                     </varlistentry>
+                                    
                                     <varlistentry>
+                                        
                                         <term>y=6</term>
+                                        
                                         <listitem>
+                                            
                                             <para>x, yデータの最小値/最大値に基づく設定から見栄えが良くなるよう
+                                                
                                                 軸を拡大
+                                                
                                             </para>
+                                            
                                         </listitem>
+                                        
                                     </varlistentry>
+                                    
                                     <varlistentry>
+                                        
                                         <term>y=7</term>
+                                        
                                         <listitem>
+                                            
                                             <para>y=1 と似ていますが, 前のプロットは新しいスケールを使用して
+                                                
                                                 再描画させます
+                                                
                                             </para>
+                                            
                                         </listitem>
+                                        
                                     </varlistentry>
+                                    
                                     <varlistentry>
+                                        
                                         <term>y=8</term>
+                                        
                                         <listitem>
+                                            
                                             <para>y=2と似ていますが,前のプロットが新しいスケールを
+                                                
                                                 用いて再描画されます.
+                                                
                                             </para>
+                                            
                                         </listitem>
+                                        
                                     </varlistentry>
+                                    
                                 </variablelist>
+                                
                             </listitem>
+                            
                         </varlistentry>
+                        
                         <varlistentry>
+                            
                             <term>z</term>
+                            
                             <listitem>
+                                
                                 <para>プロットの周囲のフレームへの情報の表示を制御します.
+                                    
                                     軸が指定された場合,目盛の数をオプションの引数
+                                    
                                     <literal>nax</literal>により指定できます.
+                                    
                                 </para>
+                                
                                 <variablelist>
+                                    
                                     <varlistentry>
+                                        
                                         <term>z=0</term>
+                                        
                                         <listitem>
+                                            
                                             <para>プロットの周囲に何も描画されません.</para>
+                                            
                                         </listitem>
+                                        
                                     </varlistentry>
+                                    
                                     <varlistentry>
+                                        
                                         <term>z=1</term>
+                                        
                                         <listitem>
+                                            
                                             <para>軸が描画され, y軸が左に表示されます.</para>
+                                            
                                         </listitem>
+                                        
                                     </varlistentry>
+                                    
                                     <varlistentry>
+                                        
                                         <term>z=2</term>
+                                        
                                         <listitem>
+                                            
                                             <para>プロットが目盛のない箱で囲われます.</para>
+                                            
                                         </listitem>
+                                        
                                     </varlistentry>
+                                    
                                     <varlistentry>
+                                        
                                         <term>z=3</term>
+                                        
                                         <listitem>
+                                            
                                             <para>軸が描画され,y軸が右側に表示されます.</para>
+                                            
                                         </listitem>
+                                        
                                     </varlistentry>
+                                    
                                     <varlistentry>
+                                        
                                         <term>z=4</term>
+                                        
                                         <listitem>
+                                            
                                             <para>
+                                                
                                                 フレームボックスの中央に軸が描画され,ボックスは無効になります.
+                                                
                                             </para>
+                                            
                                         </listitem>
+                                        
                                     </varlistentry>
+                                    
                                     <varlistentry>
+                                        
                                         <term>z=5</term>
+                                        
                                         <listitem>
+                                            
                                             <para>
+                                                
                                                 フレームボックスの中央に軸が描画され,ボックスは有効となります.
+                                                
                                             </para>
+                                            
                                         </listitem>
+                                        
                                     </varlistentry>
+                                    
                                 </variablelist>
+                                
                             </listitem>
+                            
                         </varlistentry>
+                        
                     </variablelist>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>rect</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         この引数は引数<literal>strf</literal>の2文字目のyが1, 3または5の時に
+                        
                         使用されます.
+                        
                         この値は大きさ4の行ベクトルで,フレームの次元を指定します:
+                        
                         <literal>rect=[xmin,ymin,xmax,ymax]</literal>.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>nax</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         この引数は引数<literal>strf</literal>の3文字目のzが1の場合に
+                        
                         使用されます.
+                        
                         この値は4つのエントリ<literal>[nx,Nx,ny,Ny]</literal>を有する
+                        
                         行ベクトルです.
+                        
                         ただし,<literal>nx</literal> (<literal>ny</literal>)
+                        
                         は x (y) 軸のサブグラデーションの数,
+                        
                         <literal>Nx</literal> (<literal>Ny</literal>) はx (y) 軸のグラデーションの数です.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             行列のエントリ<literal>int(a)</literal>がカレントのカラーマップにおける
+            
             カラーマップのエントリとして使用されます.
+            
             <literal>a(i,j)</literal>が指す色が位置<literal>(x=j,y=(n1-i+1))</literal>
+            
             を中心とする大きさ1の小さな正方領域を描画する際に使用されます.
+            
             行列のエントリがカラーマップの外側の場合,
-            対応する矩形は表示されません..
+            
+            対応する矩形は表示されません.
+            
+        </para>
+        
+        <para>
+            
+            <warning>
+                
+                Matplotデータを更新する際には, 対応するハンドルの
+                
+                <literal>data</literal> フィールドを使用します.
+                
+            </warning>
+            
+            <literal>data</literal> は行列(またはハイパー行列)で,
+            
+            RGB, RGBA, ... データを有します 
+            
+            (<link linkend="Matplot_properties">Matplot_properties</link>参照).
+            
         </para>
+        
         <para>
+            
             コマンド <literal>Matplot()</literal> を入力するとデモが表示されます.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
+        <programlisting role="example"><![CDATA[ 
+Matplot([1 2 3;4 5 6])
+ ]]></programlisting>
+        
         <scilab:image>
+            
             Matplot([1 2 3;4 5 6])
+            
         </scilab:image>
-    </refsection>
-    <refsection>
-        <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
-Matplot([1 2 3;4 5 6])
 clf()
-// カレントのカラーマップを表示
+// カレントのカラーマップを描画
 Matplot((1:xget("lastpattern")))
  ]]></programlisting>
+        
+        <scilab:image>
+            
+            Matplot((1:xget("lastpattern")))
+            
+        </scilab:image>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="colormap">colormap</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="plot2d">plot2d</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="Matplot1">Matplot1</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="Matplot_properties">Matplot_properties</link>
+                
             </member>
+            
         </simplelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.5.0</revnumber>
+                
+                <revremark>
+                    
+                    <literal>data</literal> は行列(またはハイパー行列)となり,
+                    
+                    RGB, RGBA, ... データを有するようになりました
+                    
+                    (<link linkend="Matplot_properties">Matplot_properties</link>参照).
+                    
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
     </refsection>
+    
 </refentry>
+
index 05f0e61..b0dc1f5 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) INRIA - Fabrice Leray
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <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="Matplot_properties">
+    
     <refnamediv>
+        
         <refname>Matplot_properties</refname>
+        
         <refpurpose>Matplotエンティティプロパティの説明</refpurpose>
+        
     </refnamediv>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>Matplotエンティティはグラフィックエンティティ階層の葉です.
+            
             このエンティティは,曲面および画像の2次元プロットを表します
+            
             (
+            
             <literal>Matplot</literal> および <literal>Matplot1</literal>参照).
+            
         </para>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>parent: </term>
+                
                 <listitem>
+                    
                     <para>このプロパティは親のハンドルを有します.
+                        
                         Matplotエンティティの親は <literal>"Axes"</literal>型となります.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>children: </term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         このプロパティにはハンドルの<literal>children</literal>
+                        
                         のベクトルが含まれます.
+                        
                         しかし,現在,<literal>Matplot</literal>には<literal>children</literal>
+                        
                         がありません.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>visible: </term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         このフィールドにはエンティティの<literal>visible</literal>
+                        
                         プロパティの値が含まれます.
+                        
                         この値は,<literal>"on" </literal> または <literal>"off"</literal> となります.
+                        
                         デフォルトでプロットは可視であり,このプロパティの値は
+                        
                         <literal>"on"</literal>となります. <literal>"off"</literal>の場合,プロットは
+                        
                         画面に描画されません.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>data: </term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         このフィールドは[<literal>m</literal>x<literal>n</literal>]のデータ行列
+                        
                         <literal>color</literal>をカレントのカラーマップに基づき定義します.
+                        
                         位置<literal>(x=j,y=(m-i+1))</literal>を中心とする長さ1の小さな正方形を
+                        
                         描画する際には<literal>color(i,j)</literal>が指す色が使用されます.
+                        
                     </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>rect: </term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        このフィールドは<literal>[xmin, ymin, xmax, ymax]</literal>で
+                        
+                        定義される行ベクトルを保持します.
+                        
+                        このフィールドはカレントのスケールで矩形を定義し,
+                        
+                        この矩形内に行列が描画されます.
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>image_type: </term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        このフィールドは画像の型を定義します. 
+                        
+                        値は以下のどれかを指定します:
+                        
+                        "rgb", "rgba", "gray", "index",
+                        
+                        "red", "green", "blue", "rgb332", "rgb444", "rgb555", "rgba5551", "argb".
+                        
+                    </para>
+                    
+                    <para>
+                        
+                        色はデータ型と image_type により以下のように定義されます:
+                        
+                    </para>
+                    
+                    <itemizedlist>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                image_type が index の場合, 
+                                
+                                データはカラーマップの添字とみなされます.
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                image_typeがrgbの場合, int8またはuint8のハイパー行列はRGB要素,
+                                
+                                doubleのハイパー行列は正規化されたRGB要素(値は0と1の間),
+                                
+                                int8またはuint8の行列(ただし,行数は3の倍数)はRGB要素,
+                                
+                                int32の行列はRGBカラー,
+                                
+                                uint32の行列はRGBAカラー(ただし,アルファチャネルは0xFFに設定)
+                                
+                                を指定します.
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                image_typeがrgbaの場合, int8またはuint8のハイパー行列はRGBA要素,
+                                
+                                doubleのハイパー行列は正規化されたRGBA要素(値は0と1の間),
+                                
+                                int8またはuint8の行列(ただし,行数は4の倍数)はRGBA要素,
+                                
+                                int32の行列はRGBAカラー,
+                                
+                                uint32の行列はRGBAカラー
+                                
+                                を指定します.
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                image_typeがgrayの場合, int8またはuint8の行列は
+                                
+                                グレーレベルカラー(R-G-B=GRAY-GRAY-GRAY)となります.
+                                
+                                その他の型の場合, data はRGBカラーとみなされ,
+                                
+                                グレーカラーに変換されます (0.299*R+0.587*G+0.114*B).
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                image_typeがredの場合, int8またはuint8の行列は
+                                
+                                レッドレベルカラー(R-G-B=REG-00-00)となります.
+                                
+                                その他の型の場合, data はRGBカラーとみなされ,
+                                
+                                レッドカラーに変換されます(赤要素を保持するマスクが適用されます).
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                image_typeがredの場合, int8またはuint8の行列は
+                                
+                                グリーンレベルカラー(R-G-B=00-GREEN-00)となります.
+                                
+                                その他の型の場合, data はRGBカラーとみなされ,
+                                
+                                グリーンカラーに変換されます(緑要素を保持するマスクが適用されます).
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                image_typeがblueの場合, int8またはuint8の行列は
+                                
+                                ブルーレベルカラー(R-G-B=00-00-BLUE)となります.
+                                
+                                その他の型の場合, data はRGBカラーとみなされ,
+                                
+                                ブルーカラーに変換されます(青要素を保持するマスクが適用されます).
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                image_typeがrgb332の場合, int8 または uint8 の行列は
+                                
+                                RGBカラーを指定します.
+                                
+                                ただし,R要素を3ビット,G要素を3ビット,B要素を2ビットで指定します.
+                                
+                                その他のデータ型の場合,
+                                
+                                RGB (8-8-8) データが RGB (3-3-2)に変換されます.
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                image_typeがrgb444の場合, int8 または uint8 の行列は
+                                
+                                RGBカラーを指定します.
+                                
+                                ただし,各要素は4ビットです.
+                                
+                                その他のデータ型の場合,
+                                
+                                RGB (8-8-8) データが RGB (4-4-4)に変換されます.
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                image_typeがrgb555の場合, int16 または uint16 の行列は
+                                
+                                RGBカラーを指定します.
+                                
+                                ただし,各要素は5ビットです.
+                                
+                                その他のデータ型の場合,
+                                
+                                RGB (8-8-8) データが RGB (5-5-5)に変換されます.
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                image_typeがrgb4444の場合, int16 または uint16 の行列は
+                                
+                                RGBAカラーを指定します.
+                                
+                                ただし,各要素は4ビットです.
+                                
+                                その他のデータ型の場合,
+                                
+                                RGBA (8-8-8-8) データが RGBA (4-4-4-4)に変換されます.
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                image_typeがrgb5551の場合, int16 または uint16 の行列は
+                                
+                                RGBAカラーを指定します.
+                                
+                                ただし,アルファチャネル以外の要素は5ビット,
+                                
+                                アルファチャネルは1ビットです.
+                                
+                                その他のデータ型の場合,
+                                
+                                RGBA (8-8-8-8) データが RGBA (5-5-5-1)に変換されます.
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                image_typeがargbの場合, int8 または uint8 のハイパー行列は
+                                
+                                ARGB要素,
+                                
+                                doubleのハイパー行列は正規化されたARGB要素(値は0と1の間),
+                                
+                                int8またはuint8の行列(ただし行数は4の倍数)はRGB要素,
+                                
+                                int32の行列はARGBカラー,uint32の行列はARGBカラーを指定します.
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                    </itemizedlist>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>clip_state: </term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         このフィールドにはMatplotの<literal>clip_state</literal>
+                        
                         プロパティの値が含まれます. 値は以下となります :
+                        
                     </para>
+                    
                     <itemizedlist>
+                        
                         <listitem>
+                            
                             <para>
+                                
                                 <literal>"off"</literal> Matplot はクリップされません.
+                                
                             </para>
+                            
                         </listitem>
+                        
                         <listitem>
+                            
                             <para>
+                                
                                 <literal>"clipgrf"</literal> 
+                                
                                 Matplot は軸ボックスの外側でクリップされます.
+                                
                             </para>
+                            
                         </listitem>
+                        
                         <listitem>
+                            
                             <para>
+                                
                                 <literal>"on"</literal>
-                                Matplot はclip_boxで指定された矩形の外側でクリップされます.
+                                
+                                Matplot は<literal>clip_box</literal>
+                                
+                                で指定された矩形の外側でクリップされます.
+                                
                             </para>
+                            
                         </listitem>
+                        
                     </itemizedlist>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>clip_box: </term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         このフィールドは<literal>clip_box</literal>プロパティを定義します.
+                        
                         デフォルトで,この値はclip_stateが"off"の場合に空の行列となります.
+                        
                         その他の場合,ベクトル<literal>[x,y,w,h]</literal> 
-                        (左上の点,幅,高さ)がMatplotが表示する範囲を定義しますが,
-                        <literal>clip_state</literal>プロパティの値は変更されません.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>user_data: </term>
-                <listitem>
-                    <para>このフィールドは任意のScilab変数をMatplotデータ構造体に
-                        保存し,復元する際に使用可能です.
-                    </para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-    </refsection>
-    <refsection>
-        <title>例</title>
-        <programlisting role="example"><![CDATA[ 
+                        
+                        (左上の点,幅,高さ)がliteral>Matplot
+                    </literal>
+                    
+                    が表示する範囲を定義しますが,
+                    
+                    <literal>clip_state</literal>プロパティの値は変更されません.
+                    
+                </para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>user_data: </term>
+            
+            <listitem>
+                
+                <para>
+                    
+                    このフィールドは任意のScilab変数を<literal>Matplot</literal>
+                    
+                    データ構造体に保存し,復元する際に使用可能です.
+                    
+                </para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+    </variablelist>
+    
+</refsection>
+
+<refsection>
+    
+    <title>例</title>
+    
+    <programlisting role="example"><![CDATA[ 
 Matplot((1:xget("lastpattern")))
 e=gce(); // カレントのエンティティを取得
 
 e.data=e.data($:-1:1) // 逆順
  ]]></programlisting>
-    </refsection>
-    <refsection role="see also">
-        <title>参照</title>
-        <simplelist type="inline">
-            <member>
-                <link linkend="set">set</link>
-            </member>
-            <member>
-                <link linkend="get">get</link>
-            </member>
-            <member>
-                <link linkend="delete">delete</link>
-            </member>
-            <member>
-                <link linkend="grayplot">grayplot</link>
-            </member>
-            <member>
-                <link linkend="Matplot">Matplot</link>
-            </member>
-            <member>
-                <link linkend="Matplot1">Matplot1</link>
-            </member>
-            <member>
-                <link linkend="graphics_entities">graphics_entities</link>
-            </member>
-            <member>
-                <link linkend="grayplot_properties">grayplot_properties</link>
-            </member>
-        </simplelist>
-    </refsection>
+    
+    <scilab:image>
+        
+        Matplot((1:xget("lastpattern")));
+        
+        e=gce();
+        
+        e.data=e.data($:-1:1);
+        
+    </scilab:image>
+    
+</refsection>
+
+<refsection role="see also">
+    
+    <title>参照</title>
+    
+    <simplelist type="inline">
+        
+        <member>
+            
+            <link linkend="set">set</link>
+            
+        </member>
+        
+        <member>
+            
+            <link linkend="get">get</link>
+            
+        </member>
+        
+        <member>
+            
+            <link linkend="delete">delete</link>
+            
+        </member>
+        
+        <member>
+            
+            <link linkend="grayplot">grayplot</link>
+            
+        </member>
+        
+        <member>
+            
+            <link linkend="Matplot">Matplot</link>
+            
+        </member>
+        
+        <member>
+            
+            <link linkend="Matplot1">Matplot1</link>
+            
+        </member>
+        
+        <member>
+            
+            <link linkend="graphics_entities">graphics_entities</link>
+            
+        </member>
+        
+        <member>
+            
+            <link linkend="grayplot_properties">grayplot_properties</link>
+            
+        </member>
+        
+    </simplelist>
+    
+</refsection>
+
+<refsection>
+    
+    <title>履歴</title>
+    
+    <revhistory>
+        
+        <revision>
+            
+            <revnumber>5.5.0</revnumber>
+            
+            <revremark>
+                
+                <itemizedlist>
+                    
+                    <listitem>
+                        
+                        プロパティ <literal>image_type</literal>が導入されました.
+                        
+                    </listitem>
+                    
+                    <listitem>
+                        
+                        プロパティ <literal>rect</literal>が導入されました.
+                        
+                    </listitem>
+                    
+                </itemizedlist>
+                
+            </revremark>
+            
+        </revision>
+        
+    </revhistory>
+    
+</refsection>
+
 </refentry>
+
index e6b701c..96426a5 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) Serge Steer
  * are also available at    
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
 -->
+
 <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="comet">
-    <refnamediv>
-        <refname>comet</refname>
-        <refpurpose>2次元 comet アニメーションプロット. </refpurpose>
-    </refnamediv>
-    <refsynopsisdiv>
-        <title>呼び出し手順</title>
-        <synopsis>comet(y)</synopsis>
-        <synopsis>comet(x,y)</synopsis>
-        <synopsis>comet(x,fun)</synopsis>
-        <synopsis>comet(x,y,p)</synopsis>
-        <synopsis>comet(x,fun,p)</synopsis>
-        <synopsis>comet(...,"colors",c)</synopsis>
-    </refsynopsisdiv>
-    <refsection>
-        <title>パラメータ</title>
+
+<refnamediv>
+    
+    <refname>comet</refname>
+    
+    <refpurpose>2次元 comet アニメーションプロット. </refpurpose>
+    
+</refnamediv>
+
+<refsynopsisdiv>
+    
+    <title>呼び出し手順</title>
+    
+    <synopsis>comet(y)</synopsis>
+    
+    <synopsis>comet(x,y)</synopsis>
+    
+    <synopsis>comet(x,fun)</synopsis>
+    
+    <synopsis>comet(x,y,p)</synopsis>
+    
+    <synopsis>comet(x,fun,p)</synopsis>
+    
+    <synopsis>comet(...,"colors",c)</synopsis>
+    
+</refsynopsisdiv>
+
+<refsection>
+    
+    <title>パラメータ</title>
+    
+    <variablelist>
+        
+        <varlistentry>
+            
+            <term>x</term>
+            
+            <listitem>
+                
+                <para>
+                    
+                    実数ベクトルまたは行列. 省略された場合,
+                    
+                    ベクトル <literal>1:ny</literal> が指定されたと仮定されます.
+                    
+                    ただし,<literal>ny</literal> は曲線の点の数(下記参照)です.
+                    
+                </para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>y</term>
+            
+            <listitem>
+                
+                <para>
+                    
+                    長さの実数ベクトルまたは行列.
+                    
+                </para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>p</term>
+            
+            <listitem>
+                
+                <para>
+                    
+                    範囲 <literal>[0 1[</literal> の実数スカラー.
+                    
+                    デフォルト値は 0.1です.
+                    
+                </para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>fun</term>
+            
+            <listitem>
+                
+                <para>
+                    
+                    呼び出し手順  <literal>y=fun(x)</literal> のScilab関数.
+                    
+                    <varname>fun</varname> は多項式または有理数とすることもできます.
+                    
+                </para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>c</term>
+            
+            <listitem>
+                
+                <para>
+                    
+                    <literal>ny</literal> 色添字のベクトル.
+                    
+                </para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+    </variablelist>
+    
+</refsection>
+
+<refsection>
+    
+    <title>説明</title>
+    
+    <para>
+        
+        <literal>(x,y)</literal> が同じ要素数のベクトルの場合,
+        
+        この関数は,
+        
+        <literal>k</literal>を<literal>1</literal> から
+        
+        <literal>size(x,'*')</literal>まで変えて
+        
+        曲線<literal>(x(1:k),y(1:k))</literal>の漸進を示す
+        
+        2次元アニメーションプロットを描画します.
+        
+    </para>
+    
+    <para>
+        
+        このプロットは以下の3つの部分から構成されます:
+        
         <variablelist>
+            
             <varlistentry>
-                <term>x</term>
-                <listitem>
-                    <para>
-                        実数ベクトルまたは行列. 省略された場合,
-                        ベクトル <literal>1:ny</literal> が指定されたと仮定されます.
-                        ただし,<literal>ny</literal> は曲線の点の数(下記参照)です.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>y</term>
-                <listitem>
-                    <para>
-                        長さの実数ベクトルまたは行列.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>p</term>
+                
+                <term>ヘッド</term> 
+                
                 <listitem>
-                    <para>
-                        範囲 <literal>[0 1[</literal> の実数スカラー.
-                        デフォルト値は 0.1です.
+                    
+                    <para>                        
+                        
+                        カレントの位置<literal>(x(i),y(i))</literal>を示すマーカ.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
-                <term>fun</term>
+                
+                <term>ボディ</term>
+                
                 <listitem>
-                    <para>
-                        呼び出し手順  <literal>y=fun(x)</literal> のScilab関数.
-                        <varname>fun</varname> は多項式または有理数とすることもできます.
+                    
+                    <para> 
+                        
+                        ヘッドにつらなる曲線を表示します:曲線の一部
+                        
+                        <literal>(x(i-k:i),y(i-k:i))</literal>.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
-                <term>c</term>
+                
+                <term>テール</term>
+                
                 <listitem>
+                    
                     <para>
-                        <literal>ny</literal> 色添字のベクトル.
+                        
+                        曲線の<literal>(x(1:i-k),y(1:i-k))</literal>の部分を表示.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
-    </refsection>
-    <refsection>
-        <title>説明</title>
+        
         <para>
-            <literal>(x,y)</literal> が同じ要素数のベクトルの場合,
-            この関数は,
-            <literal>k</literal>を<literal>1</literal> から
-            <literal>size(x,'*')</literal>まで変えて
-            曲線<literal>(x(1:k),y(1:k))</literal>の漸進を示す
-            2次元アニメーションプロットを描画します.
+            
+            <literal>comet(x,fun,...)</literal>  は, <literal>comet(x,feval(x,fun),...)</literal> と等価です.
+            
         </para>
+        
         <para>
-            このプロットは以下の3つの部分から構成されます:
-            <variablelist>
-                <varlistentry>
-                    <term>ヘッド</term> 
-                    <listitem>
-                        <para>                        
-                            カレントの位置<literal>(x(i),y(i))</literal>を示すマーカ.
-                        </para>
-                    </listitem>
-                </varlistentry>
-                <varlistentry>
-                    <term>ボディ</term>
-                    <listitem>
-                        <para> 
-                            ヘッドにつらなる曲線を表示します:曲線の一部
-                            <literal>(x(i-k:i),y(i-k:i))</literal>.
-                        </para>
-                    </listitem>
-                </varlistentry>
-                <varlistentry>
-                    <term>テール</term>
-                    <listitem>
-                        <para>
-                            曲線の<literal>(x(1:i-k),y(1:i-k))</literal>の部分を表示.
-                        </para>
-                    </listitem>
-                </varlistentry>
-            </variablelist>
-            <para>
-                <literal>comet(x,fun,...)</literal>  は, <literal>comet(x,feval(x,fun),...)</literal> と等価です.
-            </para>
-            <para>
-                <literal>comet(...,p)</literal> はボディの相対的な長さを設定する
-                際に使用することができます.
-                <literal>k</literal> は
-                <literal>k = round(p*ny)</literal>のように定義できます.
-            </para>
-            <para>
-                <varname>y</varname> が行列の場合,
-                曲線のアニメーション表示は,
-                <literal>(x,y(:,l))</literal>の各組について描画されます.
-                この場合, <literal>ny</literal> は<varname>y</varname>の
-                行の数です.
-            </para>
-            <para>
-                <varname>x</varname> および <varname>y</varname> は
-                同じ大きさの行列の場合,
-                各組  <literal>(x(:,l),y(:,l))</literal> 毎に.
-                アニメーション表示された曲線が描画されます.
-                この場合, <literal>ny</literal>は
-                <varname>x</varname>および  <varname>y</varname>の
-                行の数です.
-            </para>
-            
-            <para>
-                <literal>comet(...,"colors",c)</literal> は
-                各曲線の色を設定する際に私用できます.
-            </para>
+            
+            <literal>comet(...,p)</literal> はボディの相対的な長さを設定する
+            
+            際に使用することができます.
+            
+            <literal>k</literal> は
+            
+            <literal>k = round(p*ny)</literal>のように定義できます.
+            
+        </para>
+        
+        <para>
+            
+            <varname>y</varname> が行列の場合,
+            
+            曲線のアニメーション表示は,
+            
+            <literal>(x,y(:,l))</literal>の各組について描画されます.
+            
+            この場合, <literal>ny</literal> は<varname>y</varname>の
+            
+            行の数です.
             
         </para>
-    </refsection>
-    <refsection>
-        <title>例</title>
-        <programlisting role="example"><![CDATA[
+        
+        <para>
+            
+            <varname>x</varname> および <varname>y</varname> は
+            
+            同じ大きさの行列の場合,
+            
+            各組  <literal>(x(:,l),y(:,l))</literal> 毎に.
+            
+            アニメーション表示された曲線が描画されます.
+            
+            この場合, <literal>ny</literal>は
+            
+            <varname>x</varname>および  <varname>y</varname>の
+            
+            行の数です.
+            
+        </para>
+        
+        
+        
+        <para>
+            
+            <literal>comet(...,"colors",c)</literal> は
+            
+            各曲線の色を設定する際に使用できます.
+            
+        </para>
+        
+        
+        
+    </para>
+    
+</refsection>
+
+<refsection>
+    
+    <title>例</title>
+    
+    <programlisting role="example"><![CDATA[
 t = linspace(0,10*%pi,500);
 clf();set(gca(),"isoview","on"); // 等軸に設定
 comet(t.*sin(t),t.*cos(t))
     ]]></programlisting>
-        <programlisting role="example"><![CDATA[
+    
+    <programlisting role="example"><![CDATA[
 t = linspace(0,10*%pi,500)';
 clf();comet(t.*sin(t),[t.*sin(2*t) t.*sin(3*t)])
     ]]></programlisting>
-        <programlisting role="example"><![CDATA[
+    
+    <programlisting role="example"><![CDATA[
 t = linspace(0,10*%pi,500)';
 clf();comet(t.*sin(t),[t.*sin(2*t) t.*sin(3*t)],"colors",[3 5])
     ]]></programlisting>
-        <programlisting role="example"><![CDATA[
+    
+    <programlisting role="example"><![CDATA[
 function y=traj(x),y=1.5*sin(x^2),endfunction
 clf();comet(linspace(0,5,500),traj)
     ]]></programlisting>
-        <programlisting role="example"><![CDATA[
+    
+    <programlisting role="example"><![CDATA[
 clf();comet(linspace(-2,4,500),(%s-3)/(%s^3+2*%s^2+1))
     ]]></programlisting>
-    </refsection>
-    <refsection>
-        <title>参照</title>
-        <simplelist type="inline">
-            <member>
-                <link linkend="color">color</link>
-            </member>
-            <member>
-                <link linkend="comet3d">comet3d</link>
-            </member>
-            <member>
-                <link linkend="paramfplot2d">paramfplot2d</link>
-            </member>
-        </simplelist>
-    </refsection>
-    <refsection>
-        <title>履歴</title>
-        <revhistory>
-            <revision>
-                <revnumber>5.3.2</revnumber>
-                <revremark>
-                    関数 <function>comet</function> が導入されました.
-                </revremark>
-            </revision>
-        </revhistory>
-    </refsection>
+    
+</refsection>
+
+<refsection>
+    
+    <title>参照</title>
+    
+    <simplelist type="inline">
+        
+        <member>
+            
+            <link linkend="color">color</link>
+            
+        </member>
+        
+        <member>
+            
+            <link linkend="comet3d">comet3d</link>
+            
+        </member>
+        
+        <member>
+            
+            <link linkend="paramfplot2d">paramfplot2d</link>
+            
+        </member>
+        
+    </simplelist>
+    
+</refsection>
+
+<refsection>
+    
+    <title>履歴</title>
+    
+    <revhistory>
+        
+        <revision>
+            
+            <revnumber>5.3.2</revnumber>
+            
+            <revremark>
+                
+                関数 <function>comet</function> が導入されました.
+                
+            </revremark>
+            
+        </revision>
+        
+    </revhistory>
+    
+</refsection>
+
 </refentry>
+
index ba44081..0e63f28 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) ENPC - Jean-Philippe Chancelier
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <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="grayplot">
-    <refnamediv>
-        <refname>grayplot</refname>
-        <refpurpose>曲面の2次元カラープロット</refpurpose>
-    </refnamediv>
-    <refsynopsisdiv>
-        <title>呼び出し手順</title>
-        <synopsis>grayplot(x,y,z,[strf,rect,nax])
-            grayplot(x,y,z,&lt;opt_args&gt;)
-        </synopsis>
-    </refsynopsisdiv>
-    <refsection>
-        <title>引数</title>
-        <variablelist>
-            <varlistentry>
-                <term>x,y</term>
-                <listitem>
-                    <para>大きさ n1 および n2の実数行ベクトル.</para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>z</term>
-                <listitem>
-                    <para>
-                        大きさ (n1,n2)の実数行列. <literal>z(i,j)</literal> は
-                        点 (x(i),y(j))における曲面の値です.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>&lt;opt_args&gt;</term>
-                <listitem>
-                    <para>
-                        一連の命令 <literal>key1=value1,
-                            key2=value2
-                        </literal>
-                        ,... を表します.ただし,<literal>key1</literal>,
-                        <literal>key2,...</literal> には以下のどれかを指定します: rect, nax, strf, logflag
-                        または axesflag および frameflag (<literal>plot2d</literal> および
-                        参照).
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>strf,rect,nax</term>
-                <listitem>
-                    <para>
-                        <literal>plot2d</literal>参照.
-                    </para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-    </refsection>
-    <refsection>
-        <title>説明</title>
-        <para>
-            <literal>grayplot</literal> は,
-            <literal>x</literal> および <literal>y</literal>で定義されるグリッド上で
-            <literal>z</literal>により指定された曲面の2次元プロットを作成します.
-            グリッド上の各矩形は,矩形の4隅の<literal>z</literal>の値の平均値
-            に基づきモノクロまたはカラーで塗りつぶされます.
-            z に %nan 値が含まれる場合,周囲の矩形は表示されません.
-        </para>
-        <para>
-            コマンド <literal>grayplot()</literal> を入力するとデモが表示されます.
-        </para>
-    </refsection>
-    <refsection>
-        <title>例</title>
-        <scilab:image>
-            x=-10:10;
-            y=-10:10;
-            m=rand(21,21);
-            grayplot(x,y,m,rect=[-20,-20,20,20])
-        </scilab:image>
-    </refsection>
-    <refsection>
-        <title>例</title>
-        <programlisting role="example"><![CDATA[ 
+
+<refnamediv>
+    
+    <refname>grayplot</refname>
+    
+    <refpurpose>曲面の2次元カラープロット</refpurpose>
+    
+</refnamediv>
+
+<refsynopsisdiv>
+    
+    <title>呼び出し手順</title>
+    
+    <synopsis>grayplot(x,y,z,[strf,rect,nax])
+        
+        grayplot(x,y,z,&lt;opt_args&gt;)
+        
+    </synopsis>
+    
+</refsynopsisdiv>
+
+<refsection>
+    
+    <title>引数</title>
+    
+    <variablelist>
+        
+        <varlistentry>
+            
+            <term>x,y</term>
+            
+            <listitem>
+                
+                <para>大きさ n1 および n2の実数行ベクトル.</para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>z</term>
+            
+            <listitem>
+                
+                <para>
+                    
+                    大きさ (n1,n2)の実数行列. <literal>z(i,j)</literal> は
+                    
+                    点 (x(i),y(j))における曲面の値です.
+                    
+                </para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>&lt;opt_args&gt;</term>
+            
+            <listitem>
+                
+                <para>
+                    
+                    一連の命令 <literal>key1=value1,
+                        
+                        key2=value2
+                        
+                    </literal>
+                    
+                    ,... を表します.ただし,<literal>key1</literal>,
+                    
+                    <literal>key2,...</literal> には以下のどれかを指定します: rect, nax, strf, logflag
+                    
+                    または axesflag および frameflag (<literal>plot2d</literal> および
+                    
+                    参照).
+                    
+                </para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>strf,rect,nax</term>
+            
+            <listitem>
+                
+                <para>
+                    
+                    <literal>plot2d</literal>参照.
+                    
+                </para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+    </variablelist>
+    
+</refsection>
+
+<refsection>
+    
+    <title>説明</title>
+    
+    <para>
+        
+        <literal>grayplot</literal> は,
+        
+        <literal>x</literal> および <literal>y</literal>で定義されるグリッド上で
+        
+        <literal>z</literal>により指定された曲面の2次元プロットを作成します.
+        
+        グリッド上の各矩形は,矩形の4隅の<literal>z</literal>の値の平均値
+        
+        に基づきモノクロまたはカラーで塗りつぶされます.
+        
+        z に %nan 値が含まれる場合,周囲の矩形は表示されません.
+        
+    </para>
+    
+    <para>
+        
+        コマンド <literal>grayplot()</literal> を入力するとデモが表示されます.
+        
+    </para>
+    
+</refsection>
+
+<refsection>
+    
+    <title>例</title>
+    
+    <programlisting role="example"><![CDATA[ 
 x=-10:10; y=-10:10;m =rand(21,21);
 grayplot(x,y,m,rect=[-20,-20,20,20])
 t=-%pi:0.1:%pi; m=sin(t)'*cos(t);
 clf()
 grayplot(t,t,m)
  ]]></programlisting>
-    </refsection>
-    <refsection role="see also">
-        <title>参照</title>
-        <simplelist type="inline">
-            <member>
-                <link linkend="fgrayplot">fgrayplot</link>
-            </member>
-            <member>
-                <link linkend="plot2d">plot2d</link>
-            </member>
-            <member>
-                <link linkend="Sgrayplot">Sgrayplot</link>
-            </member>
-            <member>
-                <link linkend="Sfgrayplot">Sfgrayplot</link>
-            </member>
-        </simplelist>
-    </refsection>
+    
+    <scilab:image>
+        
+        x=-10:10;
+        
+        y=-10:10;
+        
+        m=rand(21,21);
+        
+        grayplot(x,y,m,rect=[-20,-20,20,20])
+        
+    </scilab:image>
+    
+</refsection>
+
+<refsection role="see also">
+    
+    <title>参照</title>
+    
+    <simplelist type="inline">
+        
+        <member>
+            
+            <link linkend="fgrayplot">fgrayplot</link>
+            
+        </member>
+        
+        <member>
+            
+            <link linkend="plot2d">plot2d</link>
+            
+        </member>
+        
+        <member>
+            
+            <link linkend="Sgrayplot">Sgrayplot</link>
+            
+        </member>
+        
+        <member>
+            
+            <link linkend="Sfgrayplot">Sfgrayplot</link>
+            
+        </member>
+        
+    </simplelist>
+    
+</refsection>
+
+<refsection>
+    
+    <title>履歴</title>
+    
+    <revhistory>
+        
+        <revision>
+            
+            <revnumber>5.5.0</revnumber>
+            
+            <revremark>
+                
+                オプション<function>logflag</function>が導入されました.
+                
+            </revremark>
+            
+        </revision>
+        
+    </revhistory>
+    
+</refsection>
+
 </refentry>
+
index 229b91e..084869c 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) INRIA - Serge Steer
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <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="milk_drop">
-    <refnamediv>
-        <refname>milk_drop</refname>
-        <refpurpose>ミルクドロップ3次元関数</refpurpose>
-    </refnamediv>
-    <refsynopsisdiv>
-        <title>呼び出し手順</title>
-        <synopsis>z=milk_drop(x,y)</synopsis>
-    </refsynopsisdiv>
-    <refsection>
-        <title>引数</title>
-        <variablelist>
-            <varlistentry>
-                <term>x,y</term>
-                <listitem>
-                    <para>大きさ n1 および n2の行ベクトル.</para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>z</term>
-                <listitem>
-                    <para>大きさ (n1,n2)の行列.</para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-    </refsection>
-    <refsection>
-        <title>説明</title>
-        <para>
-            <literal>milk_drop</literal> はミルクに落ちるミルクドロップの曲面を
-            表す関数です.
-            この関数は<literal>eval3d</literal> および <literal>plot3d</literal>のテスト用の
-            関数として使用できます.
-        </para>
-    </refsection>
-    <refsection>
-        <title>例</title>
-        <scilab:image>
-            warning("off")
-            x=-2:0.1:2;
-            y=x;
-            z=eval3d(milk_drop,x,y);
-            plot3d(x,y,z)
-            warning("on")
-        </scilab:image>
-    </refsection>
-    <refsection>
-        <title>例</title>
-        <programlisting role="example"><![CDATA[ 
+
+<refnamediv>
+    
+    <refname>milk_drop</refname>
+    
+    <refpurpose>ミルクドロップ3次元関数
+        
+        <emphasis role="bold">この関数は廃止されます.</emphasis>
+        
+    </refpurpose>
+    
+</refnamediv>
+
+<refsynopsisdiv>
+    
+    <title>呼び出し手順</title>
+    
+    <synopsis>z=milk_drop(x,y)</synopsis>
+    
+</refsynopsisdiv>
+
+<refsection>
+    
+    <title>引数</title>
+    
+    <variablelist>
+        
+        <varlistentry>
+            
+            <term>x,y</term>
+            
+            <listitem>
+                
+                <para>大きさ n1 および n2の行ベクトル.</para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>z</term>
+            
+            <listitem>
+                
+                <para>大きさ (n1,n2)の行列.</para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+    </variablelist>
+    
+</refsection>
+
+<refsection>
+    
+    <title>説明</title>
+    
+    <warning>
+        
+        この関数は廃止されます.
+        
+        この関数は Scilab 5.5.1で削除されます.
+        
+    </warning>
+    
+    <para>
+        
+        <literal>milk_drop</literal> はミルクに落ちるミルクドロップの曲面を
+        
+        表す関数です.
+        
+        この関数は<literal>eval3d</literal> および <literal>plot3d</literal>のテスト用の
+        
+        関数として使用できます.
+        
+    </para>
+    
+</refsection>
+
+<refsection>
+    
+    <title>例</title>
+    
+    <programlisting role="example"><![CDATA[ 
 x=-2:0.1:2; y=x;
 z=eval3d(milk_drop,x,y);
 plot3d(x,y,z)
  ]]></programlisting>
-    </refsection>
-    <refsection role="see also">
-        <title>参照</title>
-        <simplelist type="inline">
-            <member>
-                <link linkend="eval3d">eval3d</link>
-            </member>
-            <member>
-                <link linkend="plot3d">plot3d</link>
-            </member>
-        </simplelist>
-    </refsection>
+    
+    <scilab:image>
+        
+        warning("off")
+        
+        x=-2:0.1:2;
+        
+        y=x;
+        
+        z=eval3d(milk_drop,x,y);
+        
+        plot3d(x,y,z)
+        
+        warning("on")
+        
+    </scilab:image>
+    
+</refsection>
+
+<refsection role="see also">
+    
+    <title>参照</title>
+    
+    <simplelist type="inline">
+        
+        <member>
+            
+            <link linkend="eval3d">eval3d</link>
+            
+        </member>
+        
+        <member>
+            
+            <link linkend="plot3d">plot3d</link>
+            
+        </member>
+        
+    </simplelist>
+    
+</refsection>
+
+<refsection>
+    
+    <title>履歴</title>
+    
+    <revhistory>
+        
+        <revision>
+            
+            <revnumber>5.5.0</revnumber>
+            
+            <revdescription>
+                
+                関数が廃止対象となりました. 5.5.1で削除されます.
+                
+            </revdescription>
+            
+        </revision>
+        
+    </revhistory>
+    
+</refsection>
+
 </refentry>
+
index 50f1b98..ec2a088 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) INRIA - Djalel Abdemouche
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <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="legend_properties" xml:lang="ja">
-    <refnamediv>
-        <refname>legend_properties</refname>
-        <refpurpose>Legend エンティティプロパティの説明.</refpurpose>
-    </refnamediv>
-    <refsection>
-        <title>説明</title>
-        <para>Legend エンティティはグラフィックエンティティ階層の葉です.
-            このエンティティは<literal>plot2dx</literal>グラフのもとで
-            描画されるか
-            <link linkend="captions">captions</link>関数により作成される
-            凡例のパラメータを定義します.
-            指定された線について,凡例には線種,マーカ記号および色のサンプルが
-            表示されます.
-        </para>
-        <variablelist>
-            <varlistentry>
-                <term>parent:</term>
-                <listitem>
-                    <para>このプロパティには親のハンドルが含まれます.
-                        legend エンティティの親は<literal>"Compound"</literal>型と
-                        なります.
-                        この Compound エンティティにはその他のグラフのエンティティ
-                        も含まれています.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>children:</term>
-                <listitem>
-                    <para>
-                        このプロパティはハンドルの<literal>children</literal>
-                        のベクトルが含まれます.
-                        しかし,<literal>legend</literal>ハンドルには現在
-                        <literal>children</literal>が存在しません.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>visible:</term>
-                <listitem>
-                    <para>
-                        このプロパティはエンティティの <literal>visible</literal>プロパティを
-                        有し, <literal>"on" </literal> または
-                        <literal>"off"</literal>となります . <literal>"on"</literal>の場合は
-                        凡例が描画され,<literal>"off"</literal> の場合には凡例が画面に表示されません.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>text:</term>
-                <listitem>
-                    <para>このフィールドは注釈をつける対称の各オブジェクトの凡例を含む文字列ベクトルです.
-                    </para>
-                    <para>
-                        Scilab 5.2以降,<link linkend="math_rendering_features_in_graphic">LaTeX または MathML 式</link>
-                        を指定することができます.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>font_size:</term>
-                <listitem>
-                    <para>スカラー値で,表示される文字の大きさを指定します.
-                        <literal>fractional_font</literal>プロパティが <literal>"off"</literal>の場合,
-                        値の整数部のみが使用されます.
-                        詳細は <link linkend="graphics_fonts">graphics_fonts</link>を参照ください.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>font_style:</term>
-                <listitem>
-                    <para>凡例のラベルを表示する際に使用されるフォントを指定します.
-                        この値は正の整数でロード済みのフォントの一つを参照します.
-                        この値には,最初のフォントを指す 0 から最後のフォントを指すロード済みの
-                        フォントの数から1を引いた数までの数値を指定します.
-                        詳細は <link linkend="graphics_fonts">graphics_fonts</link>を参照ください.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>font_color</term>
-                <listitem>
-                    <para>色のインデックスで, このプロパティはテキストの色を定義します.</para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>fractional_font:</term>
-                <listitem>
-                    <para>このプロパティはテキストを分数のフォントサイズにより表示するかどうかを
-                        指定します.この値には,<literal>"on"</literal> または <literal>"off"</literal>を指定します. 
-                        <literal>"on"</literal> の場合,<literal>font_size</literal>の浮動小数点の値が
-                        表示の際に使用され,フォントはアンチエイリアス処理されます.
-                        <literal>"off"</literal> の場合,整数部のみが使用され,フォントは平滑化されません.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>links:</term>
-                <listitem>
-                    <para>ハンドルの行配列. 関連するポリラインを参照します.</para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>legend_location</term>
-                <listitem>
-                    <para>文字列で,凡例の位置を指定します.</para>
-                    <itemizedlist>
-                        <listitem>
-                            <para>
-                                <literal>"in_upper_right" </literal>: 凡例は軸ボックスの
-                                右上に表示されます.
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                <literal>"in_upper_left"</literal>: 
-                                凡例は軸ボックスの左上に表示されます.
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                <literal>"in_lower_right"</literal>:
-                                凡例は軸ボックスの右下に表示されます.
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                <literal>"in_lower_left"</literal>: 
-                                凡例は軸ボックスの左下に表示されます.
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                <literal>"out_upper_right"</literal>: 
-                                凡例は軸ボックスの右上隅の右に表示されます.
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                <literal>"out_upper_left"</literal>: 
-                                凡例は軸ボックスの左上隅の左に表示されます.
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                <literal>"out_lower_right"</literal>: 
-                                凡例は軸ボックスの右下隅の右に表示されます.
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                <literal>"out_lower_left"</literal>: 
-                                凡例は軸ボックスの左下隅の左に表示されます.
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                <literal>"upper_caption"</literal>: 
-                                凡例は軸ボックスの左上隅の上に表示されます.
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                <literal>"lower_caption"</literal>: 
-                                凡例は軸ボックスの左下隅の下に表示されます.このオプションは
-                                <link linkend="plot2d">plot2d</link>の<literal>leg</literal>引数に対応します
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                <literal>"by_coordinates"</literal>: 
-                                凡例ボックスの左上隅の座標を付属するデータ構造体の"position"
-                                フィールドで指定します.
-                                位置 <literal>x</literal> および <literal>y</literal> は
-                                <literal>axes_bounds</literal>に対する比で指定されます
-                            </para>
-                        </listitem>
-                    </itemizedlist>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>position</term>
-                <listitem>
-                    <para>凡例の左上隅の座標.
-                        位置
-                        <literal>x</literal> および <literal>y</literal> は<literal>axes_bounds</literal>
-                        の大きさに対する比で指定されます.
-                        このフィールドは<literal>legend_location=="by_coordinates"</literal>の場合に
-                        設定でき,
-                        その他の<literal>legend_location</literal>の設定では取得が可能です.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>line_mode</term>
-                <listitem>
-                    <para>このフィールドは凡例の周囲に矩形を描画するかどうかを指定します.
-                        値には<literal>"on"</literal> または
-                        <literal>"off"</literal>を指定します. <literal>"on"</literal>の場合,
-                        以下のプリパティを用いて矩形が描画されます.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>thickness</term>
-                <listitem>
-                    <para>このプロパティは正の実数で,矩形の線の幅をピクセル単位で指定します.
-                        実際に表示される幅は指定された幅を整数に丸めることにより定義されます.
-                        唯一の例外はベクトルのエキスポートの場合で,<literal>thickness</literal>
-                        の値が全体の幅とみなされます.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>foreground</term>
-                <listitem>
-                    <para>このフィールドは矩形の輪郭を描画する際に使用される線の色インデックスを
-                        指定します.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>fill_mode</term>
-                <listitem>
-                    <para>このフィールドは凡例の背景を塗りつぶすかどうかを指定します.
-                        値には <literal>"on"</literal> または
-                        <literal>"off"</literal>を指定します. <literal>"on"</literal>の場合,
-                        背景が<literal>background</literal>フィーづろで設定された色インデックスを
-                        用いて描画されます.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>background</term>
-                <listitem>
-                    <para>このフィールドは矩形領域を塗る際に使用される線の色インデックスを
-                        指定します.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>clip_state:</term>
-                <listitem>
-                    <para>このフィールドは全てのオブジェクトのデフォルトの
-                        <literal>clip_state</literal>プロパティの値を有します.
-                        値は以下となります :
-                    </para>
-                    <itemizedlist>
-                        <listitem>
-                            <para>
-                                <literal>"off"</literal> 
-                                以降に作成される全てのオブジェクトはクリップされません (デフォルト値).
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                <literal>"clipgrf"</literal> 
-                                以降に作成される全てのオブジェクトはAxes境界でクリップされます.
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                <literal>"on"</literal> 
-                                以降に作成される全てのオブジェクトはclip_boxプロパティで指定された
-                                矩形の外側でクリップされます.
-                            </para>
-                        </listitem>
-                    </itemizedlist>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>clip_box:</term>
-                <listitem>
-                    <para>
-                        このフィールドは全てのオブジェクトのデフォルトの
-                        <literal>clip_box</literal>プロパティを有します.
-                        この値はclip_state が<literal>"off"</literal>の場合,空の行列となります.
-                        その他の場合,ベクトル<literal>[x,y,w,h]</literal> (左上の点,幅,高さ)により
-                        クリップ領域が指定されます.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>user_data:</term>
-                <listitem>
-                    <para>このフィールドは任意のScilab変数をtextデータ構造体に保存し,
-                        復元する際に使用できます.
-                    </para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-    </refsection>
-    <refsection>
-        <title>例</title>
-        <programlisting role="example"><![CDATA[ 
-// x initialisation 
+
+<refnamediv>
+    
+    <refname>legend_properties</refname>
+    
+    <refpurpose>Legend エンティティプロパティの説明.</refpurpose>
+    
+</refnamediv>
+
+<refsection>
+    
+    <title>説明</title>
+    
+    <para>Legend エンティティはグラフィックエンティティ階層の葉です.
+        
+        このエンティティは<literal>plot2dx</literal>グラフのもとで
+        
+        描画されるか
+        
+        <link linkend="captions">captions</link>関数により作成される
+        
+        凡例のパラメータを定義します.
+        
+        指定された線について,凡例には線種,マーカ記号および色のサンプルが
+        
+        表示されます.
+        
+    </para>
+    
+    <variablelist>
+        
+        <varlistentry>
+            
+            <term>parent:</term>
+            
+            <listitem>
+                
+                <para>このプロパティには親のハンドルが含まれます.
+                    
+                    legend エンティティの親は<literal>"Compound"</literal>型と
+                    
+                    なります.
+                    
+                    この Compound エンティティにはその他のグラフのエンティティ
+                    
+                    も含まれています.
+                    
+                </para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>children:</term>
+            
+            <listitem>
+                
+                <para>
+                    
+                    このプロパティはハンドルの<literal>children</literal>
+                    
+                    のベクトルが含まれます.
+                    
+                    しかし,<literal>legend</literal>ハンドルには現在
+                    
+                    <literal>children</literal>が存在しません.
+                    
+                </para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>visible:</term>
+            
+            <listitem>
+                
+                <para>
+                    
+                    このプロパティはエンティティの <literal>visible</literal>プロパティを
+                    
+                    有し, <literal>"on" </literal> または
+                    
+                    <literal>"off"</literal>となります . <literal>"on"</literal>の場合は
+                    
+                    凡例が描画され,<literal>"off"</literal> の場合には凡例が画面に表示されません.
+                    
+                </para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>text:</term>
+            
+            <listitem>
+                
+                <para>このフィールドは注釈をつける対称の各オブジェクトの凡例を含む文字列ベクトルです.
+                    
+                </para>
+                
+                <para>
+                    
+                    Scilab 5.2以降,<link linkend="math_rendering_features_in_graphic">LaTeX または MathML 式</link>
+                    
+                    を指定することができます.
+                    
+                </para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>font_size:</term>
+            
+            <listitem>
+                
+                <para>スカラー値で,表示される文字の大きさを指定します.
+                    
+                    <literal>fractional_font</literal>プロパティが <literal>"off"</literal>の場合,
+                    
+                    値の整数部のみが使用されます.
+                    
+                    詳細は <link linkend="graphics_fonts">graphics_fonts</link>を参照ください.
+                    
+                </para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>font_style:</term>
+            
+            <listitem>
+                
+                <para>凡例のラベルを表示する際に使用されるフォントを指定します.
+                    
+                    この値は正の整数でロード済みのフォントの一つを参照します.
+                    
+                    この値には,最初のフォントを指す 0 から最後のフォントを指すロード済みの
+                    
+                    フォントの数から1を引いた数までの数値を指定します.
+                    
+                    詳細は <link linkend="graphics_fonts">graphics_fonts</link>を参照ください.
+                    
+                </para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>font_color</term>
+            
+            <listitem>
+                
+                <para>色のインデックスで, このプロパティはテキストの色を定義します.</para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>fractional_font:</term>
+            
+            <listitem>
+                
+                <para>このプロパティはテキストを分数のフォントサイズにより表示するかどうかを
+                    
+                    指定します.この値には,<literal>"on"</literal> または <literal>"off"</literal>を指定します. 
+                    
+                    <literal>"on"</literal> の場合,<literal>font_size</literal>の浮動小数点の値が
+                    
+                    表示の際に使用され,フォントはアンチエイリアス処理されます.
+                    
+                    <literal>"off"</literal> の場合,整数部のみが使用され,フォントは平滑化されません.
+                    
+                </para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>links:</term>
+            
+            <listitem>
+                
+                <para>ハンドルの行配列. 関連するポリラインを参照します.</para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>legend_location</term>
+            
+            <listitem>
+                
+                <para>文字列で,凡例の位置を指定します.</para>
+                
+                <itemizedlist>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            <literal>"in_upper_right" </literal>: 凡例は軸ボックスの
+                            
+                            右上に表示されます.
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            <literal>"in_upper_left"</literal>: 
+                            
+                            凡例は軸ボックスの左上に表示されます.
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            <literal>"in_lower_right"</literal>:
+                            
+                            凡例は軸ボックスの右下に表示されます.
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            <literal>"in_lower_left"</literal>: 
+                            
+                            凡例は軸ボックスの左下に表示されます.
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            <literal>"out_upper_right"</literal>: 
+                            
+                            凡例は軸ボックスの右上隅の右に表示されます.
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            <literal>"out_upper_left"</literal>: 
+                            
+                            凡例は軸ボックスの左上隅の左に表示されます.
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            <literal>"out_lower_right"</literal>: 
+                            
+                            凡例は軸ボックスの右下隅の右に表示されます.
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            <literal>"out_lower_left"</literal>: 
+                            
+                            凡例は軸ボックスの左下隅の左に表示されます.
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            <literal>"upper_caption"</literal>: 
+                            
+                            凡例は軸ボックスの左上隅の上に表示されます.
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            <literal>"lower_caption"</literal>: 
+                            
+                            凡例は軸ボックスの左下隅の下に表示されます.このオプションは
+                            
+                            <link linkend="plot2d">plot2d</link>の<literal>leg</literal>引数に対応します
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            <literal>"by_coordinates"</literal>: 
+                            
+                            凡例ボックスの左上隅の座標を付属するデータ構造体の"position"
+                            
+                            フィールドで指定します.
+                            
+                            位置 <literal>x</literal> および <literal>y</literal> は
+                            
+                            <literal>axes_bounds</literal>に対する比で指定されます
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                </itemizedlist>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>position</term>
+            
+            <listitem>
+                
+                <para>凡例の左上隅の座標.
+                    
+                    位置
+                    
+                    <literal>x</literal> および <literal>y</literal> は<literal>axes_bounds</literal>
+                    
+                    の大きさに対する比で指定されます.
+                    
+                    このフィールドは<literal>legend_location=="by_coordinates"</literal>の場合に
+                    
+                    設定でき,
+                    
+                    その他の<literal>legend_location</literal>の設定では取得が可能です.
+                    
+                </para>
+                
+                <para>
+                    
+                    座標(<literal>position</literal>)をユーザ座標
+                    
+                    ((<literal>x_user</literal>, <literal>y_user</literal>)
+                    
+                    を変換,またはその逆変換を行う際に以下の命令を使用できます.
+                    
+                </para>
+                
+                <programlisting role="user coordinates"><![CDATA[ 
+as=get(gcf(),"axes_size");// キャンバスの大きさ(単位:ピクセル)
+bnds=get(gca(),"axes_bounds");// 図の大きさに対して相対的に定義したカレントの軸の境界
+//汎用座標からユーザ座標に
+[x_user,y_user]=xchange(position(1)*as(1)*bnds(3)+as(1)*bnds(1),...
+               position(2)*as(2)*bnds(4)+as(2)*bnds(2),"i2f") 
+//ユーザ座標から汎用座標に
+[x1,y1]=xchange(x_user,y_user,'f2i')
+position=[(x1-as(1)*bnds(1))/(as(1)*bnds(3)),...
+          (y1-as(2)*bnds(2))/(as(2)*bnds(4))];
+ ]]></programlisting>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>line_width</term>
+            
+            <listitem>
+                
+                <para>このフィールドは凡例に表示される線幅を(軸座標で)指定します.
+                    
+                    この値は0と1の間の実数です.
+                    
+                </para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>line_mode</term>
+            
+            <listitem>
+                
+                <para>このフィールドは凡例の周囲に矩形を描画するかどうかを指定します.
+                    
+                    値には<literal>"on"</literal> または
+                    
+                    <literal>"off"</literal>を指定します. <literal>"on"</literal>の場合,
+                    
+                    以下のプリパティを用いて矩形が描画されます.
+                    
+                </para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>thickness</term>
+            
+            <listitem>
+                
+                <para>このプロパティは正の実数で,矩形の線の幅をピクセル単位で指定します.
+                    
+                    実際に表示される幅は指定された幅を整数に丸めることにより定義されます.
+                    
+                    唯一の例外はベクトルのエキスポートの場合で,<literal>thickness</literal>
+                    
+                    の値が全体の幅とみなされます.
+                    
+                </para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>foreground</term>
+            
+            <listitem>
+                
+                <para>このフィールドは矩形の輪郭を描画する際に使用される線の色インデックスを
+                    
+                    指定します.
+                    
+                </para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>fill_mode</term>
+            
+            <listitem>
+                
+                <para>このフィールドは凡例の背景を塗りつぶすかどうかを指定します.
+                    
+                    値には <literal>"on"</literal> または
+                    
+                    <literal>"off"</literal>を指定します. <literal>"on"</literal>の場合,
+                    
+                    背景が<literal>background</literal>フィーづろで設定された色インデックスを
+                    
+                    用いて描画されます.
+                    
+                </para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>background</term>
+            
+            <listitem>
+                
+                <para>このフィールドは矩形領域を塗る際に使用される線の色インデックスを
+                    
+                    指定します.
+                    
+                </para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>marks_count</term>
+            
+            <listitem>
+                
+                <para>
+                    
+                    このプロパティは0と3の間の整数で,
+                    
+                    凡例として表示される記号の数を指定します.
+                    
+                </para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>clip_state:</term>
+            
+            <listitem>
+                
+                <para>このフィールドは全てのオブジェクトのデフォルトの
+                    
+                    <literal>clip_state</literal>プロパティの値を有します.
+                    
+                    値は以下となります :
+                    
+                </para>
+                
+                <itemizedlist>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            <literal>"off"</literal> 
+                            
+                            以降に作成される全てのオブジェクトはクリップされません (デフォルト値).
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            <literal>"clipgrf"</literal> 
+                            
+                            以降に作成される全てのオブジェクトはAxes境界でクリップされます.
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            <literal>"on"</literal> 
+                            
+                            以降に作成される全てのオブジェクトはclip_boxプロパティで指定された
+                            
+                            矩形の外側でクリップされます.
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                </itemizedlist>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>clip_box:</term>
+            
+            <listitem>
+                
+                <para>
+                    
+                    このフィールドは全てのオブジェクトのデフォルトの
+                    
+                    <literal>clip_box</literal>プロパティを有します.
+                    
+                    この値はclip_state が<literal>"off"</literal>の場合,空の行列となります.
+                    
+                    その他の場合,ベクトル<literal>[x,y,w,h]</literal> (左上の点,幅,高さ)により
+                    
+                    クリップ領域が指定されます.
+                    
+                </para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+        <varlistentry>
+            
+            <term>user_data:</term>
+            
+            <listitem>
+                
+                <para>このフィールドは任意のScilab変数をtextデータ構造体に保存し,
+                    
+                    復元する際に使用できます.
+                    
+                </para>
+                
+            </listitem>
+            
+        </varlistentry>
+        
+    </variablelist>
+    
+</refsection>
+
+<refsection>
+    
+    <title>例</title>
+    
+    <programlisting role="example"><![CDATA[ 
+// x初期化
 x=[0:0.1:2*%pi]';
 plot2d(x,[sin(x) sin(2*x) sin(3*x)],..
   [1,2,3],leg="L1@L2@L3")
@@ -315,23 +670,55 @@ a=get("current_axes");
 l=a.children(2);
 l.links
 l.text=["sin(x)";"sin(2*x)";"sin(3*x)"];
-l.visible="off"; // invisible
+l.visible="off"; // 不可視
 l.font_size = 2;
 l.font_style = 5;
 l.visible='on';
-// Starting from Scilab 5.2, Latex:
+// Scilab 5.2以降, Latex:
 l.text=["$\sin(x)$";"$\sin(2*x)$";"$\sin(3*x)$"];
  ]]></programlisting>
-    </refsection>
-    <refsection role="see also">
-        <title>参照</title>
-        <simplelist type="inline">
-            <member>
-                <link linkend="plot2d">plot2d</link>
-            </member>
-            <member>
-                <link linkend="graphics_entities">graphics_entities</link>
-            </member>
-        </simplelist>
-    </refsection>
+    
+</refsection>
+
+<refsection role="see also">
+    
+    <title>参照</title>
+    
+    <simplelist type="inline">
+        
+        <member>
+            
+            <link linkend="plot2d">plot2d</link>
+            
+        </member>
+        
+        <member>
+            
+            <link linkend="graphics_entities">graphics_entities</link>
+            
+        </member>
+        
+    </simplelist>
+    
+</refsection>
+
+<refsection>
+    
+    <title>履歴</title>
+    
+    <revhistory>
+        
+        <revision>
+            
+            <revnumber>5.5.0</revnumber>
+            
+            <revremark>line_width および marks_count プロパティが追加されました.</revremark>
+            
+        </revision>
+        
+    </revhistory>
+    
+</refsection>
+
 </refentry>
+
index 42bd9cf..cbfc51e 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) INRIA - Djalel Abdemouche
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <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="axes_properties">
-    <refnamediv>
-        <refname>axes_properties</refname>
-        <refpurpose>axesエンティティプロパティの説明</refpurpose>
-    </refnamediv>
-    <refsection>
-        <title>説明</title>
-        <para>Axesエンティティはグラフィックエンティティ階層の第2レベルのエンティティです.
-            このエンティティは
-            座標系を変更するパラメータと子の作成時のパラメータのデフォルト値と共に
-            描画する軸を定義します.
-        </para>
-        <variablelist>
-            <varlistentry>
-                <term>Axesプロパティs</term>
-                <listitem>
-                    <variablelist>
-                        <varlistentry>
-                            <term>parent: </term>
-                            <listitem>
-                                <para>このフィールドは親の図のハンドルを有します.</para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>children: </term>
-                            <listitem>
-                                <para>FA ベクトルは,軸の子である全てのグラフィックオブジェクトのハンドルを有します.
-                                    これらのグラフィックオブジェクトは以下の型となります:
-                                    <literal>"Compound"</literal>, <literal>"Rectangle"</literal>,
-                                    <literal>"Polyline"</literal>, <literal>"Segs"</literal>, <literal>"Arc"</literal>,
-                                    <literal>"Grayplot"</literal>,.. (<link linkend="Compound_properties">Compound_properties</link>,
-                                    <link linkend="rectangle_properties">rectangle_properties</link>, <link linkend="champ_properties">champ_properties</link>,
-                                    <link linkend="axis_properties">axis_properties</link>, <link linkend="polyline_properties">polyline_properties</link>,
-                                    <link linkend="segs_properties">segs_properties</link>, <link linkend="grayplot_properties">grayplot_properties</link>,
-                                    <link linkend="surface_properties">surface_properties</link>,
-                                    <link linkend="fec_properties">fec_properties</link>, <link linkend="text_properties">text_properties</link>,
-                                    <link linkend="legend_properties">legend_properties</link>参照)
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>visible: </term>
-                            <listitem>
-                                <para>
-                                    このフィールドは軸の<literal>visible</literal>プロパティの値を有します.
-                                    この値は<literal>"on" </literal>または<literal>"off"</literal>となります.
-                                    デフォルトで,軸の visibleは <literal>"on"</literal>で,
-                                    この場合, 全ての "visible" な子は画面に表示されます.
-                                    <literal>"off"</literal> の場合, 軸とその全ての子は描画されません.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>axes_visible: </term>
-                            <listitem>
-                                <para>
-                                    <literal>1x3</literal> 文字列ベクトル. このプロパティは
-                                    各軸が描画されるかどうかを指定します.
-                                    この値はグローバル設定の場合<literal>"on"</literal> または <literal>"off"</literal>
-                                    となります.
-                                    一つの軸のみ変更する場合, 構文は <literal>axes_visible(N)</literal>となります.
-                                    ただし, <literal>N</literal> は <literal>1,2</literal> または <literal>3</literal>で,
-                                    それぞれ, <literal> x,y</literal> または <literal>z</literal>軸に対応します.
-                                    データは必要に応じてスケーリングされ,値が <literal>"on"</literal>の場合,
-                                    グリッドが描画されます.
-                                    <literal>gca()</literal>コマンド(<literal>get"current_axes")</literal>のショートカット)
-                                    または<literal>gcf()</literal>(<literal>get(current_figure)</literal>のショートカット)
-                                    により簡単な軸エンティティを作成する際,軸の可視性(axes
-                                    visiblibilty)は <literal>"off"</literal>に設定されます.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>axes_reverse: </term>
-                            <listitem>
-                                <para>
-                                    3つの軸(X,Y,Z)に対応する<literal>1x3</literal>文字列ベクトル.
-                                    各軸について,このプロパティは値の増加方向を指定します.
-                                    <literal>"off"</literal>の場合,デフォルトの方向が使用されます.
-                                    <literal>"on"</literal>の場合, 方向は逆になります.
-                                    一つの文字列のみ(<literal>"on"</literal> または
-                                    <literal>"off"</literal>) を使用することも可能です.
-                                    この場合, 3つのデータは同じ値に設定されます.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>grid: </term>
-                            <listitem>
-                                <para>
-                                    フィールドの値はベクトル<literal>[x-grid,y-grid,z-grid]</literal>です.
-                                    ただし,<literal>x-grid</literal>はx軸の描画グリッドを制御し,
-                                    <literal>y-grid,z-grid</literal>はそれぞれy軸,z軸に対応します.
-                                    デフォルト値は <literal>-1</literal>で,グリッドは描画されません.
-                                    それ以外の場合, grid の値により指定された色添字により
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>grid_position: </term>
-                            <listitem>
-                                <para>この文字列は他のグラフィックエンティティに相対的なグリッドの位置
-                                    を指定します.その値には 他のグラフィックエンティティの前にグリッドを描画する
-                                    <literal>"foreground"</literal>, もしくは
-                                    グリッドの背後に描画する<literal>"background"</literal>のどちらかを指定します.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>x_location: </term>
-                            <listitem>
-                                <para>x軸の位置を指定します.指定可能な値は:</para>
-                                <itemizedlist>
-                                    <listitem>
-                                        <para>
-                                            <literal>"bottom"</literal>. この場合,x軸は軸の矩形の最下部に描画されます.
-                                        </para>
-                                    </listitem>
-                                    <listitem>
-                                        <para>
-                                            <literal>"top"</literal>. この場合,x軸は軸の矩形の
-                                            最上部に描画されます.
-                                        </para>
-                                    </listitem>
-                                    <listitem>
-                                        <para>
-                                            <literal>"middle"</literal>. この場合,x軸は中心部に描画されます.
-                                        </para>
-                                    </listitem>
-                                    <listitem>
-                                        <para>
-                                            <literal>"origin"</literal>. この場合,x軸は原点に描画されます.
-                                        </para>
-                                    </listitem>
-                                </itemizedlist>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>y_location: </term>
-                            <listitem>
-                                <para>y軸の位置を指定します. 以下の値を指定可能です:</para>
-                                <itemizedlist>
-                                    <listitem>
-                                        <para>
-                                            <literal>"left"</literal>.この場合,y軸は軸の矩形の左に描画されます.
-                                        </para>
-                                    </listitem>
-                                    <listitem>
-                                        <para>
-                                            <literal>"right"</literal>. この場合,y軸は軸の矩形の右に描画されます.
-                                        </para>
-                                    </listitem>
-                                    <listitem>
-                                        <para>
-                                            <literal>"middle"</literal>. この場合,y軸は中心に描画されます.
-                                        </para>
-                                    </listitem>
-                                    <listitem>
-                                        <para>
-                                            <literal>"origin"</literal>. この場合,y軸は原点に描画されます.
-                                        </para>
-                                    </listitem>
-                                </itemizedlist>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>title: </term>
-                            <listitem>
-                                <para>Axesエンティティに付属するオブジェクトで,Label構造体の
-                                    グラフィックハンドルを返します
-                                    (<link linkend="label_properties">label_properties</link>参照).
-                                    このフィールドはこのラベルのオプションで,タイトルを定義します.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>x_label: </term>
-                            <listitem>
-                                <para>
-                                    Axesエンティティに付属するオブジェクトで, Label構造体のハンドルを
-                                    返します(<link linkend="label_properties">label_properties</link>参照).
-                                    このフィールドはこのラベルのオプションで,x軸のラベルを定義します.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>y_label: </term>
-                            <listitem>
-                                <para>
-                                    Axesエンティティに付属するオブジェクトで, Label構造体のハンドルを
-                                    返します(<link linkend="label_properties">label_properties</link>参照).
-                                    このフィールドはこのラベルのオプションで,y軸のラベルを定義します.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>z_label: </term>
-                            <listitem>
-                                <para>
-                                    Axesエンティティに付属するオブジェクトで, Label構造体のハンドルを
-                                    返します(<link linkend="label_properties">label_properties</link>参照).
-                                    このフィールドはこのラベルのオプションで,z軸のラベルを定義します.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>auto_ticks: </term>
-                            <listitem>
-                                <para>各軸のauto_ticksステータスを指定する
-                                    <literal>1x3</literal> 文字列ベクトル.
-                                    このプロパティは,各軸に計算アルゴリズムに基づく目盛が付くか否か
-                                    (目盛をユーザが指定)を指定します.
-                                    この値は,グローバルな設定値で, <literal>"on"</literal> または
-                                    <literal>"off"</literal>とします.
-                                    1つの軸にのみ適用する場合の構文は<literal>auto_ticks(N)</literal>で,
-                                    <literal>N</literal>は<literal>1,2</literal> または <literal>3</literal>
-                                    とし,それぞれ,<literal>x,y</literal> または <literal>z</literal>軸に
-                                    対応します.
-                                    <literal>x_ticks, y_ticks</literal> または<literal>z_ticks</literal>により
-                                    目盛(テキストまたは文字)を編集すると,対応する軸の
-                                    <literal>auto_ticks</literal>が自動的に<literal>"off"</literal>に設定
-                                    されることに注意してください.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>x_ticks.locations: </term>
-                            <listitem>
-                                <para>x軸の目盛の位置を有する実数ベクトル.
-                                    このプロパティは(同じ大きさの)新しい実数ベクトルを指定することにより
-                                    編集可能です.
-                                    目盛を多くまたは少なくするには,対応する文字列ベクトル<literal> x_ticks.labels</literal>
-                                    を定義する<literal>tlist</literal><literal>x_ticks</literal> 
-                                    も操作することができます.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>y_ticks.locations: </term>
-                            <listitem>
-                                <para>y軸の目盛の位置を有する実数ベクトル.
-                                    このプロパティは(同じ大きさの)新しい実数ベクトルを指定することにより
-                                    編集可能です.
-                                    目盛を多くまたは少なくするには,対応する文字列ベクトル<literal> y_ticks.labels</literal>
-                                    を定義する<literal>tlist</literal><literal>y_ticks</literal> 
-                                    も操作することができます.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>z_ticks.locations: </term>
-                            <listitem>
-                                <para>z軸の目盛の位置を有する実数ベクトル.
-                                    このプロパティは(同じ大きさの)新しい実数ベクトルを指定することにより
-                                    編集可能です.
-                                    目盛を多くまたは少なくするには,対応する文字列ベクトル<literal>z_ticks.labels</literal>
-                                    を定義する<literal>tlist</literal><literal>z_ticks</literal> 
-                                    も操作することができます.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>x_ticks.labels: </term>
-                            <listitem>
-                                <para>x軸の目盛のラベルを有する文字列ベクトル.
-                                    このプロパティは(同じ大きさの)新しい実数ベクトルを指定することにより
-                                    編集可能です.
-                                    目盛を多くまたは少なくするには,対応する実数ベクトル<literal>x_ticks.locations</literal>
-                                    を定義する<literal>tlist</literal><literal>x_ticks</literal> 
-                                    も操作することができます.
-                                </para>
-                                <para>
-                                    Scilab 5.2以降, <link linkend="math_rendering_features_in_graphic">LaTeX または MathML式</link>を
-                                    書くことができます.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>y_ticks.labels: </term>
-                            <listitem>
-                                <para>y軸の目盛のラベルを有する文字列ベクトル.
-                                    このプロパティは(同じ大きさの)新しい実数ベクトルを指定することにより
-                                    編集可能です.
-                                    目盛を多くまたは少なくするには,対応する実数ベクトル<literal>y_ticks.locations</literal>
-                                    を定義する<literal>tlist</literal><literal>y_ticks</literal> 
-                                    も操作することができます.
-                                </para>
-                                <para>
-                                    Scilab 5.2以降, <link linkend="math_rendering_features_in_graphic">LaTeX または MathML式</link>を
-                                    書くことができます.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>z_ticks.labels: </term>
-                            <listitem>
-                                <para>z軸の目盛のラベルを有する文字列ベクトル.
-                                    このプロパティは(同じ大きさの)新しい実数ベクトルを指定することにより
-                                    編集可能です.
-                                    目盛を多くまたは少なくするには,対応する実数ベクトル<literal>z_ticks.locations</literal>
-                                    を定義する<literal>tlist</literal><literal>z_ticks</literal> 
-                                    も操作することができます.
-                                </para>
-                                <para>
-                                    Scilab 5.2以降, <link linkend="math_rendering_features_in_graphic">LaTeX または MathML式</link>を
-                                    書くことができます.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>box: </term>
-                            <listitem>
-                                <para>このプロパティは軸を箱で囲うかどうかを指定します.
-                                    値には, <literal>"off"</literal>,
-                                    <literal>"hidden_axes"</literal>, <literal>"back_half"</literal> または
-                                    <literal>"on".</literal>のどれかを指定します.
-                                    プロパティが <literal>"off"</literal>の場合,箱は描画されません.
-                                    プロパティが<literal>"hidden_axes"</literal>の場合,
-                                    背景枠のみが描画されます.
-                                    プロパティが<literal>"back_half"</literal>の場合, 
-                                    X, Y および Z 軸も描画されます.
-                                    プロパティが<literal>"on"</literal>の場合,箱全体が描画されます.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>filled: </term>
-                            <listitem>
-                                <para>このプロパティは軸の背景が描画されるかどうかを指定します.
-                                    値には, <literal>"off"</literal> または
-                                    <literal>"on".</literal>を指定します.
-                                    このプロパティが <literal>"off"</literal>の場合,
-                                    <literal>background</literal>プロパティで指定された色により
-                                    背景が描画されます.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>sub_ticks: </term>
-                            <listitem>
-                                <para>このフィールドは主目盛の間に描画される目盛の数を設定します.
-                                    このフィールドの値はベクトル <literal>[nx,ny]</literal>で,
-                                    <literal>nx</literal>はx軸の副目盛の数,
-                                    <literal>ny</literal>はy軸の副目盛の数となります.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>font_style: </term>
-                            <listitem>
-                                <para>目盛ラベルの表示に使用するフォントを指定します.
-                                    この値はロード済みのフォントの一つを指す正の整数です.
-                                    この値は最初のフォントを指す 0 と最後のフォントを指す
-                                    (ロード済みのフォントの数 - 1) の間である必要があります.
-                                    より詳細な情報については<link linkend="graphics_fonts">graphics_fonts</link>
-                                    を参照ください.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>font_size: </term>
-                            <listitem>
-                                <para>スカラーで,目盛ラベルに使用する文字の大きさを指定します.
-                                    <literal>fractional_font</literal>プロパティが <literal>"off"</literal>の場合,
-                                    値の整数部分のみが使用されます.
-                                    より詳細な情報については<link linkend="graphics_fonts">graphics_fonts</link>
-                                    を参照ください.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>font_color: </term>
-                            <listitem>
-                                <para>このプロパティは目盛ラベルの色を定義します.</para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>fractional_font: </term>
-                            <listitem>
-                                <para>
-                                    このプロパティは目盛ラベルが分数のフォントの大きさにより表示されるかどうかを指定します.
-                                    値には<literal>"on"</literal> または <literal>"off"</literal>を指定します.
-                                    <literal>"on"</literal>の場合,<literal>font_size</literal>の浮動小数点の値が
-                                    表示に使用され,フォントにアンチエイリアス処理が適用されます.
-                                    <literal>"off"</literal> の場合整数部のみが使用され,フォントのスムージングは
-                                    行われません.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>isoview: </term>
-                            <listitem>
-                                <para>このプロパティは x, y および z軸を等軸スケールにするため
-                                    (例えば曲線 sin(x) および cos(x) を表示する際に楕円ではなく円となるように)
-                                    に使用されます.
-                                    値には<literal>"on"</literal> または <literal>"off"</literal>を指定します.
-                                    値が <literal>"on"</literal> の場合,対応する図のプロパティ
-                                    <literal>figure_size</literal>の値に基づき
-                                    軸の <literal>data_bounds</literal> は自動的に変更されます.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>cube_scaling:</term>
-                            <listitem>
-                                <para>
-                                    このプロパティは<literal>3d mode</literal>で使用され,
-                                    x, y および z軸の再スケーリングを行います.
-                                    <literal>data</literal>を 1x1x1 の立方体に適合させることができます ;
-                                    目的は, 軸スケールが個々に非常に異なる場合に3次元グラフィックをより
-                                    よく表示することです.
-                                    値には  <literal>"on" </literal> または
-                                    <literal>"off"</literal> (デフォルト値)を指定します. 多くの場合, 
-                                    Matlabのような3次元表示の生成を容易にします.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>view: </term>
-                            <listitem>
-                                <para>このフィールドは,グラフィック領域に関係します.
-                                    <literal>"3d"</literal>を3次元視点に対応する値として指定する
-                                    ことができます.
-                                    その他の場合,初期値である2次元プロットを意味する
-                                    <literal>"2d"</literal> (デフォルト値)とすることができます.
-                                    このフラグはユーザが入力したプロットにも依存します:
-                                    例えば, <literal>plot3d </literal> コマンドは
-                                    <literal>view</literal>フラグを<literal>"2d"</literal>から
-                                    <literal>"3d"</literal>に切り替えます.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>rotation_angles: </term>
-                            <listitem>
-                                <para>
-                                    このフィールドはベクトル <literal>[alpha,theta]</literal>です. 
-                                    この2つの値は視点の球座標(単位:度)を指定します.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>log_flags: </term>
-                            <listitem>
-                                <para> 各軸のスケール(線形または対数)を指定する3文字の文字列.
-                                    各文字はそれぞれX, YおよびZ軸のスケールを指定します.
-                                    値には,線形スケールの場合に<literal>'n'</literal>,
-                                    対数スケールの場合に <literal>'l'</literal>を指定します.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>tight_limits: </term>
-                            <listitem>
-                                <para>
-                                    このプロパティの値が  <literal>"on"</literal> の場合,
-                                    軸は厳密に<literal>data_bounds</literal>の最小値と最大値に
-                                    調整されます.
-                                    このフィールドの値が <literal>"off"</literal>の場合,
-                                    目盛ラベルを見栄え良く表示するなどのために境界が拡大される
-                                    場合があります.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>data_bounds: </term>
-                            <listitem>
-                                <para>このフィールドにはx,yおよびz座標の境界値が含まれます.
-                                    このフィールドは行列  <literal>[xmin,ymin,zmin;xmax,ymax,zmax]</literal>または
-                                    <literal>[xmin,ymin;xmax,ymax]</literal>となります.
-                                    厳密に指定したデータ境界にするためには<literal>tight_limits</literal> を
-                                    <literal>"on"</literal>に設定する必要があることに注意してください (上記参照).
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>zoom_box: </term>
-                            <listitem>
-                                <para>このフィールドには座標系が指定された場合の
-                                    カレントのズームボックスが含まれます.
-                                    この値は空の行列(ズームなし)または(より小さな軸ボックスを指定する)ベクトル
-                                    <literal>[xmin,ymin,xmax,ymax,zmin,zmax]</literal>となります.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>margins: </term>
-                            <listitem>
-                                <para>A vector
-                                    <literal>[margin_left,margin_right,margin_top,margin_bottom]</literal>
-                                    はこの軸の余白部を指定します.このベクトルは[0 1]の範囲の数値で構成され,
-                                    デフォルト値は [0.125 0.125 0.125 0.125]です.
-                                    これらの数値は<literal>axes_bounds</literal>プロパティの対応する値,
-                                    つまり,
-                                    <literal>margin_left</literal> および <literal>margin_right</literal>
-                                    の場合は <literal>width</literal>,
-                                    <literal>margin_top</literal> および
-                                    <literal>margin_bottom</literal>の場合は<literal>height</literal>
-                                    に関する相対比です.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>axes_bounds: </term>
-                            <listitem>
-                                <para>
-                                    ベクトル <literal>[x_left,y_up,width,height]</literal> はこの軸で
-                                    使用される図の部分を指定します.
-                                    ただし, <literal>x_left</literal>, <literal>y_up</literal>, <literal>width</literal> 
-                                    および<literal>height</literal>は[0 1]の範囲の数値で,
-                                    それぞれ左上隅の位置と軸の寸法を指定します.
-                                    (これらの数値は対応する図<literal>figure_size</literal>プロパティの値
-                                    に対する比です.)
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>hidden_axis_color: </term>
-                            <listitem>
-                                <para>このプロパティはhidden軸の色を定義します.
-                                    カレントのカラーマップに関連する添字を指定します.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>user_data: </term>
-                            <listitem>
-                                <para>このフィールドは軸データ構造に任意のScilab変数を保存し,
-                                    再度取得するために使用できます.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                    </variablelist>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>高レベル関数のプロパティ</term>
-                <listitem>
-                    <para>
-                        <literal>plot</literal>, <literal>plot2dx</literal>, <literal>grayplot</literal>
-                        および <literal>matplot</literal> 関数は,
-                        引数<literal>frameflag</literal>により指定されない場合,
-                        以降のプロットをマージする方法を決定するために
-                        以下のプロパティを使用します.
-                        マージの結果は以下の2つのプロパティにより決定されます:
-                    </para>
-                    <variablelist>
-                        <varlistentry>
-                            <term>auto_clear: </term>
-                            <listitem>
-                                <para>
-                                    このプロパティが<literal>"on"</literal>に等しい場合,
-                                    高レベルグラフィクをコールする際に
-                                    カレントの軸は再初期化され,描画前に全ての子が消去されます.
-                                    この値が<literal>"off"</literal>の場合,
-                                    描画内容が<literal>"auto_scale"</literal>プロパティに基づき
-                                    カレントの軸に追加されます.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>auto_scale: </term>
-                            <listitem>
-                                <para>
-                                    軸データ境界を更新するためのプロパティ.
-                                    この値が <literal>"on"</literal>の場合,
-                                    プロットを新規に行うとカレントの軸プロパティは
-                                    以前とカレントのプロットに適合するよう調整されます.
-                                    この値が <literal>"off"</literal>の場合,
-                                    新規のプロットはカレントの軸データ境界内に描画されます.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                    </variablelist>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>子のデフォルト値: </term>
-                <listitem>
-                    <variablelist>
-                        <varlistentry>
-                            <term>hiddencolor: </term>
-                            <listitem>
-                                <para>
-                                    このプロパティは,隠蔽された部分の色を制御します.
-                                    カレントの色マップへの相対インデックスを値として指定します.
-                                    その他の場合,値が負の時,隠蔽された部分は面と同じ色となります.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>line_mode: </term>
-                            <listitem>
-                                <para>このフィールドには,
-                                    Segs Rectangle Legend Axis Plot3d Fac3d および
-                                    Polylineオブジェクトに関する
-                                    デフォルトの<literal>line_mode</literal>
-                                    プロパティの値が含まれます.
-                                    この値には, <literal>"on" </literal>(デフォルト)
-                                    または <literal>"off"</literal>を指定します.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>line_style: </term>
-                            <listitem>
-                                <para>このフィールドには,
-                                    Segs, Arcs, Rectangle および Polylineオブジェクトに関する
-                                    デフォルトの<literal>line_style</literal>
-                                    プロパティの値が含まれます.
-                                    <literal>line_style</literal> は線を描画する際に使用される線の種類を
-                                    選択します.
-                                    その値には, [0 8] の範囲の整数を指定します.
-                                    0 および 1は実線, その他の値は破線(破線,1点鎖線,長い1点鎖線,非常に大きい1点鎖線,
-                                    非常に大きく長い1点鎖線,点,2点)の選択を意味します.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>thickness: </term>
-                            <listitem>
-                                <para>
-                                    このフィールドは線の描画を行う全てのオブジェクトの<literal>thickness</literal>
-                                    プロパティのデフォルト値を含みます.
-                                    この値は,ピクセル単位の線幅を指定する正の実数です.
-                                    実際に表示される幅は指定された幅を最も近い整数に丸めることにより定義されます.
-                                    唯一の例外は,<literal>thickness</literal>の合計値が使用されるベクトルの
-                                    エキスポートの場合です.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>mark_mode: </term>
-                            <listitem>
-                                <para>
-                                    このフィールドには,Segs Rectangle Legend Axis Plot3d Fac3d および
-                                    Polyline オブジェクトに関する<literal>mark_mode</literal>プロパティの
-                                    デフォルト値が含まれます.
-                                    この値には,<literal>"on" </literal> または
-                                    <literal>"off"</literal> (デフォルト)を指定します.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>mark_style: </term>
-                            <listitem>
-                                <para>このフィールドには,Segs Rectangle Legend Axis Plot3d Fac3d および
-                                    Polyline オブジェクトに関する<literal>mark_style</literal>プロパティの
-                                    デフォルト値が含まれます.
-                                    <literal>mark_style</literal> は表示される記号の種類を選択します.
-                                    この値には, 以下を意味する[0 9]の範囲の整数を指定します:
-                                    ドット, プラス, 十宇, 星型, 塗りつぶされた菱形, 菱形,
-                                    上三角, 下三角, 三つ葉および円.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>mark_size_unit: </term>
-                            <listitem>
-                                <para>このフィールドには,Segs Rectangle Legend Axis Plot3d Fac3d および
-                                    Polyline に関する<literal>mark_size_unit</literal>プロパティのデフォルト値が
-                                    含まれます.
-                                    <literal>mark_size_unit</literal>に<literal>"point"</literal>が
-                                    指定された場合,<literal>mark_size</literal>の値は
-                                    直接ポイント単位で指定されます.
-                                    <literal>mark_size_unit</literal>に<literal>"tabulated"</literal>が
-                                    指定された場合,<literal>mark_size</literal>は
-                                    フォントサイズ配列に相対的に設定されます:
-                                    この場合,値には [0 5]の範囲の整数値を指定し,
-                                    それぞれ, 8pt, 10pt, 12pt, 14pt, 18pt および
-                                    24ptを意味します.
-                                    <link linkend="plot2d">plot2d</link>およびScilabの組み込み関数は
-                                    <literal>tabulated</literal>モードがデフォルトであることに注意
-                                    してください;
-                                    <link linkend="plot">plot</link>を使用する場合,
-                                    <literal>point</literal>モードが自動的に有効になります.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>mark_size: </term>
-                            <listitem>
-                                <para>
-                                    このフィールドには,Segs Rectangle Legend Axis Plot3d Fac3d および
-                                    Polylineオブジェクトに関する<literal>mark_size</literal>プロパティの
-                                    デフォルト値が含まれます.
-                                    <literal>mark_size</literal> は表示される記号のフォントの大きさを
-                                    選択します.
-                                    この値は [0 5]の範囲の整数である必要があり,それぞれ,
-                                    8pt, 10pt, 12pt, 14pt, 18pt および 24ptを意味します.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>mark_foreground: </term>
-                            <listitem>
-                                <para>このフィールドには,
-                                    この軸のもとで作成された全てのオブジェクトに関する<literal>mark_foreground</literal>
-                                    プロパティのデフォルト値が含まれます.
-                                    Polyline,
-                                    rectangle, legend, surface, segment および axisオブジェクトは
-                                    記号の表面(縁)色を指定する際にこのプロパティを使用します.
-                                    値には,(カレントのカラーマップに基づく)色のインデックスまたは
-                                    透明な輪郭を意味する 0 を指定します.
-                                    デフォルト値は<literal>-1</literal>(デフォルトの黒)で,
-                                    <literal>color_map</literal>を変更した場合でも,
-                                    この値<literal>-1</literal>は常にデフォルトの黒色を指し続けることに
-                                    注意してください.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>mark_background: </term>
-                            <listitem>
-                                <para>このフィールドには,
-                                    この軸のもとで作成された全てのオブジェクトに関する
-                                    <literal>mark_background</literal>
-                                    プロパティのデフォルト値が含まれます.
-                                    Polyline,
-                                    rectangle, legend, surface, segment および axisオブジェクトは
-                                    背景(表面)色を指定する際にこのプロパティを使用します.
-                                    値には,(カレントのカラーマップに基づく)色のインデックスまたは
-                                    透明な輪郭を意味する 0 を指定します.
-                                    デフォルト値は<literal>-2</literal>(デフォルトの白)で,
-                                    <literal>color_map</literal>を変更した場合でも,
-                                    この値<literal>-2</literal>は常にデフォルトの白色を指し続けることに
-                                    注意してください.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>foreground: </term>
-                            <listitem>
-                                <para>このフィールドには,
-                                    この軸のもとで作成された全てのオブジェクトに関する
-                                    <literal>foreground</literal>
-                                    プロパティのデフォルト値が含まれます.
-                                    値には,(カレントのカラーマップに基づく)色のインデックスを指定します.
-                                    デフォルト値は<literal>-1</literal>(デフォルトの黒)で,
-                                    <literal>color_map</literal>を変更した場合でも,
-                                    この値<literal>-1</literal>は常にデフォルトの黒色を指し続けることに
-                                    注意してください.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>background: </term>
-                            <listitem>
-                                <para>このフィールドには,
-                                    この軸のもとで作成された全てのオブジェクトに関する
-                                    <literal>background</literal>
-                                    プロパティのデフォルト値が含まれます.
-                                    値には,(カレントのカラーマップに基づく)色のインデックスを指定します.
-                                    デフォルト値は<literal>-2</literal>(デフォルトの白)で,
-                                    <literal>color_map</literal>を変更した場合でも,
-                                    この値<literal>-2</literal>は常にデフォルトの白色を指し続けることに
-                                    注意してください.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>arc_drawing_mode: </term>
-                            <listitem>
-                                <para>
-                                    このプロパティは,この Axes オブジェクトの元で作成された全ての Arc
-                                    オブジェクトの<literal>arc_drawing_mode</literal>プロパティの
-                                    デフォルト値を制御します.
-                                    値には, <literal>"nurbs"</literal> または <literal>"lines"</literal>
-                                    のどちらかを指定します.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>clip_state: </term>
-                            <listitem>
-                                <para>
-                                    このフィールドには全てのオブジェクトに関する<literal>clip_state</literal>
-                                    プロパティのデフォルト値が含まれます.以下の値を指定します:
-                                </para>
-                                <itemizedlist>
-                                    <listitem>
-                                        <para>
-                                            <literal>"off"</literal> 
-                                            以降に作成される全てのオブジェクトはクリップされない
-                                            ことを意味します (デフォルト値).
-                                        </para>
-                                    </listitem>
-                                    <listitem>
-                                        <para>
-                                            <literal>"clipgrf"</literal> 
-                                            以降に作成される全てのオブジェクトはAxesの境界の外側はクリップされる
-                                            ことを意味します.
-                                        </para>
-                                    </listitem>
-                                    <listitem>
-                                        <para>
-                                            <literal>"on"</literal> 
-                                            以降に作成される全てのオブジェクトは
-                                            プロパティ clip_box で指定した矩形の外側はクリップされることを
-                                            意味します.
-                                        </para>
-                                    </listitem>
-                                </itemizedlist>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>clip_box: </term>
-                            <listitem>
-                                <para>
-                                    このフィールドには全てのオブジェクトに関する<literal>clip_box</literal>
-                                    プロパティのデフォルト値が含まれます.
-                                    clip_state が <literal>"off"</literal>の場合,
-                                    この値は空の行列となります.その他の場合,このクリッピングは
-                                    ベクトル<literal>[x,y,w,h]</literal>(左上の点, 幅, 高さ)により指定されます.
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                        <varlistentry>
-                            <term>デフォルト値に関する注意 :</term>
-                            <listitem>
+
+<refnamediv>
+    
+    <refname>axes_properties</refname>
+    
+    <refpurpose>axesエンティティプロパティの説明</refpurpose>
+    
+</refnamediv>
+
+<refsection>
+    
+    <title>説明</title>
+    
+    <para>Axesエンティティはグラフィックエンティティ階層の第2レベルのエンティティです.
+        
+        このエンティティは
+        
+        座標系を変更するパラメータと子の作成時のパラメータのデフォルト値と共に
+        
+        描画する軸を定義します.
+        
+    </para>
+    
+    <variablelist>
+        
+        <varlistentry>
+            
+            <term>Axesプロパティs</term>
+            
+            <listitem>
+                
+                <variablelist>
+                    
+                    <varlistentry>
+                        
+                        <term>parent: </term>
+                        
+                        <listitem>
+                            
+                            <para>このフィールドは親の図のハンドルを有します.</para>
+                            
+                        </listitem>
+                        
+                    </varlistentry>
+                    
+                    <varlistentry>
+                        
+                        <term>children: </term>
+                        
+                        <listitem>
+                            
+                            <para>FA ベクトルは,軸の子である全てのグラフィックオブジェクトのハンドルを有します.
+                                
+                                これらのグラフィックオブジェクトは以下の型となります:
+                                
+                                <literal>"Compound"</literal>, <literal>"Rectangle"</literal>,
+                                
+                                <literal>"Polyline"</literal>, <literal>"Segs"</literal>, <literal>"Arc"</literal>,
+                                
+                                <literal>"Grayplot"</literal>,.. (<link linkend="Compound_properties">Compound_properties</link>,
+                                
+                                <link linkend="rectangle_properties">rectangle_properties</link>, <link linkend="champ_properties">champ_properties</link>,
+                                
+                                <link linkend="axis_properties">axis_properties</link>, <link linkend="polyline_properties">polyline_properties</link>,
+                                
+                                <link linkend="segs_properties">segs_properties</link>, <link linkend="grayplot_properties">grayplot_properties</link>,
+                                
+                                <link linkend="surface_properties">surface_properties</link>,
+                                
+                                <link linkend="fec_properties">fec_properties</link>, <link linkend="text_properties">text_properties</link>,
+                                
+                                <link linkend="legend_properties">legend_properties</link>参照)
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                    </varlistentry>
+                    
+                    <varlistentry>
+                        
+                        <term>visible: </term>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                このフィールドは軸の<literal>visible</literal>プロパティの値を有します.
+                                
+                                この値は<literal>"on" </literal>または<literal>"off"</literal>となります.
+                                
+                                デフォルトで,軸の visibleは <literal>"on"</literal>で,
+                                
+                                この場合, 全ての "visible" な子は画面に表示されます.
+                                
+                                <literal>"off"</literal> の場合, 軸とその全ての子は描画されません.
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                    </varlistentry>
+                    
+                    <varlistentry>
+                        
+                        <term>axes_visible: </term>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                <literal>1x3</literal> 文字列ベクトル. このプロパティは
+                                
+                                各軸が描画されるかどうかを指定します.
+                                
+                                この値はグローバル設定の場合<literal>"on"</literal> または <literal>"off"</literal>
+                                
+                                となります.
+                                
+                                一つの軸のみ変更する場合, 構文は <literal>axes_visible(N)</literal>となります.
+                                
+                                ただし, <literal>N</literal> は <literal>1,2</literal> または <literal>3</literal>で,
+                                
+                                それぞれ, <literal> x,y</literal> または <literal>z</literal>軸に対応します.
+                                
+                                データは必要に応じてスケーリングされ,値が <literal>"on"</literal>の場合,
+                                
+                                グリッドが描画されます.
+                                
+                                <literal>gca()</literal>コマンド(<literal>get"current_axes")</literal>のショートカット)
+                                
+                                または<literal>gcf()</literal>(<literal>get(current_figure)</literal>のショートカット)
+                                
+                                により簡単な軸エンティティを作成する際,軸の可視性(axes
+                                
+                                visiblibilty)は <literal>"off"</literal>に設定されます.
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                    </varlistentry>
+                    
+                    <varlistentry>
+                        
+                        <term>axes_reverse: </term>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                3つの軸(X,Y,Z)に対応する<literal>1x3</literal>文字列ベクトル.
+                                
+                                各軸について,このプロパティは値の増加方向を指定します.
+                                
+                                <literal>"off"</literal>の場合,デフォルトの方向が使用されます.
+                                
+                                <literal>"on"</literal>の場合, 方向は逆になります.
+                                
+                                一つの文字列のみ(<literal>"on"</literal> または
+                                
+                                <literal>"off"</literal>) を使用することも可能です.
+                                
+                                この場合, 3つのデータは同じ値に設定されます.
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                    </varlistentry>
+                    
+                    <varlistentry>
+                        
+                        <term>grid: </term>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                フィールドの値はベクトル<literal>[x-grid,y-grid,z-grid]</literal>です.
+                                
+                                ただし,<literal>x-grid</literal>はx軸の描画グリッドを制御し,
+                                
+                                <literal>y-grid,z-grid</literal>はそれぞれy軸,z軸に対応します.
+                                
+                                デフォルト値は <literal>-1</literal>で,グリッドは描画されません.
+                                
+                                それ以外の場合, grid の値により指定された色添字により
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                    </varlistentry>
+                    
+                    <varlistentry>
+                        
+                        <term>grid_position: </term>
+                        
+                        <listitem>
+                            
+                            <para>この文字列は他のグラフィックエンティティに相対的なグリッドの位置
+                                
+                                を指定します.その値には 他のグラフィックエンティティの前にグリッドを描画する
+                                
+                                <literal>"foreground"</literal>, もしくは
+                                
+                                グリッドの背後に描画する<literal>"background"</literal>のどちらかを指定します.
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                    </varlistentry>
+                    
+                    <varlistentry>
+                        
+                        <term>x_location: </term>
+                        
+                        <listitem>
+                            
+                            <para>x軸の位置を指定します.指定可能な値は:</para>