sync the japanese manual with scilab 5.5.0. 58/14458/2
Rui Hirokawa [Sat, 26 Apr 2014 06:06:44 +0000 (15:06 +0900)]
Change-Id: I4155e00ca96bab852f41e82c36576b842204dac3

60 files changed:
scilab/modules/arnoldi/help/ja_JP/eigs.xml [new file with mode: 0644]
scilab/modules/cacsd/help/ja_JP/copfac.xml
scilab/modules/cacsd/help/ja_JP/csim.xml
scilab/modules/cacsd/help/ja_JP/dtsi.xml
scilab/modules/cacsd/help/ja_JP/fspecg.xml
scilab/modules/cacsd/help/ja_JP/fstabst.xml
scilab/modules/cacsd/help/ja_JP/gamitg.xml
scilab/modules/cacsd/help/ja_JP/gcare.xml
scilab/modules/cacsd/help/ja_JP/gfrancis.xml
scilab/modules/cacsd/help/ja_JP/h2norm.xml
scilab/modules/cacsd/help/ja_JP/h_cl.xml
scilab/modules/cacsd/help/ja_JP/h_inf.xml
scilab/modules/cacsd/help/ja_JP/lcf.xml
scilab/modules/cacsd/help/ja_JP/macglov.xml
scilab/modules/cacsd/help/ja_JP/nehari.xml
scilab/modules/cacsd/help/ja_JP/routh_t.xml
scilab/modules/call_scilab/help/ja_JP/call_scilab.xml [new file with mode: 0644]
scilab/modules/console/help/ja_JP/lines.xml
scilab/modules/core/help/ja_JP/perl.xml
scilab/modules/core/help/ja_JP/scilab.xml
scilab/modules/data_structures/help/ja_JP/isfield.xml
scilab/modules/differential_equations/help/ja_JP/daskr.xml
scilab/modules/differential_equations/help/ja_JP/intc.xml
scilab/modules/differential_equations/help/ja_JP/numdiff.xml
scilab/modules/elementary_functions/help/ja_JP/IsAScalar.xml
scilab/modules/elementary_functions/help/ja_JP/iscolumn.xml
scilab/modules/elementary_functions/help/ja_JP/ismatrix.xml
scilab/modules/elementary_functions/help/ja_JP/isrow.xml
scilab/modules/elementary_functions/help/ja_JP/isscalar.xml
scilab/modules/elementary_functions/help/ja_JP/issquare.xml
scilab/modules/elementary_functions/help/ja_JP/modulo.xml
scilab/modules/elementary_functions/help/ja_JP/unwrap.xml [new file with mode: 0644]
scilab/modules/graphic_export/help/ja_JP/driver.xml
scilab/modules/graphic_export/help/ja_JP/xs2emf.xml
scilab/modules/graphics/help/ja_JP/segs_properties.xml
scilab/modules/graphics/help/ja_JP/xget.xml
scilab/modules/graphics/help/ja_JP/xgrid.xml
scilab/modules/graphics/help/ja_JP/xset.xml
scilab/modules/graphics/help/ja_JP/xsetm.xml
scilab/modules/gui/help/ja_JP/createWindow.xml [new file with mode: 0644]
scilab/modules/gui/help/ja_JP/loadGui.xml [new file with mode: 0644]
scilab/modules/gui/help/ja_JP/saveGui.xml [new file with mode: 0644]
scilab/modules/gui/help/ja_JP/uicontrol.xml
scilab/modules/gui/help/ja_JP/uicontrol_properties.xml [new file with mode: 0644]
scilab/modules/gui/help/ja_JP/uimenu.xml
scilab/modules/gui/help/ja_JP/uimenu_properties.xml [new file with mode: 0644]
scilab/modules/spreadsheet/help/ja_JP/csvDefault.xml
scilab/modules/spreadsheet/help/ja_JP/csvRead.xml
scilab/modules/spreadsheet/help/ja_JP/csvTextscan.xml
scilab/modules/spreadsheet/help/ja_JP/csvWrite.xml
scilab/modules/spreadsheet/help/ja_JP/read_csv.xml
scilab/modules/spreadsheet/help/ja_JP/readxls.xml
scilab/modules/spreadsheet/help/ja_JP/write_csv.xml
scilab/modules/spreadsheet/help/ja_JP/xls_open.xml
scilab/modules/spreadsheet/help/ja_JP/xls_read.xml
scilab/modules/string/help/ja_JP/length.xml
scilab/modules/string/help/ja_JP/part.xml
scilab/modules/string/help/ja_JP/regexp.xml
scilab/modules/string/help/ja_JP/string.xml
scilab/modules/string/help/ja_JP/strtod.xml

diff --git a/scilab/modules/arnoldi/help/ja_JP/eigs.xml b/scilab/modules/arnoldi/help/ja_JP/eigs.xml
new file mode 100644 (file)
index 0000000..f2dbc8d
--- /dev/null
@@ -0,0 +1,884 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2012 - Scilab Enterprises - Adeline CARNIS
+ * 
+ * This file must be used under the terms of the CeCILL.
+ * This source file is licensed as described in the file COPYING, which
+ * you should have received as part of this distribution.  The terms
+ * are also available at    
+ * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+ *
+ -->
+
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns: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="eigs" xml:lang="ja">
+    
+    <refnamediv>
+        
+        <refname>eigs</refname>
+        
+        <refpurpose>
+            
+            行列の最大固有値と固有ベクトルを計算
+            
+        </refpurpose>
+        
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        
+        <title>呼び出し手順</title>
+        
+        <synopsis>
+            
+            d = eigs(A [,B [,k [,sigma [,opts]]]])
+            
+            [d, v] = eigs(A [,B [,k [,sigma [,opts]]]])
+            
+            
+            
+            d = eigs(Af, n [,B [,k [,sigma [,opts]]]])
+            
+            [d, v] = eigs(Af, n [,B [,k [,sigma [,opts]]]])
+            
+        </synopsis>
+        
+    </refsynopsisdiv>
+    
+    <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>A </term>
+                
+                <listitem>
+                    
+                    <para>a full or sparse, real or complex, symmetric or non-symmetric square matrix</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>Af </term>
+                
+                <listitem>
+                    
+                    <para>a function</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>n </term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        a scalar, defined only if <literal>A</literal> is a function
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>B</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        a sparse, real or complex, square matrix with same dimensions as
+                        
+                        <literal> A</literal>
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>k</term>
+                
+                <listitem>
+                    
+                    <para>an integer, number of eigenvalues to be computed</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>sigma</term>
+                
+                <listitem>
+                    
+                    <para>a real scalar or a string of length 2</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>opts</term>
+                
+                <listitem>
+                    
+                    <para>a structure</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>d</term>
+                
+                <listitem>
+                    
+                    <para>a real or complex eigenvalues vector or diagonal matrix (eigenvalues along the diagonal)</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>v</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        real or complex eigenvector matrix
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>
+            
+            The purpose of the eigs function is to compute the largest eigenvalues of sparse, large matrices.
+            
+        </para>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>d = eigs(A) or d = eigs(Af, n)</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        solves the eigenvalue problem <literal>A * v = lambda * v</literal>. This calling returns a vector <literal>d</literal> containing the six largest magnitude eigenvalues.
+                        
+                        <literal>A</literal> is either a square matrix, which can be symmetric or non-symmetric, real or complex, full or sparse.
+                        
+                    </para>
+                    
+                    <para>
+                        
+                        <literal>A</literal> should be represented by a function <literal>Af</literal>. In this instance, a scalar <literal>n</literal> designating
+                        
+                        the length of the vector argument, must be defined. It must have the following header :
+                        
+                    </para>
+                    
+                    <programlisting role="no-scilab-exec">
+                        
+                        <![CDATA[ 
+function y = A ( x )
+ ]]>
+                        
+                    </programlisting>
+                    
+                    <para>
+                        
+                        This function <literal>Af</literal> must return one of the four following expressions :
+                        
+                        <itemizedlist>
+                            
+                            <listitem>
+                                
+                                <term>A * x</term>
+                                
+                                <para> if sigma is not given or is a string other than 'SM'.</para>
+                                
+                            </listitem>
+                            
+                            <listitem>
+                                
+                                <term>A \ x</term>
+                                
+                                <para> if sigma is 0 or 'SM'.</para>
+                                
+                            </listitem>
+                            
+                            <listitem>
+                                
+                                <term>(A - sigma * I) \ x</term>
+                                
+                                <para>for the standard eigenvalue problem, where I is the identity matrix.</para>
+                                
+                            </listitem>
+                            
+                            <listitem>
+                                
+                                <term>(A - sigma * B) \ x</term>
+                                
+                                <para> for the generalized eigenvalue problem.</para>
+                                
+                            </listitem>
+                            
+                        </itemizedlist>
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>[d, v] = eigs(A) or [d, v] = eigs(Af, n)</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        returns a diagonal matrix <literal>d</literal> containing the six largest magnitude eigenvalues on the diagonal.
+                        
+                        <literal>v</literal> is a n by six matrix whose columns are the six eigenvectors corresponding to the returned eigenvalues.
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>d = eigs(A, B)</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        solves the generalized eigenvalue problem <literal>A * v = lambda  * B * v </literal> with positive, definite matrix <literal>B</literal>.
+                        
+                    </para>
+                    
+                    <itemizedlist>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                if <literal>B</literal> is not specified, <literal>B = []</literal> is used.
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                if <literal>B</literal> is specified, <literal>B</literal> must be the same size as A.
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                    </itemizedlist>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>d = eigs(A, B, k)</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        returns in vector <literal>d</literal> the <literal>k</literal> eigenvalues.
+                        
+                        If <literal>k</literal> is not specified, <literal>k = min(n, 6)</literal>, where n is the row number of A.
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>d = eigs(A, B, k, sigma)</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        returns in vector <literal>d</literal> the <literal>k</literal> eigenvalues determined by <literal>sigma</literal>.
+                        
+                        <literal>sigma</literal> can be either a real or complex including 0 scalar or string.
+                        
+                        If sigma is a string of length 2, it takes one of the following values :
+                        
+                    </para>
+                    
+                    <itemizedlist>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                <literal>'LM'</literal> compute the <varname>k</varname> largest in magnitude eigenvalues (by default).
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                <literal>'SM'</literal> compute the <varname>k</varname> smallest in magnitude eigenvalues (same as sigma = 0).
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                <literal>'LA'</literal> compute the <varname>k</varname> Largest Algebraic eigenvalues, only for real symmetric problems.
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                <literal>'SA'</literal> compute the <varname>k</varname> Smallest Algebraic eigenvalues, only for real symmetric problems.
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                <literal>'BE'</literal> compute <varname>k</varname> eigenvalues, half from each end of the spectrum, only for real 
+                                
+                                symmetric problems.
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                <literal>'LR'</literal> compute the <varname>k</varname> eigenvalues of Largest Real part, only for real non-symmetric or 
+                                
+                                complex problems.
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                <literal>'SR'</literal> compute the <varname>k</varname> eigenvalues of Smallest Real part, only for real non-symmetric or 
+                                
+                                complex problems.
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                <literal>'LI'</literal> compute the <varname>k</varname> eigenvalues of Largest Imaginary part, only for real non-symmetric 
+                                
+                                or complex problems.
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                <literal>'SI'</literal> compute the <varname>k</varname> eigenvalues of Smallest Imaginary part, only for real non-symmetric 
+                                
+                                or complex problems.
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                    </itemizedlist>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>d = eigs(A, B, k, sigma, opts)</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        If the <literal> opts </literal> structure is specified, different options can be used to compute the <literal>k</literal> eigenvalues :
+                        
+                    </para>
+                    
+                    <itemizedlist>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                <term>tol</term>
+                                
+                                <para>
+                                    
+                                    required convergence tolerance. By default, <literal>tol = %eps</literal>.
+                                    
+                                </para>
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                <term>maxiter</term>
+                                
+                                <para>
+                                    
+                                    maximum number of iterations. By default, <literal>maxiter = 300</literal>.
+                                    
+                                </para>
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                <term>ncv</term>
+                                
+                                <para>
+                                    
+                                    number of Lanzcos basis vectors to use. For real non-symmetric problems, the <literal>ncv</literal> value must be greater or equal than <literal>2 * k + 1 </literal> and, by default, <literal>ncv = min(max(2 * k + 1, 20), nA) </literal>. For real symmetric or complex problems, <literal>ncv</literal> must be greater or equal <literal>2 * k </literal> and, by default, <literal> ncv = min(max(2 * k, 20), nA) </literal> with <literal> nA = size(A, 2) </literal>.
+                                    
+                                </para>
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                <term>resid</term>
+                                
+                                <para>
+                                    
+                                    starting vector whose contains the initial residual vector, possibly from a previous run. By default,
+                                    
+                                    <literal>resid</literal> is a random initial vector.
+                                    
+                                </para>
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                <term>cholB</term>
+                                
+                                <para>
+                                    
+                                    if <literal>chol(B)</literal> is passed rather than <literal>B</literal>. By default, <literal>cholB</literal> is %f.
+                                    
+                                </para>
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                <term>isreal</term>
+                                
+                                <para>
+                                    
+                                    if <literal>Af</literal> is given, <literal>isreal</literal> can be defined. By default, <literal>isreal</literal> is %t.
+                                    
+                                    This argument should not be indicated if <literal>A</literal> is a matrix.
+                                    
+                                </para>
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                <term>issym</term>
+                                
+                                <para>
+                                    
+                                    if <literal>Af</literal> is given, <literal>issym</literal> can be defined. By default, <literal>issym</literal> is %f.
+                                    
+                                    This argument should not be indicated if <literal>A</literal> is a matrix.
+                                    
+                                </para>
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                    </itemizedlist>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>参考文献</title>
+        
+        <para>
+            
+            この関数はR. Lehoucq, K. Maschhoff, D. Sorensen, および C. Yang.により書かれた
+            
+            ARPACKパッケージに基づいています.
+            
+        </para>
+        
+        <itemizedlist>
+            
+            <listitem>
+                
+                <para>実対称問題用のDSAUPD および DSEUPD ルーチン,</para>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <para>実非対称行列用のDNAUPD および DNEUPD ルーチン.</para>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <para>複素問題用のZNAUPD および ZNEUPD.</para>
+                
+            </listitem>
+            
+        </itemizedlist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>実対称問題の例</title>
+        
+        <programlisting role="example">
+            
+            <![CDATA[ 
+A            = diag(10*ones(10,1));
+A(1:$-1,2:$) = A(1:$-1,2:$) + diag(6*ones(9,1));
+A(2:$,1:$-1) = A(2:$,1:$-1) + diag(6*ones(9,1));
+
+B = eye(10,10);
+k = 8;
+sigma = 'SM';
+opts.cholB = %t;
+
+d = eigs(A)
+[d, v] = eigs(A)
+
+d = eigs(A, B, k, sigma)
+[d, v] = eigs(A, B, k, sigma)
+
+d = eigs(A, B, k, sigma, opts)
+[d, v] = eigs(A, B, k, sigma, opts)
+
+// 疎行列
+AS = sparse(A);
+BS = sparse(B);
+
+d = eigs(AS)
+[d, v] = eigs(AS)
+
+d = eigs(AS, BS, k, sigma)
+[d, v] = eigs(AS, BS, k, sigma)
+
+d = eigs(AS, BS, k, sigma, opts)
+[d, v] = eigs(AS, BS, k, sigma, opts)
+
+// 関数
+clear opts
+function y = fn(x)
+   y = A * x;
+endfunction
+
+opts.isreal = %t;
+opts.issym = %t;
+
+d = eigs(fn, 10, [], k, 'LM', opts)
+
+function y = fn(x)
+   y = A \ x;
+endfunction
+
+d = eigs(fn, 10, [], k, 'SM', opts)
+
+function y = fn(x)
+   y = (A - 4 * eye(10,10)) \ x;
+endfunction
+
+d = eigs(fn, 10, [], k, 4, opts)
+ ]]>
+            
+        </programlisting>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>実非対称問題の例</title>
+        
+        <programlisting role="example">
+            
+            <![CDATA[ 
+    A            = diag(10*ones(10,1));
+    A(1:$-1,2:$) = A(1:$-1,2:$) + diag(6*ones(9,1));
+    A(2:$,1:$-1) = A(2:$,1:$-1) + diag(-6*ones(9,1));
+
+    B = eye(10,10);
+    k = 8;
+    sigma = 'SM';
+    opts.cholB = %t;
+    
+    d = eigs(A)
+[d, v] = eigs(A)
+    
+    d = eigs(A, B, k, sigma)
+    [d, v] = eigs(A, B, k, sigma) 
+
+    d = eigs(A, B, k, sigma, opts)
+    [d, v] = eigs(A, B, k, sigma, opts)
+
+// 疎行列
+    AS = sparse(A);
+    BS = sparse(B);
+
+d = eigs(AS)
+[d, v] = eigs(AS)
+    d = eigs(AS, BS, k, sigma)
+    [d, v] = eigs(AS, BS, k, sigma)
+
+    d = eigs(AS, BS, k, sigma, opts)
+    [d, v] = eigs(AS, BS, k, sigma, opts)
+    
+    // 関数
+clear opts
+function y = fn(x)
+   y = A * x;
+endfunction
+
+opts.isreal = %t;
+opts.issym = %f;
+
+d = eigs(fn, 10, [], k, 'LM', opts)
+
+function y = fn(x)
+   y = A \ x;
+endfunction
+
+d = eigs(fn, 10, [], k, 'SM', opts)
+
+function y = fn(x)
+   y = (A - 4 * eye(10,10)) \ x;
+endfunction
+
+d = eigs(fn, 10, [], k, 4, opts)
+    ]]>
+            
+        </programlisting>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>複素問題の例</title>
+        
+        <programlisting role="example">
+            
+            <![CDATA[ 
+    A            = diag(10*ones(10,1) + %i * ones(10,1));
+    A(1:$-1,2:$) = A(1:$-1,2:$) + diag(6*ones(9,1));
+    A(2:$,1:$-1) = A(2:$,1:$-1) + diag(-6*ones(9,1));
+
+    B = eye(10,10);
+    k = 8;
+    sigma = 'LM';
+    opts.cholB = %t;
+    
+    d = eigs(A)
+[d, v] = eigs(A)
+
+    d = eigs(A, B, k, sigma)
+    [d, v] = eigs(A, B, k, sigma)
+    d = eigs(A, B, k, sigma, opts)
+    [d, v] = eigs(A, B, k, sigma, opts)
+    
+    // 疎行列
+    AS = sparse(A);
+    BS = sparse(B);
+    
+    d = eigs(AS)
+[d, v] = eigs(AS)
+
+    d = eigs(AS, BS, k, sigma)
+    [d, v] = eigs(AS, BS, k, sigma)
+
+    d = eigs(AS, BS, k, sigma, opts)
+    [d, v] = eigs(AS, BS, k, sigma, opts)
+    
+    // 関数
+clear opts
+function y = fn(x)
+   y = A * x;
+endfunction
+
+opts.isreal = %f;
+opts.issym = %f;
+
+d = eigs(fn, 10, [], k, 'LM', opts)
+
+function y = fn(x)
+   y = A \ x;
+endfunction
+
+d = eigs(fn, 10, [], k, 'SM', opts)
+
+function y = fn(x)
+   y = (A - 4 * eye(10,10)) \ x;
+endfunction
+
+d = eigs(fn, 10, [], k, 4, opts)
+    ]]>
+            
+        </programlisting>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="spec">spec</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revremark>
+                    
+                    関数が導入されました. 
+                    
+                    dnaupd, dneupd, dsaupd, dseupd, znaupd および zneupdは廃止されました.
+                    
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
+</refentry>
+
index 012b25e..50fe823 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="copfac">
+    
     <refnamediv>
+        
         <refname>copfac</refname>
-        <refpurpose>右既約分解 </refpurpose>
+        
+        <refpurpose>連続時間動的システムの右既約分解</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>[N,M,XT,YT]=copfac(G [,polf,polc,tol])</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
+        
         <title>パラメータ</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>G</term>
+                
                 <listitem>
+                    
                     <para>
-                        <literal>syslin</literal> リスト  (連続時間線形システム )
+                        
+                        連続時間線形動的システム
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>polf, polc</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         それぞれ,<literal>XT</literal>と<literal>YT</literal>の極と,
+                        
                         <literal>N</literal>  と <literal>M</literal>の極 (デフォルト値=-1).
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>tol</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         安定な極を検出ための実数閾値 (デフォルト値 <literal>100*%eps</literal>)
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>N,M,XT,YT</term>
+                
                 <listitem>
+                    
                     <para>
-                        <literal>syslin</literal>リストで表される線形システム
+                        
+                        <literal>syslin</literal>連続時間線形動的システム
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             <literal>[N,M,XT,YT]=copfac(G,[polf,polc,[tol]])</literal> は,
+            
             <literal>G</literal>の右既約分解を返します.
+            
         </para>
+        
         <para>
+            
             <literal>G= N*M^-1</literal>, ただし, 
+            
             <literal>N</literal> と <literal>M</literal>は安定で,プロパーで,右既約です.
+            
             (すなわち, <literal>[N M]</literal> は安定な左可逆)
+            
         </para>
+        
         <para>
+            
             <literal>XT</literal> と <literal>YT</literal> は以下を満たします:
+            
         </para>
+        
         <para>
+            
             <literal>[XT -YT].[M N]' = eye</literal> (ベズー恒等式)
+            
         </para>
+        
         <para>
+            
             <literal>G</literal> は可安定で可検出であると仮定します.
+            
         </para>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="syslin">syslin</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="lcf">lcf</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revremark>
+                    
+                    <literal>Sl</literal> は連続時間線形動的システムについて
+                    
+                    確認されるようになりました.
+                    
+                    この変換は
+                    
+                    <ulink url="http://gitweb.scilab.org/?p=scilab.git;a=commit;h=3d7083daae3339813ba747c8adcda1f9599bb80d">コミット</ulink>により導入されました.
+                    
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
 </refentry>
+
index 9fe021d..de7ac85 100644 (file)
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="csim">
     
     <refnamediv>
-        
         <refname>csim</refname>
-        
         <refpurpose>線形システムのシミュレーション (時間応答)</refpurpose>
-        
     </refnamediv>
-    
     <refsynopsisdiv>
-        
-        <title>呼び出しの手順</title>
-        
+        <title>呼び出し手順</title>
         <synopsis>[y [,x]]=csim(u,t,sl,[x0 [,tol]])</synopsis>
-        
     </refsynopsisdiv>
-    
     <refsection>
-        
         <title>引数</title>
-        
         <variablelist>
-            
             <varlistentry>
-                
                 <term>u</term>
-                
                 <listitem>
-                    
                     <para>関数, リストまたは文字列 (制御入力)</para>
-                    
                 </listitem>
-                
             </varlistentry>
-            
             <varlistentry>
-                
                 <term>t</term>
-                
                 <listitem>
-                    
                     <para>
-                        
                         時間を指定するための実数ベクトルで、<literal>t(1)</literal> は
-                        
                         初期時間 (<literal>x0=x(t(1))</literal>)を表す.
-                        
                     </para>
-                    
                 </listitem>
-                
             </varlistentry>
-            
             <varlistentry>
-                
                 <term>sl</term>
-                
                 <listitem>
-                    
                     <para>
-                        
                         連続時間系の<literal>syslin</literal>リスト (SIMO線形システム)
-                        
                     </para>
-                    
                 </listitem>
-                
             </varlistentry>
-            
             <varlistentry>
-                
                 <term>y</term>
-                
                 <listitem>
-                    
                     <para>
-                        
                         <literal>y=[y(t(i)]</literal>, i=1,..,n となる行列
-                        
                     </para>
-                    
                 </listitem>
-                
             </varlistentry>
-            
             <varlistentry>
-                
                 <term>x</term>
-                
                 <listitem>
-                    
                     <para>
-                        
                         <literal>x=[x(t(i)]</literal>, i=1,..,n となる行列
-                        
                     </para>
-                    
                 </listitem>
-                
             </varlistentry>
-            
             <varlistentry>
-                
                 <term>tol</term>
-                
                 <listitem>
-                    
                     <para>2つの要素 [atol rtol] からなるベクトルであり、それぞれ
-                        
                         ODEソルバ(ode参照)の絶対許容誤差および相対許容誤差を定義する
-                        
                     </para>
-                    
                 </listitem>
-                
             </varlistentry>
-            
         </variablelist>
-        
     </refsection>
-    
     <refsection>
-        
         <title>説明</title>
-        
         <para>
-            
             線形制御系 <literal>sl</literal>のシミュレーションを行います.
-            
             ただし,<literal>sl</literal>は,
-            
             <literal>syslin</literal>リストで表された連続時間システムとします.
-            
         </para>
-        
         <para>
-            
             <literal>u</literal> は制御入力,<literal>x0</literal> は状態量初期値です.
-            
         </para>
-        
         <para>
-            
             <literal>y</literal> は出力,<literal>x</literal> は状態量です.
-            
         </para>
-        
         <para>
-            
             制御入力は以下のいずれかとすることができます:
-            
         </para>
-        
         <para>
-            
             1. 関数 : <literal>[inputs]=u(t)</literal>
-            
         </para>
-        
         <para>
-            
             2. リスト : <literal>list(ut,parameter1,....,parametern)</literal>. 
-            
             ただし、<literal>inputs=ut(t,parameter1,....,parametern)</literal> (<literal>ut</literal> は関数)
-            
         </para>
-        
         <para>
-            
             3. インパルス応答の計算を表す文字列 <literal>"impuls"</literal>
-            
             (ここで,<literal>sl</literal>の入力は単一で<literal>x0=0</literal>が必要).
-            
             直達項を有する系の場合, t=0における無限インパルスは無視されます.
-            
         </para>
-        
         <para>
-            
             4. ステップ応答の計算を表す文字列 <literal>"step"</literal> 
-            
             (ここで、<literal>sl</literal>の入力は単一で,<literal>x0=0</literal>が必要)
-            
         </para>
-        
         <para>
-            
             5. t の各値に対応する u の値を指定するベクトル.
-            
         </para>
-        
     </refsection>
-    
     <refsection>
-        
         <title>例</title>
-        
         <programlisting role="example"><![CDATA[
 s=poly(0,'s');
 rand('seed',0);
@@ -219,25 +121,14 @@ t=0:0.05:5;
 //impulse(w) = step (s * w)
 plot2d([t',t'],[(csim('step',t,tf2ss(s)*w))',0*t'])
 ]]></programlisting>
-        
         <scilab:image>
-            
             s=poly(0,'s');
-            
             rand('seed',0);
-            
             w=ssrand(1,1,3);
-            
             w('A')=w('A')-2*eye();
-            
             t=0:0.05:5;
-            
             plot2d([t',t'],[(csim('step',t,tf2ss(s)*w))',0*t'])
-            
         </scilab:image>
-        
-        
-        
         <programlisting role="example"><![CDATA[
 s=poly(0,'s');
 rand('seed',0);
@@ -246,23 +137,14 @@ w('A')=w('A')-2*eye();
 t=0:0.05:5;
 plot2d([t',t'],[(csim('impulse',t,w))',0*t'])
 ]]></programlisting>
-        
         <scilab:image>
-            
             s=poly(0,'s');
-            
             rand('seed',0);
-            
             w=ssrand(1,1,3);
-            
             w('A')=w('A')-2*eye();
-            
             t=0:0.05:5;
-            
             plot2d([t',t'],[(csim('impulse',t,w))',0*t'])
-            
         </scilab:image>
-        
         <programlisting role="example"><![CDATA[
 s=poly(0,'s');
 rand('seed',0);
@@ -272,23 +154,14 @@ t=0:0.05:5;
 //step(w) = impulse (s^-1 * w)
 plot2d([t',t'],[(csim('step',t,w))',0*t'])
 ]]></programlisting>
-        
         <scilab:image>
-            
             s=poly(0,'s');
-            
             rand('seed',0);
-            
             w=ssrand(1,1,3);
-            
             w('A')=w('A')-2*eye();
-            
             t=0:0.05:5;
-            
             plot2d([t',t'],[(csim('step',t,w))',0*t'])
-            
         </scilab:image>
-        
         <programlisting role="example"><![CDATA[
 s=poly(0,'s');
 rand('seed',0);
@@ -297,107 +170,59 @@ w('A')=w('A')-2*eye();
 t=0:0.05:5;
 plot2d([t',t'],[(csim('impulse',t,tf2ss(1/s)*w))',0*t'])
 ]]></programlisting>
-        
         <scilab:image>
-            
             s=poly(0,'s');
-            
             rand('seed',0);
-            
             w=ssrand(1,1,3);
-            
             w('A')=w('A')-2*eye();
-            
             t=0:0.05:5;
-            
             plot2d([t',t'],[(csim('impulse',t,tf2ss(1/s)*w))',0*t'])
-            
-            
-            
         </scilab:image>
-        
         <programlisting role="example"><![CDATA[
 s=poly(0,'s');
 rand('seed',0);
 w=ssrand(1,1,3);
 w('A')=w('A')-2*eye();
 t=0:0.05:5;
-//input defined by a time function
+//時間関数で定義された入力
 deff('u=timefun(t)','u=abs(sin(t))')
 clf();plot2d([t',t'],[(csim(timefun,t,w))',0*t'])
 ]]></programlisting>
-        
         <scilab:image>
-            
             s=poly(0,'s');
-            
             rand('seed',0);
-            
             w=ssrand(1,1,3);
-            
             w('A')=w('A')-2*eye();
-            
             t=0:0.05:5;
-            
             deff('u=timefun(t)','u=abs(sin(t))')
-            
             clf();plot2d([t',t'],[(csim(timefun,t,w))',0*t'])
-            
         </scilab:image>
-        
     </refsection>
-    
     <refsection role="see also">
-        
         <title>参照</title>
-        
         <simplelist type="inline">
-            
             <member>
-                
                 <link linkend="syslin">syslin</link>
-                
             </member>
-            
             <member>
-                
                 <link linkend="dsimul">dsimul</link>
-                
             </member>
-            
             <member>
-                
                 <link linkend="flts">flts</link>
-                
             </member>
-            
             <member>
-                
                 <link linkend="ltitr">ltitr</link>
-                
             </member>
-            
             <member>
-                
                 <link linkend="rtitr">rtitr</link>
-                
             </member>
-            
             <member>
-                
                 <link linkend="ode">ode</link>
-                
             </member>
-            
             <member>
-                
                 <link linkend="impl">impl</link>
-                
             </member>
-            
         </simplelist>
-        
     </refsection>
-    
 </refentry>
 
index 980d72a..8a872be 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="dtsi">
+    
     <refnamediv>
+        
         <refname>dtsi</refname>
-        <refpurpose>安定な非安定分解</refpurpose>
+        
+        <refpurpose>
+            
+            連続時間動的システムの安定な非安定分解
+            
+        </refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>[Ga,Gs,Gi]=dtsi(G,[tol])</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>G</term>
+                
                 <listitem>
+                    
                     <para>
-                        線形システム (<literal>syslin</literal> リスト)
+                        
+                        連続時間線形システム.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>Ga</term>
+                
                 <listitem>
+                    
                     <para>
-                        線形システム (<literal>syslin</literal> リスト) 非安定で厳密にプロパー
+                        
+                        連続時間線形システム,非安定で厳密にプロパー
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>Gs</term>
+                
                 <listitem>
+                    
                     <para>
-                        線形システム (<literal>syslin</literal> リスト) 安定で厳密にプロパー
+                        
+                        連続時間線形システム,安定で厳密にプロパー
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>Gi</term>
+                
                 <listitem>
+                    
                     <para>実数行列 (またはプロパーでないシステムの多項式行列)</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>tol</term>
+                
                 <listitem>
+                    
                     <para>安定な極を検出するためのオプションのパラメータ.
+                        
                         デフォルト値: <literal>100*%eps</literal>
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             次のような<literal>G</literal>の安定な非安定分解を返します:
+            
         </para>
+        
         <para>
+            
             <literal>G= Ga + Gs + Gi</literal>,  <literal>(Gi = G(oo))</literal>
+            
         </para>
+        
         <para>
+            
             <literal>G</literal> は状態空間形式または伝達関数形式とすることができます.
+            
         </para>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="syslin">syslin</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="pbig">pbig</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="psmall">psmall</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="pfss">pfss</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[ 
+a=0.5;
+b=1;
+c=2;
+sl=syslin('c',a,b,c);
+dtsi(sl)
+ ]]></programlisting>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revremark>
+                    
+                    <literal>Sl</literal>は,連続時間線形システムとして確認されます.
+                    
+                    この修正は, <ulink url="http://gitweb.scilab.org/?p=scilab.git;a=commit;h=3d7083daae3339813ba747c8adcda1f9599bb80d">コミット</ulink> により導入されました.
+                    
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
 </refentry>
+
index efc54b3..6c57d04 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="fspecg">
+    
     <refnamediv>
+        
         <refname>fspecg</refname>
+        
         <refpurpose>安定な因数分解</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼出し手順</title>
+        
         <synopsis>[gm]=fspecg(g).</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
-                <term>g,gm</term>
+                
+                <term>g</term>
+                
                 <listitem>
-                    <para>
-                        <literal>syslin</literal>リスト (状態空間表現の線形システム)
-                    </para>
+                    
+                    <para> 連続時間線形動的システム.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
+            <varlistentry>
+                
+                <term>gm</term>
+                
+                <listitem>
+                    
+                    <para> 連続時間線形動的システム.</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
-            <literal>gm</literal>      および <literal>gm^-1</literal>が安定となる
+            
+            <literal>gm</literal> および <literal>gm^-1</literal>が安定となる
+            
             次のような
+            
             <literal>gm</literal> を返します:
+            
         </para>
-        <programlisting><![CDATA[ 
+        
+        <programlisting role="no-scilab-exec"><![CDATA[ 
 gtild(g)*g = gtild(gm)*gm
  ]]></programlisting>
+        
         <para>
+            
             <literal>g</literal> および <literal>gm</literal> は,
+            
             状態空間形式の連続時間線形システムです.
+            
         </para>
+        
         <para>
+            
             虚軸の極がある場合は使用できません.
+            
         </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[ 
+a=0.5;
+b=1;
+c=2;
+sl=syslin('c',a,b,c);
+fspecg(sl)
+ ]]></programlisting>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revremark>
+                    
+                    <literal>Sl</literal> は連続時間線形動的システムを確認します.
+                    
+                    この修正はこの  <ulink url="http://gitweb.scilab.org/?p=scilab.git;a=commit;h=3d7083daae3339813ba747c8adcda1f9599bb80d">コミット</ulink>により導入されました.
+                    
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
     </refsection>
+    
 </refentry>
+
index ea59eac..a795326 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="fstabst">
+    
     <refnamediv>
+        
         <refname>fstabst</refname>
-        <refpurpose>ユーラ(Youla)・パラメトリゼーション</refpurpose>
+        
+        <refpurpose>線形動的システムのユーラ(Youla)・パラメトリゼーション</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼出し手順</title>
-        <synopsis>[J]=fstabst(P,r)</synopsis>
+        
+        <synopsis>J = fstabst(P,r)</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>P</term>
+                
                 <listitem>
+                    
                     <para>
-                        <literal>syslin</literal> リスト (線形システム)
+                        
+                        連続時間線形動的システム
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>r</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         1x2 行ベクトル, <literal>P22</literal>の次元
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>J</term>
+                
                 <listitem>
+                    
                     <para>
-                        <literal>syslin</literal> リスト (状態空間表現の線形システム)
+                        
+                        連続時間線形動的システム
+                        
+                        (<literal>P</literal>と同じ表現)
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             安定化フィードバックのパラメトリゼーション.
+            
         </para>
+        
         <para>
+            
             <literal>P</literal> は以下のように分割されます:
+            
         </para>
+        
         <programlisting role=""><![CDATA[ 
 P=[ P11 P12;
     P21 P22]  
  ]]></programlisting>
+        
         <para>
+            
             (状態空間形式または伝達関数形式: 計算時に状態空間形式の
+            
             自動変換が行われます)
+            
         </para>
+        
         <para>
+            
             <literal>r</literal> = <literal>P22</literal> サブシステムの大きさ,  
+            
             <literal>P</literal>の(2,2)ブロック
+            
         </para>
+        
         <programlisting role=""><![CDATA[ 
 J =[J11 J12;
     J21 J22]
  ]]></programlisting>
+        
         <para>
+            
             <literal>K</literal> は,
+            
             安定な<literal>Q</literal>により
+            
             <literal>K=lft(J,r,Q)</literal>である時に限り,
+            
             <literal>P</literal>(すなわち<literal>P22</literal>)の
+            
             安定化コントローラです.
+            
         </para>
+        
         <para>
+            
             <literal>J</literal>の中心部である , <literal>J11</literal> は
-            <literal>P</literal>のLQGレギュレータです.
+            
+            <literal>P</literal>のlqgレギュレータです.
+            
         </para>
+        
         <para>
+            
             この <literal>J</literal> は,
+            
             <literal>P</literal> および <literal>J</literal> の
+            
             2ポート <literal>lft</literal> として以下のように <literal>T</literal>
+            
             を定義するものです: <literal>[T,rt]=lft(P,r,J,r)</literal>
+            
             この時, <literal>T12</literal> はインナ(inner),
+            
             <literal>T21</literal>はコ・インナ(co-inner)となります.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
 ny=2;nu=3;nx=4;
 P22=ssrand(ny,nu,nx);
@@ -105,22 +187,70 @@ Q=ssrand(nu,ny,1);Q('A')=-1;  //安定なQ
 K=lft(J,r,Q);
 A=h_cl(P,r,K); spec(A)
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="obscont">obscont</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="lft">lft</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="lqg">lqg</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="lqg2stan">lqg2stan</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revremark>
+                    
+                    <literal>Sl</literal> は連続時間線形動的システムについて
+                    
+                    確認されます.
+                    
+                    この修正はこの
+                    
+                    <ulink url="http://gitweb.scilab.org/?p=scilab.git;a=commit;h=3d7083daae3339813ba747c8adcda1f9599bb80d">コミット</ulink>により導入されました.
+                    
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
 </refentry>
+
index 804213a..18fdb2c 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="gamitg">
+    
     <refnamediv>
+        
         <refname>gamitg</refname>
-        <refpurpose>H無限大ガンマ・イタレーション</refpurpose>
+        
+        <refpurpose>連続時間システムのH無限大ガンマ・イタレーション</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>[gopt]=gamitg(G,r,prec [,options]);</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>G</term>
+                
                 <listitem>
+                    
                     <para>
-                        <literal>syslin</literal> リスト (プラント実現 )
+                        
+                        連続時間動的システム (プラント実現 )
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>r</term>
+                
                 <listitem>
+                    
                     <para>
-                        1x2 r行ベクトル ( <literal>G22</literal>の次元)
+                        
+                        1x2 行ベクトル ( <literal>G22</literal>の次元)
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>prec</term>
+                
                 <listitem>
+                    
                     <para>ノルムの相対精度を指定</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>option</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         文字列 <literal>'t'</literal>
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>gopt</term>
+                
                 <listitem>
+                    
                     <para>実数スカラー, 最適 H無限大ゲイン </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             <literal>gopt=gamitg(G,r,prec [,options])</literal>
-            はH無限大最適ゲイン<literal>gopt</literal>を返します.
+            
+            は,H無限大最適ゲイン<literal>gopt</literal>を返します.
+            
         </para>
+        
         <para>
+            
             <literal>G</literal> は
+            
             プラント<literal>[A,B,C,D]</literal>を以下のように
+            
             分割した状態空間行列を含みます:
+            
         </para>
+        
         <programlisting role=""><![CDATA[ 
 B = ( B1 , B2 ) ,    C = ( C1 ) ,    D = ( D11  D12)
                          ( C2 )          ( D21  D22)
  ]]></programlisting>
+        
         <para>
+            
             これらの分割は,<literal>r</literal>により暗黙のうちに
+            
             指定されます:
+            
             <literal>r(1)</literal> および <literal>r(2)</literal> は
+            
             <literal>D22</literal> の次元(行 x 列)です.
+            
         </para>
+        
         <para>
+            
             <literal>option='t'</literal>を指定すると, 
+            
             <literal>gamitg</literal> は,各二分探索ステップのトレースを行います.
+            
             すなわち, カレントの下界と上界と試行点を表示します.
             
+            
+            
         </para>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="ccontrg">ccontrg</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="h_inf">h_inf</link>
+                
             </member>
+            
         </simplelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>著者</title>
+        
+        <para>P. Gahinet</para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revremark>
+                    
+                    <literal>Sl</literal> は連続時間線形動的システム
+                    
+                    について確認されるようになりました.
+                    
+                    この修正はこの
+                    
+                    <ulink url="http://gitweb.scilab.org/?p=scilab.git;a=commit;h=3d7083daae3339813ba747c8adcda1f9599bb80d">コミット</ulink>により導入されました.
+                    
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
     </refsection>
+    
 </refentry>
+
index 4b015eb..cbbea01 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="gcare">
+    
     <refnamediv>
+        
         <refname>gcare</refname>
+        
         <refpurpose>制御リカッチ方程式</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>[X,F]=gcare(Sl)</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>Sl</term>
+                
                 <listitem>
+                    
                     <para>
-                        線形システム (<literal>syslin</literal> リスト)
+                        
+                        状態空間表現の連続時間線形動的システム
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>X</term>
+                
                 <listitem>
+                    
                     <para>対称行列</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>F</term>
+                
                 <listitem>
+                    
                     <para>実数行列</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             一般化制御代数リカッチ方程式(GCARE).
+            
             <literal>X</literal> = 解 , <literal>F</literal> = ゲイン.
+            
         </para>
+        
         <para>
+            
             <literal>Sl=[A,B,C,D]</literal> に関するGCAREは次のようになります:
+            
         </para>
+        
         <programlisting role=""><![CDATA[ 
 (A-B*Si*D'*C)'*X+X*(A-B*Si*D'*C)-X*B*Si*B'*X+C'*Ri*C=0
  ]]></programlisting>
+        
         <para>
+            
             ただし, <literal>S=(eye()+D'*D)</literal>, <literal>Si=inv(S)</literal>, <literal>R=(eye()+D*D')</literal>, <literal>Ri=inv(R)</literal> 
+            
             そして, <literal>F=-Si*(D'*C+B'*X)</literal> は<literal>A+B*F</literal>
+            
             が安定となるように設定されます.
+            
         </para>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="gfare">gfare</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revremark>
+                    
+                    <literal>Sl</literal> は連続時間線形動的システム
+                    
+                    について確認されるようになりました.
+                    
+                    この修正はこの
+                    
+                    <ulink url="http://gitweb.scilab.org/?p=scilab.git;a=commit;h=3d7083daae3339813ba747c8adcda1f9599bb80d">コミット</ulink>により導入されました.
+                    
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
 </refentry>
+
index 5a5f668..bf71946 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="gfrancis">
+    
     <refnamediv>
+        
         <refname>gfrancis</refname>
+        
         <refpurpose>追尾用のフランシス方程式</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>[L,M,T]=gfrancis(Plant,Model)</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
+        
         <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>Plant</term>
+                
                 <listitem>
-                    <para>状態空間表現の連続時間システム.</para>
+                    
+                    <para>状態空間表現の連続時間動的システム.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>Model</term>
+                
                 <listitem>
-                    <para>状態空間表現の連続時間システム.</para>
+                    
+                    <para>状態空間表現の連続時間動的システム.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>L,M,T</term>
+                
                 <listitem>
+                    
                     <para>実数行列</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             線形プラント:
+            
         </para>
+        
         <programlisting role=""><![CDATA[ 
 x'= F*x + G*u 
 y = H*x + J*u
  ]]></programlisting>
+        
         <para>
+            
             および線形モデルを指定
+            
         </para>
+        
         <programlisting role=""><![CDATA[
 xm'= A*xm + B*um
 ym = C*xm + D*um
  ]]></programlisting>
+        
         <para>
+            
             プラントの状態量 x(t) の安定性を維持しつつ,
+            
             プラントがモデルを追尾する,すなわち,
+            
             <literal>e = y - ym ---&gt; 0</literal>
+            
             ことが目標です.
+            
             <literal>u</literal> はフィードフォワードおよびフィードバックにより
+            
             指定されます
+            
         </para>
+        
         <programlisting role=""><![CDATA[ 
 u = L*xm + M*um + K*(x-T*xm) = [K , L-K*T] *(x,xm) + M*um
  ]]></programlisting>
+        
         <para>
+            
             行列 T,L,M は一般化フランシス方程式を満たします
+            
         </para>
+        
         <programlisting role=""><![CDATA[ 
 F*T + G*L = T*A
 H*T + J*L = C
       G*M = T*B
       J*M = D
  ]]></programlisting>
+        
         <para>
+            
             行列 <literal>K</literal> は,対 <literal>(F,G)</literal> を安定化するように
+            
             選択する必要があります.
+            
             ディレクトリ <literal>demos/tracking</literal> の使用例を参照ください.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
 Plant=ssrand(1,3,5);
 [F,G,H,J]=abcd(Plant);
@@ -99,29 +164,56 @@ norm(H*T+J*L-C,1)
 norm(G*M-T*B,1)
 norm(J*M-D,1)
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="lqg">lqg</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="ppol">ppol</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>履歴</title>
+        
         <revhistory>
+            
             <revision>
+                
                 <revnumber>5.4.0</revnumber>
+                
                 <revremark>
+                    
                     <literal>Sl</literal>が
+                    
                     連続時間線形システムであることを確認するようになりました.
+                    
                     この修正は,この <ulink url="http://gitweb.scilab.org/?p=scilab.git;a=commit;h=3d7083daae3339813ba747c8adcda1f9599bb80d">コミット</ulink>により導入されました.
+                    
                 </revremark>
+                
             </revision>
+            
         </revhistory>
+        
     </refsection>
+    
 </refentry>
+
index 485dae6..8460818 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="h2norm">
+    
     <refnamediv>
+        
         <refname>h2norm</refname>
-        <refpurpose>H2ノルム</refpurpose>
+        
+        <refpurpose>連続時間プロパー動的システムのH2ノルム</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>[n]=h2norm(Sl [,tol])</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>Sl</term>
+                
                 <listitem>
+                    
                     <para>
-                        線形システム (<literal>syslin</literal> リスト)
+                        
+                        連続時間プロパー線形動的システム
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>n</term>
+                
                 <listitem>
+                    
                     <para>実数スカラー</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             線形連続時間システム<literal>Sl</literal>のH2ノルムを
+            
             出力します.
+            
         </para>
+        
         <para>
+            
             (<literal>Sl</literal>が状態空間形式の場合,
+            
             <literal>h2norm</literal> は可観測性グラミアンを使用し,
+            
             <literal>Sl</literal>が伝達形式の場合,
+            
             <literal>h2norm</literal> は残渣法を使用します)
+            
         </para>
+        
     </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[
+    h=syslin('c',(2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01));
+    h2norm(h)
+    ]]></programlisting>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revremark>
+                    
+                    <literal>Sl</literal>が
+                    
+                    連続時間線形システムであることを確認するようになりました.
+                    
+                    この修正は,この <ulink url="http://gitweb.scilab.org/?p=scilab.git;a=commit;h=3d7083daae3339813ba747c8adcda1f9599bb80d">コミット</ulink>により導入されました.
+                    
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
 </refentry>
+
index f430efb..a3cfe4d 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 - F. Delebecque
  * 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="h_cl">
+    
     <refnamediv>
+        
         <refname>h_cl</refname>
+        
         <refpurpose>閉ループ行列</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>[Acl]=h_cl(P,r,K)
+            
             [Acl]=h_cl(P22,K)
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
+        
         <title>パラメータ</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>P, P22</term>
+                
                 <listitem>
+                    
                     <para>
-                        線形システム (<literal>syslin</literal> リスト), 
+                        
+                        連続時間動的システム:
+                        
                         それぞれ拡張プラントまたはノミナルプラント
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>r</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         1x2 行ベクトル, <literal>P</literal> の
+                        
                         2,2 部分の次元 (<literal>r=[rows,cols]=size(P22)</literal>)
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>K</term>
+                
                 <listitem>
+                    
                     <para>
-                        線形システム (<literal>syslin</literal> リスト), コントローラ
+                        
+                        連続時間線形動的システム: コントローラ
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>Acl</term>
+                
                 <listitem>
+                    
                     <para>実数正方行列</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             標準プラント <literal>P</literal> を
+            
             (<literal>r=size(P22)</literal> とコントローラ <literal>K</literal> と共に)
-            指定すると,この関数は閉ループ行列
-            <literal>Acl</literal> を返します.
+            
+            指定すると,この関数は閉ループ行列 <literal>Acl</literal> を返します.
+            
         </para>
+        
         <para>
+            
             閉ループ系の内部安定性を確保するために,<literal>Acl</literal> の極は,
+            
             安定である必要があります.
+            
         </para>
+        
         <para>
+            
             <literal>Acl</literal> は線形システム<literal>[I -P22;-K I]^-1</literal>
+            
             の<literal>A</literal>行列,すなわち,
+            
             <literal>lft(P,r,K)</literal>の<literal>A</literal>行列です
+            
         </para>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="lft">lft</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <para>F. D.  </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revremark>
+                    
+                    <literal>Sl</literal>が
+                    
+                    連続時間線形システムであることを確認するようになりました.
+                    
+                    この修正は,この <ulink url="http://gitweb.scilab.org/?p=scilab.git;a=commit;h=3d7083daae3339813ba747c8adcda1f9599bb80d">コミット</ulink>により導入されました.
+                    
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
 </refentry>
+
index 4dc0a71..88759d2 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 - F. Delebecque
  * 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="h_inf">
+    
     <refnamediv>
+        
         <refname>h_inf</refname>
-        <refpurpose>H無限大 (中心) コントローラ</refpurpose>
+        
+        <refpurpose>連続時間H無限大 (中心) コントローラ</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>[Sk,ro]=h_inf(P,r,romin,romax,nmax)
+            
             [Sk,rk,ro]=h_inf(P,r,romin,romax,nmax)
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>P</term>
+                
                 <listitem>
+                    
                     <para>
-                        <literal>syslin</literal> リスト : 連続時間線形システム 
+                        
+                        連続時間線形動的システム
+                        
                         (状態空間形式または伝達形式で指定した``拡張'' プラント)
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>r</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         <literal>P22</literal>プラントの大きさ
+                        
                         すなわち,長さ2のベクトル<literal>[#outputs,#inputs]</literal>
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>romin,romax</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         <literal>ro=1/gama^2</literal>に関するアプリオリ境界; (通常は<literal>romin=0</literal>)
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>nmax</term>
+                
                 <listitem>
+                    
                     <para>整数, ガンマ反復の最大回数.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             <literal>h_inf</literal> は連続時間プラント<literal>P</literal>
+            
             のH無限大最適コントローラを計算します.
+            
         </para>
+        
         <para>
+            
             <literal>P</literal>の4個のサブプラントへの分割は,
+            
             <literal>P</literal>の<literal>22</literal>部分の大きさである
+            
             2要素のベクトル <literal>r</literal> により指定されます.
+            
         </para>
+        
         <para>
+            
             <literal>P</literal> は状態空間表現,
+            
             例えば,<literal>A,B,C,D</literal> = 定数行列を用いて,
+            
             <literal>P=syslin('c',A,B,C,D)</literal>,
+            
             または,伝達関数<literal>H</literal>を用いて<literal>P=syslin('c',H)</literal>
+            
             により指定します.
+            
         </para>
+        
         <para>
+            
             <literal>[Sk,ro]=H_inf(P,r,romin,romax,nmax)</literal> は,
+            
             <literal>[romin,romax]</literal> の
+            
             <literal>ro</literal>と,
+            
             <literal>P</literal>と同じ形式の中心コントローラ <literal>Sk</literal>
+            
             を返します.
+            
         </para>
+        
         <para>
+            
             (全ての計算は状態空間で行われます,
+            
             すなわち,状態空間への変換は必要に応じて関数により自動的に
+            
             行われます).
+            
         </para>
+        
         <para>
+            
             左辺パラメータを3個指定してコールされた場合,
+            
         </para>
+        
         <para>
+            
             <literal>[Sk,rk,ro]=H_inf(P,r,romin,romax,nmax)</literal> は,
+            
             <literal>ro</literal>と安定化コントローラのパラメトリゼーション
+            
             を返します:
+            
         </para>
+        
         <para>
+            
             安定化コントローラ <literal>K</literal> は
+            
             <literal>K=lft(Sk,r,PHI)</literal> により得られます.
+            
             ただし, <literal>PHI</literal>は次元<literal>r'</literal>
+            
             の線形システムで,次の関係を満たします:
+            
         </para>
+        
         <para>
+            
             <literal>H_norm(PHI) &lt; gamma</literal>.  
+            
             <literal>rk (=r)</literal> は,
+            
             <literal>nmax</literal>回反復後の
+            
             <literal>Sk22</literal> ブロックの大きさです.
+            
         </para>
+        
         <para>
+            
             アルゴリズムは, Safonov-Limebeer に基づきます.
+            
             <literal>P</literal> は連続時間プラントであることを前提と
+            
             することに注意してください.
+            
         </para>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="gamitg">gamitg</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="ccontrg">ccontrg</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="leqr">leqr</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
+    <refsection>
+        
+        <title>著者</title>
+        
+        <para>F.Delebecque INRIA (1990)  </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revremark>
+                    
+                    <literal>Sl</literal>が
+                    
+                    連続時間線形システムであることを確認するようになりました.
+                    
+                    この修正は,この <ulink url="http://gitweb.scilab.org/?p=scilab.git;a=commit;h=3d7083daae3339813ba747c8adcda1f9599bb80d">コミット</ulink>により導入されました.
+                    
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
 </refentry>
+
index 1227a6c..deca9ab 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="lcf">
+    
     <refnamediv>
+        
         <refname>lcf</refname>
-        <refpurpose>正規化された既約分解</refpurpose>
+        
+        <refpurpose>連続時間動的システムの正規化された既約分解</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>[N,M]=lcf(sl)</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>sl</term>
+                
                 <listitem>
+                    
                     <para>
-                        状態空間または伝達関数で指定された線形システム (<literal>syslin</literal> リスト)
+                        
+                        連続時間線形動的システム.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
-                <term>N,M</term>
+                
+                <term>N</term>
+                
                 <listitem>
-                    <para>
-                        2つの線形システム (<literal>syslin</literal> リスト)
-                    </para>
+                    
+                    <para>連続時間動的システム.</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>M</term>
+                
+                <listitem>
+                    
+                    <para>連続時間動的システム.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
-            線形システム<literal>sl</literal>の
+            
+            線形動的システム<literal>sl</literal>の
+            
             正規化された既約分解を計算します.
+            
         </para>
+        
         <para>
+            
             <literal>sl = M^-1 N</literal>
+            
         </para>
+        
+        <para>
+            
+            <literal>M</literal> および <literal>N</literal> は
+            
+            <literal>sl</literal>と同じ表現(伝達関数または状態空間)
+            
+            で返されます.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>著者</title>
+        
+        <para>F. D.; ;   </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revremark>
+                    
+                    <literal>Sl</literal>が
+                    
+                    連続時間線形システムであることを確認するようになりました.
+                    
+                    この修正は,この <ulink url="http://gitweb.scilab.org/?p=scilab.git;a=commit;h=3d7083daae3339813ba747c8adcda1f9599bb80d">コミット</ulink>により導入されました.
+                    
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
     </refsection>
+    
 </refentry>
+
index 6cd2c1d..b929607 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="macglov">
+    
     <refnamediv>
+        
         <refname>macglov</refname>
-        <refpurpose>Mac Farlane Glover 問題</refpurpose>
+        
+        <refpurpose>連続時間動的システムのMac Farlane Glover 問題</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼出し手順</title>
+        
         <synopsis>[P,r]=macglov(Sl)</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>Sl</term>
+                
                 <listitem>
+                    
                     <para>
-                        線形システム (<literal>syslin</literal> リスト)
+                        
+                        連続時間線形動的システム
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>P</term>
+                
                 <listitem>
+                    
                     <para>
-                        線形システム (<literal>syslin</literal> リスト), ``拡張'' プラント
+                        
+                        連続時間線形動的システム, "拡張" プラント
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>r</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         1x2 ベクトル, <literal>P22</literal>の次元
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             <literal>[P,r]=macglov(Sl)</literal> は,
+            
             Glover-McFarlane問題の
+            
             標準プラント<literal>P</literal>を返します.
+            
         </para>
+        
         <para>
+            
             この問題の場合,
+            
             ro_optimal = 1-ハンケルノルム(<literal>[N,M]</literal>)
+            
             ただし, <literal>[N,M]=lcf(sl)</literal> (正規化既約分解) すなわち,
+            
         </para>
+        
         <para>
+            
             gama_optimal = <literal>1/sqrt(ro_optimal)</literal>
+            
         </para>
+        
+        <para>
+            
+            <literal>P</literal> は,<literal>Sl</literal>と
+            
+            同じ表現(伝達関数または状態空間)を返します.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>Examples</title>
+        
+        MAC-FARLANE PROBLEM for G=1/s^3;
+        
+        <programlisting role="example"><![CDATA[ 
+    G=syslin("c",1/%s^3);
+    [P,r]=macglov(G);
+
+    //K Optimal controller , ro = gamaopt^-2;
+    [K,ro]=h_inf(P,r,0,1,30);
+
+    ]]></programlisting>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>著者</title>
+        
+        <para>F. Delebecque INRIA</para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revremark>
+                    
+                    <literal>Sl</literal>が
+                    
+                    連続時間線形システムであることを確認するようになりました.
+                    
+                    この修正は,この <ulink url="http://gitweb.scilab.org/?p=scilab.git;a=commit;h=3d7083daae3339813ba747c8adcda1f9599bb80d">コミット</ulink>により導入されました.
+                    
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
     </refsection>
+    
 </refentry>
+
index 7be2dae..a529493 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="nehari">
+    
     <refnamediv>
+        
         <refname>nehari</refname>
-        <refpurpose>ネハリ近似</refpurpose>
+        
+        <refpurpose>連続時間動的システムのネハリ近似</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼出し手順</title>
+        
         <synopsis>[x]=nehari(R [,tol])</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>R</term>
+                
                 <listitem>
+                    
                     <para>
-                        線形システム (<literal>syslin</literal> リスト)
+                        
+                        状態空間表現の連続時間線形動的システム
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>x</term>
+                
                 <listitem>
+                    
                     <para>
-                        線形システム (<literal>syslin</literal> リスト)
+                        
+                        状態空間表現の連続時間線形動的システム
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>tol</term>
+                
                 <listitem>
-                    <para>オプションの閾値</para>
+                    
+                    <para>オプションの閾値, デフォルト値は 1e-6.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             <literal>[x]=nehari(R [,tol])</literal>
+            
             は<literal>R</literal>のネハリ近似を返します.
+            
         </para>
+        
         <para>
-            <literal>R</literal> = 状態空間表現の線形システム (<literal>syslin</literal>リスト).
+            
+            <literal>R</literal> = 状態空間表現の線形システム 
+            
+            (<literal>syslin</literal>リスト).
+            
         </para>
+        
         <para>
+            
             <literal>R</literal> は厳密にプロパーで <literal>- R~</literal> は安定です 
+            
             (すなわち <literal>R</literal> は反安定です).
+            
         </para>
+        
         <programlisting role=""><![CDATA[ 
 || R - X ||oo = min || R - Y ||oo
               Y in Hoo
  ]]></programlisting>
+        
     </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revremark>
+                    
+                    <literal>Sl</literal>が
+                    
+                    連続時間線形システムであることを確認するようになりました.
+                    
+                    この修正は,この <ulink url="http://gitweb.scilab.org/?p=scilab.git;a=commit;h=3d7083daae3339813ba747c8adcda1f9599bb80d">コミット</ulink>により導入されました.
+                    
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
 </refentry>
+
index ffdbc11..8176e99 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) 2006-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:ns4="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="routh_t" xml:lang="ja">
+    
     <refnamediv>
+        
         <refname>routh_t</refname>
+        
         <refpurpose>ラウス表</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
-        <synopsis>r=routh_t(p)
-            r=routh_t(h [,k])
+        
+        <synopsis>
+            
+            [r [,num] ]=routh_t(p)
+            
+            [r [,num] ]=routh_t(h ,kp)
+            
+            r=routh_t(h ,k [,normalized])
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>p</term>
+                
                 <listitem>
+                    
                     <para>実数多項式</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>h</term>
+                
                 <listitem>
+                    
                     <para>実数 SISO 伝達システム</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>k</term>
+                
                 <listitem>
+                    
                     <para>実数多項式またはスカラー</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>kp</term>
+                
+                <listitem>
+                    
+                    <para>スカラー: 比例制御定数</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>normalized</term>
+                
+                <listitem>
+                    
+                    <para>論理値 (%t (デフォルト値) または %f)</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>r</term>
+                
+                <listitem>
+                    
+                    <para>行列またはリスト: ラウス配列要素</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>num</term>
+                
                 <listitem>
-                    <para>行列</para>
+                    
+                    <para>スカラー: 符号変更の数</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
-            <literal>r=routh_t(p)</literal> は
-            多項式<literal>h</literal>のラウス表を計算します.
+            
+            <literal>r=routh_t(p)</literal> は,
+            
+            多項式<literal>p</literal>のラウス表を計算します.
+            
         </para>
+        
         <para>
+            
             <literal>r=routh_t(h,k)</literal> は,
+            
             ゲイン<literal>k</literal>によるフィードバックを有する
+            
             SISO伝達行列 <literal>h</literal>で記述されたシステムの
+            
             分母のラウス表を計算します.
+            
         </para>
+        
         <para>
+            
             <literal>k=poly(0,'k')</literal> の場合,ダミー変数<literal>k</literal>
+            
             で表した多項式行列でラウス表が記述されます.
+            
+        </para>
+        
+        <para>
+            
+            <literal>normalized=%f</literal> の場合,
+            
+            正規化されていない要素を有する多項式行列を有します.
+            
+            他の場合, 有理数または正規化された行列を有します.
+            
+        </para>
+        
+        <para>
+            
+            2番目の引数 <literal>num</literal> はラウス表の最初の列の
+            
+            符号変化の数を返します.
+            
+            この引数の値は,表が正規化された場合のみ意味を有します.
+            
+        </para>
+        
+        <para>
+            
+            <note>
+                
+                ヒント: <literal>h=1/p</literal>の場合, 
+                
+                <literal>routh_t(h, kp)</literal> は
+                
+                <literal>routh_t(p+kp)</literal> に等価です.
+                
+            </note>
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
-        <programlisting role="example"><![CDATA[ 
+        
+        <programlisting role="example"><![CDATA[
 s=%s;
 P=5*s^3-10*s^2+7*s+20;
 routh_t(P)
 
-//transfer function with formal feedback
+// フィードバックを有する伝達関数, 正規化された場合
 routh_t((1+s)/P,poly(0,'k'))
-    
-// One of the coefficients in the polynomial equals zero
-P1=2*s^3-24*s+32; 
+
+// フィードバックを有する伝達関数, 正規化されていない場合
+routh_t((1+s)/P,poly(0,'k'),%f)
+
+// 多項式の係数の一つが0
+P1=2*s^3-24*s+32;
 routh_t(P1)
 
-// A row full of zeros
+// ある行が全てゼロ
 P2=s^4-6*s^3+10*s^2-6*s+9;
 routh_t(P2)
+
+// 右辺の根の数を2番目の出力引数として取得可能
+P3=5*s^3-10*s^2+7*s;
+[r,num]=routh_t(1/P3,20)
+if num==0
+   disp("System is stable")
+else
+   mprintf("There is %g sign changes in entries of first column.\nTherefore, system is unstable.", num)
+end
+
+//
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="roots">roots</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="spec">spec</link>
+                
             </member>
+            
             <member>
+                
+                <link linkend="evans">evans</link>
+                
+            </member>
+            
+            <member>
+                
                 <link linkend="kpure">kpure</link>
+                
             </member>
+            
+            <member>
+                
+                <link linkend="krac2">krac2</link>
+                
+            </member>
+            
         </simplelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>参考文献</title>
-        <para>http://controls.engin.umich.edu/wiki/index.php/RouthStability</para>
-        <para>http://www.jdotec.net/s3i/TD_Info/Routh/Routh.pdf</para>
+        
+        <para>
+            
+            <ulink url="http://controls.engin.umich.edu/wiki/index.php/RouthStability">http://controls.engin.umich.edu/wiki/index.php/RouthStability</ulink>
+            
+        </para>
+        
+        <para>
+            
+            <ulink url="http://www.jdotec.net/s3i/TD_Info/Routh/Routh.pdf">http://www.jdotec.net/s3i/TD_Info/Routh/Routh.pdf</ulink>
+            
+        </para>
+        
         <para>Comments on the Routh-Hurwitz criterion, Shamash, Y.,Automatic
+            
             Control, IEEE T.A.C Volume 25, Issue 1, Feb 1980 Page(s): 132 - 133
+            
         </para>
+        
     </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.5.0</revnumber>
+                
+                <revremark>新規出力引数が追加されました: num (SEP #104).</revremark>
+                
+            </revision>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revremark>新規入力引数が追加されました: normalized (SEP #89).</revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
 </refentry>
+
diff --git a/scilab/modules/call_scilab/help/ja_JP/call_scilab.xml b/scilab/modules/call_scilab/help/ja_JP/call_scilab.xml
new file mode 100644 (file)
index 0000000..6d2a400
--- /dev/null
@@ -0,0 +1,235 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2009  - DIGITEO - Sylvestre LEDRU
+ * 
+ * This file must be used under the terms of the CeCILL.
+ * This source file is licensed as described in the file COPYING, which
+ * you should have received as part of this distribution.  The terms
+ * are also available at    
+ * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+ *
+ -->
+
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns: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="call_scilab" xml:lang="ja">
+    
+    <refnamediv>
+        
+        <refname>call_scilab</refname>
+        
+        <refpurpose>
+            
+            call_scilabは,
+            
+            C/C++コードからScilabエンジンをコールする機能を提供する
+            
+            インターフェイスです.
+            
+        </refpurpose>
+        
+    </refnamediv>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>
+            
+            Scilabはネーティブな(C/C++)アプリケーションからコールできる
+            
+            可能性を提供します.
+            
+        </para>
+        
+        <para>
+            
+            このモジュールにより, 
+            
+            他のコード/アプリケーションからScilabの機能をインターフェイスする
+            
+            ために,
+            
+            または,他の言語からScilabの機能をインターフェイスできるようにする
+            
+            ために,
+            
+            C/C++からScilabをコールできるようになります.
+            
+        </para>
+        
+        <para>
+            
+            Scilab 5.2.0以降, 全てのScilabデータ型をcall_scilabで
+            
+            処理できるようになりました.
+            
+            これは,<link linkend="api_scilab">API_Scilab</link>により
+            
+            行われました.
+            
+        </para>
+        
+        <para>
+            
+            このヘルプは,call_scilab APIの機能を説明します.
+            
+        </para>
+        
+        <para>
+            
+            注意: <link linkend="javasci">javasci</link> モジュールは
+            
+            call_scilabに基づいています.
+            
+        </para>
+        
+        <para>注意: 
+            
+            古いAPI (stackX.h) はScilab 6.0以降では利用できません.
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="c"><![CDATA[ 
+// 簡単な call_scilab の例
+
+#include <stdio.h> /* stderr */
+
+#include "stack-c.h" /* Scilabメモリにアクセスする関数を提供 */
+#include "call_scilab.h" /* Scilabエンジンをコールする関数を提供 */
+
+// Filename: simple_call_scilab.c
+
+int main(void)
+{
+/****** 初期化 **********/
+#ifdef _MSC_VER
+ if ( StartScilab(NULL,NULL,NULL) == FALSE )
+#else
+ if ( StartScilab(getenv("SCI"),NULL,NULL) == FALSE )
+#endif
+  {
+   fprintf(stderr,"Error while calling StartScilab\n");
+   return -1;
+  }
+
+/****** 実際のScilabタスク *******/
+
+ SendScilabJob("myMatrix=['sample','for the help']");
+ SendScilabJob("disp(myMatrix);"); // !sample  for the help  !を表示します 
+ SendScilabJob("disp([2,3]+[-44,39]);"); // - 42.    42.  を表示します   
+
+/****** 終了 **********/
+ if ( TerminateScilab(NULL) == FALSE ) {
+  fprintf(stderr,"Error while calling TerminateScilab\n");
+  return -2;
+ }
+ return 0;
+}
+ ]]></programlisting>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revdescription>新規メソッドを追加:
+                    
+                    <itemizedlist>
+                        
+                        <listitem>
+                            
+                            <literal>CallScilab.h</literal> が削除されました (Scilab 5.2.0以降で廃止). <literal>call_scilab.h</literal>で置換されました.
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            関数 <literal>int getLastErrorValue(void);</literal> が追加されました. Scilabで生成された直近のエラーコードを返します.
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            関数 <literal>const char* getLastErrorMessageSingle();</literal> が追加されました. Scilabで生成された直近のエラーメッセージを返します.
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            call_scilab.hの廃止された関数を削除:
+                            
+                            <literal>C2F(readmat), C2F(creadmat), C2F(creadbmat), C2F(creadcmat), C2F(readchain), C2F(creadchain),  C2F(creadchains), GetLengthStringMatrixByName, C2F(matptr), C2F(cmatptr), C2F(cmatcptr),  C2F(cmatsptr), C2F(cmatbptr), getlengthchain</literal>
+                            
+                        </listitem>
+                        
+                    </itemizedlist>
+                    
+                </revdescription>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="api_scilab">api Scilab</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="compile_and_run_call_scilab">Compile and run with call_scilab</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="DoubleManagement_callscilab">Matrix Management</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="BooleanManagement_callscilab">Boolean Management</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="ComplexManagement_callscilab">Complex Management</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="StringManagement_callscilab">String Management</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+
index 1658410..2b81f2c 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) 2002 - 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="lines">
+    
     <refnamediv>
+        
         <refname>lines</refname>
+        
         <refpurpose>表示に使用される行および列</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
-        <synopsis>lines([nl [,nc]])
-            ncl=lines()
+        
+        <synopsis>lines(nl)
+            
+            lines(nl, nc)
+            
+            lines(ncl)
+            
+            ncl = lines()
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
-                <term>nl : 整数, 垂直方向のページ切替制御の行数. </term>
+                
+                <term>nl</term>
+                
                 <listitem>
-                    <para>0の場合,垂直方向のページ切替制御は行われません.</para>
+                    
+                    <para>整数, 垂直方向のページ切替制御の行数.</para>
+                    
+                    <itemizedlist>
+                        
+                        <listitem>
+                            
+                            <para>0の場合,垂直方向のページ切替制御は行われません.</para>
+                            
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            <para>
+                                
+                                -1の場合: 垂直ページング制御をウインドウの現在
+                                
+                                の大きさにリセット.
+                            </para>
+                            
+                        </listitem>
+                        
+                    </itemizedlist>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>nc</term>
+                
                 <listitem>
+                    
                     <para>整数, 出力の列の数. 整形出力で使用されます</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>ncl</term>
+                
                 <listitem>
+                    
                     <para>1x2 ベクトル [nc,nl]</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             <literal>lines</literal> はScilab表示ページ制御を処理します.
+            
         </para>
+        
         <para>
+            
             <literal>lines()</literal> は結果の表示用にScilabにより現在使用されている
+            
             ベクトル <literal>[# columns, # rows]</literal>を返します.
+            
         </para>
+        
         <para>
+            
             <literal>lines(nl)</literal> は,(moreとユーザに聞くまでの)表示行の数を
+            
             <literal>nl</literal>に設定します.
+            
         </para>
+        
         <para>
+            
             <literal>lines(0)</literal> は垂直ページ制御を無効にします
+            
         </para>
+        
         <para>
+            
             <literal>lines(nl,nc)</literal> は
+            
             出力の大きさを<literal>nc</literal>列にも変更します.
+            
         </para>
+        
         <para>
+            
             Scilabが-nwオプションを指定せずに起動された場合,
+            
             <literal>lines</literal>パラメータは出力ウインドウの大きさに
+            
             基づき自動的に設定されます.
+            
             これらのパラメータはウインドウの大きさが変更された場合にも
+            
             自動的に修正されます.
+            
         </para>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="disp">disp</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="print">print</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revdescription>
+                    
+                    <itemizedlist>
+                        
+                        <listitem>lines はデフォルトで 0に設定されます. 
+                            
+                            引数 -1 が追加されます.
+                            
+                            詳細については, SEP #67 を参照ください.
+                        </listitem>
+                        
+                        <listitem>
+                            
+                            lines は,
+                            
+                            入力引数として 1x2 ベクトル [nc, nl] を管理します.
+                            
+                        </listitem>
+                        
+                    </itemizedlist>
+                    
+                </revdescription>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
 </refentry>
+
index 04e163b..dc14aa2 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="perl">
+    
     <refnamediv>
+        
         <refname>perl</refname>
-        <refpurpose>適当なオペレーティングシステムの実行ファイルによりPerl スクリプトをコール</refpurpose>
+        
+        <refpurpose>
+            
+            適当なオペレーティングシステムの実行ファイルにより
+            
+            Perl スクリプトをコール
+            
+            <emphasis role="bold">この関数は廃止されます.</emphasis>
+            
+        </refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>Calling Sequence</title>
+        
         <synopsis>perl('perlfile')
+            
             perl('perlfile',arg1,arg2,...)
+            
             result = perl(...)
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
+        
         <title>説明</title>
-        <para>perl('perlfile') は,
+        
+        <para>
+            
+            <literal>perl('perlfile')</literal> は,
+            
             適当なオペレーティングシステムの実行ファイルを使用して
-            Perlスクリプト perlfileをコールします.
+            
+            Perlスクリプト<literal>perlfile</literal>をコールします.
+            
         </para>
-        <para>perl('perlfile',arg1,arg2,...) は Perlスクリプト perlfileを
+        
+        <para>
+            
+            <literal>perl('perlfile',arg1,arg2,...)</literal>は Perlスクリプト 
+            
+            <literal>perlfile</literal> を
+            
             適当なオペレーティングシステムの実行ファイルを使用してコールし,
-            引数として arg1, arg2, ... を渡します.
+            
+            引数として <literal>arg1</literal>, <literal>arg2</literal>, ... を渡します.
+            
         </para>
-        <para>result = perl(...) は実行したPerlコールの結果を result に返します.</para>
+        
+        <para>
+            
+            <literal>result = perl(...)</literal>
+            
+            は実行したPerlコールの結果を <literal>result</literal> に返します.
+            
+        </para>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="unix">unix</link>
+                
             </member>
+            
         </simplelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.5.0</revnumber>
+                
+                <revremark>Tagged が廃止予定となりました. 
+                    
+                    Scilab 6.0.0で削除されます.
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
     </refsection>
+    
 </refentry>
+
index bf6a1ea..8d7a0e4 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:ns4="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="scilab" xml:lang="ja">
+    
     <refnamediv>
+        
         <refname>scilab</refname>
+        
         <refpurpose>
-            Scilabおよび関連ツールを実行すうrための
-            主要なUnixスクリプト
+            
+            Scilabおよび関連ツールを起動するためのツール
+            
+            (GNU/Linux, Unix および Mac OS X)
+            
         </refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼出し手順</title>
+        
         <synopsis>scilab &lt;Options&gt;
+            
             scilab-adv-cli &lt;Options&gt;
+            
             scilab-cli &lt;Options&gt;
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>-args Arguments</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         このオプションが存在する場合,引数がScilabに渡されます.
+                        
                         これらは,<link linkend="sciargs">sciargs</link>関数で取得することが
+                        
                         できます.
+                        
                         複数の引数を指定する場合,以下のように一連の複数の単語を引用符で括り,
+                        
                         空白で分割してください: <literal>scilab -args 'foo1 foo2'</literal>. 
+                        
                         このオプションを指定しない場合,未知の引数は受け付けられません.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>-display Display</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         Xwindow システム上でのみ使用可能で, 表示する
+                        
                         Xサーバーを指定します.
+                        
                         デフォルトの表示先は unix:0.0 です.
+                        
                     </para>
+                    
                     <para>
+                        
                         <literal>-display</literal> は,
+                        
                         <literal>-d</literal>と短縮形で指定できます.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>-debug</term>
+                
                 <listitem>
-                    <para>デバッガgdb上でScilabを開始します(Unix/linuxのみ).</para>
+                    
+                    <para>デバッガgdb上でScilabを開始します(Unix/Linux/Mac OS Xのみ).</para>
+                    
                     <para>
+                        
                         gdb にカスタムオプションを追加する場合,
-                        変数SCILAB_GDB_OPTを定義します.
+                        
+                        変数<literal>SCILAB_GDB_OPT</literal>を定義します.
+                        
                     </para>
+                    
                     <para>助言: このオプションをScilabソースツリー上で使用してください.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>-debug-kdbg</term>
+                
                 <listitem>
-                    <para>kdbg上でScilabを開始します (Unix/linux のみ).</para>
+                    
+                    <para>kdbg上でScilabを開始します (Unix/Linux/Mac OS X のみ).</para>
+                    
                     <para>助言: このオプションをScilabソースツリー上で使用してください.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>-profiling</term>
+                
                 <listitem>
-                    <para>valgrind上でScilabを開始します (Unix/linux のみ).</para>
+                    
+                    <para>valgrind上でScilabを開始します (Unix/Linux/Mac OS X のみ).</para>
+                    
                     <para>
+                        
                         valgrind にカスタムオプションを追加する場合
+                        
                         (および既存の valgrind オプションを上書きする場合),SCILAB_VALGRIND_OPT
+                        
                         を定義してください.
+                        
                     </para>
+                    
                     <para>助言: このオプションをScilabソースツリー上で使用してください.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>-profiling-visu</term>
+                
                 <listitem>
-                    <para>callgrind上でScilabを開始します (Unix/linux のみ).</para>
+                    
+                    <para>callgrind上でScilabを開始します (Unix/Linux/Mac OS X のみ).</para>
+                    
                     <para>
+                        
                         callgrind にカスタムオプションを追加する場合
+                        
                         (および既存の callgrind オプションを上書きする場合),SCILAB_VALGRIND_OPT
+                        
                         を定義してください.
+                        
                     </para>
+                    
                     <para>助言: このオプションをScilabソースツリー上で使用してください.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>-electric-fence</term>
+                
                 <listitem>
-                    <para>Electric Fence を指定して Scilab を開始します(Unix/linux のみ).</para>
+                    
+                    <para>Electric Fence を指定して Scilab を開始します(Unix/Linux/Mac OS Xのみ).</para>
+                    
                     <para>助言: このオプションをScilabソースツリー上で使用してください.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
-                <term>-e Instruction</term>
+                
+                <term>-e 命令</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         このオプションを指定すると Scilab 命令
+                        
                         <literal>Instruction</literal> が(スタートアップファイルの実行直後に)
+                        
                         まずScilabで実行されます.
+                        
                         <literal>-e</literal> および
+                        
                         <literal>-f</literal> オプションは相互に排他的です.
+                        
                     </para>
-                    <para>-e により複数の命令を指定できることに注意してください.</para>
-                    <programlisting>scilab-cli -e  "a=1+%i; aPlusPi=a+%pi; disp(aPlusPi);exit;" -nb</programlisting>
+                    
+                    <para>
+                        <literal>-e</literal>により複数の命令を指定できることに注意してください.
+                    </para>
+                    
+                    <programlisting role="no-scilab-exec">scilab-cli -e  "a=1+%i; aPlusPi=a+%pi; disp(aPlusPi);exit;" -nb</programlisting>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>-f file</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         このオプションを指定すると, Scilab はスクリプト <literal>file</literal>
+                        
                         を(スタートアップファイルの実行直後,)Scilab上で最初に実行します.
                         
+                        
+                        
                         <literal>-e</literal> および
+                        
                         <literal>-f</literal> オプションは相互に排他的です.
+                        
                     </para>
+                    
+                    <para>.xcos 拡張子を有するファイルはXcosで開かれます.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>-l lang</term>
+                
                 <listitem>
+                    
                     <para>このオプションを指定した場合,
+                        
                         ユーザ言語を指定します.
+                        
                         <emphasis>lang</emphasis> は以下の値を指定できます: <emphasis>ca_ES de_DE en_US es_ES
+                            
                             fr_FR ja_JP pt_BR ru_RU zh_CN zh_TW
+                            
                         </emphasis>
+                        
                         (Scilab 5.2以降).
+                        
                     </para>
+                    
                     <para>
+                        
                         互換性維持のため,その他に <literal>lang</literal> の値は,フランス語として
+                        
                         <literal>'fr'</literal> および英語として <literal>'en'</literal> を使用可能です.
+                        
                         デフォルト値は,<literal>scilab.start</literal>ファイルで指定されます.
+                        
                     </para>
+                    
                     <para>いくつかのシステムでは,UTF-8フォントを正しく描画するために,
+                        
                         ロケールをコンパイルする必要があります.
+                        
                     </para>
+                    
                     <para>Scilab を以下のようにコールすることも可能です:</para>
-                    <programlisting>LANG=ja_JP scilab
+                    
+                    <programlisting role="no-scilab-exec">LANG=ja_JP scilab
+                        
                         # これは以下と等価です
+                        
                         scilab -l ja_JP
+                        
                     </programlisting>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>-mem N</term>
+                
                 <listitem>
-                    <para>-nsオプションと共に指定し,stacksizeの初期値を設定します. 
-                        -ns オプションを指定しない場合, stacksizeの初期値は
-                        scilab.startにより設定されます.
+                    
+                    <para>
+                        <literal>-ns</literal>オプションと共に指定し,
+                        
+                        <literal>stacksize</literal>の初期値を設定します. 
+                        
+                        <literal>-ns</literal>オプションを指定しない場合, 
+                        
+                        <literal>stacksize</literal>の初期値は
+                        
+                        <literal>scilab.start</literal>により設定されます.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>-nb</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         このオプションが指定された場合, Scilabの Welcome バナーは表示されません.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>-ns</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         このオプションが指定された場合, スタートアップファイル
+                        
                         <literal>SCI/etc/scilab.start</literal> およびユーザスタートアップファイル
+                        
                         <literal>SCIHOME/.scilab</literal>,
+                        
                         <literal>SCIHOME/scilab.ini</literal> は実行されません.
+                        
                     </para>
+                    
                     <para>このオプションは, Scilabの多くの機能を無効にします (動作を理解している場合のみ
+                        
                         使用してください).
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>-nouserstartup</term>
+                
                 <listitem>
+                    
                     <para>このオプションが指定された場合, スタートアップファイル
+                        
                         <literal>SCIHOME/.scilab</literal>,
+                        
                         <literal>SCIHOME/scilab.ini</literal> は実行されません.
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>-noatomsautoload</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        このオプションが指定された場合,イントール済みのATOMモジュールは
+                        
+                        このセッションでロードされません.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>-nw</term>
+                
                 <listitem>
-                    <para>このオプションが指定された場合, Scilab は(グラフィックスなどの)先進的な機能と
-                        共にコマンドラインで起動されます.
+                    
+                    <para>
+                        
+                        このオプションが指定された場合, Scilab は
+                        
+                        先進的な機能(グラフィック, export, xcos, scinotes, ヘルプブラウザ, ...)
+                        
+                        と共にコマンドラインで起動されます.
+                        
+                    </para>
+                    
+                    <para>
+                        このオプションは <literal>-f</literal>または <literal>-e</literal>
+                        
+                        オプションと同時に指定することができます.
                     </para>
-                    <para>このオプションは -f または -e オプションと同時に指定することができます.</para>
+                    
                     <para>Scilab 5.2以降:</para>
+                    
                     <itemizedlist>
+                        
                         <listitem>
+                            
                             <para>Scilab のディストリビューションには,
-                                -nw と同様のバイナリとして scilab-adv-cli (Scilab Advanced
-                                Command Line Interpreter) が含まれています.
+                                
+                                <literal>-nw</literal>と同様のバイナリを提供します: 
+                                
+                                <literal>scilab-adv-cli</literal>
+                                
+                                (Scilab Advanced Command Line Interpreter).
+                                
                             </para>
+                            
                         </listitem>
+                        
                         <listitem>
+                            
                             <para>全てのオペレーティングシステムについて
+                                
                                 パイプが有効です (詳細については例を参照ください).
+                                
                             </para>
+                            
                         </listitem>
+                        
                     </itemizedlist>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>-nwni / -nogui</term>
+                
                 <listitem>
-                    <para>このオプションが指定された場合, Scilab は(先進的な機能を含まない)
+                    
+                    <para>このオプションが指定された場合, Scilab は先進的な機能
+                        
+                        (グラフィック, export, xcos, scinotes, ヘルプブラウザ, ...)なしで
+                        
                         コマンドラインで起動されます.
+                        
+                    </para>
+                    
+                    <para>
+                        このオプションは <literal>-f</literal> または <literal>-e</literal>
+                        
+                        オプションと同時に指定することができます.
                     </para>
-                    <para>このオプションは -f または -e オプションと同時に指定することができます.</para>
+                    
                     <para>Scilab 5.2以降:</para>
+                    
                     <itemizedlist>
+                        
                         <listitem>
+                            
                             <para>
-                                Scilab のディストリビューションには,
-                                -nwni と同様のバイナリとして scilab-cli (Scilab
-                                Command Line Interpreter) が含まれています.
+                                
+                                Scilab のディストリビューションでは,
+                                
+                                <literal>-nwni</literal>と同じ専用バイナリが提供されています
+                                
+                                : <literal>scilab-cli</literal>
+                                
+                                (Scilab Command Line Interpreter).
+                                
                             </para>
+                            
                         </listitem>
+                        
                     </itemizedlist>
+                    
                     <itemizedlist>
+                        
                         <listitem>
+                            
                             <para>全てのオペレーティングシステムについて
+                                
                                 パイプが有効です (詳細については例を参照ください).
+                                
                             </para>
+                            
                         </listitem>
+                        
                     </itemizedlist>
+                    
                     <para>このモードでは Java 仮想マシンはロードされません.
+                        
                         (起動は高速化され,メモリ消費量は減少します)
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>--texmacs</term>
+                
                 <listitem>
+                    
                     <para>このオプションは TeXMacs用に予約されています.</para>
+                    
+                    <para>
+                        
+                        ATOMSモジュールをインストールしてください: <programlisting role="">atomsInstall('texmacs')</programlisting>
+                        
+                    </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>-version</term>
+                
                 <listitem>
+                    
                     <para>このオプションはプロダクトのバージョンを出力し,終了します.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
+        <title>環境変数の説明</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>SCIVERBOSE</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        この変数が存在した場合, Scilab起動スクリプトは起動時デバッグ情報を表示します.
+                        
+                        主にバグレポートおよびデバッグ目的で使用されます.
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>JAVA_HOME</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        使用するJavaを指定します. 例えば,
+                        
+                        <literal>JAVA_HOME=/usr/lib/jvm/java-7-openjdk/ scilab</literal> は
+                        
+                        Java 7 でScilabを起動します.
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>SCI_DISABLE_TK</term>
+                
+                <listitem>
+                    
+                    <para>Tk (Tclではなく) 機能を無効にします.</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>SCI_JAVA_ENABLE_HEADLESS</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        ヘッドレスJava仮想マシン (すなわち,GUI機能なし).
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
         <title>Java 仮想マシンオプション</title>
+        
         <para>Scilab 5.0以降, グラフィカルユーザインターフェイス (GUI) および
+            
             ドキュメントの構築は,Java機能に基づいています.
+            
             いくつかのケースでは,
+            
             JVM (Java仮想マシン)オプションを編集することが重要となります.
+            
         </para>
+        
         <para>これらのオプションは,
+            
             <emphasis>jvm_options.xml</emphasis>ファイルで利用可能です.
+            
         </para>
+        
         <para>5.0.X および 5.1.Xでは, このファイルは
+            
             <emphasis>SCI/modules/jvm/etc/jvm_options.xml</emphasis>に保存されています.
+            
         </para>
+        
         <para>&gt;= 5.2.0以降, このファイルは
+            
             <emphasis>
+                
                 etc/jvm_options.xml<emphasis> </emphasis>
+                
             </emphasis>
+            
             にあります.
+            
         </para>
+        
         <para>デフォルトで, 以下の3つのオプションが
+            
             設定ファイルで容易にアクセス可能です:
+            
         </para>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>-XmxXXXm</term>
+                
                 <listitem>
-                    <para>このオプションは,Java仮想マシンで利用可能なメモリ量を設定します.
+                    
+                    <para>
+                        
+                        このオプションは,Java仮想マシンで利用可能なメモリ量を設定します.
+                        
                         デフォルトで, 256M が確保されます.
-                        この値を変更した場合, その値がシステムで利用可能なメモリを超えないことを確認してください.
+                        
+                        この値を変更した場合, その値がシステムで利用可能なメモリを
+                        
+                        超えないことを確認してください.
+                        
+                    </para>
+                    
+                    <para>
+                        
+                        Scilab 5.4.0以降, この値は設定メニュー内で変更可能です.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>-Djava.compiler=JIT</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         このオプションを引数<emphasis>JIT</emphasis>を付けて指定すると,
+                        
                         Java Just In Time compilerが有効になります.
+                        
                         このオプションはデフォルトで有効となります.
+                        
                         <emphasis>NONE</emphasis>によりJITは無効となり,
+                        
                         著しく性能が低下します.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>-verbose:jni / -Xcheck:jni</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         これらのオプションは,JNIコールとその出力をより詳細に確認します.
+                        
                         デバッグ時にはこれらのオプションを利用可能ですが,
+                        
                         性能を低下させるためデフォルトでは無効となっています.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
         <para>より多くのオプションが利用可能です.
+            
             これにより性能を改善したり,ルックアンドフィールを変更したり,
+            
             メモリ管理を変更したりといったことが可能です.
+            
             参照:  <ulink url="http://www.oracle.com/technetwork/java/javase/tech/vmoptions-jsp-140102.html">http://www.oracle.com/technetwork/java/javase/tech/vmoptions-jsp-140102.html</ulink>
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
-        <programlisting role="example"> 
-            # Let's start Scilab in profiling mode without attaching a gdb one a SIGSEGV is meet.
-            # We are under Bash shell
-            export SCILAB_VALGRIND_OPT="--db-attach=no --log-file=myfile.txt"
-            scilab -profiling
-            
-            # Let's start Scilab in debug mode without stopping after each SIGSEGV
-            # First, we write a small command file
-            echo "handle SIGSEGV nostop" &amp;gt; debug.txt
-            # Now set the custom option
-            # We are under Bash shell
-            export SCILAB_GDB_OPT="--command=debug.txt"
-            # Start Scilab in debug mode
-            scilab -debug
-        </programlisting>
-        <programlisting role="example-cli">
-            # Under GNU/Linux, Mac OS X or Unix:
-            $ echo "disp(%pi)"|scilab-cli
-            or
-            $ echo "disp(%pi)"|scilab -nwni
-            
-            # Only open the Scilab help window:
-            $ scilab-adv-cli -e "help()"
-            or
-            $ scilab -nw -e "help()"
-            
-            
-            # Scilab can be used for scripting aspects:
-            echo "if 1&lt;&gt;2 then exit(99) end"|scilab-cli
-            echo $? 
-        </programlisting>
+        
+        <programlisting role="no-scilab-exec"><![CDATA[ 
+# Let's start Scilab in profiling mode without attaching a gdb once a SIGSEGV is met.
+# We are under Bash shell
+export SCILAB_VALGRIND_OPT="--db-attach=no --log-file=myfile.txt"
+scilab -profiling
+
+# Let's start Scilab in debug mode without stopping after each SIGSEGV
+# First, we write a small command file
+echo "handle SIGSEGV nostop" &> debug.txt
+# Now set the custom option
+# We are under Bash shell
+export SCILAB_GDB_OPT="--command=debug.txt"
+# Start Scilab in debug mode
+scilab -debug]]></programlisting>
+        
+        <programlisting role="no-scilab-exec"><![CDATA[
+# Under GNU/Linux, Mac OS X or Unix:
+$ echo "disp(%pi)"|scilab-cli
+or
+$ echo "disp(%pi)"|scilab -nwni
+
+# Only open the Scilab help window:
+$ scilab-adv-cli -e "help()"
+or
+$ scilab -nw -e "help()"
+
+
+# Scilab can be used for scripting aspects:
+echo "if 1<>2 then exit(99) end"|scilab-cli
+echo $? ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="exit">exit</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="startup">startup</link>
+                
             </member>
+            
         </simplelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revremark>-noatomsautoload が追加されました.</revremark>
+                
+            </revision>
+            
+            <revision>
+                
+                <revnumber>5.4.1</revnumber>
+                
+                <revremark>scinotes と xcos 個別スクリプトが導入されました. SEP #87参照.</revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
     </refsection>
+    
 </refentry>
+
index 8d7d1bb..326fbce 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) 2009 - DIGITEO - Pierre MARECHAL <pierre.marechal@scilab.org>
  * 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="isfield">
+    
     <refnamediv>
+        
         <refname>isfield</refname>
-        <refpurpose>指定したフィールド名が構造体の中にあるかどうか調べる</refpurpose>
+        
+        <refpurpose>指定したフィールド名が構造体またはmlistまたはtlistの中にあるかどうか調べる</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>bool = isfield(s,fieldname)</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>s</term>
+                
                 <listitem>
-                    <para>構造体配列</para>
+                    
+                    <para>構造体配列, tlist または mlist</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>fieldname</term>
+                
                 <listitem>
-                    <para>文字列の行列</para>
+                    
+                    <para>文字列の行列: 検出するフィールド名</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>bool</term>
+                
                 <listitem>
-                    <para>論理値の行列.</para>
+                    
+                    <para>
+                        論理値の行列 (<varname>fieldname></varname>と同じ形式).
+                    </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
+            This function returns <constant>%t</constant> if the specified structure or tlist or mlist <varname>s</varname> includes the field <varname>fieldname</varname>, regardless of the corresponding value. For a structure, the hidden field <code class="literal">dims</code> is ignored.
+            
             この関数は指定した構造体 "s" がその値によらず,
+            
             フィールド "field" を有する場合に true を返します.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
 s = struct("field_1",123,"field_2",456,"field_4",789)
 
@@ -59,20 +106,75 @@ isfield( s , "field_1"  )
 
 // Multiple Fieldname Syntax
 isfield( s , [ "field_1" "field_2" ; "field_3" "field_4" ] )
+
+// with a tlist:
+s = tlist(["test" "t" "n","","p"], "Hello", %pi, "anonymous", (1-%z)^3)
+isfield(s, ["b" "t" ""])  // =>  F  T  T  (anonymous fields can be detected)
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="struct">struct</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="tlist">tlist</link>
+                
             </member>
+            
             <member>
+                
+                <link linkend="mlist">mlist</link>
+                
+            </member>
+            
+            <member>
+                
                 <link linkend="getfield">getfield</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="definedfields">definedfields</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.5</revnumber>
+                
+                <revremark>
+                    
+                    mlistおよびtlist用の拡張モジュール
+                    
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
 </refentry>
+
index 9cde487..e96d517 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) 2013 - Scilab Enterprises
@@ -243,6 +245,7 @@ r=res(t,y,ydot,x1,x2,...)
                             </para>
                             
                             <para>
+                                
                                 警告: この形式は<literal>関数</literal>に渡す別の引数が存在しない場合には
                                 
                                 使用するべきではありません.
@@ -266,7 +269,7 @@ void res(double *t, double y[], double yd[], double r[],
          int *ires, double rpar[], int ipar[])
  ]]></programlisting>
                             
-                            <para>Fortranの場合, 以下としま:</para>
+                            <para>Fortranの場合, 以下とします:</para>
                             
                             <programlisting role="no-scilab-exec"><![CDATA[
 subroutine res(t,y,yd,r,ires,rpar,ipar)
@@ -309,6 +312,7 @@ integer ires,ipar(*)
                             <para>Scilab関数.</para>
                             
                             <para>
+                                
                                 呼び出し手順は <literal>r=jac(t,y,ydot,cj)</literal> で,
                                 
                                 <literal>jac</literal> 関数は
@@ -394,6 +398,8 @@ integer ipar(*)
                         
                         <link linkend="external">external</link> (関数またはリストまたは文字列). 
                         
+                        k                        
+                        
                         <literal>ng</literal>個の要素を有する列ベクトル <literal>surf(t,y)</literal> の値を計算します.
                         
                         各要素は局面を定義します.
@@ -537,6 +543,7 @@ integer ny,ng
                                         "dg(i)/dy(j)+cj*dg(i)/dydot(j)"
                                         
                                     </literal>
+                                    
                                     で計算するバンド行列の定義域<literal>[ml,mu]</literal>を指定します.
                                     
                                     <literal>info(3)=[]</literal>の場合, <literal>jac</literal> は通常の行列
@@ -1179,6 +1186,7 @@ nn
                 <link linkend="ode">ode</link>
                 
             </member>
+             
             
             <member>
                 
@@ -1240,3 +1248,5 @@ nn
     
 </refentry>
 
+
+
index 3591a7d..181999c 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: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="intc">
+    
     <refnamediv>
+        
         <refname>intc</refname>
+        
         <refpurpose>コーシー積分</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
-        <synopsis>[y]=intc(a,b,f)</synopsis>
+        
+        <synopsis>[y  [,err]] = intc(a, b, f [,abserr [,relerr]])</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
+        
         <title>パラメータ</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>a,b</term>
+                
                 <listitem>
-                    <para>複素数</para>
+                    
+                    <para>2つの複素数スカラー</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>f</term>
+                
                 <listitem>
+                    
                     <para>"外部" 関数</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
+            <varlistentry>
+                
+                <term>abserr, rerr</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        実スカラー, 絶対および相対エラー.
+                        
+                        デフォルト値: <literal>1.d-14</literal> および
+                        
+                        <literal>1d-8</literal>.
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>err</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        実数, 推定された結果の絶対誤差.
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             <literal>f</literal> が複素数を値とする関数の場合,
-            <literal> intc(a,b,f) </literal> は,
-            複素平面上の直線<literal>a b</literal>に沿った
+            
+            <literal>intc(a, b, f)</literal> は,
+            
+            複素平面上の直線<literal>[a b]</literal>に沿った
+            
             <literal>f(z)dz</literal> の
+            
             <literal>a</literal> から <literal>b</literal>の積分を計算します.
+            
         </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[
+function y = f(z)
+  y = z^(3 + %pi * %i);
+endfunction
+
+intc(1+%i, 4-%i, f)
+
+[r, err] = intc(1+%i, 4-%i, f, 1d-10, 1d-6)
+ ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="intg">intg</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="intl">intl</link>
+                
             </member>
+            
         </simplelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.5.0</revnumber>
+                
+                <revremark>絶対および相対(入力)および絶対 (出力) 
+                    
+                    誤差管理が追加されました.
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
     </refsection>
+    
 </refentry>
+
index dc90b98..02d104d 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) 2008 - INRIA
         
         <refname>numdiff</refname>
         
-        <refpurpose>数値的な傾きの推定</refpurpose>
+        <refpurpose>
+            
+            ある点における数値的な傾きの推定.
+            
+            <emphasis role="bold"> この関数は廃止されます. 
+                
+                <link linkend="numderivative">numderivative</link> 関数を代わりに
+                
+                使用してください.
+                
+            </emphasis>
+            
+        </refpurpose>
         
     </refnamediv>
     
@@ -26,7 +40,7 @@
         
         <title>呼び出し手順</title>
         
-        <synopsis>g=numdiff(fun,x [,dx])</synopsis>
+        <synopsis>g = numdiff(fun, x [,dx])</synopsis>
         
     </refsynopsisdiv>
     
                 
                 <listitem>
                     
-                    <para>外部, Scilab 関数またはリスト. 呼び出し手順については,
+                    <para>
+                        
+                        外部, Scilab 関数またはリスト. 呼び出し手順については,
                         
                         以下を参照ください. また,外部関数に関する詳細については,
                         
                         <link linkend="external">external</link>を参照ください.
                         
+                        f: R<superscript>n</superscript> --> R<superscript>p</superscript>
+                        
                     </para>
                     
                 </listitem>
@@ -61,7 +79,8 @@
                 <listitem>
                     
                     <para>
-                        ベクトル, 関数<literal>fun</literal>の引数
+                        
+                        傾きを探す点の <code>n</code> 座標のベクトル
                         
                     </para>
                     
                 
                 <listitem>
                     
-                    <para>ベクトル, 有限差分ステップ. デフォルト値は
+                    <para>
                         
-                        <literal>dx=sqrt(%eps)*(1+1d-3*abs(x))</literal>です.
+                        ベクトル, 有限差分ステップ. デフォルト値は
+                        
+                        <literal>dx = sqrt(%eps)*(1+1d-3*abs(x))</literal>です.
                         
                     </para>
                     
                 
                 <listitem>
                     
-                    <para>ベクトル, 傾きの推定値</para>
+                    <para>
+                        
+                        行列, 軌跡<varname>x</varname>における傾きの推定値
+                        
+                    </para>
                     
                 </listitem>
                 
         
         <para>
             
-            指定した関数 <literal>fun(x)</literal> 
-            
-            from
+            R<superscript>n</superscript> から R<superscript>p</superscript>まで
             
-            <literal>R^n</literal> to <literal>R^p</literal> は
+            関数 <literal>fun(x)</literal>を指定すると, 有限差分法により
             
-            以下のように有限差分法により行列<literal>g</literal>を計算します.
+            以下のような <code>p x n</code> 行列 <varname>g</varname>を計算します.
             
         </para>
         
-        <programlisting role=""><![CDATA[ 
-g(i,j) = (df_i)/(dx_j)
- ]]></programlisting>
+        <programlisting role="no-scilab-exec">
+            
+            <![CDATA[
+         g(i,j) = [(df_i)/(dx_j)](x)
+         ]]>
+            
+        </programlisting>
         
         <para>
             
@@ -129,23 +156,29 @@ g(i,j) = (df_i)/(dx_j)
         
         <para>
             
-            パラメータがない場合, 関数funの呼び出し手順は
+            パラメータがない場合, 関数<varname>fun</varname>の呼び出し手順は,
             
-            <literal>y=fun(x)</literal>となり, numdiff は
+            <varname>x</varname> &#8712; R<superscript>n</superscript> 
             
-            <literal>g=numdiff(fun,x)</literal>のようにコールすることがでできます.
+            および <varname>y</varname> &#8712; R<superscript>p</superscript>として,
             
-            これ以外の場合,関数funの呼び出し手順は,
+            <code>y = fun(x)</code> となります.
             
-            <literal>y=fun(x,param_1,pararm_2,..,param_q)</literal>
+            <function>numdiff</function> は,
             
-            とする必要があります.
+            <code>g = numdiff(fun, x)</code>のようにコールできます.
             
-            パラメータ<literal>param_1,param_2,..param_q</literal>が存在する場合,
+            これ以外の場合,関数<varname>fun</varname>の呼び出し手順は,
             
-            <literal>numdiff</literal> は以下のようにコールすることができます
+            <literal>y = fun(x, param_1, pararm_2, ..., param_q)</literal>
             
-            <literal>g=numdiff(list(fun,param_1,param_2,..param_q),x)</literal>.
+            となります.
+            
+            パラメータ<literal>param_1, param_2, ..., param_q</literal>が存在する場合,
+            
+            <function>numdiff</function> は以下のようにコールすることができます
+            
+            <literal>g = numdiff(list(fun, param_1, param_2, ..., param_q), x)</literal>.
             
         </para>
         
@@ -163,34 +196,58 @@ g(i,j) = (df_i)/(dx_j)
         
         <title>例</title>
         
-        <programlisting role="example"><![CDATA[ 
-// 例1 (パラメータなし)
-// myfun は R^2 から R への関数:   (x(1),x(2)) |--> myfun(x) 
-function f=myfun(x)
-  f=x(1)*x(1)+x(1)*x(2)
-endfunction
+        <programlisting role="example">
+            
+            <![CDATA[
+         // 例1 (パラメータなし)
+         // myfun は R^2 から R への関数:   (x(1),x(2)) |--> myfun(x)
+         function f = myfun(x)
+         f = x(1)*x(1) + x(1)*x(2)
+         endfunction
 
-x=[5 8]
-g=numdiff(myfun,x)
+         x = [5 8];
+         g = numdiff(myfun, x)
 
-// 正確な傾き (すなわち,最初の要素x(1)に関する微分および二番目の要素x(2)に関する
-// 微分はexact=[2*x(1)+x(2)  x(1)]となります.
-exact=[2*x(1)+x(2)  x(1)]
+         // 正確な傾き (すなわち,最初の要素x(1)に関する微分および二番目の要素x(2)に関する
+         // 微分はexact=[2*x(1)+x(2)  x(1)]となります.
+         exact = [2*x(1)+x(2)  x(1)]
 
-// 例2 (パラメータ)
-// myfun はRからRへの関数:  x(1) |--> myfun(x) 
-// myfun は3個のパラメータ a, b, cを有します
-function  f=myfun(x,a,b,c)
-  f=(x+a)^c+b
-endfunction
 
-a=3; b=4; c=2;
-x=1
-g2=numdiff(list(myfun,a,b,c),x)
+         // 例2 (パラメータあり)
+         // myfun はRからRへの関数:  x(1) |--> myfun(x) 
+         // myfun は3個のパラメータ a, b, cを有します
+         function  f = myfun(x, a, b, c)
+         f = (x+a)^c + b
+         endfunction
 
-// 正しい傾き, すなわち,x(1)に関する微分は以下のようになります :
-exact2=c*(x+a)^(c-1)
- ]]></programlisting>
+         a = 3; b = 4; c = 2;
+         x = 1;
+         g2 = numdiff(list(myfun, a, b, c), x)
+
+         // 正しい傾き, すなわち,x(1)に関する微分は以下のようになります:
+         exact2 = c*(x+a)^(c-1)
+
+
+         // 例3 (f: R^3 --> R^3)
+         // myfunはR^2からR^2への関数: (x(1), x(2), x(3)) |--> (myfun(x)(1), myfun(x)(2), mfun(x)(3))
+         function f = myfun(x)
+         f(1) = x(1) * x(1);
+         f(2) = x(1) * x(2) * x(3);
+         f(3) = 2*x(1) + 2*x(2) + 2*x(3);
+         endfunction
+
+         x = [5 8 10];
+         g = numdiff(myfun, x)
+
+         // 正確な傾斜は以下となります:
+         // [  df_1/dx_1  df_1/dx_2  df_1/dx_3 ;
+         //    df_2/dx_1  df_2/dx_2  df_2/dx_3 ;
+         //    df_3/dx_1  df_3/dx_2  df_3/dx_3 ; ]
+         exact3 = [2*x(1) 0 0  ;  x(2)*x(3) x(1)*x(3) x(1)*x(2)  ;  2 2 2]
+
+         ]]>
+            
+        </programlisting>
         
     </refsection>
     
@@ -202,18 +259,54 @@ exact2=c*(x+a)^(c-1)
             
             <member>
                 
+                <link linkend="interp">interp</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="interp2d">interp2d</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="splin">splin</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="eval_cshep2d">eval_cshep2d</link>
+                
+            </member>
+            
+            <member>
+                
                 <link linkend="optim">optim</link>
                 
             </member>
             
             <member>
                 
+                <link linkend="diff">diff</link>
+                
+            </member>
+            
+            <member>
+                
                 <link linkend="derivative">derivative</link>
                 
             </member>
             
             <member>
                 
+                <link linkend="numderivative">numderivative</link>
+                
+            </member>
+            
+            <member>
+                
                 <link linkend="external">external</link>
                 
             </member>
@@ -222,5 +315,122 @@ exact2=c*(x+a)^(c-1)
         
     </refsection>
     
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.5.0</revnumber>
+                
+                <revremark>廃止予定となりました. 
+                    
+                    Scilab 6.0.0で削除されます.
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>付録</title>
+        
+        <para>
+            
+            我々は,<literal>numdiff</literal>関数を使用する  
+            
+            <literal>numderivative</literal>関数を使うように更新できる方法について
+            
+            議論しています.
+            
+        </para>
+        
+        <para>
+            
+            以下の関数について考えてみましょう:
+            
+        </para>
+        
+        <programlisting role="example">
+            
+            <![CDATA[
+         function f = myfun(x)
+         f = x(1)*x(1)+x(1)*x(2)
+         endfunction
+         ]]>
+            
+        </programlisting>
+        
+        <para>
+            
+            および点:
+            
+        </para>
+        
+        <programlisting role="example">
+            
+            <![CDATA[
+         x = [5 8]
+         ]]>
+            
+        </programlisting>
+        
+        <para>
+            
+            ここで, 命令:
+            
+        </para>
+        
+        <programlisting role="example">
+            
+            <![CDATA[
+         g1 = numdiff(myfun, x)
+         ]]>
+            
+        </programlisting>
+        
+        <para>
+            
+            は以下で置換できます
+            
+        </para>
+        
+        <programlisting role="example">
+            
+            <![CDATA[
+         g2 = numderivative(myfun, x)
+         ]]>
+            
+        </programlisting>
+        
+        <para>
+            
+            正確に同じステップを使用することが重要です,
+            
+            <literal>numdiff</literal>と値が同じステップを使用します:
+            
+        </para>
+        
+        <programlisting role="example">
+            
+            <![CDATA[
+         x = [5 8];
+         h = sqrt(%eps)*(1+1d-3*abs(x))
+         g1 = numdiff(myfun, x)
+         g2 = numderivative(myfun, x, h)
+         g1 == g2
+         ]]>
+            
+        </programlisting>
+        
+    </refsection>
+    
+    
+    
 </refentry>
 
index 82c880e..6b78483 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) 2013 - Scilab Enterprises
  *
  -->
 
+
+
 <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="IsAScalar" xml:lang="ja">
     
+    
+    
     <refnamediv>
         
         <refname>IsAScalar</refname>
             (size(<varname>x</varname>が1, type(<varname>x</varname>,1) も 1)の場合,
             
             <literal>
+                
                 IsAScalar(<varname>x</varname>)
+                
             </literal>
+            
             は true を返します.
             
             <warning>この関数は廃止予定です.</warning>
@@ -133,3 +142,5 @@ IsAScalar("s")
     
 </refentry>
 
+
+
index 4e13056..4e2d7db 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) 2013 - Scilab Enterprises
         <para>
             
             <literal>
+                
                 iscolumn(<varname>x</varname>)
+                
             </literal>
+            
             は
             
             <varname>x</varname>が列ベクトルの場合にtrueを返します.
@@ -177,3 +182,5 @@ iscolumn(s) // 構造体の3次元配列 (うち2つの次元は1要素)
     
 </refentry>
 
+
+
index b9016cf..82bf14b 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) 2013 - Scilab Enterprises
         <para>
             
             <literal>
+                
                 ismatrix(<varname>x</varname>)
+                
             </literal>
+            
             は,
             
             <varname>x</varname>が行列の場合にtrueを返します.
             
         </para>
         
+        
+        
     </refsection>
     
+    
+    
     <refsection>
         
+        
+        
         <title>例</title>
         
+        
+        
         <programlisting role="example"><![CDATA[ 
 ismatrix(ones(10,5))
 ismatrix(1)
@@ -125,65 +138,129 @@ s(1,2,1).b = list(%e, %s);
 ismatrix(s) // 構造体の3次元 (立法)配列
  ]]></programlisting>
         
+        
+        
     </refsection>
     
+    
+    
     <refsection role="see also">
         
+        
+        
         <title>参照</title>
         
+        
+        
         <simplelist type="inline">
             
+            
+            
             <member>
                 
+                
+                
                 <link linkend="isscalar">isscalar</link>
                 
+                
+                
             </member>
             
+            
+            
             <member>
                 
+                
+                
                 <link linkend="isrow">isrow</link>
                 
+                
+                
             </member>
             
+            
+            
             <member>
                 
+                
+                
                 <link linkend="iscolumn">iscolumn</link>
                 
+                
+                
             </member>
             
+            
+            
             <member>
                 
+                
+                
                 <link linkend="issquare">issquare</link>
                 
+                
+                
             </member>
             
+            
+            
             <member>
                 
+                
+                
                 <link linkend="isempty">isempty</link>
                 
+                
+                
             </member>
             
+            
+            
         </simplelist>
         
+        
+        
     </refsection>
     
+    
+    
     <refsection>
         
+        
+        
         <title>履歴</title>
         
+        
+        
         <revhistory>
             
+            
+            
             <revision>
                 
+                
+                
                 <revnumber>5.5.0</revnumber>
                 
+                
+                
                 <revremark>関数 ismatrix が導入されました.</revremark>
                 
+                
+                
             </revision>
             
+            
+            
         </revhistory>
         
+        
+        
     </refsection>
     
+    
+    
 </refentry>
 
+
+
index afe2c5e..0e78581 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) 2013 - Scilab Enterprises
         <para>
             
             <literal>
+                
                 isrow(<varname>x</varname>)
+                
             </literal>
-            は
+             は,
             
             <varname>x</varname>が行ベクトルの場合にtrueを返します.
             
             スカラーは行ベクトルとみなされます.
             
-            ハイパー行列は最後の次元以外が1である場合にのみ
+            ハイパー行列は,最後の次元以外が1である場合にのみ
             
             行ベクトルとみなされます.
             
index e9da5cd..adc40ca 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) 2013 - Scilab Enterprises
         <para>
             
             <literal>
+                
                 isscalar(<varname>x</varname>)
+                
             </literal>
-            は <varname>x</varname>
+             は, <varname>x</varname>
             
             がスカラー (size(<varname>x</varname>) が 1)の場合にtrueを返します. 
             
index 49ea4d6..80f8fc9 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) 2013 - Scilab Enterprises
         <para>
             
             <literal>
+                
                 issquare(<varname>x</varname>)
+                
             </literal>
-            は
+             は,
             
             <varname>x</varname>が正方行列
             
@@ -81,7 +85,7 @@
             
             <varname>x</varname> がハイパー行列の場合は要素数が1)
             
-            の場合にtrueを返します.. 
+            の場合にtrueを返します.
             
             <literal>issquare([])</literal>はfalseを返すことに注意してください.
             
index 27e8361..8a30df7 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="modulo" xml:lang="ja">
+    
     <refnamediv>
+        
         <refname>modulo</refname>
-        <refpurpose>対称剰余モジュロm演算</refpurpose>
+        
+        <refpurpose>左オペランド符号を有するモジュロm剰余演算</refpurpose>
+        
     </refnamediv>
+    
     <refnamediv xml:id="pmodulo">
+        
         <refname>pmodulo</refname>
-        <refpurpose>正の剰余モジュロm演算</refpurpose>
+        
+        <refpurpose>正のモジュロmユークリッド剰余演算</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼出し手順</title>
-        <synopsis>i=modulo(n,m)</synopsis>
-        <synopsis>i=pmodulo(n,m)</synopsis>
+        
+        <synopsis>i = modulo(n,m)</synopsis>
+        
+        <synopsis>i = pmodulo(n,m)</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
+            <varlistentry>
+                
+                <term>m, n</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        エンコードされた整数, 実数または多項式の
+                        
+                        スカラー, ベクトル, またはハイパー行列
+                        
+                        (ハイパー行列は多項式ではサポートされません).
+                        
+                        <varname>m</varname> および <varname>n</varname>は,
+                        
+                        同じ型である必要があります.
+                        
+                        yが整数型の場合,(int8およびint16のように)
+                        
+                        異なるエンコード長とすることが可能です.
+                        
+                        どちらもスカラーでない場合、yは同じ大きさとする
+                        
+                        必要があります.
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
             <varlistentry>
-                <term>n,m</term>
+                
+                <term>i</term>
+                
                 <listitem>
-                    <para>整数</para>
+                    
+                    <para>
+                        
+                        <varname>n</varname>と同じ型(および整数型)の
+                        
+                        スカラー, ベクトル, 行列またはハイパー行列.
+                        
+                        <varname>i</varname> は,
+                        
+                        <varname>m</varname>または<varname>n</varname>の
+                        
+                        大きい方の大きさとなります.
+                        
+                    </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             <literal>modulo</literal> は,
+            
             <literal>i= n (modulo m)</literal>,
+            
             すなわち, <literal>n</literal>を<literal>m</literal>で
-            割った剰余を計算します(<literal>n</literal> および <literal>m</literal>
-            は整数).
+            
+            割った剰余を計算します.
+            
         </para>
-        <para>i = n - m .* int (n ./ m). ここで,
+        
+        <para>
+            
+            <code>i = n - m .* int (n ./ m)</code>.
+            
+            この式で,
+            
             <literal>n</literal> または <literal>m</literal>が負の場合,
+            
             答えが負となる可能性があります.
+            
         </para>
+        
         <para>
-            <literal>pmodulo</literal> は <literal>i = n - |m| .* floor (n
-                ./ |m|)
-            </literal>
-            を計算します, 答えは正またはゼロとなります.
+            
+            <literal>pmodulo</literal> は,
+            
+            <code>i = n - |m| .* floor (n ./ |m|)</code>
+            
+            を計算します.答えは正またはゼロとなります.
+            
         </para>
+        
+        <warning>
+            
+            <varname>m</varname>が1つ以上の値0を含む場合,
+            
+            <code>modulo(x,m)</code> および <code>pmodulo(x,m)</code>
+            
+            はゼロ割を発生します.
+            
+            <varname>m</varname>hが実数型の場合,
+            
+            この例外は<literal>ieee()</literal> モードに基づき処理されます.
+            
+            エンコードされた整数の場合,常にエラーを発生します.
+            
+        </warning>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
-        <programlisting role="example"><![CDATA[ 
+        
+        <programlisting role="example"><![CDATA[
 n = [1,2,10,15];
 m = [2,2,3,5];
 modulo(n,m)
@@ -69,6 +178,82 @@ modulo(10, -4)
 pmodulo(-3, 9)
 pmodulo(10, -6)
 pmodulo(-10, -6)
+
+// エンコードされた整数
+modulo( int8(-13), int16(-7))
+pmodulo(int8(-13), int16(-7))
+modulo( int8(-13), int16([-7 5]))
+pmodulo(int8(-13), int16([-7 5]))
+modulo( int8([-13 8]), int16(-7))
+pmodulo(int8([-13 8]), int16(-7))
+modulo( int8([-13 8]), int16([-7 5]))
+pmodulo(int8([-13 8]), int16([-7 5]))
+
+// ハイパー行列
+m = grand(2,2,2,"uin",-100,100)
+n = grand(2,2,2,"uin",-10 ,10);
+n(n==0) = 1
+modulo(m, 5)
+pmodulo(m,5)
+modulo(51, n)
+pmodulo(51,n)
+modulo(m, n)
+pmodulo(m,n)
+
+// 多項式
+modulo( %z^2+1, %z)
+pmodulo(%z^2+1, %z)
+
+
  ]]></programlisting>
+        
     </refsection>
+    
+    <refsection role= "see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="unwrap">unwrap</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="ieee">ieee</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.5.0</revnumber>
+                
+                <revremark>
+                    
+                    エンコードされた整数およびエンコードされた整数または実数の
+                    
+                    ハイパー行列に拡張されました.
+                    
+                </revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
 </refentry>
+
diff --git a/scilab/modules/elementary_functions/help/ja_JP/unwrap.xml b/scilab/modules/elementary_functions/help/ja_JP/unwrap.xml
new file mode 100644 (file)
index 0000000..a55b64a
--- /dev/null
@@ -0,0 +1,613 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2013 - Samuel GOUGEON
+ *
+ * This file must be used under the terms of the CeCILL.
+ * This source file is licensed as described in the file COPYING,
+ * which you should have received as part of this distribution.
+ * The terms are also available at
+ * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+ *
+ -->
+
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns: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="unwrap" xml:lang="ja">
+    
+    <refnamediv>
+        
+        <refname>unwrap</refname>
+        
+        <refpurpose>
+            
+            Y(x)輪郭またはZ(x,y)面をアンラップする. Y(x)輪郭を展開する
+            
+        </refpurpose>
+        
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        
+        <title>呼び出し手順</title>
+        
+        <synopsis>unwrap() // 例を実行
+            
+            [U, breakPoints] = unwrap(Y)
+            
+            [U, breakPoints] = unwrap(Y, z_jump)
+            
+            [U, cuspPoints]  = unwrap(Y, "unfold")
+            
+            U = unwrap(Z)
+            
+            U = unwrap(Z, z_jump)
+            
+            U = unwrap(Z, z_jump, dir)
+            
+        </synopsis>
+        
+    </refsynopsisdiv>
+    
+    <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>Y</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        実数ベクトル: アンラップまたは展開する外形. 
+                        
+                        暗黙の座標軸Xが等間隔であることを仮定します.
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>Z</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        実数の行列: アンラップする面. 暗黙の座標軸 (X,Y)
+                        
+                        は直交軸で等間隔(間隔はXとYで異なることが可能)と仮定されます.
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>z_jump</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        アンラップモードで使用される正のスカラー実数:
+                        
+                        アンラップを実行する.不連続点で適用されるジャンプ高さ.
+                        
+                        絶対値のみが考慮されます.
+                        
+                        実際に適用されるジャンプは各不連続点の
+                        
+                        両端をつなぐ傾きの符号を有します.
+                        
+                        デフォルト値は, <literal>z_jump = 2*%pi</literal>です. 
+                        
+                        特別な値  <literal>z_jump = 0</literal> は,
+                        
+                        各不連続点の周辺の平均的な傾きに
+                        
+                        等しいジャンプを適用し,
+                        
+                        外形または面全体に連続的な傾きを回復します.
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>dir</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        "c" | "r" | "" (デフォルト): 
+                        
+                        アンラップを行う方向. 
+                        
+                        "c" は列方向にアンラップ, "r" は行方向にアンラップ, 
+                        
+                        "" は両方向にアンラップします.
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>"unfold"</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        指定した曲線が折り畳まれている場合,アンラップではなく,展開します.
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>U</term>
+                
+         &n