japanese translation updated. 59/14459/3
Rui Hirokawa [Sat, 26 Apr 2014 13:34:22 +0000 (22:34 +0900)]
Change-Id: Ia6f6e1f0cf52c20b53004a3a86fa89d3095673d6

71 files changed:
scilab/modules/api_scilab/help/ja_JP/handle/A_isHandleType.xml
scilab/modules/api_scilab/help/ja_JP/handle/B_getScalarHandle.xml
scilab/modules/api_scilab/help/ja_JP/handle/C_createScalarHandle.xml
scilab/modules/api_scilab/help/ja_JP/handle/D_handleExample.xml
scilab/modules/api_scilab/help/ja_JP/optionals/getOptionals.xml
scilab/modules/cacsd/help/ja_JP/plot_display/chart.xml
scilab/modules/cacsd/help/ja_JP/plot_display/nicholschart.xml
scilab/modules/cacsd/help/ja_JP/plot_display/phaseplot.xml
scilab/modules/core/help/ja_JP/1_keywords/backslash.xml
scilab/modules/core/help/ja_JP/1_keywords/slash.xml
scilab/modules/core/help/ja_JP/debugging/debug.xml
scilab/modules/core/help/ja_JP/error_handling/error.xml
scilab/modules/core/help/ja_JP/error_handling/error_table.xml
scilab/modules/core/help/ja_JP/variables/clear.xml
scilab/modules/core/help/ja_JP/variables/clearglobal.xml
scilab/modules/core/help/ja_JP/variables/exists.xml
scilab/modules/core/help/ja_JP/variables/getvariablesonstack.xml
scilab/modules/core/help/ja_JP/variables/isdef.xml
scilab/modules/core/help/ja_JP/variables/isglobal.xml
scilab/modules/core/help/ja_JP/variables/names.xml
scilab/modules/core/help/ja_JP/variables/predef.xml
scilab/modules/core/help/ja_JP/variables/who.xml
scilab/modules/core/help/ja_JP/variables/who_user.xml
scilab/modules/core/help/ja_JP/variables/whos.xml
scilab/modules/elementary_functions/help/ja_JP/elementarymatrices/eye.xml
scilab/modules/elementary_functions/help/ja_JP/elementarymatrices/linspace.xml
scilab/modules/elementary_functions/help/ja_JP/elementarymatrices/logspace.xml
scilab/modules/elementary_functions/help/ja_JP/matrixmanipulation/flipdim.xml
scilab/modules/elementary_functions/help/ja_JP/matrixmanipulation/repmat.xml
scilab/modules/elementary_functions/help/ja_JP/matrixmanipulation/resize_matrix.xml
scilab/modules/elementary_functions/help/ja_JP/searchandsort/dsearch.xml
scilab/modules/elementary_functions/help/ja_JP/searchandsort/gsort.xml
scilab/modules/elementary_functions/help/ja_JP/setoperations/members.xml
scilab/modules/fileio/help/ja_JP/path_filename/fullpath.xml
scilab/modules/fileio/help/ja_JP/path_filename/splitURL.xml
scilab/modules/fileio/help/ja_JP/path_filename/tempname.xml
scilab/modules/graphics/help/ja_JP/2d_plot/Matplot.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/annotation/legend_properties.xml
scilab/modules/graphics/help/ja_JP/axes_operations/axes_properties.xml
scilab/modules/helptools/etc/images_md5.txt
scilab/modules/helptools/images/splin3d_ja_JP_1.png [new file with mode: 0644]
scilab/modules/history_manager/help/ja_JP/gethistoryfile.xml
scilab/modules/history_manager/help/ja_JP/loadhistory.xml
scilab/modules/history_manager/help/ja_JP/savehistory.xml
scilab/modules/history_manager/help/ja_JP/sethistoryfile.xml
scilab/modules/interpolation/help/ja_JP/bsplin3val.xml
scilab/modules/interpolation/help/ja_JP/cshep2d.xml
scilab/modules/interpolation/help/ja_JP/eval_cshep2d.xml
scilab/modules/interpolation/help/ja_JP/interp.xml
scilab/modules/interpolation/help/ja_JP/interp1.xml
scilab/modules/interpolation/help/ja_JP/interp2d.xml
scilab/modules/interpolation/help/ja_JP/interp3d.xml
scilab/modules/interpolation/help/ja_JP/linear_interpn.xml
scilab/modules/interpolation/help/ja_JP/splin.xml
scilab/modules/interpolation/help/ja_JP/splin2d.xml
scilab/modules/interpolation/help/ja_JP/splin3d.xml
scilab/modules/io/help/ja_JP/load.xml
scilab/modules/io/help/ja_JP/save.xml
scilab/modules/matio/help/ja_JP/matfile_open.xml
scilab/modules/polynomials/help/ja_JP/pol2str.xml
scilab/modules/polynomials/help/ja_JP/poly.xml
scilab/modules/scinotes/help/ja_JP/scinotes.xml
scilab/modules/special_functions/help/ja_JP/calerf.xml
scilab/modules/special_functions/help/ja_JP/dawson.xml
scilab/modules/special_functions/help/ja_JP/dlgamma.xml
scilab/modules/special_functions/help/ja_JP/erfi.xml
scilab/modules/special_functions/help/ja_JP/gamma.xml
scilab/modules/special_functions/help/ja_JP/gammaln.xml
scilab/modules/special_functions/help/ja_JP/percentasn.xml

index a251b49..9e0ac06 100644 (file)
@@ -84,7 +84,7 @@
         
     </refsection>
     
-    <title>History</title>
+    <title>履歴</title>
     
     <revhistory>
         
     
 </refentry>
 
+
+
index 62371ca..1b58611 100644 (file)
@@ -99,6 +99,7 @@
         <para>成功した場合は 0, それ以外はScilabコンソールにエラーメッセージを出力し,
             
             最初のエラー番号を返します.
+            
         </para>
         
     </refsection>
     
 </refentry>
 
+
+
index 1ce48e1..4d17831 100644 (file)
@@ -1,5 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 
+
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) 2009  - DIGITEO - Antoine ELIAS
         <para>成功した場合は 0, それ以外はScilabコンソールにエラーメッセージを出力し,
             
             最初のエラー番号を返します.
+            
         </para>
         
     </refsection>
     
-    <title>History</title>
+    <title>履歴</title>
     
     <revhistory>
         
     
 </refentry>
 
+
+
index 224cc2a..cea91b8 100644 (file)
@@ -30,7 +30,7 @@
                     
                     <para>
                         
-                        Scilab環境ポインタ, api_scilab.h により定義された "pvApiCtx"で指定.
+                        Scilab環境ポインタ, api_scilab.h により定義された "pvApiCtx"で指定.                        
                         
                     </para>
                     
index 4dc7037..fbf9762 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="chart">
+    
     <refnamediv>
+        
         <refname>chart</refname>
-        <refpurpose>ニコルス線図における等高線プロット</refpurpose>
+        
+        <refpurpose>
+            
+            ニコルス線図.
+            
+            <emphasis role="bold">この関数は廃止されます.</emphasis>
+            
+        </refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>chart([flags])
+            
             chart(gain [,flags])
+            
             chart(gain,phase [,flags])
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>gain</term>
+                
                 <listitem>
+                    
                     <para>実数ベクトル ( ゲイン (単位:DB))</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>phase</term>
+                
                 <listitem>
+                    
                     <para>実数ベクトル (位相 (単位:度 ))</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>flags</term>
+                
                 <listitem>
+                    
                     <para>最大4個のフラグのリスト(sup [,leg [,cm [,cphi]]])</para>
+                    
                     <variablelist>
+                        
                         <varlistentry>
+                            
                             <term>sup</term>
+                            
                             <listitem>
+                                
                                 <para>1は前のプロットへ重ね合わせを行うこと,
+                                    
                                     0 は重ね合わせを行わないことを示します.
+                                    
                                 </para>
+                                
                             </listitem>
+                            
                         </varlistentry>
+                        
                         <varlistentry>
+                            
                             <term>leg</term>
+                            
                             <listitem>
+                                
                                 <para>1 は凡例を描画する, 0 は凡例を描画しないことを示します</para>
+                                
                             </listitem>
+                            
                         </varlistentry>
+                        
                         <varlistentry>
+                            
                             <term>cm</term>
+                            
                             <listitem>
+                                
                                 <para>ゲイン曲線の色の添え字</para>
+                                
                             </listitem>
+                            
                         </varlistentry>
+                        
                         <varlistentry>
+                            
                             <term>cphi</term>
+                            
                             <listitem>
+                                
                                 <para>位相曲線の色の添え字</para>
+                                
                             </listitem>
+                            
                         </varlistentry>
+                        
                     </variablelist>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>ニコルス線図,つまり,
+            
             位相/ゲイン平面におけるy/(1+y)の等ゲイン,等位相の等高線
+            
             をプロットします.
+            
         </para>
+        
         <para>
+            
             <literal>chart</literal> は
+            
             <link linkend="black">black</link>と組み合わせて
+            
             使用することができます.
+            
         </para>
+        
         <para>
+            
             <literal>gain</literal> および
+            
             <literal>phase</literal> のデフォルト値はそれぞれ以下のようになっています :
+            
         </para>
+        
         <para>
+            
             <literal>[-12 -8 -6 -5 -4 -3 -2 -1.4 -1 -.5 0.25 0.5 0.7 1 1.4 2 2.3 3 4 5 6 8 12]</literal>
+            
         </para>
+        
         <para>
+            
             <literal>[-(1:10) , -(20:10:160)]</literal>
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
 s=poly(0,'s')
 h=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01))
@@ -109,16 +204,60 @@ black([h1;h],0.01,100,['h1';'h'])
 set(gca(),'data_bounds',[-180 -30;180 30]) //enlarge the frame
 chart(list(1,0));
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="nyquist">nyquist</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="black">black</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="nicholschart">nicholschart</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.5.0</revnumber>
+                
+                <revdescription>
+                    
+                    関数が廃止予定となりました. 5.5.1で削除されます. 
+                    
+                    代わりに <link linkend="nicholschart">nicholschart</link> を使用してください.
+                    
+                </revdescription>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
 </refentry>
+
index c5d7197..b849ce1 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="nicholschart">
+    
     <refnamediv>
+        
         <refname>nicholschart</refname>
+        
         <refpurpose>ニコルス線図</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
-        <synopsis>nicholschart([ modules [,args [,colors]]])</synopsis>
+        
+        <synopsis>nicholschart([modules] [,args] [,colors])</synopsis>
+        
+        <synopsis/>
         
     </refsynopsisdiv>
+    
     <refsection>
+        
         <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>modules</term>
+                
                 <listitem>
+                    
                     <para>実数ベクトル (モジュール (単位: dB))</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>args</term>
+                
                 <listitem>
+                    
                     <para>r実数ベクトル (位相 (単位: 度))</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>colorss</term>
+                
                 <listitem>
-                    <para>スカラーまたはベクトル, 等ゲインまたは等位相曲線の色インデックスs</para>
+                    
+                    <para>スカラーまたはベクトル, 等ゲインまたは等位相曲線の色インデックス</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             ニコルス線図をプロット: <literal>y</literal>の位相/ゲイン平面への
+            
             <literal>y/(1+y)</literal>の等モジュールおよび等引数等高線をプロット
+            
         </para>
+        
         <para>
+            
             <literal>nicholschart</literal> は,<link linkend="black">black</link>
+            
             と組み合わせて使用することができます.
+            
         </para>
+        
         <para>
+            
             <literal>modules</literal>および<literal>args</literal>の
+            
             デフォルト値はそれぞれ次のようになります :
+            
         </para>
+        
         <para>
+            
             <literal>[-12 -8 -6 -5 -4 -3 -2 -1.4 -1 -.5 0.25 0.5 0.7 1 1.4 2 2.3 3 4 5 6 8 12]</literal>
+            
         </para>
+        
         <para>
+            
             <literal>[-(1:10) , -(20:10:160)]</literal>
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
+        <title>注意</title>
+        
+        <para>
+            
+            従来からの<code>nicholschart</code>のニコルス線図の呼び出し手順は以下の形式でした:
+            
+            nicholschart(modules=gains, args=phases, colors=colors), 
+            
+            しかし,以下の呼び出し手順も利用可能です: nicholschart(gains, phases, colors).
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[
     //ニコルス線図
     clf()
     nicholschart(modules=[-6 -3 -1 1 3 6], args=[-1 -20 20 40 80 160 180]);
     ]]></programlisting>
+        
         <para>
+            
             <scilab:image localized="true">
+                
                 nicholschart(modules=[-6 -3 -1 1 3 6], args=[-1 -20 20 40 80 160 180]);
+                
             </scilab:image>
+            
         </para>
+        
         <programlisting role="example"><![CDATA[
     //ニコルス線図のグリッドを付けたブラック図
     s=poly(0,'s');
     Leg.legend_location="in_lower_right";
     nicholschart(colors=color('light gray')*[1 1])
     ]]></programlisting>
+        
         <para>
+            
             <scilab:image localized="true">
+                
                 s=poly(0,'s');
+                
                 Plant=syslin('c',16000/((s+1)*(s+10)*(s+100)));
+                
                 tau=0.2;xsi=1.2;
+                
                 PID=syslin('c',(1/(2*xsi*tau*s))*(1+2*xsi*tau*s+tau^2*s^2));
+                
                 clf();
+                
                 black([Plant;Plant*PID ],0.01,100,["Plant";"Plant and PID corrector"]);
+                
                 ax=gca();Leg=ax.children(1);
+                
                 Leg.legend_location="in_lower_right";
+                
                 nicholschart(colors=color('light gray')*[1 1])
+                
             </scilab:image>
+            
         </para>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="black">black</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="nyquist">nyquist</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="hallchart">hallchart</link>
+                
             </member>
+            
         </simplelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.5.0</revnumber>
+                
+                <revremark> 使用可能な呼び出し手順: nicholschart(gains, phases, colors).</revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
     </refsection>
+    
 </refentry>
+
index 54e8dbe..e68c81e 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) 2011 - INRIA - Serge Steer <serge.steer@inria.fr>
 * 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="phaseplot">
+    
     <refnamediv>
+        
         <refname>phaseplot</refname>
+        
         <refpurpose>周波数位相プロット</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>
+            
             phaseplot(sl)
+            
             phaseplot(sl,fmin,fmax [,step] [,comments] )
+            
             phaseplot(frq,db,phi [,comments])
+            
             phaseplot(frq, repf [,comments])
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
+        
         <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>sl</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         一入力多出力 (SIMO) 線形動的システム (<link linkend="syslin">syslin</link>参照).
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>fmin</term>
+                
                 <listitem>
+                    
                     <para>実スカラー: 表示する最小周波数 (単位:Hz) .</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>fmax</term>
+                
                 <listitem>
+                    
                     <para>実スカラー: 表示する最大周波数 (単位:Hz).</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>step</term>
+                
                 <listitem>
+                    
                     <para>実スカラー: 周波数離散化刻み (指数スケール)).
+                        
                         指定しない場合、このアルゴリズムは、
+                        
                         適用型周波数刻みを使用します.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>comments</term>
+                
                 <listitem>
+                    
                     <para>文字列ベクトル: 各曲線に付随する凡例ラベル.
+                        
                         オプションの値は空の配列です.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>frq</term>
+                
                 <listitem>
+                    
                     <para>行ベクトルまたは n x m 配列: 周波数離散化(Hz).</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>db</term>
+                
                 <listitem>
+                    
                     <para>n x m 配列:
+                        
                         <literal>frq</literal>に対応する大きさ. この引数が使用されない場合、
+                        
                         <literal>phaseplot</literal>は<literal>gainplot</literal>および
+                        
                         <literal>bode</literal>と同じ呼び出し手順となります.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>phi</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         n x m 配列:  <literal>frq</literal>に対応する位相[deg].
+                        
                         <literal>phaseplot</literal>関数は曲線
+                        
                         <literal>phi(i,:)</literal> 対 <literal>frq(i,:)</literal>
+                        
                         をプロットします.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>repf</term>
+                
                 <listitem>
+                    
                     <para>n x m 複素数配列.
+                        
                         <literal>phaseplot</literal> 関数は,曲線
+                        
                         <literal>phase(repf(i,:))</literal> 対
+                        
                         <literal>frq(i,:)</literal> をプロットします.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             この関数はシステムの周波数応答の位相を描画します.
+            
             このシステムは異なる表現で指定することができます:
+            
         </para>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para>
+                    
                     <literal>phaseplot(sl,...)</literal> の場合,
+                    
                 </para>
+                
                 <para>
+                    
                     <literal>sl</literal>
+                    
                     は連続系または離散系SIMOとすることができます.
+                    
                     多出力の場合,出力は異なる記号でプロットされます.
+                    
                 </para>
+                
                 <para>この場合,周波数は以下のように指定できます:</para>
+                
                 <itemizedlist mark="point">
+                    
                     <listitem>
+                        
                         <para>
+                            
                             上限および下限周波数[Hz]
+                            
                             <literal>fmin</literal>, <literal>fmax</literal>および
+                            
                             周波数刻み(オプション) <literal>step</literal>.
+                            
                             <literal>fmin</literal> および
+                            
                             <literal>fmax</literal>のデフォルト値は,
+                            
                             <literal>sl</literal>が連続系の場合
+                            
                             <literal>1.e-3</literal>および
+                            
                             <literal>1.e3</literal>,
+                            
                             離散系の場合 <literal>1.e-3</literal>,
+                            
                             <literal>0.5/sl.dt</literal> (ナイキスト周波数) です.
+                            
                             引数<literal>step</literal> が省略された場合,
+                            
                             この関数は適用型周波数刻み
+                            
                             (<link linkend="calfrq">calfrq</link>参照)を使用します.
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>
+                            
                             行ベクトルまたは二次元配列 <literal>frq</literal>は
+                            
                             周波数をHzで指定します.
+                            
                             2次元配列は多出力系において各入出力の組について
+                            
                             異なる周波数刻みを適用する場合に使用されます.
+                            
                         </para>
+                        
                     </listitem>
+                    
                 </itemizedlist>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <literal>phaseplot(frq,...)</literal> の場合
+                    
                 </para>
+                
                 <para>
+                    
                     この場合,事前に計算された周波数応答により周波数位相プロットを
+                    
                     描画することができます.
+                    
                     周波数応答は複素数表現<literal>repf</literal>または
+                    
                     ゲイン/位相表現<literal>db</literal>,
+                    
                     <literal>phi</literal>で指定できます.
+                    
                 </para>
+                
                 <para>
+                    
                     <literal>frq</literal> および <literal>repf</literal> は,
+                    
                     行ベクトルまたは(各行が入出力の組みを表わす) n x m 配列です.
+                    
                 </para>
+                
             </listitem>
+            
         </itemizedlist>
+        
         <para>
+            
             The <link linkend="datatips">データティップ</link>ツールは位相曲線に沿ってデータを表示する際に使用できます.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[
     s=poly(0,'s')
     h1=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01))
     title('Phaseplot')
 
     ]]></programlisting>
+        
         <para>
+            
             <scilab:image localized="true">
+                
                 s=poly(0,'s')
+                
                 h1=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01))
+                
                 h2=syslin('c',(s^2+2*0.1*15.1*s+228.01)/(s^2+2*0.9*15*s+225))
+                
                 clf();phaseplot([h1;h2],0.01,100,..
+                
                 ["$\frac{s^2+18 s+100}{s^2+6.06 s+102.1}$";
+                
                 "$\frac{s^2+3.02 s+228.01}{s^2+27 s+225}$"])
+                
                 title('Phaseplot')
+                
             </scilab:image>
+            
         </para>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="bode">bode</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="gainplot">gainplot</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="repfreq">repfreq</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="calfrq">calfrq</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="datatips">datatips</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
     <refsection>
-        <title>ヒストリ</title>
+        
+        <title>履歴</title>
+        
         <revhistory>
+            
             <revision>
+                
                 <revnumber>5.4.0</revnumber>
-                <revremark>Function phaseplot introduced.</revremark>
+                
+                <revremark>関数phaseplotが導入されました.</revremark>
+                
             </revision>
+            
         </revhistory>
+        
     </refsection>
+    
 </refentry>
+
index 257fea5..7013d07 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="backslash">
+    
     <refnamediv>
+        
         <refname>backslash</refname>
+        
         <refpurpose>(\) 左行列除算.</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
-        <synopsis>x=A\b</synopsis>
+        
+        <synopsis>X=A\B</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             バックスラッシュは左行列除算を定義します. 
-            <literal>x=A\b</literal> は <literal>A*x=b</literal>の解です.
+            
+            <literal>X=A\B</literal> は <literal>A*X=B</literal>の解です.
+            
         </para>
+        
         <para>
+            
             <literal>A</literal> が正方で非特異の場合,
-            <literal>x=A\b</literal> (唯一の解) は <literal>x=inv(A)*b</literal> 
-            と等価です(しかし,計算コストははるかに小さくなります).
+            
+            <literal>X=A\B</literal> は <literal>X=inv(A)*B</literal> 
+            
+            と等価です.しかし,計算はより正確で浮動小数点演算の負荷は小さくなります.
+            
+            すなわち,線形システムの方程式<code>A*X=B</code>の解を計算する際には,
+            
+            バックスラッシュ演算子を使用するべきであり,<function>inv</function>関数の
+            
+            使用は避けるべきです.
+            
         </para>
+        
         <para>
-            <literal>A</literal> が正方でない場合, <literal>x</literal> は最小二乗解となります.
-            すなわち, <literal>norm(A*x-b)</literal> は最小値 (ユークリッドノルム)となります. <literal>A</literal> が列フルランクの場合,最小二乗解, <literal>x=A\b</literal>, は
-            唯一の解 (<literal>norm(A*x-b)</literal>を最小化する唯一の
-            <literal>x</literal>が存在)となります.
+            
+            <literal>A</literal>が正方の場合, 解<literal>X</literal>は
+            
+            LU分解または線形最小二乗ソルバのどちらかにより計算できます.
+            
+            <literal>A</literal>の条件数が<code>1/(10*%eps)</code>よりも小さい場合
+            
+            (つまり,<literal>A</literal>の条件が良い場合),ピボット選択付きLU分解が使用されます.
+            
+            そうでない場合(<literal>A</literal>の条件が悪い場合),
+            
+            <literal>X</literal> は<literal>A</literal>の完全直交分解を用いて
+            
+            <literal>||A*X-B||</literal>を最小化する最小ノルム解となります
+            
+            (すなわち,<literal>X</literal>は線形最小二乗問題の解です).
+            
+        </para>
+        
+        <para>     
+            
+            <literal>A</literal> が正方でない場合, <literal>X</literal> は最小二乗解となります.
+            
+            すなわち, <code>norm(A*X-B)</code> は,最小値 (ユークリッドノルム)となります. 
+            
+            <literal>A</literal> が列フルランクの場合,最小二乗解, <literal>X=A\B</literal>, は
+            
+            唯一の解 (<literal>norm(A*X-B)</literal>を最小化する唯一の
+            
+            <literal>X</literal>が存在)となります.
+            
             <literal>A</literal> が列フルランクでない場合, 最小二乗解は唯一ではなくなり,
-            <literal>x=A\b</literal>は一般に最小ノルム解ではなくなります
-            (最小ノルム解は <literal>x=pinv(A)*b</literal>です).
+            
+            <literal>X=A\B</literal>は一般に最小ノルム解ではなくなります
+            
+            (最小ノルム解は <literal>X=pinv(A)*B</literal>です).
+            
         </para>
+        
         <para>
+            
             <literal>A.\B</literal>  は<literal>(i,j)</literal> エントリが
+            
             <literal>A(i,j)\B(i,j)</literal>となる行列となります.
+            
             <literal>A.\B</literal> は
+            
             <literal>A*ones(B).\B</literal> (または <literal>A.\(B*ones(A))</literal>
+            
             と等価になります.
+            
         </para>
+        
         <para>
+            
             <literal>A\.B</literal>  は定義されていない演算子です.
-            この演算子は, * または /.のように新しい演算子を定義する際に使用できます(オーバーロード参照).
+            
+            この演算子は, <literal>*</literal> または <literal>/</literal> のように
+            
+            新しい演算子を定義する際に使用できます
+            
+            (<link linkend="overloading">オーバーロード</link>参照).
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
-        <programlisting role="example"><![CDATA[ 
-A=rand(3,2);b=[1;1;1]; x=A\b; y=pinv(A)*b;  x-y
-A=rand(2,3);b=[1;1]; x=A\b; y=pinv(A)*b; x-y, A*x-b, A*y-b
-A=rand(3,1)*rand(1,2); b=[1;1;1]; x=A\b; y=pinv(A)*b; A*x-b, A*y-b
-A=rand(2,1)*rand(1,3); b=[1;1]; x=A\b; y=pinv(A)*b; A*x-b, A*y-b 
+        
+        <programlisting role="example"><![CDATA[
+A=[
+   9.   -36.    30.
+  -36.   192.  -180.
+   30.  -180.   180.
+];
+b=[
+   3.
+  -24.
+   30.
+];
+x=A\b
+A*x-b // ゼロに近い
+
+A=rand(3,2);
+b=[1;1;1];
+x=A\b;
+y=pinv(A)*b;
+x-y
+A=rand(2,3);b=[1;1];
+x=A\b;
+y=pinv(A)*b;
+x-y, A*x-b, A*y-b
+
+// ランク落ちの場合
+A=rand(3,1)*rand(1,2);
+b=[1;1;1];
+x=A\b;
+y=pinv(A)*b;
+A*x-b, A*y-b
+A=rand(2,1)*rand(1,3);
+b=[1;1];
+x=A\b;
+y=pinv(A)*b;
+A*x-b, A*y-b
 
-// A benchmark of several linear solvers
+// 複数の線形ソルバのベンチマーク
 
-[A,descr,ref,mtype] = ReadHBSparse(SCI+"/modules/umfpack/examples/bcsstk24.rsa"); 
+[A,descr,ref,mtype] = ReadHBSparse(SCI+..
+   "/modules/umfpack/examples/bcsstk24.rsa");
 
 b = zeros(size(A,1),1);
 
 tic();
 res = umfpack(A,'\',b);
-mprintf('\ntime needed to solve the system with umfpack: %.3f\n',toc());
+mprintf('\nTime with umfpack: %.3f\n',toc());
 
 tic();
 res = linsolve(A,b);
-mprintf('\ntime needed to solve the system with linsolve: %.3f\n',toc());
+mprintf('\ntime with linsolve: %.3f\n',toc());
 
 tic();
 res = A\b;
-mprintf('\ntime needed to solve the system with the backslash operator: %.3f\n',toc());
+mprintf('\ntime with backslash: %.3f\n',toc());
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="slash">slash</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="inv">inv</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="pinv">pinv</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="percent">percent</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="ieee">ieee</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="linsolve">linsolve</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="umfpack">umfpack</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.1</revnumber>
+                
+                <revremark>バックスラッシュの条件数の閾値が増加しました.</revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
 </refentry>
+
index c96e5f3..31861b8 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="slash">
+    
     <refnamediv>
+        
         <refname>slash</refname>
+        
         <refpurpose>(/) 右除算およびフィードバック</refpurpose>
+        
     </refnamediv>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
-            右除算.  <literal>x=A / b</literal> は, <literal>x*b=A</literal> の解です.
+            
+            右除算.  <literal>X=A/B</literal> は, <literal>X*B=A</literal> の解です.
+            
         </para>
+        
         <para>
-            <literal>b/a = (a' \ b')'</literal> .
+            
+            スラッシュ (右除算) とバックスラッシュ (左除算) 演算子は以下の等式で関係付けられます:
+            
+            <code>B/A=(A'\B')'</code>.
+            
         </para>
+        
         <para>
-            <literal>a./  b</literal> は,
-            エントリ <literal>a(i,j)/ b(i,j)</literal> を有する行列です.
-            <literal>b</literal> がスカラー(1x1 行列)の場合,
-            この処理は <literal> a./b*ones(a)</literal> と同じになります.
-            (<literal>a</literal> がスカラーの場合も同様).
+            
+            <literal>A</literal>が正方の場合, 
+            
+            <literal>X</literal> の解はLU分解または線形最小二乗ソルバにより求められます.
+            
+            <literal>A</literal>の条件数が <code>1/(10*%eps)</code>以下の場合(すなわち<literal>A</literal>
+            
+            の条件が良い場合), ピボット選択付きLU分解が使用されます.
+            
+            そうでない場合 (すなわち <literal>A</literal> の条件が悪い場合),
+            
+            <literal>X</literal> は<literal>A</literal>の完全直交分解により
+            
+            <literal>||A*X-B||</literal>を最小化する最小ノルム解となります
+            
+            (すなわち, <literal>X</literal>は線形最小二乗問題の解となります).
+            
         </para>
+        
         <para>
-            <literal>123./b</literal> は, <literal>(123.)/b</literal> と
-            解釈されることに注意してください.
-            この場合, ドット(.) は演算子ではなく数値の一部となります.
+            
+            <code>A./B</code> は要素毎の右除算, すなわち,
+            
+            エントリ<literal>A(i,j)/B(i,j)</literal>を有する行列となります.
+            
+            <literal>B</literal> がスカラー (1x1 行列)の場合,この演算は
+            
+            <code>A./B*ones(A)</code>と同じになります. 
+            
+            <literal>A</literal>がスカラーの場合も
+            
+            同様です.
+            
         </para>
+        
         <para>
-            バックスラッシュは左除算を意味します.
+            
+            <note>
+                
+                <code>123./B</code> は <code>(123.)/B</code>と解釈されることに注意してください. 
+                
+                この場合,ドットは演算子ではなく数値の一部となります.
+                
+            </note>
+            
         </para>
+        
         <para>
-            システムフィードバック.  <literal>S=G/.K</literal> は <literal>S=G*(eye()+K*G)^(-1)</literal>
-            と評価されます.
+            
+            システムフィードバック. <code>S = G/.K</code>は
+            
+            <code>S = G*(eye() + K*G)^(-1)</code> と評価されます.
+            
             この演算子はシンプルな記述が容易に可能となります.
+            
         </para>
+        
         <para>
-            <literal>G/.5</literal> は <literal>G/(.5)</literal>と解釈されることに注意してください. 
-            この場合, ドット(.) は演算子ではなく数値の一部となります.
+            
+            <note>
+                
+                <code>G/.5</code> は
+                
+                <code>G/(.5)</code>と解釈されることに注意してください.
+                
+                この場合, ドット(.) は演算子ではなく数値の一部となります.
+                
+            </note>
+            
         </para>
+        
         <para>
-            コメント <literal>//</literal> は, 特定の行をコメントにします.
-            すなわち, <literal>//</literal> で始まる行はインタプリタから無視されます.
+            
+            コメント <code>//</code> は, 特定の行をコメントにします.
+            
+            すなわち, <code>//</code> で始まる行はインタプリタから無視されます.
+            
         </para>
+        
     </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[
+a=[3.,-24.,30.];
+B=[
+   9.   -36.    30.
+  -36.   192.  -180.
+   30.  -180.   180.
+];
+x=a/B
+x*B-a // ゼロに近い
+
+a=4 / 2; // 2となります
+a=2 ./ [2,4]; //     1.    0.5
+// コメントは有用です. コードを理解しやすくします.
+ ]]></programlisting>
+        
+    </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="inv">inv</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="percent">percent</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="backslash">backslash</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="ieee">ieee</link>
+                
             </member>
+            
         </simplelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.1</revnumber>
+                
+                <revremark>バックスラッシュの条件数の閾値が増加しました.</revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
     </refsection>
+    
 </refentry>
+
index d7eee8f..5a801cd 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="debug">
+    
     <refnamediv>
+        
         <refname>debug</refname>
-        <refpurpose>デバッギングレベル</refpurpose>
+        
+        <refpurpose>Scilab内部のデバッギングレベル</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼出し手順</title>
+        
         <synopsis>debug(level_int)
+            
             level_int = debug()
-            previous_level_int = debug(level_int)
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>level_int</term>
+                
                 <listitem>
-                    <para>integer (-1 to 4)</para>
+                    
+                    <para>整数 (-1 から 4)</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
-            <literal>level_int</literal> の値(0,1,2,3,4)により, <literal>debug</literal>
-            はデバッグのレベルを定義します. この関数はパーサ用で,
+            
+            <varname>level_int</varname> の値 0,1,2,3,4 により, 
+            
+            <code>debug</code> はデバッグのレベルを定義します. 
+            
+            この関数はパーサ用で,
+            
             Scilabスクリプト用ではなく, Scilabのエキスパート専用です.
+            
         </para>
+        
+        <para>
+            
+            <note>
+                
+                この関数の出力は Scilab 6.0.0で変更されます.
+                
+            </note>
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[ 
+debug(3);
+2+2
+//  0.200E+01
+//+
+//  0.200E+01
+// eol
+ ]]></programlisting>
+        
+    </refsection>
+    
+    
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revremark>
+                    
+                    新しい値を設定した際,出力引数として過去の値が返されます.
+                    
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
     </refsection>
+    
 </refentry>
+
index edb507f..0a0a3c8 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="error">
+    
     <refnamediv>
+        
         <refname>error</refname>
+        
         <refpurpose>エラーメッセージ</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼出し手順</title>
+        
         <synopsis>error(message)
+            
             error(message, n)
+            
             error(n)
+            
             error(n, message)
+            
             error(n, pos)
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>message</term>
+                
                 <listitem>
-                    <para>文字列. 表示されるエラーメッセージ.</para>
+                    
+                    <para>文字列または文字列のベクトル. 表示されるエラーメッセージ.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>n</term>
+                
                 <listitem>
+                    
                     <para>整数. エラーメッセージの番号</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>pos</term>
+                
                 <listitem>
+                    
                     <para>整数. エラーメッセージのパラメータ</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             <literal>error</literal> 関数によりエラーメッセージを発行でき,
+            
             エラーを処理できます.
+            
             デフォルトで <literal>error</literal> は実行を停止し,
+            
             プロンプトレベルに復帰します.
+            
             このデフォルト動作は,<literal>errcatch</literal> または 
+            
             <literal>execstr(...,'errcatch')</literal> 関数により変更できます.
+            
         </para>
+        
         <para>
+            
             <literal>error(message)</literal> は<literal>message</literal>の文字列を
+            
             出力します.
+            
             エラーメッセージの番号は 10000 となります.
+            
         </para>
+        
         <para>
+            
             <literal>error(message,n)</literal> は
+            
             <literal>message</literal>の文字列を出力します.
+            
             エラーメッセージの番号は<literal>n</literal>で指定されます.
+            
             この番号は 10000 より大きい必要があります. 
+            
         </para>
+        
         <para>
+            
             <literal>error(n)</literal> は,
+            
             エラー番号 <literal>n</literal>の
+            
             定義済みエラーメッセージを出力します. 
+            
         </para>
+        
         <para>いくつかの定義済みエラーメッセージが
+            
             パラメータを必要とします(
+            
             <link linkend="error_table">error_table</link>参照).
+            
             この場合,パラメータの値を指定するために
+            
             <literal>error(n,pos)</literal>のように
+            
             引数<literal>pos</literal>を使用する必要があります.
+            
             その他の場合, <literal>pos</literal>  引数は無視されます.
+            
         </para>
-        <para> エラーメッセージのリストおよび対応するエラー番号については
+        
+        <para> 
+            
+            エラーメッセージのリストおよび対応するエラー番号については
+            
             <link linkend="error_table">error_table</link> を参照ください.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[error('my error message')
 error(43)
 error(52, 3)
 error(10001, ['A'; 'multi';'line';'error';'message'])
 lasterror()]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="warning">warning</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="errcatch">errcatch</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="execstr">execstr</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="lasterror">lasterror</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="messagebox">messagebox</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revremark>
+                    
+                    <literal>error</literal> 関数は入力引数として文字列ベクトルを受け付けます.
+                    
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
 </refentry>
+
index c1b0dee..aed25dc 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns: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="error_table" xml:lang="ja">
+    
     <refnamediv>
+        
         <refname>error_table</refname>
-        <refpurpose>エラーメッセージのテーブル</refpurpose>
+        
+        <refpurpose>エラーメッセージの表</refpurpose>
+        
     </refnamediv>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>このページは
-            定義済みエラーメッセージとそれらの関連するエラー番号のテーブルを示します.
+            
+            定義済みエラーメッセージとそれらの関連するエラー番号の表を示します.
+            
             これらのエラーメッセージのいくつかは,
+            
             パーサエラーや特定の組み込みエラーのために
+            
             Scilab自体で使用されています.
+            
             これ以外の使用法としてはより一般的なものがあり,
+            
             Scilab関数内で使用することができます.
+            
             星がついたメッセージでは,
+            
             構文<literal>error(n,pos)</literal>が処理されます.
+            
         </para>
+        
         <para>1 "Incorrect assignment."</para>
+        
         <para>2 "Invalid factor."</para>
+        
         <para>3 "Waiting for right parenthesis."</para>
+        
         <para>4 "Undefined variable: %s"</para>
+        
         <para>5 "Inconsistent column/row dimensions."</para>
+        
         <para>6 "Inconsistent row/column dimensions."</para>
+        
         <para>7 "Dot cannot be used as modifier for this operator."</para>
+        
         <para>8 "Inconsistent addition."</para>
+        
         <para>9 "Inconsistent subtraction."</para>
+        
         <para>10 "Inconsistent multiplication."</para>
+        
         <para>11 "Inconsistent right division."</para>
+        
         <para>12 "Inconsistent left division."</para>
+        
         <para>13 "Redefining permanent variable."</para>
+        
         <para>14 "Eye variable undefined in this context."</para>
+        
         <para>15 "Submatrix incorrectly defined."</para>
+        
         <para>16 "Incorrect command!"</para>
+        
         <para>17 "stack size exceeded! Use stacksize function to increase
+            
             it."
+            
         </para>
+        
         <para>18 "Too many variables."</para>
+        
         <para>19 "Problem is singular."</para>
+        
         <para>* 20 "Wrong type for argument #%d: Square matrix expected."</para>
+        
         <para>21 "Invalid index."</para>
+        
         <para>22 "Recursion problems. Sorry..."</para>
+        
         <para>23 "Matrix norms available are 1, 2, inf, and fro."</para>
+        
         <para>24 "Convergence problem..."</para>
+        
         <para>25 "Bad call to primitive: %s"</para>
+        
         <para>26 "Too complex recursion! (recursion tables are full)"</para>
+        
         <para>27 "Division by zero..."</para>
+        
         <para>28 "Empty function..."</para>
+        
         <para>29 "Matrix is not positive definite."</para>
+        
         <para>30 "Invalid exponent."</para>
+        
         <para>31 "Incorrect string."</para>
+        
         <para>32 "singularity of log or tan function"</para>
+        
         <para>33 "too many "":"""</para>
+        
         <para>34 "Incorrect control intruction syntax."</para>
+        
         <para>34 "Syntax error in a '%s' instruction."
+            
             (if,while,select/case)
+            
         </para>
+        
         <para>* 36 "Wrong input argument #%d."</para>
+        
         <para>* 37 "Incorrect function at line %d."</para>
+        
         <para>38 "Wrong file name."</para>
+        
         <para>39 "Incorrect number of input arguments."</para>
+        
         <para>40 "Waiting for end of command."</para>
+        
         <para>41 "Incompatible output argument."</para>
+        
         <para>42 "Incompatible input argument."</para>
+        
         <para>43 "Not implemented in scilab..."</para>
+        
         <para>* 44 "Wrong argument %d."</para>
+        
         <para>* 45 "null matrix (argument # %d)."</para>
+        
         <para>46 "Incorrect syntax."</para>
+        
         <para>47 " end or else is missing..."</para>
+        
         <para>* 48 " input line longer than buffer size: %d"</para>
+        
         <para>49 "Incorrect file or format."</para>
+        
         <para>50 "Subroutine '%s' not found."</para>
+        
         <para>* 52 "Wrong type for argument #%d: Real matrix expected."</para>
+        
         <para>* 53 "Wrong type for input argument #%d: Real or complex matrix
+            
             expected."
+            
         </para>
+        
         <para>* 54 "Wrong type for input argument #%d: Polynomial expected."</para>
+        
         <para>* 55 "Wrong type for argument #%d: String expected."</para>
+        
         <para>* 56 "Wrong type for argument #%d: List expected."</para>
+        
         <para>57 "Problem with comparison symbol..."</para>
+        
         <para>58 "Function has no input argument..."</para>
+        
         <para>59 "Function has no output."</para>
+        
         <para>60 "Wrong size for argument: Incompatible dimensions."</para>
+        
         <para>61 "Direct access : give format."</para>
+        
         <para>* 62 "End of file at line %d."</para>
+        
         <para>* 63 "%d graphic terminal?"</para>
+        
         <para>64 "Integration fails."</para>
+        
         <para>* 65 "%d: logical unit already used."</para>
+        
         <para>66 "No more logical units available!"</para>
+        
         <para>67 "Unknown file format."</para>
+        
         <para>68 "Fatal error!!! Your variables have been saved in the file :
+            
             %s"
+            
         </para>
+        
         <para>69 "Floating point exception."</para>
+        
         <para>70 "Too many arguments in fort (max 30)."</para>
+        
         <para>71 "This variable is not valid in fort."</para>
+        
         <para>72 "%s is not valid in this context."</para>
+        
         <para>73 "Error while linking."</para>
+        
         <para>74 "Leading coefficient is zero."</para>
+        
         <para>75 "Too high degree (max 100)."</para>
+        
         <para>* 76 "for x=val with type(val)=%d is not implemented in
+            
             Scilab."
+            
         </para>
+        
         <para>77 "%s: Wrong number of input arguments."</para>
+        
         <para>78 "%s: Wrong number of output arguments."</para>
+        
         <para>79 "Indexing not allowed for output arguments of resume."</para>
+        
         <para>80 "Incorrect function (argument n: %d)."</para>
+        
         <para>81 "%s: Wrong type for argument #%d: Real or complex matrix
+            
             expected."
+            
         </para>
+        
         <para>82 "%s: Wrong type for argument #%d: Real matrix expected."</para>
+        
         <para>83 "%s: Wrong type for argument #%d: Real vector expected."</para>
+        
         <para>84 "%s: Wrong type for argument #%d: Scalar expected."</para>
+        
         <para>85 "Host does not answer..."</para>
+        
         <para>86 "Uncontrollable system."</para>
+        
         <para>87 "Unobservable system."</para>
+        
         <para>88 "sfact: singular or asymmetric problem."</para>
+        
         <para>* 89 "Wrong size for argument #%d."</para>
+        
         <para>* 90 "Wrong type for argument #%d: Transfer matrix expected."</para>
+        
         <para>* 91 "Wrong type for argument #%d: In state space form
+            
             expected."
+            
         </para>
+        
         <para>* 92 "Wrong type for argument #%d: Rational matrix expected."</para>
+        
         <para>* 93 "Wrong type for argument #%d: In continuous time
+            
             expected."
+            
         </para>
+        
         <para>* 94 "Wrong type for argument #%d: In discrete time expected."</para>
+        
         <para>* 95 "Wrong type for argument #%d: SISO expected."</para>
+        
         <para>* 96 "time domain of argument #%d is not defined."</para>
+        
         <para>* 97 "Wrong type for argument #%d: A system in state space or
+            
             transfer matrix form expected."
+            
         </para>
+        
         <para>98 "Variable returned by scilab argument function is
+            
             incorrect."
+            
         </para>
+        
         <para>* 99 "Elements of %dth argument must be in increasing order."</para>
+        
         <para>* 100 "Elements of %dth argument are not in (strictly) decreasing
+            
             order."
+            
         </para>
+        
         <para>* 101 "Last element of %dth argument &lt;&gt; first."</para>
+        
         <para>102 "Variable or function %s are not in file."</para>
+        
         <para>103 "Variable %s is not a valid rational function."</para>
+        
         <para>104 "Variable %s is not a valid state space representation."</para>
+        
         <para>105 "Undefined function."</para>
+        
         <para>106 "Function name already used."</para>
+        
         <para>* 107 "Too many functions are defined (maximum #:%d)."</para>
+        
         <para>108 "Too complex for scilab, may be a too long control
+            
             instruction."
+            
         </para>
+        
         <para>109 "Too large, can't be displayed."</para>
+        
         <para>110 "%s was a function when compiled but is now a primitive!"</para>
+        
         <para>111 "Trying to re-define function %s."</para>
+        
         <para>112 "No more memory."</para>
+        
         <para>113 "Too large string."</para>
+        
         <para>114 "Too many linked routines."</para>
+        
         <para>115 "Stack problem detected within a loop."</para>
+        
         <para>* 116 "Wrong value for argument #%d."</para>
+        
         <para>* 117 "List element number %d is Undefined."</para>
+        
         <para>* 118 "Wrong type for argument #%d: Named variable not an expression
+            
             expected."
+            
         </para>
+        
         <para>120 "Indices for non-zero elements must be given by a 2 column
+            
             matrix."
+            
         </para>
+        
         <para>121 "Incompatible indices for non-zero elements."</para>
+        
         <para>* 122 "Logical unit number should be larger than %d."</para>
+        
         <para>123 "Function not bounded from below."</para>
+        
         <para>125 "Problem may be unbounded: too high distance between two
+            
             consecutive iterations."
+            
         </para>
+        
         <para>126 "Inconsistent constraints."</para>
+        
         <para>127 "No feasible solution."</para>
+        
         <para>128 "Degenerate starting point."</para>
+        
         <para>129 "No feasible point has been found."</para>
+        
         <para>130 "Optimization fails: back to initial point."</para>
+        
         <para>131 "optim: Stop requested by simulator (ind=0)"</para>
+        
         <para>132 "optim: Wrong input parameters."</para>
+        
         <para>133 "Too small memory."</para>
+        
         <para>134 "optim: Problem with initial constants in simul."</para>
+        
         <para>135 "optim : Bounds and initial guess are incompatible."</para>
+        
         <para>136 "optim : This method is NOT implemented."</para>
+        
         <para>137 "NO hot restart available in this method."</para>
+        
         <para>138 "optim: Incorrect stopping parameters."</para>
+        
         <para>139 "optim: Incorrect bounds."</para>
+        
         <para>140 "Variable : %s must be a list"</para>
+        
         <para>* 141 "Incorrect function (argument n: %d)."</para>
+        
         <para>* 142 "Hot restart: dimension of working table (argument
+            
             n:%d)."
+            
         </para>
+        
         <para>143 "optim:: df0 must be positive !"</para>
+        
         <para>144 "Undefined operation for the given operands."</para>
+        
         <para>201 "%s: Wrong type for argument #%d: Real or complex matrix
+            
             expected."
+            
         </para>
+        
         <para>202 "%s: Wrong type for argument #%d: Real matrix expected."</para>
+        
         <para>203 "%s: Wrong type for argument #%d: Real vector expected."</para>
+        
         <para>* 204 "%s: Wrong type for argument #%d: Scalar expected."</para>
+        
         <para>205 "%s: Wrong size for argument #%d: (%d,%d) expected."</para>
+        
         <para>206 "%s: Wrong size for argument #%d: %d expected."</para>
+        
         <para>207 "%s: Wrong type for argument #%d: Matrix of strings
+            
             expected."
+            
         </para>
+        
         <para>208 "%s: Wrong type for argument #%d: Boolean matrix
+            
             expected."
+            
         </para>
+        
         <para>209 "%s: Wrong type for argument #%d: Matrix expected."</para>
+        
         <para>210 "%s: Wrong type for argument #%d: List expected."</para>
+        
         <para>211 "%s: Wrong type for argument #%d: Function or string (external
+            
             function) expected."
+            
         </para>
+        
         <para>212 "%s: Wrong type for argument #%d: Polynomial expected."</para>
+        
         <para>213 "%s: Wrong type for argument #%d: Working integer matrix
+            
             expected."
+            
         </para>
+        
         <para>214 "Argument #%d of %s: wrong type argument, expecting a
+            
             vector"
+            
         </para>
+        
         <para>* 215 "%dth argument type must be boolean."</para>
+        
         <para>* 216 "Wrong type for argument #%d: Boolean or scalar
+            
             expected."
+            
         </para>
+        
         <para>* 217 "Wrong type for argument #%d: Sparse matrix of scalars
+            
             expected."
+            
         </para>
+        
         <para>* 218 "Wrong type for argument #%d: Handle to sparse lu factors
+            
             expected."
+            
         </para>
+        
         <para>* 219 "Wrong type argument #%d: Sparse or full scalar matrix
+            
             expected."
+            
         </para>
+        
         <para>220 "Null variable cannot be used here."</para>
+        
         <para>221 "A sparse matrix entry is defined with two differents
+            
             values."
+            
         </para>
+        
         <para>222 "%s not yet implemented for full input parameter."</para>
+        
         <para>223 "It is not possible to redefine the %s primitive this way (see
+            
             clearfun)."
+            
         </para>
+        
         <para>224 "Type data base is full."</para>
+        
         <para>225 "This data type is already defined."</para>
+        
         <para>226 "Inequality comparison with empty matrix."</para>
+        
         <para>227 "Missing index."</para>
+        
         <para>228 "reference to the cleared global variable %s."</para>
+        
         <para>229 "Operands of / and \\ operations must not contain NaN or
+            
             Inf."
+            
         </para>
+        
         <para>230 "semi def fails."</para>
+        
         <para>231 "Wrong type for first input argument: Single string
+            
             expected."
+            
         </para>
+        
         <para>232 "Entry name not found."</para>
+        
         <para>233 "Maximum number of dynamic interfaces reached."</para>
+        
         <para>234 "link: expecting more than one argument."</para>
+        
         <para>235 "link: problem with one of the entry point."</para>
+        
         <para>236 "link: the shared archive was not loaded."</para>
+        
         <para>237 "link: Only one entry point allowed on this operating
+            
             system."
+            
         </para>
+        
         <para>238 "link: First argument cannot be a number."</para>
+        
         <para>239 "You cannot link more functions, maxentry reached."</para>
+        
         <para>240 "File '%s' already exists or directory write access
+            
             denied."
+            
         </para>
+        
         <para>241 "File '%s' does not exist or read access denied."</para>
+        
         <para>242 "Binary direct access files must be opened by 'file'."</para>
+        
         <para>243 "C file logical unit not allowed here."</para>
+        
         <para>244 "Fortran file logical unit not allowed here."</para>
+        
         <para>* 245 "No input file associated to logical unit %d."</para>
+        
         <para>246 "function not defined for given argument type(s)"</para>
+        
         <para>247 "Wrong value for argument #%d: the lu handle is no more
+            
             valid."
+            
         </para>
+        
         <para>* 248 "Wrong value for argument #%d: Valid variable name
+            
             expected."
+            
         </para>
+        
         <para>* 249 "Wrong value for argument #%d: Empty string expected."</para>
+        
         <para>250 "Recursive extraction is not valid in this context."</para>
+        
         <para>251 "bvode: ipar dimensioned at least 11."</para>
+        
         <para>252 "bvode: ltol must be of size ipar(4)."</para>
+        
         <para>253 "bvode: fixpnt must be of size ipar(11)."</para>
+        
         <para>254 "bvode: ncomp &lt; 20 requested."</para>
+        
         <para>255 "bvode: m must be of size ncomp."</para>
+        
         <para>256 "bvode: sum(m) must be less than 40."</para>
+        
         <para>257 "bvode: sum(m) must be less than 40."</para>
+        
         <para>258 "bvode: input data error."</para>
+        
         <para>259 "bvode: no. of subintervals exceeds storage."</para>
+        
         <para>260 "bvode: Th colocation matrix is singular."</para>
+        
         <para>261 "Interface property table is full."</para>
+        
         <para>* 262 "Too many global variables! , max number is %d."</para>
+        
         <para>263 "Error while writing in file,(disk full or deleted file."</para>
+        
         <para>* 264 "Wrong value for argument #%d: Must not contain NaN or
+            
             Inf."
+            
         </para>
+        
         <para>265 "A and B must have equal number of rows."</para>
+        
         <para>266 "A and B must have equal number of columns."</para>
+        
         <para>267 "A and B must have equal dimensions."</para>
+        
         <para>* 268 "Invalid return value for function passed in arg %d."</para>
+        
         <para>* 269 "Wrong value for argument #%d: eigenvalues must have negative
+            
             real parts."
+            
         </para>
+        
         <para>* 270 "Wrong value for argument #%d: eigenvalues modulus must be less
+            
             than one."
+            
         </para>
+        
         <para>* 271 "Size varying argument a*eye(), (arg %d) not allowed
+            
             here."
+            
         </para>
+        
         <para>272 "endfunction is missing."</para>
+        
         <para>273 "Instruction left hand side: waiting for a dot or a left
+            
             parenthesis."
+            
         </para>
+        
         <para>274 "Instruction left hand side: waiting for a name."</para>
+        
         <para>275 "varargout keyword cannot be used here."</para>
+        
         <para>276 "Missing operator, comma, or semicolon."</para>
+        
         <para>277 "Too many commands defined."</para>
+        
         <para>278 "%s: Input arguments should have the same formal variable
+            
             name."
-        </para>
+            
+        </para>
+        
+        <para>
+            
+            <note>
+                
+                将来のリリースでは変更される可能性があるため,
+                
+                このリストの使用は避けてください.
+                
+            </note>
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[
+    error(43);
+    // Display "Not implemented in scilab..."
+    error(42);
+    // Display "Incompatible input argument."
+    lasterror()
+ ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="error">error</link>
+                
+            </member>
+            
             <member>
+                
                 <link linkend="warning">warning</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="errcatch">errcatch</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="execstr">execstr</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="lasterror">lasterror</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index 6ccda9e..f0d68f1 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="clear">
+    
     <refnamediv>
+        
         <refname>clear</refname>
+        
         <refpurpose>変数を消去する</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼出し手順</title>
-        <synopsis>clear a</synopsis>
+        
+        <synopsis>
+            
+            clear a b c
+            
+            clear('a', 'b', 'c')
+            
+            clear(['a' 'b' 'c'])
+            
+        </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>a, b, c...</term>
+                
+                <listitem>
+                    
+                    <para>任意の型および大きさの変数, ただし,保護されていないこと</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             このコマンドは保護されていない変数を消去します.
+            
             変数は環境から削除されます.
-            <literal>clear</literal> は<literal>predef</literal>で保護された
+            
+            <code>clear</code> は<code>predef</code>で保護された
+            
             変数以外の全ての変数を消去します.
-            このため,2つのコマンド  <literal>predef(0)</literal> および<literal>clear</literal>
+            
+            このため,2つのコマンド  <code>predef(0)</code> および<code>clear</code>
+            
             により全ての変数が削除されます.
+            
         </para>
+        
         <para>
+            
             通常,保護される変数は標準ライブラリとパーセント構文の変数です.
+            
+        </para>
+        
+        <para>
+            
+            <note>
+                
+                正しい構文は<code>clear a</code>および<code>clear('a')</code>であり, 
+                
+                <code>clear(a)</code>ではないことに注意してください.
+                
+                <code>a=[]</code> は <varname>a</varname> を消去しませんが, 
+                
+                <varname>a</varname>を空の行列にすることに注意してください.
+                
+            </note>
+            
         </para>
+        
         <para>
-            正しい構文は<literal>clear a</literal> で <literal>clear(a)</literal>ではないことに注意してください.
-            <literal>a=[]</literal> は <literal>a</literal> を消去しませんが, 
-            <literal>a</literal> を空の行列にすることに注意してください.
+            
+            コマンド <code>clear</code> は存在しない変数も消去します,
+            
+            すなわち, 
+            
+            <code>clear</code> は存在しない変数を存在するものとして
+            
+            消去します.
+            
         </para>
+        
     </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[
+a = 2;
+b = 3;
+c = 4;
+clear a
+isdef("a") // F
+isdef("b") // T
+clear("b");
+isdef("b") // F
+
+a = 2;
+b = 3;
+c = 4;
+clear(['a' 'b' 'c'])
+isdef("a") | isdef("b") | isdef("c") // F
+        ]]></programlisting>
+        
+    </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="predef">predef</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="who">who</link>
+                
             </member>
+            
         </simplelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.5.0</revnumber>
+                
+                <revdescription>引数を文字列の行列とすることができるようになりました</revdescription>
+                
+            </revision>
+            
+        </revhistory>
+        
     </refsection>
+    
 </refentry>
+
index 606bfd7..5fee9bf 100644 (file)
@@ -1,44 +1,91 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="clearglobal">
+    
     <refnamediv>
+        
         <refname>clearglobal</refname>
+        
         <refpurpose>グローバル変数を削除</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
-        <synopsis>clearglobal()
-            clearglobal nam1 .. namn
-            clearglobal('nam1', ..,'namn')
+        
+        <synopsis>
+            
+            clearglobal()
+            
+            clearglobal nam1 ... namn
+            
+            clearglobal('nam1', ...,'namn')
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>nam1,..., namn</term>
+                
                 <listitem>
+                    
                     <para>有効な変数名</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
-            <literal>clearglobal() </literal> はグローバル変数を全て削除します.
+            
+            <code>clearglobal()</code> は,グローバル変数を全て削除します.
+            
         </para>
+        
         <para>
+            
             <literal>clearglobal nam1 .. namn</literal>  は名前で指定したグローバル変数を
+            
             削除します.
+            
         </para>
+        
         <para>
-            <literal>clearglobal() </literal> はグローバル変数のみをクリアし,
-            これらのグローバル変数のローカルなコピーは破棄されないことに
-            注意してください.
+            
+            <note>
+                
+                <code>clearglobal()</code> はグローバル変数のみをクリアし,
+                
+                これらのグローバル変数のローカルなコピーは破棄されないことに
+                
+                注意してください.
+                
+            </note>
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
 global a b c
 a=1;b=2;c=3;
@@ -46,16 +93,30 @@ who('global')
 clearglobal b
 who('global')
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="global">global</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="who">who</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index 4a2e9e4..d0ad593 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns3="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="exists" xml:lang="ja">
+    
     <refnamediv>
+        
         <refname>exists</refname>
+        
         <refpurpose>変数の存在を確認する</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼出し手順</title>
-        <synopsis>exists(name [,where])</synopsis>
+        
+        <synopsis>ve = exists(name [,where])</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
+            <varlistentry>
+                
+                <term>ve</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        <varname>name</varname>と同じ大きさの行列で,
+                        
+                        使用される値は:
+                        
+                        <literal>1</literal> (trueの場合), 
+                        
+                        <literal>0</literal> (falseの場合)
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
             <varlistentry>
+                
                 <term>name</term>
+                
                 <listitem>
-                    <para>文字列</para>
+                    
+                    <para>文字列の行列</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>where</term>
+                
                 <listitem>
-                    <para>オプションの文字で,以下の値を指定します:
+                    
+                    <para>
+                        
+                        オプションの文字で,以下の値を指定します:
+                        
                         <literal>'l'</literal> (local), <literal>'n'</literal>
+                        
                         (nolocal) および <literal>'a'</literal> (all). 
-                        デフォルト値は<literal>'all'</literal>です.
+                        
+                        デフォルト値は<literal>'a'</literal>です.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             <literal>exists(name)</literal> は,
+            
             <literal>name</literal>という名前の変数が存在する場合に
+            
             <literal>1</literal>,それ以外の場合に<literal>0</literal>を返します.
+            
               
+            
         </para>
+        
         <para>
+            
             注意: <literal>exists</literal> を使用する関数は,
+            
             環境に依存する結果を返す可能性があります!
+            
         </para>
+        
         <para>
+            
             <literal>exists(name,'l')</literal> は,
+            
             <literal>name</literal>という名前の変数がカレントの関数の
+            
             環境に存在する場合に <literal>1</literal>,
+            
             それ以外の場合に <literal>0</literal> を返します.
+            
         </para>
+        
         <para>
+            
             <literal>exists(name,'n')</literal> は,
+            
             <literal>name</literal>という名前の変数が関数の呼び出し元の
+            
             環境(Scilabシェルメインレベルを含む)に存在する場合に <literal>1</literal>,
+            
             それ以外の場合に <literal>0</literal> を返します.
+            
         </para>
+        
         <para>
-            警告: exists関数は,ある変数が<link linkend="global">グローバル</link>
+            
+            警告: <literal>exists</literal>関数は,ある変数が
+            
+            <link linkend="global">グローバル</link>
+            
             名前空間に存在するかどうかを確認しません.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
+        <programlisting role="example"><![CDATA[
+exists("myNotLikelyToExistVar")
+myNotLikelyToExistVar = 1;
+exists("myNotLikelyToExistVar")
+ ]]></programlisting>
+        
         <programlisting role="example"><![CDATA[ 
 deff('foo(x)',..
 ['disp([exists(''a12''),exists(''a12'',''l'')])'
@@ -69,9 +163,9 @@ a12=[];foo(1)
 
 function level1()
   function level2()
-    disp(exists("a","a"));
-    disp(exists("a","l"));
-    disp(exists("a","n"));
+    disp(exists(["a","b"],"a"));
+    disp(exists(["a","b"],"l"));
+    disp(exists(["a","b"],"n"));
   endfunction
   level2()
 endfunction
@@ -81,28 +175,54 @@ function go()
 endfunction
 go()
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="isdef">isdef</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="isglobal">isglobal</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="whereis">whereis</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="type">type</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="typeof">typeof</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="macrovar">macrovar</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index f1d8449..604e549 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="getvariablesonstack">
+    
     <refnamediv>
+        
         <refname>getvariablesonstack</refname>
+        
         <refpurpose>Scilabスタック上の変数名を取得</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼出し手順</title>
-        <synopsis>s=getvariablesonstack()
+        
+        <synopsis>
+            
+            s=getvariablesonstack()
+            
             s=getvariablesonstack('local')
+            
             s=getvariablesonstack('global')
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>s</term>
+                
                 <listitem>
+                    
                     <para>文字列行列</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
+            <literal>s = getvariablesonstack()</literal>は,
+            
             Scilabスタック上の変数名を<literal>s</literal>に返します.
+            
         </para>
-        <para>getvariablesonstack('local') はScilabスタック上のローカル変数を返します.</para>
-        <para>getvariablesonstack('global') はScilabスタック上のグローバル変数を返します.</para>
+        
+        <para>
+            
+            <literal>getvariablesonstack('local')</literal>
+            
+            は,Scilabスタック上のローカル変数を返します.
+            
+        </para>
+        
+        <para>
+            
+            <literal>getvariablesonstack('global')</literal>
+            
+            は,Scilabスタック上のグローバル変数を返します.
+            
+        </para>
+        
         <para>変数はアルファベット順にソートされます.</para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
 getvariablesonstack()
 getvariablesonstack('local')
 getvariablesonstack('global')
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="who">who</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index c684204..5a665ad 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) 2008 - 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: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="isdef" xml:lang="ja">
+    
     <refnamediv>
+        
         <refname>isdef</refname>
+        
         <refpurpose>変数の存在を確認</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
-        <synopsis>isdef(name [,where])</synopsis>
+        
+        <synopsis>ve = isdef(name [,where])</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
+            <varlistentry>
+                
+                <term>ve</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        論理値を有する <varname>name</varname>と同じ大きさの行列
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
             <varlistentry>
+                
                 <term>name</term>
+                
                 <listitem>
-                    <para>文字列</para>
+                    
+                    <para>文字列の行列</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>where</term>
+                
                 <listitem>
-                    <para>オプションのパラメータ文字列,
-                        デフォルト値は <literal>'all'</literal>
+                    
+                    <para>
+                        
+                        文字列, <literal>'l'</literal> (<literal>"local"</literal>の場合),
+                        
+                        <literal>'n'</literal> (<literal>"nolocal"</literal>の場合) or
+                        
+                        <literal>'a'</literal> (<literal>"all"</literal>の場合)を指定できます. 
+                        
+                        デフォルト値は <literal>'a'</literal>です.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
-            <literal>isdef(name)</literal>は,
-            <literal>name</literal>という名前の変数が存在する場合に
-            <literal>%T</literal>, それ以外の場合に <literal>%F</literal> を返します.
+            
+            <code>isdef(name)</code>は,
+            
+            <varname>name</varname> という名前の変数が存在する場合に
+            
+            <constant>%T</constant>,それ以外の場合に <constant>%F</constant>を返します.
+            
         </para>
+        
         <para>
-            注意: <literal>isdef</literal> を使用する関数
-            は環境に依存した結果を返す可能性があります!
+            
+            <caution>
+                
+                注意: <function>isdef</function> を使用する関数
+                
+                は環境に依存した結果を返す可能性があります!
+                
+            </caution>
+            
         </para>
+        
         <para>
-            <literal>isdef(name,'local')</literal> は,
-            <literal>name</literal>という名前の変数がカレントの関数のローカル環境に
-            存在する場合に      <literal>%T</literal>, それ以外の場合に <literal>%F</literal> を返します.
+            
+            <code>isdef(name, 'l')</code> は,
+            
+            <varname>name</varname> という名前の変数がカレントの関数のローカル環境に
+            
+            存在する場合に<constant>%T</constant>, 
+            
+            それ以外の場合に <constant>%F</constant> を返します.
+            
         </para>
+        
         <para>
-            <literal>isdef(name,'nolocal')</literal> は,
-            <literal>name</literal>という名前の変数が(グローバルレベルを含む)呼び出した側の環境に
-            存在する場合に      <literal>%T</literal>, 
-            それ以外の場合に <literal>%F</literal> を返します.
+            
+            <code>isdef(name, 'n')</code>  は,
+            
+            <varname>name</varname> という名前の変数が
+            
+            (グローバルレベルを含む)呼び出した側の環境に
+            
+            存在する場合に<constant>%T</constant>, 
+            
+            それ以外の場合に <constant>%F</constant>を返します.
+            
         </para>
+        
+        <note>
+            
+            注意: <varname>where</varname>オプション
+            
+            の最初の1文字のみが処理されます.
+            
+        </note>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
-        <programlisting role="example"><![CDATA[ 
-A=1;
-isdef('A')
-clear A
-isdef('A')
+        
+        <programlisting role="example"><![CDATA[
+A = 1; B = 2; C = 3; D = 4;
+isdef(['A', 'B'; 'C', 'D'])
+clear A, B, C, D;
+isdef(['A', 'B'; 'C', 'D'])
 
 function level1()
   function level2()
-    disp(isdef("a","all"));
-    disp(isdef("a","local"));
-    disp(isdef("a","nolocal"));
+    disp(isdef(["a", "b"], "a"));
+    disp(isdef(["a", "b"], "l"));
+    disp(isdef(["a", "b"], "n"));
   endfunction
   level2()
 endfunction
 function go()
-  a=1;
+  a = 1;
   level1()
 endfunction
 go()
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="exists">exists</link>
+                
+            </member>
+            
+            <member>
+                
                 <link linkend="isglobal">isglobal</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="whereis">whereis</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="type">type</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="typeof">typeof</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="clear">clear</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index 9ce37d7..4c6a92f 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="isglobal">
+    
     <refnamediv>
+        
         <refname>isglobal</refname>
+        
         <refpurpose>変数がグローバルかどうかを確認</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼出し手順</title>
-        <synopsis>t=isglobal(x)</synopsis>
+        
+        <synopsis>t = isglobal(x)</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>Parameters</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>x</term>
+                
                 <listitem>
+                    
                     <para>任意の変数</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>t</term>
+                
                 <listitem>
+                    
                     <para>論理値</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
-            <literal>isglobal(x)</literal> は, x がグローバル変数として
-            宣言されている場合に true,それ以外の場合に false を返します.
+            
+            <literal>isglobal(x)</literal> は, <varname>x</varname> がグローバル変数として
+            
+            宣言されている場合に <emphasis>true</emphasis>,
+            
+            それ以外の場合に <emphasis>false</emphasis> を返します.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
 isglobal(1)
 global a
 isglobal(a)
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="global">global</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="clearglobal">clearglobal</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="who">who</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index 672cc89..37e8462 100644 (file)
@@ -1,29 +1,63 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="names">
+    
     <refnamediv>
+        
         <refname>names</refname>
-        <refpurpose>scilab 名前の構文</refpurpose>
+        
+        <refpurpose>Scilab 名前の構文</refpurpose>
+        
     </refnamediv>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             変数および関数の名前は文字または以下の特殊文字のとれかから始まる必要があります:
+            
             '<literal>%</literal>', '<literal>_</literal>', '<literal>#</literal>', '<literal>!</literal>', 
+            
             '<literal>$</literal>', '<literal>?</literal>'.
+            
         </para>
+        
         <para>
+            
             以下に続く文字は,文字,数字,
+            
             '<literal>_</literal>', '<literal>#</literal>', '<literal>!</literal>', '<literal>$</literal>', '<literal>?</literal>'
+            
             を含む任意の特殊文字とすることができます.
+            
         </para>
+        
         <para>
-            名前は任意の長さとすることができますが,
-            最初の24文字のみが認識されます.
+            
+            大文字小文字は区別されます.
+            
+        </para>
+        
+        <para>
+            
+            名前は任意の長さとすることができますが,最初の24文字のみが認識されます.
+            
             大文字と小文字は区別されます.
+            
+            この制限を超えた場合,警告が発生します.
+            
+            この制限はScilab 6のリリースでも変わらないことに注意してください.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
 //有効な名前
 %eps
@@ -32,6 +66,20 @@ A1=123
 My_Special_Color_Table=rand(10,3)
 //無効な名前
 //1A , b%, .C
+
+//長い名前
+Try_to_use_a_long_name = 1 // 長いが長すぎない
+Try_to_use_a_too_long_name = 1 // 長すぎる
+
+// 同様な長い名前を有する2番目の変数を挿入してみましょう
+Try_to_use_a_too_long_name2 = 2
+
+// ... 最初の変数の値を見てみましょう
+disp(Try_to_use_a_too_long_name)
+// この制限は Scilab 6のリリースでも変わらないことに注意してください.
  ]]></programlisting>
+        
     </refsection>
+    
 </refentry>
+
index f943dd4..5d89c38 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="predef">
+    
     <refnamediv>
+        
         <refname>predef</refname>
+        
         <refpurpose>変数の保護</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼出し手順</title>
+        
         <synopsis>n = predef()
+            
             oldnew = predef(n)
+            
             oldnew = predef('all')
+            
             oldnew = predef('clear')
+            
             variables_name = predef('names')
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             "oldest"変数を"protected"として定義するために使用されるユーティリティ関数.
+            
             保護されている変数は削除できません.
-            これらの変数は<literal>'save'</literal>コマンドで保存されません.
-            "oldest" は<literal>who('get')</literal>で最後に現れます.
+            
+            これらの変数は <function>save</function> コマンドで保存されません.
+            
+            "oldest" は<code>who('get')</code>で最後に現れます.
+            
         </para>
+        
         <para>
-            <literal>predef()</literal> は保護される変数の数を取得します.
+            
+            <code>predef()</code>は保護される変数の数を取得します.
+            
         </para>
+        
         <para>
-            <literal>predef('a[ll]')</literal> は
+            
+            <code>predef('a[ll]')</code>は
+            
             全ての変数を保護し,保護される変数の数の古い値と新しい値も返します.
+            
         </para>
+        
         <para>
-            <literal>predef('c[lear]')</literal> は最後の7変数以外の
+            
+            <code>predef('c[lear]')</code> は最後の7変数以外の
+            
             保護を外し,
+            
             保護される変数の数の古い値と新しい値も返します.
+            
         </para>
+        
         <para>
-            <literal>predef(n)</literal> は,
-            <literal>max(n,7)</literal>個の最後に定義された変数を保護し,
+            
+            <code>predef(n)</code> は,
+            
+            <code>max(n,7)</code>個の最後に定義された変数を保護し,
+            
             保護される変数の数の古い値と新しい値も返します.
+            
         </para>
+        
+        <para>
+            
+            <code>predef('names')</code> は保護されている変数の名前を保持する
+            
+            文字列のベクトルを返します.
+            
+        </para>
+        
+        <para>
+            
+            <code>predef('clear')</code> はリストから定義済みの変数を削除します.
+            
+        </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>注意:</title>
+        
         <para>
+            
             変数 <literal>ans</literal> 
+            
             は,式が代入されない場合に自動的に定義され,
-            <literal>predef('all')</literal>により保護されません.
+            
+            <code>predef('all')</code>により保護されません.
+            
         </para>
+        
         <para>
+            
             保護される変数の数は,スタートアップファイル
+            
             <literal>SCI/etc/scilab.start</literal>で設定されます.
+            
             ユーザは独自の定義済みの変数を
+            
             ユーザのスタートアップファイル 
+            
             <literal>SCIHOME/.scilab</literal> および <literal>SCIHOME/scilab.ini</literal>
+            
             により設定することができます.
+            
         </para>
+        
+        <para>
+            
+            <important>
+                
+                新規に定義した変数を<code>predef(1)</code>により保護できないことに注意してください.
+                
+                これはある変数を保護する際, Scilab はその前に定義されている全ての変数を保護する必要があります.
+                
+                この制限は スタック設計でなくなるScilab 6ではなくなります.
+                
+            </important>
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[ 
+errcatch(13, "continue") // "clear a" が失敗する場合でも続行するようにする
+a = 1;
+predef("all");
+clear a // 失敗
+predef("clear")
+clear a // 動作
+ ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="clear">clear</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="save">save</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="ans">ans</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="startup">startup</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index 39015df..c5c7b9e 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="who">
+    
     <refnamediv>
+        
         <refname>who</refname>
+        
         <refpurpose>変数の一覧</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼出し手順</title>
+        
         <synopsis>who
+            
             who()
-            names=who('local')
-            [names,mem]=who('local')
-            names=who('global')
-            [names,mem]=who('global')
+            
+            names = who('local')
+            
+            [names, mem] = who('local')
+            
+            names = who('global')
+            
+            [names, mem] = who('global')
+            
             who('sorted')
-            names=who('local','sorted')
-            [names,mem]=who('local','sorted')
-            names=who('global','sorted')
-            [names,mem]=who('global','sorted')
+            
+            names = who('local','sorted')
+            
+            [names, mem] = who('local','sorted')
+            
+            names = who('global','sorted')
+            
+            [names, mem] = who('global','sorted')
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
-            <literal>who</literal> はカレントの変数名を表示します.
+            
+            <code>who()</code> は,カレントの変数名を表示します.
+            
         </para>
+        
         <para>
-            <literal>who('local')</literal> または <literal>who('get')</literal> は
+            
+            <code>who('local')</code> または <code>who('get')</code> は,
+            
             カレントの変数名と倍精度ワード単位の使用メモリを返します.
+            
         </para>
+        
         <para>
-            <literal>who('global')</literal> はグローバル変数の名前と
+            
+            <code>who('global')</code> は,グローバル変数の名前と
+            
             倍精度ワード単位の使用メモリを返します.
+            
         </para>
+        
         <para>
-            <literal>who('sorted')</literal> は
+            
+            <code>who('sorted')</code> は,
+            
             アルファベット順に全ての変数を表示します.
+            
         </para>
+        
     </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[
+a=1;
+b=2;
+[name, mem]=who("local");
+position=find(name=="a")
+mem(position) // aにより使用される大きさ
+position=find(name=="d") // []
+ ]]></programlisting>
+        
+    </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="whos">whos</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="who_user">who_user</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index c1e6cca..975c497 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="who_user">
+    
     <refnamediv>
+        
         <refname>who_user</refname>
-        <refpurpose>ユーザ変数の一覧を得る</refpurpose>
+        
+        <refpurpose>ユーザ変数の一覧</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
-        <synopsis>who_user()</synopsis>
+        
+        <synopsis>varList = who_user([bPrint])</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>bPrint</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        画面出力を有効または無効にする (デフォルト: <constant>%t</constant>).
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>返り値</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>varList</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        ユーザ変数の列ベクトルまたはユーザが変数が有さない場合に<literal>[]</literal>.
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
         <title>説明</title>
+        
         <para>
-            <literal>who_user</literal> は,ユーザの変数名を表示します.
+            
+            <literal>who_user</literal> は,ユーザの変数名を表示し,ユーザ変数名を返します.
+            
         </para>
+        
     </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="code_scilab"><![CDATA[ 
+clear;
+who_user()
+who_user(%t)
+who_user(%f)
+a = 1;
+b = 2;
+who_user()
+who_user(%t)
+who_user(%f)
+clear;
+ ]]>
+            
+        </programlisting>
+        
+    </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="whos">whos</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="who">who</link>
+                
             </member>
+            
         </simplelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revremark>
+                    
+                    <function>who_user</function> はユーザ変数名を
+                    
+                    文字列の列ベクトルで返すようになりました.
+                    
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
     </refsection>
+    
 </refentry>
+
index 4a23c38..c33c019 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="whos">
+    
     <refnamediv>
+        
         <refname>whos</refname>
+        
         <refpurpose>長い形式で変数のリストを得る</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
-        <synopsis>whos()
+        
+        <synopsis>
+            
+            whos()
+            
             whos -type typ
+            
             whos -name nam
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>typ</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         指定する変数型の名前 (<literal>typeof</literal>参照)
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>nam</term>
+                
                 <listitem>
+                    
                     <para>指定する名前の先頭文字</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
-            <literal>whos()</literal> は,カレントの全ての変数の名前,型および使用メモリを表示します.
+            
+            <code>whos()</code>  は,カレントの全ての変数の名前,型および使用メモリを表示します.
+            
         </para>
+        
         <para>
+            
             <literal>whos -type typ</literal> は,
-            指定した型のカレントの全変数を表示します.
+            
+            指定した型<varname>typ</varname>のカレントの全変数を表示します.
+            
         </para>
+        
         <para>
+            
             <literal>whos -name nam</literal> は
+            
             名前が<literal>nam</literal>から始まる全変数を表示します.
+            
         </para>
-        <para>注意 : 変数がグローバルの場合, 型の前に * が出力されます.</para>
+        
+        <para>
+            
+            <note>
+                
+                注意 : 変数がグローバルの場合, 型の前に <literal>*</literal> が出力されます.
+                
+            </note>
+            
+        </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
 lines(0) 
 whos()
 whos -type boolean
 whos -name %
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="who">who</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="who_user">who_user</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="typeof">typeof</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index 9a684c0..691b0fa 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) 2008 - 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: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="eye" xml:lang="ja">
+    
     <refnamediv>
+        
         <refname>eye</refname>
+        
         <refpurpose>単位行列</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
-        <synopsis>X=eye(m,n)
-            X=eye(A)
-            X=eye()
+        
+        <synopsis>X = eye(m,n)
+            
+            X = eye(A)
+            
+            X = eye()
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>A,X</term>
+                
                 <listitem>
+                    
                     <para>
-                        行列または <literal>syslin</literal> リスト
+                        
+                        行列,ハイパー行列または <literal>syslin</literal> リスト
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>m,n</term>
+                
                 <listitem>
-                    <para>整数</para>
+                    
+                    <para>
+                        
+                        整数値:  <varname>X</varname>の行および列の数
+                        
+                    </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>その引数に基づき, 
+            
             <literal>m</literal>x<literal>n</literal> の
+            
             主対角項に1を有する行列,または
+            
             <literal>A</literal>と同じ次元の単位行列を返します.
+            
+            <varname>A</varname> がハイパー行列の場合, 
+            
+            <varname>X</varname> は,1から<literal>min(size(A))</literal>までの全ての
+            
+            <literal>i</literal>について,<literal>X(i,i,...,i) = 1</literal>として定義されます.
+            
         </para>
-        <para>
-            注意: <literal>eye(10)</literal> は,
+        
+        <warning>
+            
+            <literal>eye(10)</literal> は,
+            
             <literal>A=10</literal>の時の <literal>eye(A)</literal> と
+            
             解釈され,すなわち, <literal>1</literal>となります.
+            
             (10x10の単位行列とはなりません!)
-        </para>
+            
+        </warning>
+        
         <para>
+            
             <literal>A</literal> が<literal>syslin</literal>リスト
+            
             で表された線形システムの場合,
+            
             <literal>eye(A)</literal>は適当な次元(出力の数x入力の数)の
+            
             <literal>eye</literal>行列を返します.
+            
         </para>
+        
         <para>
+            
             <literal>eye()</literal> は,
+            
             次元が未定義の単位行列を返します.
+            
             次元はこの単位行列が次元が固定した行列に加算される時に
+            
             定義されます.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
-        <programlisting role="example"><![CDATA[ 
+        
+        <programlisting role="example"><![CDATA[
 eye(2,3)
 A=rand(2,3);eye(A)
 s=poly(0,'s');A=[s,1;s,s+1];eye(A)
 A=[1/s,1;s,2];eye(A);
 A=ssrand(2,2,3);eye(A)
 [1 2;3 4]+2*eye()
+eye(zeros(4,4,4,4))
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="ones">ones</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="zeros">zeros</link>
+                
             </member>
+            
         </simplelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.5.0</revnumber>
+                
+                <revdescription>
+                    
+                    <para>N-D ハイパー行列に一般化</para>
+                    
+                </revdescription>
+                
+            </revision>
+            
+        </revhistory>
+        
     </refsection>
+    
 </refentry>
+
index f024f8e..039fc67 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) 2008 - 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: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="linspace" xml:lang="ja">
+    
     <refnamediv>
+        
         <refname>linspace</refname>
+        
         <refpurpose>線形に配置されたベクトル</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>[v]=linspace(x1,x2 [,n])</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>x1,x2</term>
+                
                 <listitem>
-                    <para>実数または複素数のスカラー</para>
+                    
+                    <para>実数または複素数のスカラーまたは列ベクトル</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>n</term>
+                
                 <listitem>
-                    <para>整数 (値の数) (デフォルト値= 100)</para>
+                    
+                    <para>整数: 要求された値の数. 2以上とする必要があります (デフォルト値= 100)</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>v</term>
+                
                 <listitem>
+                    
                     <para>実数または複素数の行ベクトル</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             線形に間隔をとったベクトル. <literal>linspace(x1, x2)</literal>
-            は<literal>x1</literal> と <literal>x2</literal>の間に線形に間隔をとった
+            
+            は<literal>x1</literal> と <literal>x2</literal>の間に線形に等間隔をとった
+            
             n(デフォルト値=100)要素の行ベクトルとなります.
+            
             <literal>x1</literal> または <literal>x2</literal> が複素数の場合,
+            
             <literal>linspace(x1,x2)</literal>はn個の複素数からなる行ベクトル
+            
             を返します.
+            
             n個の複素数の実部は,<literal>x1</literal>と<literal>x2.</literal>
+            
             の実部の間に線形に等間隔に配置されます.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
 linspace(1,2,10)
+linspace([1:4]',[5:8]',10)
 linspace(1+%i,2+2*%i,10)
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="logspace">logspace</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revremark>
+                    
+                    <itemizedlist>
+                        
+                        <listitem>
+                            
+                            linspace関数は最初の2つの入力引数に列ベクトルを指定できるようになりました.
+                            
+                            実装したGuillaume AZEMAに感謝します.
+                            
+                        </listitem>
+                        
+                        <listitem>3番目の引数は整数値とする必要があります.
+                            
+                        </listitem>
+                        
+                    </itemizedlist>
+                    
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
 </refentry>
+
index 9cf68d5..b52963a 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) 2008 - 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: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="logspace" xml:lang="ja">
+    
     <refnamediv>
+        
         <refname>logspace</refname>
+        
         <refpurpose>対数的間隔のベクトル</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>logspace(d1,d2, [n])</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>d1,d2</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         実数または複素数のスカラー (
+                        
                         <literal>%pi</literal>の場合は特別な意味があります)
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>n</term>
+                
                 <listitem>
-                    <para>整数 (値の数) (デフォルト値 = 50)</para>
+                    
+                    <para>整数: 要求された値の数. 2以上にすることが必要です (デフォルト値 = 50)</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             <latex>10^{d1}</latex> および
-            <latex>10^{d2}</latex>の間に指数的に等しい間隔にとった
+            
+            <latex>10^{d2}</latex>の間に指数的に等間隔にとった
+            
             <literal>n</literal>個の点からなる行ベクトルを返します.
+            
             <latex>d2=\pi</latex> の場合,
+            
             <latex>10^{d1}</latex> および <latex>\pi</latex>の間の
+            
             点となります.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
-        <programlisting role="example"><![CDATA[ 
+        
+        <programlisting role="example"><![CDATA[
 logspace(1,2,10)
+logspace([1:3]',[4:6]',4)
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="linspace">linspace</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revremark>logspace関数は最初の2つの入力引数に列ベクトルを
+                    
+                    受け付けるようになりました.
+                    
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
 </refentry>
+
index 245be35..b9d8cb7 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) 2008 - INRIA - Farid BELAHCENE
  * 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="flipdim" xml:lang="ja">
+    
     <refnamediv>
+        
         <refname>flipdim</refname>
-        <refpurpose>指定した次元に沿って x の要素を反転</refpurpose>
+        
+        <refpurpose>指定した次元に沿って x ブロック要素を反転</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
-        <synopsis>y=flipdim(x,dim)</synopsis>
+        
+        <synopsis>y = flipdim(x, dim [,sb])</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
-                <term>x</term>
+                
+                <term>x, y</term>
+                
                 <listitem>
-                    <para>実数のスカラー, ベクトルまたは配列</para>
+                    
+                    <para>任意の型, 同じ大きさのスカラー, ベクトル, 行列またはハイパー行列</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>dim</term>
+                
                 <listitem>
-                    <para>正の整数</para>
+                    
+                    <para>正の整数, 反転させる次元の番号</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
-                <term>y</term>
+                
+                <term>sb</term>
+                
                 <listitem>
-                    <para>実数のスカラー, ベクトルまたは配列</para>
+                    
+                    <para>正の整数, 交換するブロックの大きさ</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
-            実数のスカラー/ベクトル/配列 <literal>x</literal>と正の整数<literal>dim</literal>
-            を指定すると, この関数は<literal>x</literal>の次元番号 <literal>dim</literal>
+            
+            任意の型のスカラー/ベクトル/配列/ハイパー行列 <literal>x</literal>と
+            
+            2つの正の整数<literal>dim</literal>および<literal>sb</literal>を指定すると,
+            
+            この関数は大きさ<literal>sb</literal>のブロック要素により
+            
+            <literal>x</literal>の次元番号 <literal>dim</literal>
+            
             に沿って x の要素を反転します.
+            
             (<literal>x</literal> および <literal>y</literal> は同じ大きさとなります)
+            
         </para>
+        
+        <para>
+            
+            オプションパラメータ<literal>sb</literal> (Size Block) により,
+            
+            ブロックの大きさ <literal>sb*size(x,2)</literal>
+            
+            (<literal>dim=1</literal>) または <literal>size(x,1)*sb</literal> (<literal>dim=2</literal>)
+            
+            での反転が可能となります.
+            
+        </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
 // 例 1: x の要素を最初の次元に沿って反転
 x=[1 2 3 4; 5 6 7 8];
@@ -67,6 +128,80 @@ y=flipdim(x,dim)
 x=matrix(1:48,[3 2,4,2]);
 dim=3;
 y=flipdim(x,dim)
+
+// 例4: 最初の例を複素数に
+x = [1+%i 2*%i 3 4; 5 6-%i 7 8*%pi*%i]
+dim = 1
+y = flipdim(x, dim)
+
+// 整数エンコードされた数値
+x = int16(grand(4, 3, 2, "uin", -9, 9))
+y = flipdim(x, 1)
+
+// 論理値:
+x = (grand(3, 4, "uin", -9, 9) > 0)
+y = flipdim(x, 2)
+
+// テキスト:
+x = matrix(strsplit("a":"x", 1:23), 4, 6);
+x = x+x
+flipdim(x, 2)
+
+// 多項式:
+x = inv_coeff(grand(3, 9, "uin", 0, 3), 2)
+flipdim(x, 1)
+
+// 有理数:
+n = inv_coeff(grand(3, 9, "uin", 0, 3), 2);
+d = inv_coeff(grand(3, 9, "uin", 0, 3), 2);
+r = n./d
+flipdim(r, 2)
+ ]]></programlisting>
+        
+        <para>
+            
+            <literal>sb</literal>の使用例:
+            
+        </para>
+        
+        <programlisting role="example"><![CDATA[
+X = [0 1 2 3 4 5 6 7 8 9 10 11];
+flipdim(X, 2, 2) // => [10 11   8 9   6 7   4 5   2 3   0 1] // ブロックサイズ = 2.
+flipdim(X, 2, 3) // => [9 10 11   6 7 8   3 4 5   0 1 2]
+flipdim(X, 2, 4) // => [8 9 10 11   4 5 6 7   0 1 2 3]
+flipdim(X, 2, 6) // => [6 7 8 9 10 11   0 1 2 3 4 5]
+
+// sbがxの指定した次元を分割しない場合はエラー.
+y = flipdim(x, 2, 5); // size(X) = [1 12] および sb=5 は 12を割り切れない.
  ]]></programlisting>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.5.0</revnumber>
+                
+                <revremark>
+                    
+                    10進数から任意の型に拡張: 論理値, 整数, 文字列, 多項式および有理数.
+                    
+                    <literal>x</literal>ブロック毎に反転するために,
+                    
+                    新しい入力引数 <literal>sb</literal>が追加されました.
+                    
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
     </refsection>
+    
 </refentry>
+
index 4fcfb96..6ab3f9b 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) 2011 - 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: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="repmat" xml:lang="ja">
+    
     <refnamediv>
+        
         <refname>repmat</refname>
+        
         <refpurpose>配列を複製/タイル状に配置</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>B = repmat(A,m,n,...)</synopsis>
+        
         <synopsis>B = repmat(A,siz)</synopsis>
+        
         <synopsis>B = repmat(A,m)</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
+        
         <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>A</term>
+                
                 <listitem>
+                    
                     <para>入力二次元配列.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>m, n, ...</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         整数で, <literal>B</literal>の各次元に関する
+                        
                         <literal>A</literal> ブロックの数.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>siz</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         整数ベクトルで, 各要素は<literal>B</literal>の対応する次元に
+                        
                         関する<literal>A</literal>ブロックの数を指定する.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>B</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         2次元配列<literal>A</literal>をタイル状に配置した
+                        
                         配列.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             <literal>repmat(A,m,n)</literal> または同様な
+            
             <literal>repmat(A,[m,n])</literal> は,<literal>A</literal>の
+            
             <literal>m</literal> x <literal>n</literal> のタイル状の
+            
             コピーからなる大きな行列を返します.
+            
             結果の大きさは,<literal>[size(A,1)*M, size(A,2)*N]</literal>です.
+            
         </para>
+        
         <para>
+            
             <literal>repmat(A,m)</literal> は,
+            
             <literal>m</literal> x <literal>m</literal>のタイル状コピーを作成します.
+            
         </para>
+        
         <para>
+            
             <literal>repmat(A,[m n p ...])</literal> は,配列Aをタイル状に
+            
             コピーし,<literal>A</literal>のコピーからなる多次元配列を作成します.
+            
             結果の大きさは,
+            
             <literal>[size(A,1)*M, size(A,2)*N, size(A,3)*P, ...] </literal>となります.
+            
         </para>
+        
         <para>
+            
             現時点では,実数,整数,論理値,文字列,多項式,有理数および
+            
             疎行列の配列のみがサポートされています.
+            
             この関数の定義は,オーバーロード機能により拡張することができます.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
     repmat(1:3,2,2)
     repmat(int8([1 0 1;0 1 0]),2,3,2)
     repmat([1/%s;2/(%s+1)],1,3)
 
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection>
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="matrix">matrix</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="extraction">extraction</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="size">size</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.3.1</revnumber>
+                
+                <revremark>関数 repmat が導入されました.</revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
 </refentry>
+
index 8a60648..9baa240 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) 2008 - INRIA - Jean-Baptiste SILVY
  * 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="resize_matrix" xml:lang="ja">
+    
     <refnamediv>
+        
         <refname>resize_matrix</refname>
-        <refpurpose>異なる大きさの新規行列を作成</refpurpose>
+        
+        <refpurpose>
+            
+            行列またはハイパー行列をトリムまたは拡張(およびキャスト)
+            
+        </refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
-        <synopsis>resMat = resize_matrix(mat,nbRow,nbCol,[typeOfMat])</synopsis>
+        
+        <synopsis>
+            
+            resMat = resize_matrix(mat, nbRows, nbCols)
+            
+            
+            
+            resMat = resize_matrix(mat, nbRows, nbCols, resType)
+            
+            resMat = resize_matrix(mat, nbRows, nbCols, resType, padding)
+            
+            resMat = resize_matrix(mat, nbRows, nbCols,    ""  , padding)
+            
+            
+            
+            resMat = resize_matrix(mat, newSizes)
+            
+            resMat = resize_matrix(mat, newSizes, resType)
+            
+            resMat = resize_matrix(mat, newSizes, resType, padding)
+            
+            resMat = resize_matrix(mat, newSizes,    ""  , padding)
+            
+        </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>mat</term>
+                
                 <listitem>
-                    <para>入力行列で, この行列から大きさが変更された行列が
-                        作成されます.
+                    
+                    <para>
+                        
+                        入力行列またはハイパー行列. 論理値, エンコードされた整数, 10進数 (実数または複素数),
+                        
+                        多項式, またはテキストがサポートされます.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
-                <term>nbRow</term>
+                
+                <term>nbRows</term>
+                
                 <listitem>
-                    <para>大きさが変更される行列の行の数.</para>
+                    
+                    <para>
+                        
+                        大きさ変更後の行列の行数. 超過した行はトリムされます.
+                        
+                        足りない行は拡張されます.
+                        
+                    </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
-                <term>nbCol</term>
+                
+                <term>nbCols</term>
+                
                 <listitem>
-                    <para>大きさが変更される行列の列の数.</para>
+                    
+                    <para>
+                        
+                        大きさ変更後の行列の列数. 超過した列はトリムされます.
+                        
+                        足りない列は拡張されます.
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>newSizes</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        <varname>mat</varname>の各次元方向の新しい大きさを指定するベクトル.
+                        
+                    </para>
+                    
+                    <para>
+                        
+                        <literal>size(mat)</literal>より短い場合, 1でパディングされます. 
+                        
+                        例: <literal>size(mat)==[ 4 3 3 2]</literal>となる <varname>mat</varname> が入力され,
+                        
+                        <literal>newSizes=[6 2]</literal>が指定された場合,
+                        
+                        <literal>newSizes = [6 2 1 1]</literal> が考慮されます.
+                        
+                    </para>
+                    
+                    <para>
+                        
+                        <varname>newSizes</varname> が <literal>size(mat)</literal>でなくなる場合, 
+                        
+                        新規次元が <varname>mat</varname>に追加され,パディングされます.
+                        
+                        例えば,<literal>size(mat)==[ 4 3 ]</literal>となるような <varname>mat</varname>が入力され,
+                        
+                        <literal>newSizes=[6 2 2]</literal>が指定された場合,
+                        
+                        結果は2ページのハイパー行列となります.
+                        
+                        2番目の次元は完全にパディングされます.
+                        
+                    </para>
+                    
+                    <para>
+                        
+                        <literal>newSizes = [nbRows, nbCols]</literal> は行列として使用できます.
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>padding</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        <varname>mat</varname>と同じ型のオプションのスカラー,
+                        
+                        次元方向に大きさが増加した際に作成された要素に設定する内容を指定します.
+                        
+                        デフォルトのパディングは <literal>0</literal>
+                        
+                        (実数または複素数10進数,エンコードされた整数,多項式), または
+                        
+                        <literal>""</literal> (テキスト),<literal>%F</literal> (論理値)で行われます.
+                        
+                    </para>
+                    
+                    <para>
+                        
+                        <varname>mat</varname> および <varname>padding</varname> の型が一致しない場合, 
+                        
+                        scilabは<varname>padding</varname>の型を変換しようとします.
+                        
+                    </para>
+                    
+                    <para>
+                        
+                        多項式の場合, パティングの変数名は強制的に<varname>mat</varname>と同じとなります.
+                        
+                    </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
-                <term>typeOfMat</term>
+                
+                <term>resType</term>
+                
                 <listitem>
-                    <para>文字列, 大きさが変更される行列の型名.</para>
+                    
+                    <para>
+                        
+                        オプションのテキストで大きさが変更された行列が変換されるデータ型を指定します.
+                        
+                        "boolean", "constant", "string", "int8", "uint8", "int16", "uint16", "int32", および "uint32" 
+                        
+                        がサポートされます.
+                        
+                    </para>
+                    
+                    <para>多項式およびテキストのハイパー行列については型変換がサポートされません.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>resMat</term>
+                
                 <listitem>
-                    <para>大きさが変更された行列.</para>
+                    
+                    <para>大きさが変更され(変換され)た行列またはハイパー行列</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
-            大きさ <literal>nbRow</literal> x
-            <literal>nbCol</literal> の行列を作成し,
-            <literal>(i,j)</literal>が入力行列の範囲の場合,
-            その要素<literal>(i,j)</literal>
-            を<literal>mat(i,j)</literal>とします.
-            それ以外の場合, 要素 <literal>(i,j)</literal>は
-            実数または整数行列の場合に <literal>0</literal>,
-            論理値行列,文字列行列の空の文字列
-            の場合に <literal>%f</literal>となります.
+            
+            大きさ<literal>[nbRows, nbCols]</literal> または <literal>newSizes</literal>の行列,
+            
+            大きさ<literal>newSizes</literal>のハイパー行列を作成します.
+            
+            新しい大きさのある次元が最初のものよりも小さい場合, 行列はトリムされます.
+            
+            大きさが増加した場合, 行列/ハイパー行列はパディングされます.
+            
+            次元の数を増やすことも可能です.
+            
+            Scilabは自動的に大きさが1(シングルトン)に設定された最高の次元を縮小します.
+            
         </para>
-        <para>出力行列の型は
-            <literal>typeOfMat</literal> 引数で指定することにより修正できます.
-            この場合,入力行列がこの型と互換性があることを確認してください.
-        </para>
-        <para>現在,実数,整数行列,論理値および文字列行列のみが
-            サポートされています.
-            これは, <literal>typeOfMat</literal>を
-            'constant', 'boolean', 'string' または任意の整数型 
-            ('int8', 'int16',...)の中から選択する必要があることを意味します.
+        
+        <para>
+            
+            結果の型は,上記の制限のもとに<literal>resType</literal>引数の指定により変更できます.
+            
         </para>
+               
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
-        <programlisting role="example"><![CDATA[ 
-// 数値行列
-myMat = 5 * rand( 3, 4 )
-myMat = resize_matrix( myMat, 3, 3 ) // 行列の大きさを縮小
-myMatInteger = resize_matrix( myMat, 4, 4, 'int32' ) // 整数行列を作成
-myMatBoolean = resize_matrix( myMat, 2, 2, 'boolean' )
-myMatBoolean = resize_matrix( myMatBoolean, 3, 5 )
+        
+        <programlisting role="example"><![CDATA[
+// 組込の例, 多項式を含む
+resize_matrix
 
-// 文字列行列
-myMatString = ["Scilab","the";"Open Source","Scientific";"Software","Package"]
-myMatString = resize_matrix( myMatString, 3, 1 )
+// 数値行列:
+M = grand(4, 3, "uin", -9, 9)
+resize_matrix(M, 3, 4)
+resize_matrix(M, [3 4 2])
+resize_matrix(M, [3 4 2], "", %i)
+resize_matrix(M, [3 4 2], "string", %i)
+
+// テキストの行列:
+myMatString = ["Scilab", "the"; "Open Source", "Scientific"; "Software", "Package"]
+resize_matrix( myMatString, 5, 3 )
+// new sizesに等価な構文:
+resize_matrix( myMatString, [5 3], "", "$" )    // カスタムパディング
+
+// トリム, パディングとハイパー行列へのキャスト:
+h = rand(2, 3, 2)*200
+resize_matrix(h, [3 2 3], "int8")
+resize_matrix(h, [3 2 3], "int8", -1)    // カスタムパディング
+r = resize_matrix(h, [3 2 ] , "" , -1)   // 型変換せずにカスタムパディング
+size(r)  // 最後の次元は縮小されました
+
+// 多項式:
+x = poly(0, "x");
+P = (1-x)^grand(4, 2, "uin", 0, 3)
+resize_matrix(P, 3, 3)
+resize_matrix(P, [3 3 2])
+resize_matrix(P, [3 3 2], "", %z)
+//  => パディングの未知数はPのものに強制的に変更されました
+//  => 多項式は変換できません
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="matrix">matrix</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="size">size</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="typeof">typeof</link>
+                
             </member>
+            
+            <member>
+                
+                <link linkend="double">double</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="strtod">strtod</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="strtod">string</link>
+                
+            </member>
+            
         </simplelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.5.0</revnumber>
+                
+                <revremark>
+                    
+                    多項式とハイパー行列を利用可能になりました.
+                    
+                    カスタムパディングを指定可能となりました.
+                    
+                    新しい大きさをベクトルとして指定できます.
+                    
+                    resize_matrix に引数を付けない場合, 例(デモ)を表示します.
+                    
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
     </refsection>
+    
 </refentry>
+
index 1ff337e..9a41067 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns: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="dsearch" xml:lang="ja">
+    
     <refnamediv>
+        
         <refname>dsearch</refname>
-        <refpurpose>二分探索法</refpurpose>
+        
+        <refpurpose>
+            
+            指定の分類で行列またはハイパー行列の要素を分配, 配置および数える
+            
+        </refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
-        <synopsis>[ind, occ, info] = dsearch(X, val [, ch ])</synopsis>
+        
+        <synopsis>
+            
+            [i_bin [,counts [,outside]]] = dsearch(X, bins )
+            
+            [i_bin [,counts [,outside]]] = dsearch(X, bins , pm )
+            
+        </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>X</term>
+                
                 <listitem>
-                    <para>実数ベクトルまたは行列</para>
+                    
+                    <para>
+                        
+                        実数,エンコードされた整数,またはテキストの行列またはハイパー行列: 分類するエントリ.
+                        
+                        複素数と多項式はサポートされません.
+                        
+                    </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
-                <term>val</term>
+                
+                <term>bins</term>
+                
                 <listitem>
+                    
                     <para>
-                        厳密に昇順(val(1) &lt; val(2) &lt; ... &lt; val(n))のn個の要素を有する
-                        実数 (行または列) ベクトル
+                        
+                        分類を定義する<varname>X</varname>と同じ型
+                        
+                        (<varname>X</varname>のエンコードされた整数の場合, <varname>bins</varname> は10進数とすることができます)
+                        
+                        の行または列ベクトル,
+                        
+                        <itemizedlist>
+                            
+                            <listitem>
+                                
+                                離散型の場合(pm="d"): <varname>bins</varname> は,
+                                
+                                <varname>X</varname>のエントリを特定する異なった値となります.
+                                
+                                If <varname>X</varname> が数値 (実数またはエンコードされた整数)の場合, 
+                                
+                                <varname>bins</varname> は厳密に昇順にソートする必要があります.
+                                
+                            </listitem>
+                            
+                            <listitem>
+                                
+                                連続の場合 (デフォルト, pm="c"): <varname>bins</varname> は
+                                
+                                隣接する間隔の境界です:
+                                
+                                <literal>I1 = [bins(1), bins(2)]</literal>, <literal>I2 = (bins(2), bins(3)]</literal>,..., 
+                                
+                                <literal>In = (bins(n), bins(n+1)]</literal>. 
+                                
+                                <varname>X</varname>からのエントリはbins(1)に等しいものが
+                                
+                                <literal>I1</literal>に含まれることに注意してください.
+                                
+                                <varname>bins</varname>の値は厳密に昇順である必要があります:
+                                
+                                bins(1) &lt; bins(2) &lt; ... &lt; bins(n).
+                                
+                                テキスト処理の場合, 大文字小文字を区別する辞書順が使用されます.
+                                
+                            </listitem>
+                            
+                        </itemizedlist>
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
-                <term>ch</term>
+                
+                <term>pm</term>
+                
                 <listitem>
-                    <para>(オプションの) 文字 "c" または "d" (デフォルト値 "c")</para>
+                    
+                    <para>
+                        
+                        "c" (連続, デフォルト) または "d" (離散): 処理モード. 連続モードの場合, 
+                        
+                        <varname>bins</varname> は分類として隣接する範囲の境界を定義します.
+                        
+                        離散モードの場合,
+                        
+                        <varname>bins</varname> は<varname>X</varname>を特定する
+                        
+                        エントリの値を提供します.
+                        
+                    </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
-                <term>ind</term>
+                
+                <term>i_bin</term>
+                
                 <listitem>
-                    <para>Xと同じ次元の実数ベクトルまたは行列</para>
+                    
+                    <para>
+                        
+                        <varname>X</varname>と同じ大きさの行列またはハイパー行列: 
+                        
+                        <literal>i_bin(k)</literal> は<varname>X(k)</varname> が属する分類の添字です.
+                        
+                        <varname>X(k)</varname>がどの分類にも属さない場合, <literal>i_bin(k) = 0</literal>となります.
+                        
+                    </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
-                <term>occ</term>
-                <listitem>
+                
+                <term>counts</term>
+                
+                <listitem>各ビンにおけるXエントリの数.
+                    
+                    <para>
+                        
+                        連続ケース (pm="c"): 
+                        
+                        counts(i)は,
+                        
+                        上記 (<varname>bins</varname>パラメータ参照)の範囲<literal>Ik</literal> に属する
+                        
+                        <varname>X</varname>の要素数です. 
+                        
+                        bins(1)にちょうど等しい<varname>X</varname>の要素はcounts(1)に含まれます.
+                        
+                        <varname>counts</varname> の大きさは <varname>bins</varname> - 1 です.
+                        
+                    </para>
+                    
                     <para>
-                        val と同じ形式の実数のベクトル
-                        (しかし, ch="c"の場合には n-1 個の要素となります)
+                        
+                        離散ケース(pm="d"): <literal>counts(i)</literal> は,
+                        
+                        <literal>bins(i)</literal>に等しい<varname>X</varname> の要素の数です.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
-                <term>info</term>
+                
+                <term>outside</term>
+                
                 <listitem>
-                    <para>整数</para>
+                    
+                    <para>
+                        
+                        <literal>bins</literal>のどれにも属さないXのエントリの総数.
+                        
+                    </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
-        <para>この関数は,
-            ソートされたテーブルを探索したり,
-            いくつかのクラス(間隔または値のクラス)に散らばっている
-            ベクトルの要素の数を数える際に有用です.
-        </para>
+        
         <para>
-            デフォルトで,または <literal>ch="c"</literal>の時,
-            これは区間の場合で, n-1 個の間隔で
-            各 X(i) の探索が行われます.
-            区間は次のように定義されます: 
+            
+            各<varname>X(i)</varname>エントリについて,
+            
+            <varname>dsearch</varname>は,<varname>bins</varname>により定義される
+            
+            値<literal>bins(j)</literal>または
+            
+            範囲<literal>(bins(j), bins(j+1)]</literal> について
+            
+            <varname>X(i)</varname>を含まれるまたは等しいかを決めます.
+            
+            その後, 等しいビンがないまたは有する場合に応じて, 
+            
+            <literal>i_bin(i) = j</literal> または 0 を返します.
+            
+            (最初の範囲が<literal>bins(1)</literal>を含みます)
+            
+            各ビンの母集団が<varname>counts</varname>により返されます.
+            
+            ビンに含まれないエントリの総数が<varname>outside</varname> に返されます
+            
+            (よって<literal>outside = sum(bool2s(i_bin==0))</literal>です).
+            
         </para>
-        <programlisting role=""><![CDATA[ 
-I1 = [val(1), val(2)]
-Ik = (val(k), val(k+1)] for 1 < k <= n-1 ; 
- ]]></programlisting>
-        <para>そして:</para>
-        <variablelist>
-            <varlistentry>
-                <term>ind(i)</term>
-                <listitem>
-                    <para>はX(i)の区間番号です.
-                        (X(i)が [val(1),val(n)] の範囲にない場合は 0)
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>occ(k)</term>
-                <listitem>
-                    <para>はIkの中にあるXの要素の数です.</para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>info</term>
-                <listitem>
-                    <para>[val(1),val(n)]の範囲にないXの要素の数</para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
+        
         <para>
-            <literal>ch="d"</literal> の場合, これは離散値の時で,
-            各 X(i) に関して val(k) と等しいかどうかの検索となります :
+            
+            <literal>dsearch(..)</literal> はオーバーロードできます.
+            
+            デフォルト pm="c" オプションはデータ集合を与える関数の実験的なヒストグラムを計算する
+            
+            際に使用できます.
+            
         </para>
-        <variablelist>
-            <varlistentry>
-                <term>ind(i)</term>
-                <listitem>
-                    <para>は,値がX(i) (X(i)=val(k)の場合, ind(i) = k) に一致する要素の添字と等しくなります.
-                        X(i) が val に含まれない場合は 0 となります.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>occ(k)</term>
-                <listitem>
-                    <para>val(k)に等しい X の要素の数</para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>info</term>
-                <listitem>
-                    <para>
-                        集合{val(1),...,val(n)}の中にない X の要素の数
-                    </para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
+        
     </refsection>
+    
+    
+    
     <refsection>
+        
         <title>例</title>
-        <programlisting role="example"><![CDATA[ 
-// 例 #1 (elementary stat for U(0,1))
-m = 50000 ; n = 10;
-X = grand(m,1,"def");
-val = linspace(0,1,n+1)';
-[ind, occ] = dsearch(X, val);
-clf() ; plot2d2(val, [occ/m;0])  // no normalisation : y must be near 1/n
-
-
-// 例 #2 (elementary stat for B(N,p))
-N = 8 ; p = 0.5; m = 50000;
-X = grand(m,1,"bin",N,p); val = (0:N)';
-[ind, occ] = dsearch(X, val, "d");
-Pexp = occ/m; Pexa = binomial(p,N); 
-clf() ; hm = 1.1*max(max(Pexa),max(Pexp));
-plot2d3([val val+0.1], [Pexa' Pexp],[1 2],"111",  ...
-        "Pexact@Pexp", [-1 0 N+1 hm],[0 N+2 0 6])
-xtitle(  "binomial distribution B("+string(N)+","+string(p)+") :" ...
-        +" exact probability versus experimental ones")
+        
+        <programlisting role="example"><![CDATA[
+// DISCRETE values of TEXT
+// -----------------------
+i = grand(4,6,"uin",0,7)+97;
+T = matrix(strsplit(ascii(i),1:length(i)-1), size(i));
+T(T=="f") = "#";
+T(T=="a") = "AA";
+T
+bins = [ strsplit(ascii(97+(7:-1:0)),1:7)' "AA"]
+[i_bin, counts, outside] = dsearch(T, bins, "d")
 
+// BINNING TEXTS in LEXICOGRAPHIC INTERVALS
+// ----------------------------------------
+// generating a random matrix of text
+nL = 3; nC = 5; L  = 3;
+s = ascii(grand(1,nL*nC*L,"uin",0,25)+97);
+T = matrix(strsplit(s, L:L:nL*nC*L-1), nL, nC);
+// generating random bins bounds
+L  = 2; nC = 6;
+s = ascii(grand(1,nC*L,"uin",0,25)+97);
+bins = unique(matrix(strsplit(s, L:L:nC*L-1), 1, nC))
+T
+[i_bin, counts, outside] = dsearch(T, bins)
+    ]]></programlisting>
+        
+        
+        
+        <para>
+            
+            以下の例では, 3つの範囲
+            
+            <literal>I1 = [5,11]</literal>,
+            
+            <literal>I2 = (11,15]</literal> および <literal>I3 = (15,20]</literal>を考えます.
+            
+            <literal>X = [11 13 1 7 5 2 9]</literal>のエントリの位置をこれらの範囲で探してみます.
+            
+        </para>
+        
+        <programlisting role="example"><![CDATA[
+[i_bin, counts, outside] = dsearch([11 13 1 7 5 2 9], [5 11 15 20])
+    ]]></programlisting>
+        
+        <para>
+            
+            表示される出力:
+            
+        </para>
+        
+        <screen><![CDATA[
+-->[i_bin, counts, outside] = dsearch([11 13 1 7 5 2 9], [5 11 15 20])
+ outside  =
+    2.
+ counts  =
+    4.    1.    0.
+ i_bin  =
+    1.    2.    0.    1.    1.    0.    1.
+    ]]></screen>
+        
+        <para>
+            
+            ここで,
+            
+        </para>
+        
+        <itemizedlist>
+            
+            <listitem>
+                
+                <para>X(1)=11 は範囲 I1, すなわち i_bin(1)=1.</para>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <para> X(2)=13 は範囲 I2, すなわち i_bin(2)=2.</para>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <para> X(3)=1 は定義された範囲のどれにも属さない, すなわち i_bin(3)=0.</para>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <para> X(4)=7 は範囲 I1, すなわち i_bin(4)=1.</para>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <para>...</para>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <para> I1 には4個のエントリ (5, 7, 9 および 11), すなわち counts(1)=4.</para>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <para> I2 のエントリは1個のみ (13), すなわち counts(2)=1.</para>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <para> I3 にはXのエントリなし, すなわち counts(3)=0.</para>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <para> 2個のXのエントリは定義された範囲のどれにも属さない(1, 2),  すなわち outside=2.</para>
+                
+            </listitem>
+            
+        </itemizedlist>
+        
+        <programlisting role="example"><![CDATA[
+// Numbers in DISCRETE categories (having specific values)
+// ------------------------------
+[i_bin, counts, outside] = dsearch([11 13 1 7 5 2 9], [5 11 15 20],"d" )
+    ]]></programlisting>
+        
+        <para>
+            
+            は以下を出力します
+            
+        </para>
+        
+        <screen><![CDATA[
+-->[i_bin, counts, outside] = dsearch([11 13 1 7 5 2 9], [5 11 15 20], "d" )
+ outside  =
+    5.
+ counts  =
+    1.    1.    0.    0.
+ i_bin  =
+    2.    0.    0.    0.    1.    0.    0.
+    ]]></screen>
+        
+        <para>
+            
+            ここで,
+            
+        </para>
+        
+        <itemizedlist>
+            
+            <listitem>
+                
+                <para>
+                    
+                    X(1)=11 は位置 #2にある集合<literal>bins</literal>, すなわち i_bin(1)=2.
+                    
+                </para>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <para>
+                    
+                    X(2)=13 は集合<literal>bins</literal>に含まれない, すなわち i_bin(2)=0.
+                    
+                </para>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <para>...</para>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <para>
+                    
+                    X(7)=9 は集合<literal>bins</literal>に含まれない, すなわち i_bin(7)=0.
+                    
+                </para>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <para>
+                    
+                    5に等しいXのエントリ(5)は1つのみ, すなわち, counts(1)=1.
+                    
+                </para>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <para>
+                    
+                    <literal>bins(4)</literal>に一致するエントリはなし, すなわち counts(4)=0.
+                    
+                </para>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <para>
+                    
+                    集合<literal>bins</literal>に含まれないXのエントリは5個(すなわち 13, 1, 7, 2, 9), よってoutside=5.
+                    
+                </para>
+                
+            </listitem>
+            
+        </itemizedlist>
+        
+        <para>
+            
+            処理モード(連続または離散)によらず
+            
+            <literal>bins</literal>の数は昇順にする必要があります.
+            
+            これ以外の場合, エラーが発生します:
+            
+        </para>
+        
+        <screen><![CDATA[
+-->dsearch([11 13 1 7 5 2 9], [2 1])
+!--error 999
+dsearch   : the array s (arg 2) is not well ordered
+-->dsearch([11 13 1 7 5 2 9], [2 1],"d")
+!--error 999
+dsearch   : the array s (arg 2) is not well ordered
+    ]]></screen>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>高度な例</title>
+        
+        <para>
+            
+            以下の例では, 
+            
+            [0,1) の一様乱数の経験的ヒストグラムを一様分布関数と比較します.
+            
+            この比較を行うために, 範囲(pm="c")に基づくデフォルトの探索アルゴリズムを
+            
+            使用します.
+            
+            Xを [0,1)の範囲の一様乱数の集合(m=50 000)として生成します.
+            
+            n=10とし,[0,1]の範囲に等間隔の値を配置し,
+            
+            関連する範囲を設定します.
+            
+            次に,各範囲に入るXのエントリの数を数えます:
+            
+            これは,一様分布関数の経験的ヒストグラムです.
+            
+            数/mの期待値は 1/(n-1) に等しくなります.
+            
+        </para>
+        
+        <programlisting role="example"><![CDATA[
+m = 50000 ;
+n = 10;
+X = grand(m, 1, "def");
+bins = linspace(0, 1, n)';
+[i_bin, counts] = dsearch(X, bins);
+e = 1/(n-1)*ones(1, n-1);
+scf() ;
+plot(bins(1:n-1), counts/m, "bo");
+plot(bins(1:n-1), e', "r-");
+legend(["Experiment", "Expectation"]);
+xtitle("Uniform random numbers", "X", "P(X)");
+ ]]></programlisting>
+        
+        <scilab:image>
+            
+            m = 50000 ;
+            
+            n = 10;
+            
+            X = grand(m,1, "def");
+            
+            bins = linspace(0, 1, n)';
+            
+            [i_bin, counts] = dsearch(X, bins);
+            
+            e = 1/(n-1)*ones(1, n-1);
+            
+            scf() ;
+            
+            plot(bins(1:n-1), counts/m, "bo");
+            
+            plot(bins(1:n-1), e', "r-");
+            
+            legend(["Experiment","Expectation"]);
+            
+            xtitle("Uniform random numbers", "X", "P(X)");
+            
+        </scilab:image>
+        
+        <para>
+            
+            以下の例では,二項分布乱数のヒストグラムを
+            
+            N=8 および p=0.5の二項確率分布関数B(N,p)と比較します.
+            
+            この比較を行うために, 集合に基づく離散アルゴリズム(pm="d")を使用します.
+            
+        </para>
+        
+        <programlisting role="example"><![CDATA[
+N = 8 ;
+p = 0.5;
+m = 50000;
+X = grand(m,1,"bin",N,p);
+bins = (0:N)';
+[i_bin, counts] = dsearch(X, bins, "d");
+Pexp = counts/m;
+Pexa = binomial(p,N);
+scf() ;
+plot(bins, Pexp, "bo");
+plot(bins, Pexa', "r-");
+xtitle("Binomial distribution B(8,0.5)","X","P(X)");
+legend(["Experiment","Expectation"]);
+]]></programlisting>
+        
+        <scilab:image>
+            
+            N = 8 ;
+            
+            p = 0.5;
+            
+            m = 50000;
+            
+            X = grand(m,1,"bin",N,p);
+            
+            bins = (0:N)';
+            
+            [i_bin, counts] = dsearch(X, bins, "d");
+            
+            Pexp = counts/m;
+            
+            Pexa = binomial(p,N);
+            
+            scf() ;
+            
+            plot(bins, Pexp, "bo");
+            
+            plot(bins, Pexa',"r-");
+            
+            xtitle("Binomial distribution B(8,0.5)","X","P(X)");
+            
+            legend(["Experiment","Expectation"]);
+            
+        </scilab:image>
+        
+        <para>
+            
+            以下の例では,データ集合を補間するたねい離散エルミート多項式を使用します.
+            
+        </para>
+        
+        <programlisting role="example"><![CDATA[
 
-// 例 #3 (piecewise Hermite polynomial)
-x = [0 ; 0.2 ; 0.35 ; 0.5 ; 0.65 ; 0.8 ;  1];
-y = [0 ; 0.1 ;-0.1  ; 0   ; 0.4  ;-0.1 ;  0];
-d = [1 ; 0   ; 0    ; 1   ; 0    ; 0   ; -1];
-X = linspace(0, 1, 200)';
-ind = dsearch(X, x);
+      // define Hermite base functions
+      function y=Ll(t,k,x)
+        // Lagrange left on Ik
+        y=(t-x(k+1))./(x(k)-x(k+1))
+      endfunction
+      function y=Lr(t,k,x)
+        // Lagrange right on Ik
+        y=(t-x(k))./(x(k+1)-x(k))
+      endfunction
+      function y=Hl(t,k,x)
+        y=(1-2*(t-x(k))./(x(k)-x(k+1))).*Ll(t,k,x).^2
+      endfunction
+      function y=Hr(t,k,x)
+        y=(1-2*(t-x(k+1))./(x(k+1)-x(k))).*Lr(t,k,x).^2
+      endfunction
+      function y=Kl(t,k,x)
+        y=(t-x(k)).*Ll(t,k,x).^2
+      endfunction
+      function y=Kr(t,k,x)
+        y=(t-x(k+1)).*Lr(t,k,x).^2
+      endfunction
 
-// Hermite base 関数を定義
-deff("y=Ll(t,k,x)","y=(t-x(k+1))./(x(k)-x(k+1))")   // Lagrange left on Ik
-deff("y=Lr(t,k,x)","y=(t-x(k))./(x(k+1)-x(k))")     // Lagrange right on Ik
-deff("y=Hl(t,k,x)","y=(1-2*(t-x(k))./(x(k)-x(k+1))).*Ll(t,k,x).^2")
-deff("y=Hr(t,k,x)","y=(1-2*(t-x(k+1))./(x(k+1)-x(k))).*Lr(t,k,x).^2")
-deff("y=Kl(t,k,x)","y=(t-x(k)).*Ll(t,k,x).^2")
-deff("y=Kr(t,k,x)","y=(t-x(k+1)).*Lr(t,k,x).^2")
+      x = [0 ; 0.2 ; 0.35 ; 0.5 ; 0.65 ; 0.8 ;  1];
+      y = [0 ; 0.1 ;-0.1  ; 0   ; 0.4  ;-0.1 ;  0];
+      d = [1 ; 0   ; 0    ; 1   ; 0    ; 0   ; -1];
+      X = linspace(0, 1, 200)';
+      i_bin = dsearch(X, x);
 
-// 曲線をプロット
-Y = y(ind).*Hl(X,ind) + y(ind+1).*Hr(X,ind) + d(ind).*Kl(X,ind) + d(ind+1).*Kr(X,ind);
-clf(); plot2d(X,Y,2) ; plot2d(x,y,-9,"000") 
-xtitle("an Hermite piecewise polynomial")
-// NOTE : you can verify by adding these ones : 
-// YY = interp(X,x,y,d); plot2d(X,YY,3,"000")
- ]]></programlisting>
+      // plot the curve
+      Y = y(i_bin).*Hl(X,i_bin) + y(i_bin+1).*Hr(X,i_bin) + d(i_bin).*Kl(X,i_bin) + d(i_bin+1).*Kr(X,i_bin);
+      scf();
+      plot(X,Y,"k-");
+      plot(x,y,"bo")
+      xtitle("Hermite piecewise polynomial");
+      legend(["Polynomial","Data"]);
+      // NOTE : it can be verified by adding these ones :
+      // YY = interp(X,x,y,d); plot2d(X,YY,3,"000")
+      ]]></programlisting>
+        
+        <scilab:image>
+            
+            
+            
+            function y=Ll(t,k,x)
+            
+            y=(t-x(k+1))./(x(k)-x(k+1))
+            
+            endfunction
+            
+            function y=Lr(t,k,x)
+            
+            y=(t-x(k))./(x(k+1)-x(k))
+            
+            endfunction
+            
+            function y=Hl(t,k,x)
+            
+            y=(1-2*(t-x(k))./(x(k)-x(k+1))).*Ll(t,k,x).^2
+            
+            endfunction
+            
+            function y=Hr(t,k,x)
+            
+            y=(1-2*(t-x(k+1))./(x(k+1)-x(k))).*Lr(t,k,x).^2
+            
+            endfunction
+            
+            function y=Kl(t,k,x)
+            
+            y=(t-x(k)).*Ll(t,k,x).^2
+            
+            endfunction
+            
+            function y=Kr(t,k,x)
+            
+            y=(t-x(k+1)).*Lr(t,k,x).^2
+            
+            endfunction
+            
+            
+            
+            x = [0 ; 0.2 ; 0.35 ; 0.5 ; 0.65 ; 0.8 ;  1];
+            
+            y = [0 ; 0.1 ;-0.1  ; 0   ; 0.4  ;-0.1 ;  0];
+            
+            d = [1 ; 0   ; 0    ; 1   ; 0    ; 0   ; -1];
+            
+            X = linspace(0, 1, 200)';
+            
+            i_bin = dsearch(X, x);
+            
+            
+            
+            Y = y(i_bin).*Hl(X,i_bin) + y(i_bin+1).*Hr(X,i_bin) + d(i_bin).*Kl(X,i_bin) + d(i_bin+1).*Kr(X,i_bin);
+            
+            scf();
+            
+            plot(X,Y,"k-");
+            
+            plot(x,y,"bo")
+            
+            xtitle("Hermite piecewise polynomial");
+            
+            legend(["Polynomial","Data"]);
+            
+        </scilab:image>
+        
     </refsection>
+    
+    
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="find">find</link>
+                
             </member>
+            
             <member>
+                
+                <link linkend="members">members</link>
+                
+            </member>
+            
+            <member>
+                
                 <link linkend="tabul">tabul</link>
+                
             </member>
+            
         </simplelist>
+        
+    </refsection>
+    
+    
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.5.0</revnumber>
+                
+                <revremark>ハイパー行列, エンコードされた整数,およびテキストへの拡張.</revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
     </refsection>
+    
 </refentry>
+
index 7e6aac1..0d21d74 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) 2008 - 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: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="gsort" xml:lang="ja">
+    
     <refnamediv>
+        
         <refname>gsort</refname>
+        
         <refpurpose>クイックソートアルゴリズムによるソート</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>[B [,k]]=gsort(A)
+            
             [B [,k]]=gsort(A,option)
+            
             [B [,k]]=gsort(A,option,direction)
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>A</term>
+                
                 <listitem>
+                    
                     <para>実数,整数または文字列のベクトル/行列または疎ベクトル.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>option</term>
+                
                 <listitem>
+                    
                     <para>文字列. ソートの種類(下記)を指定します:</para>
+                    
                     <itemizedlist>
+                        
                         <listitem>
+                            
                             <para>
+                                
                                 'r' : <literal>A</literal> の各列がソートされます
+                                
                             </para>
+                            
                         </listitem>
+                        
                         <listitem>
+                            
                             <para>
+                                
                                 'c': <literal>A</literal> の各行がソートされます
+                                
                             </para>
+                            
                         </listitem>
+                        
                         <listitem>
+                            
                             <para>
+                                
                                 'g': <literal>A</literal> の全要素がソートされます. 
+                                
                                 デフォルト値です.
+                                
                             </para>
+                            
                         </listitem>
+                        
                         <listitem>
+                            
                             <para>
+                                
                                 'lr': <literal>A</literal>の列の辞書式ソート
+                                
                             </para>
+                            
                         </listitem>
+                        
                         <listitem>
+                            
                             <para>
+                                
                                 'lc': <literal>A</literal>のの行の辞書式ソート
+                                
                             </para>
+                            
                         </listitem>
+                        
                     </itemizedlist>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>direction</term>
+                
                 <listitem>
+                    
                     <para>文字列. ソートの方向を指定します:
+                        
                         <literal>'i'</literal> は昇順,
+                        
                         <literal>'d'</literal> は降順 (デフォルト)を意味します.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>B</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         <literal>A</literal>と同じ型と次元の配列.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>k</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         整数値を有し,<literal>A</literal>と同じ次元の実数配列.
+                        
                         元の添え字を有します.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             <literal>gsort</literal> は種々のデータ型に関する
+            
             "クイックソート" アルゴリズムです.
+            
         </para>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para>
+                    
                     <literal>B=gsort(A,'g')</literal>,
+                    
                     <literal>B=gsort(A,'g','d')</literal> および
+                    
                     <literal>B=gsort(A)</literal> は
+                    
                     配列  <literal>A</literal>の要素を<literal>A(:)</literal>として
+                    
                     降順にソートします.
+                    
                 </para>
+                
                 <para>
+                    
                     <literal>B=gsort(A,'g','i')</literal> は
+                    
                     <literal>A</literal>の要素を昇順にソートします.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <literal>B=gsort(A,'lr')</literal> は<literal>A</literal>
+                    
                     の行を辞書的に降順にソートします.
+                    
                     <literal>B</literal>は,
+                    
                     <literal>B</literal>の各行が<literal>B(i,:)&gt;=B(j,:)</literal>
+                    
                     (ただし,<literal>i&lt;j</literal>)となるように,
+                    
                     行列<literal>A</literal>の行を並び替えることにより
+                    
                     得られます.
+                    
                 </para>
+                
                 <para>
+                    
                     <literal>B=gsort(A,'lr','i')</literal> は
+                    
                     昇順の辞書的ソートについても同様に動作します.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <literal>B=gsort(A,'lc')</literal> 
+                    
                     の列を辞書的に降順にソートします.
+                    
                     <literal>B</literal>は,
+                    
                     <literal>B</literal>の各列が<literal>B(:,i)&gt;=B(:,j)</literal>
+                    
                     (ただし,<literal>i&lt;j</literal>となるように,
+                    
                     行列<literal>A</literal>の列を並び替えることにより
+                    
                     得られます.
+                    
                 </para>
+                
                 <para>
+                    
                     <literal>B=gsort(A,'lc','i')</literal> は
+                    
                     昇順の辞書的ソートについても同様に動作します.
+                    
                 </para>
+                
             </listitem>
+            
         </itemizedlist>
+        
         <para>二番目の戻り値引数が指定された場合, 
+            
             <literal>k</literal>に<literal>A</literal>のソートされた値の添え字が
+            
             代入されます.
+            
             <literal>[B,k]=gsort(A,'g')</literal>の場合,
+            
             <literal>B==A(k)</literal>となります.
+            
             <emphasis role="bold">このアルゴリズムは,等しい値を有する
+                
                 レコードの相対的な順序を保持します.
+                
             </emphasis>
+            
         </para>
+        
         <para>
+            
             <literal>v</literal> が複素数の場合, その要素は
+            
             大きさ,すなわち, abs(<literal>v</literal>) によりソートされます,
+            
             2番目の引数としては<literal>'g'</literal>のみが複素数で使用可能です.
+            
+        </para>
+        
+        <para>
+            
+            複素数の場合, <literal>gsort</literal> はオーバーロードできます.
+            
+        </para>
+        
+        <para>マクロを参照:
+            
+            SCI/modules/elementary_functions/macros/%_gsort.sci
+            
+        </para>
+        
+        <para>
+            
+            (実数,整数または文字列ベクトル/行列または疎ベクトル以外の)
+            
+            管理されない型のオーバーロードが可能です.
+            
         </para>
+        
         <para>
+            
             <literal>v</literal> が <literal>%nan</literal> または
+            
             <literal>%inf</literal> を要素として有する場合, gsort は
+            
             これらを <literal>'d'</literal> の場合は先頭,
+            
             <literal>'i'</literal>の場合は末尾に置きます.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"> 
+            
             alr=[1,2,2;
+            
             1,2,1;
+            
             1,1,2;
+            
             1,1,1];
+            
             [alr1,k]=gsort(alr,'lr','i')
+            
             [alr1,k]=gsort(alr,'lc','i')
             
+            
+            
             v=int32(alr)
             
+            
+            
             gsort(v)
+            
             gsort(v,'lr','i')
+            
             gsort(v,'lc','i')
             
+            
+            
             v=['Scilab' '2.6'
+            
             'Scilab' '2.7'
+            
             'xcos' '2.7'
+            
             'Scilab' '3.1'
+            
             'xcos' '3.1'
+            
             'xcos' '4.0'
+            
             'Scilab' '4.0']
             
+            
+            
             gsort(v,'lr','i')
+            
             gsort(v,'lc','i')
+            
         </programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="find">find</link>
+                
+            </member>
+            
+        </simplelist>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="overloading">オーバーロード</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>参考文献</title>
+        
         <para>Quick sort algorithm from Bentley &amp; McIlroy's "Engineering a
+            
             Sort Function". Software---Practice and Experience,
+            
             23(11):1249-1265
+            
         </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revremark>
+                    
+                    この関数は(実数, 整数または文字列ベクトル/行列または疎ベクトル以外の)
+                    
+                    管理されない型についてオーバーロードできるようになりました.
+                    
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
     </refsection>
+    
 </refentry>
+
index 4341993..201fb5f 100644 (file)
             
             <literal>N(i,j,...)</literal>が現れる最初(デフォルト)または
             
-            <literal>"last"</literal>(最後)の<literal>H</literal>の
+            <literal>"last"</literal>(最後)の<literal>H</literal>の添字を,
             
-            添字を,
-            
-            2番目のオプションの出力<literal>loc</literal>により
-            
-            取得できます.
+            2番目のオプションの出力<literal>loc</literal>により取得できます.
             
             <literal>"rows"</literal> または <literal>"cols"</literal> 
             
index 6beb6e8..00c3c98 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) 2008 - INRIA - Allan CORNET
  * 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="fullpath">
+    
     <refnamediv>
+        
         <refname>fullpath</refname>
+        
         <refpurpose>
+            
             指定した相対パス名に関する完全なパス名を作成する.
+            
         </refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>res = fullpath(relative_path)</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>res</term>
+                
                 <listitem>
-                    <para>文字列</para>
+                    
+                    <para>文字列または文字列の行列</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>relative_path</term>
+                
                 <listitem>
-                    <para>文字列</para>
+                    
+                    <para>文字列または文字列の行列</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
+            <code>fullpath(relative_path)</code>は,
+            
             指定した相対パス名に関する完全なパス名を作成します.
+            
         </para>
-        <para>linuxでは, 'relative_path' が存在する必要があります.</para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
-mkdir(TMPDIR+'/niv1');
-mkdir(TMPDIR+'/niv1/niv2');
-mputl(' ',TMPDIR+'/niv1/test.txt');
-cd(TMPDIR+'/niv1/niv2');
-fullpath('../test.txt')
+cd(TMPDIR);
+mkdir(TMPDIR + "/niv1");
+mkdir(TMPDIR + "/niv1/niv2");
+mkdir(TMPDIR + "/niv1/niv2/niv3");
+mputl(' ', TMPDIR + "/niv1/test1.txt");
+mputl(' ' , TMPDIR + "/niv1/niv2/test2.txt");
+
+cd(TMPDIR + "/niv1/niv2/niv3");
+
+r1 = fullpath("../../test1.txt")
+r2 = fullpath("../test2.txt")
+M = ["../../test1.txt", "../test2.txt"];
+R = fullpath(M)
  ]]></programlisting>
+        
     </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revremark>管理された文字列の行列 (SEP 72)</revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
 </refentry>
+
index 953177d..dcc66ed 100644 (file)
             この関数は <ulink url="http://xmlsoft.org/html/libxml-uri.html#xmlParseURI">libxml2ライブラリ
                 
                 (特に, 関数 xmlParseURI)
+                
             </ulink>
+            
             に基づいています.
             
         </para>
         
-        
-        
     </refsection>
     
-    
-    
     <refsection>
         
         <title>例</title>
         
-        
-        
         <programlisting role="example">
             
             [proto, server, path, query, username, port, fragment] = splitURL("http://xmlsoft.org/html/libxml-uri.html#xmlParseURI")
@@ -250,8 +246,6 @@ M = grand(3,4,"uin",0,9);
 cshift(M,1);
 -->
         
-        
-        
     </refsection>
     
     
@@ -272,9 +266,11 @@ cshift(M,1);
         
     </refsection>
     
+    
+    
     <refsection>
         
-        <title>History</title>
+        <title>履歴</title>
         
         <revhistory>
             
index 8761d55..1b855ac 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) 2011 - DIGITEO - Allan CORNET
  * 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="tempname">
+    
     <refnamediv>
+        
         <refname>tempname</refname>
-        <refpurpose>テンポラリファイル用のユニークな名前</refpurpose>
+        
+        <refpurpose>
+            
+            ユニークなファイル名を有するファイルを作成
+            
+        </refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>tmp_name = tempname([prefix])</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
+        
         <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>tmp_name</term>
+                
                 <listitem>
+                    
                     <para>文字列</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>prefix</term>
+                
                 <listitem>
+                    
                     <para>文字列: ファイル名の接頭辞(Windowsでは,最大3文字).</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
-        <para>ユニークなファイル名を有するファイルをTMPDIRディレクトリに作成します.
+        
+        <para>
+            
+            <function>tempname</function>は,
+            
+            ユニークなファイル名を有するファイルを<literal>TMPDIR</literal> ディレクトリに作成します.
+            
         </para>
-        <para>tmp_nam = tempname() は,テンポラリなファイル名として使用可能な
-            ユニークな文字列, tmp_namを返します.
+        
+        <para>
+            
+            <code>tmp_name = tempname()</code> は,テンポラリなファイル名として使用可能な
+            
+            ユニークな文字列, <varname>tmp_name</varname>を返します.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[
       F1 = tempname()
       isfile(F1)
       F2 = tempname('TMP')
       isfile(F2)
  ]]></programlisting>
+        
     </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revremark>
+                    
+                    関数<function>tempname</function>が導入されました.
+                    
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
 </refentry>
+
index d488635..7a2a43e 100644 (file)
@@ -1,5 +1,4 @@
 <?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])
-            
             Matplot(a,&lt;opt_args&gt;)
-            
         </synopsis>
-        
     </refsynopsisdiv>
-    
     <refsection>
-        
         <title>引数</title>
-        
         <variablelist>
-            
             <varlistentry>
-                
                 <term>a</term>
-                
                 <listitem>
-                    
                     <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>
-