[doc] misc. typos & improvements 76/21476/17
Samuel GOUGEON [Sun, 31 May 2020 14:46:55 +0000 (16:46 +0200)]
Change-Id: I0d256104bd6fad74327fbbb6aecb936f60e13f85

40 files changed:
scilab/modules/core/help/en_US/1_keywords/backslash.xml
scilab/modules/core/help/fr_FR/1_keywords/backslash.xml
scilab/modules/core/help/ja_JP/1_keywords/backslash.xml
scilab/modules/core/help/pt_BR/1_keywords/backslash.xml
scilab/modules/core/help/ru_RU/1_keywords/backslash.xml
scilab/modules/elementary_functions/help/en_US/elementarymatrices/perms.xml [moved from scilab/modules/elementary_functions/help/en_US/setoperations/perms.xml with 98% similarity]
scilab/modules/elementary_functions/help/en_US/elementarymatrices/random/grand.xml
scilab/modules/elementary_functions/help/en_US/matrixoperations/or.xml
scilab/modules/elementary_functions/help/fr_FR/elementarymatrices/perms.xml [moved from scilab/modules/elementary_functions/help/fr_FR/setoperations/perms.xml with 98% similarity]
scilab/modules/elementary_functions/help/fr_FR/elementarymatrices/random/grand.xml
scilab/modules/elementary_functions/help/fr_FR/matrixoperations/or.xml
scilab/modules/elementary_functions/help/ja_JP/elementarymatrices/random/grand.xml
scilab/modules/elementary_functions/help/ru_RU/elementarymatrices/random/grand.xml
scilab/modules/graphics/help/en_US/2d_plot/champ.xml
scilab/modules/graphics/help/en_US/axes_operations/sda.xml
scilab/modules/graphics/help/ja_JP/2d_plot/champ.xml
scilab/modules/graphics/help/ja_JP/axes_operations/sda.xml
scilab/modules/graphics/help/pt_BR/2d_plot/champ.xml
scilab/modules/graphics/help/pt_BR/axes_operations/sda.xml
scilab/modules/graphics/help/ru_RU/2d_plot/champ.xml
scilab/modules/helptools/etc/images_md5.txt
scilab/modules/helptools/images/dawson_1.png [new file with mode: 0644]
scilab/modules/linear_algebra/help/en_US/linear/lsq.xml
scilab/modules/linear_algebra/help/ja_JP/linear/lsq.xml
scilab/modules/linear_algebra/help/pt_BR/linear/lsq.xml
scilab/modules/linear_algebra/help/ru_RU/linear/lsq.xml [new file with mode: 0644]
scilab/modules/signal_processing/help/en_US/correlation_convolution/convol.xml
scilab/modules/signal_processing/help/en_US/spectral_estimation/cspect.xml
scilab/modules/signal_processing/help/en_US/spectral_estimation/pspect.xml
scilab/modules/signal_processing/help/ja_JP/correlation_convolution/convol.xml
scilab/modules/signal_processing/help/ja_JP/spectral_estimation/cspect.xml
scilab/modules/signal_processing/help/ja_JP/spectral_estimation/pspect.xml
scilab/modules/signal_processing/help/ru_RU/correlation_convolution/convol.xml
scilab/modules/signal_processing/help/ru_RU/spectral_estimation/cspect.xml
scilab/modules/signal_processing/help/ru_RU/spectral_estimation/pspect.xml
scilab/modules/special_functions/help/en_US/dawson.xml
scilab/modules/special_functions/help/ja_JP/dawson.xml
scilab/modules/special_functions/help/ru_RU/dawson.xml [new file with mode: 0644]
scilab/modules/xml/help/en_US/xmlGetValues.xml
scilab/modules/xml/help/ja_JP/xmlGetValues.xml

index c9505f7..040678d 100644 (file)
@@ -119,6 +119,9 @@ mprintf('\ntime with backslash: %.3f\n',toc());
                 <link linkend="slash">slash</link>
             </member>
             <member>
+                <link linkend="lsq">lsq</link>
+            </member>
+            <member>
                 <link linkend="inv">inv</link>
             </member>
             <member>
index fa90d04..5e6c496 100644 (file)
@@ -67,6 +67,9 @@ mprintf('\ntemps nécessaire à la résolution du système avec l''opérateur ba
                 <link linkend="slash">slash</link>
             </member>
             <member>
+                <link linkend="lsq">lsq</link>
+            </member>
+            <member>
                 <link linkend="inv">inv</link>
             </member>
             <member>
index 8625c6d..1fae4e5 100644 (file)
@@ -122,6 +122,9 @@ mprintf('\ntime with backslash: %.3f\n',toc());
                 <link linkend="slash">slash</link>
             </member>
             <member>
+                <link linkend="lsq">lsq</link>
+            </member>
+            <member>
                 <link linkend="inv">inv</link>
             </member>
             <member>
index ae8f851..441b865 100644 (file)
@@ -79,6 +79,9 @@ mprintf('\ntime needed to solve the system with the backslash operator: %.3f\n',
                 <link linkend="slash">slash</link>
             </member>
             <member>
+                <link linkend="lsq">lsq</link>
+            </member>
+            <member>
                 <link linkend="inv">inv</link>
             </member>
             <member>
index eff761b..538b630 100644 (file)
@@ -125,6 +125,9 @@ mprintf('\nвремя, необходимое для решения систем
                 <link linkend="slash">slash</link>
             </member>
             <member>
+                <link linkend="lsq">lsq</link>
+            </member>
+            <member>
                 <link linkend="inv">inv</link>
             </member>
             <member>
@@ -19,7 +19,7 @@
           xmlns:scilab="http://www.scilab.org" xml:id="perms" xml:lang="en">
     <refnamediv>
         <refname>perms</refname>
-        <refpurpose>Set of permutations of given components</refpurpose>
+        <refpurpose>Generate the table of permutations of given elements</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Syntax</title>
index ce2a945..f33f69f 100644 (file)
@@ -977,6 +977,12 @@ grand("setsd",n)
             <member>
                 <link linkend="ssrand">ssrand</link>
             </member>
+            <member>
+                <link linkend="randpencil">randpencil</link>
+            </member>
+            <member>
+                <link linkend="genmarkov">genmarkov</link>
+            </member>
         </simplelist>
     </refsection>
 </refentry>
index 378edeb..e2911d4 100644 (file)
@@ -270,7 +270,7 @@ or(A, "c")
 
 --> or(A, "r")
  ans  =
-(  1,  100) sparse matrix
+(  1,  100) sparse boolean matrix
 
 (  1,   1)  T
 (  1,  34)  T
@@ -280,7 +280,7 @@ or(A, "c")
 
 --> or(A, "c")
  ans  =
-(  70,  1) sparse matrix
+(  70,  1) sparse boolean matrix
 
 (  18,  1)  T
 (  23,  1)  T
@@ -19,7 +19,7 @@
           xmlns:scilab="http://www.scilab.org" xml:id="perms" xml:lang="fr">
     <refnamediv>
         <refname>perms</refname>
-        <refpurpose>Ensemble des permutations des éléments donnés</refpurpose>
+        <refpurpose>Génère le tableau des permutations des éléments donnés</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Séquence d'appel</title>
index 23c8c5a..ec43c97 100644 (file)
@@ -948,6 +948,12 @@ grand("setsd", n)
             <member>
                 <link linkend="ssrand">ssrand</link>
             </member>
+            <member>
+                <link linkend="randpencil">randpencil</link>
+            </member>
+            <member>
+                <link linkend="genmarkov">genmarkov</link>
+            </member>
         </simplelist>
     </refsection>
 </refentry>
index fddd39c..e1eae39 100644 (file)
@@ -276,7 +276,7 @@ or(A, "c")
 
 --> or(A, "r")
  ans  =
-(  1,  100) sparse matrix
+(  1,  100) sparse boolean matrix
 
 (  1,   1)  T
 (  1,  34)  T
@@ -286,7 +286,7 @@ or(A, "c")
 
 --> or(A, "c")
  ans  =
-(  70,  1) sparse matrix
+(  70,  1) sparse boolean matrix
 
 (  18,  1)  T
 (  23,  1)  T
index 7b4b82c..ec21002 100644 (file)
             <member>
                 <link linkend="rand">rand</link>
             </member>
+            <member>
+                <link linkend="sprand">sprand</link>
+            </member>
+            <member>
+                <link linkend="ssrand">ssrand</link>
+            </member>
+            <member>
+                <link linkend="randpencil">randpencil</link>
+            </member>
+            <member>
+                <link linkend="genmarkov">genmarkov</link>
+            </member>
         </simplelist>
     </refsection>
 </refentry>
index c71930d..656b2e4 100644 (file)
@@ -989,6 +989,12 @@ grand("setsd",n)
             <member>
                 <link linkend="ssrand">ssrand</link>
             </member>
+            <member>
+                <link linkend="randpencil">randpencil</link>
+            </member>
+            <member>
+                <link linkend="genmarkov">genmarkov</link>
+            </member>
         </simplelist>
     </refsection>
 </refentry>
index d89c212..053fc55 100644 (file)
@@ -158,8 +158,7 @@ xsetech([0 0.5 0.55 0.5])
 champ(x, x, fx, fy, arfact=1.7)
 gce().colored = "on";
 title("arfact=1.7, .colored=""on""", "fontsize",3)
-L = sqrt(fx.^2 + fy.^2);
-colorbar(min(L), max(L));
+colorbar
 
 // Field's intensity = color, + imposed boundaries
 subplot(2,2,4)
@@ -218,8 +217,7 @@ title(".colored = ""on""", "fontsize",3)
 gce().colored = "on";
 
 gcf().color_map = jetcolormap(100);
-L = sqrt(fx.^2 + fy.^2);
-colorbar(min(L), max(L));
+colorbar
 ]]></programlisting>
         <scilab:image>
             x = -1.2:0.11:0.7;
index c1169ee..2e878e0 100644 (file)
  * along with this program.
  *
  -->
-<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"  xml:lang="en" xml:id="sda">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
+          xml:lang="en" xml:id="sda">
     <refnamediv>
         <refname>sda</refname>
-        <refpurpose>Set default axes. </refpurpose>
+        <refpurpose>reSets the Default Axes to its factory values</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Syntax</title>
-        <synopsis>sda()
-            a = gda(); set(a,"default_values",1)
+        <synopsis>
+            sda()
         </synopsis>
     </refsynopsisdiv>
     <refsection>
-        <title>Arguments</title>
-        <variablelist>
-            <varlistentry>
-                <term>a</term>
-                <listitem>
-                    <para>handle, the handle of the default axes.</para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-    </refsection>
-    <refsection>
         <title>Description</title>
         <para>
-            This routine resets the axes' model to default values.
+            This routine resets the properties of the axes's model to their factory values.
+        </para>
+        <para>
+            <literal>sda()</literal> is equivalent to <literal>set(gda(),"default_values",1)</literal>.
         </para>
     </refsection>
     <refsection>
index 9ac1b1e..dd41954 100644 (file)
@@ -151,8 +151,7 @@ xsetech([0 0.5 0.55 0.5])
 champ(x, x, fx, fy, arfact=1.7)
 gce().colored = "on";
 title("arfact=1.7, .colored=""on""", "fontsize",3)
-L = sqrt(fx.^2 + fy.^2);
-colorbar(min(L), max(L));
+colorbar
 
 // Field's intensity = color, + imposed boundaries
 subplot(2,2,4)
@@ -211,8 +210,7 @@ title(".colored = ""on""", "fontsize",3)
 gce().colored = "on";
 
 gcf().color_map = jetcolormap(100);
-L = sqrt(fx.^2 + fy.^2);
-colorbar(min(L), max(L));
+colorbar
 ]]></programlisting>
         <scilab:image>
             x = -1.2:0.11:0.7;
index 780f557..122f9d0 100644 (file)
@@ -1,14 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
 <!--
-
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
-
  * Copyright (C) INRIA - Djalel Abdemouche
-
  *
-
-
  * Copyright (C) 2012 - 2016 - Scilab Enterprises
  *
  * This file is hereby licensed under the terms of the GNU GPL v2.0,
  * and continues to be available under such terms.
  * For more information, see the COPYING file which you should have received
  * along with this program.
-
  *
-
  -->
-
-<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="sda">
-
+<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="sda">
     <refnamediv>
-
         <refname>sda</refname>
-
-        <refpurpose>デフォルトの軸(Axes)を設定. </refpurpose>
-
+        <refpurpose>
+          デフォルトの軸(Axes)を工場出荷時のデフォルト値にリセット
+        </refpurpose>
     </refnamediv>
-
     <refsynopsisdiv>
-
         <title>呼び出し手順</title>
-
-        <synopsis>sda()
-
-            a = gda(); set(a,"default_values",1)
-
+        <synopsis>
+           sda()
         </synopsis>
-
     </refsynopsisdiv>
-
     <refsection>
-
-        <title>引数</title>
-
-        <variablelist>
-
-            <varlistentry>
-
-                <term>a</term>
-
-                <listitem>
-
-                    <para>ハンドル, デフォルトの軸のハンドル.</para>
-
-                </listitem>
-
-            </varlistentry>
-
-        </variablelist>
-
-    </refsection>
-
-    <refsection>
-
         <title>説明</title>
-
         <para>
-
-            このルーチンは軸の規範をデフォルト値にリセットします.
-
+            このルーチンは、Axesモデルプロパティを工場出荷時のデフォルト値にリセットします.
+        </para>
+        <para>
+            <literal>sda()</literal>は、<literal> set(gda(),"default_values",1)</literal>と同等です.
         </para>
-
     </refsection>
-
     <refsection>
-
         <title>例</title>
-
         <programlisting role="example"><![CDATA[
-
 x=[0:0.1:2*%pi]';
-
 f=get("default_figure"); // 規範となる図のハンドルを取得
-
 a=get("default_axes");   // 規範となる軸のハンドルを取得
-
                          // そのプロパティを設定
-
 f.figure_size=[1200 900];
-
 f.figure_position=[0 0];
-
 a.background=4;
-
 a.box="off";
-
 a.foreground=5;
-
 a.labels_font_color=25;
-
 a.labels_font_size=4;
-
 a.sub_tics=[7 3];
-
 a.x_location="middle";
-
 a.y_location="middle";
-
 a.tight_limits="on";
-
 a.thickness=2;
-
 a.grid=[-1 24];
 
 subplot(221);
-
 plot2d(x-2,sin(x))
-
 subplot(222);
-
 plot2d(x-6,[2*cos(x)+.7 2*cos(x)+.9 cos(2*x) .2+sin(3*x)],[-1,-2,-3 -4])
-
 sda() // return to the  default values of the axes' model
-
 subplot(223);
-
 plot2d(x-2,sin(x))
-
 subplot(224);
-
 plot2d(x-6,[2*cos(x)+.7 2*cos(x)+.9 cos(2*x) .2+sin(3*x)],[-1,-2,-3 -4])
-
 xdel(0)
-
 plot2d(x-2,sin(x))
-
  ]]></programlisting>
-
     </refsection>
-
     <refsection role="see also">
-
         <title>参照</title>
-
         <simplelist type="inline">
-
             <member>
-
                 <link linkend="sdf">sdf</link>
-
             </member>
-
             <member>
-
                 <link linkend="gda">gda</link>
-
             </member>
-
             <member>
-
                 <link linkend="gdf">gdf</link>
-
             </member>
-
             <member>
-
                 <link linkend="set">set</link>
-
             </member>
-
             <member>
-
                 <link linkend="graphics_entities">graphics_entities</link>
-
             </member>
-
         </simplelist>
-
     </refsection>
-
 </refentry>
-
index 4a6034b..f43fa2a 100644 (file)
@@ -150,8 +150,7 @@ xsetech([0 0.5 0.55 0.5])
 champ(x, x, fx, fy, arfact=1.7)
 gce().colored = "on";
 title("arfact=1.7, .colored=""on""", "fontsize",3)
-L = sqrt(fx.^2 + fy.^2);
-colorbar(min(L), max(L));
+colorbar
 
 // Field's intensity = color, + imposed boundaries
 subplot(2,2,4)
@@ -210,8 +209,7 @@ title(".colored = ""on""", "fontsize",3)
 gce().colored = "on";
 
 gcf().color_map = jetcolormap(100);
-L = sqrt(fx.^2 + fy.^2);
-colorbar(min(L), max(L));
+colorbar
 ]]></programlisting>
         <scilab:image>
             x = -1.2:0.11:0.7;
index 242f7d4..45df2fe 100644 (file)
  * along with this program.
  *
  -->
-<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns: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="sda" xml:lang="pt">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns: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="sda" xml:lang="pt">
     <refnamediv>
         <refname>sda</refname>
-        <refpurpose>Ajusta eixos padrões </refpurpose>
+        <refpurpose>Redefine os eixos padrão para seus valores de fábrica</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Seqüência de Chamamento</title>
-        <synopsis>sda()
-            a = gda(); set(a,"default_values",1)
+        <synopsis>
+            sda()
         </synopsis>
     </refsynopsisdiv>
     <refsection>
-        <title>Parâmetros</title>
-        <variablelist>
-            <varlistentry>
-                <term>a</term>
-                <listitem>
-                    <para>manipulador dos eixos padrões </para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-    </refsection>
-    <refsection>
         <title>Descrição</title>
-        <para>Esta rotina reajusta o os eixos modelos para valores padrões.
+        <para>
+            Esta rotina redefine as propriedades do modelo dos eixos para seu valores de fábrica.
+        </para>
+        <para>
+            <literal>sda()</literal> é equivalente a <literal>set(gda(),"default_values",1)</literal>.
         </para>
     </refsection>
     <refsection>
index cde456b..a261bb7 100644 (file)
@@ -157,8 +157,7 @@ xsetech([0 0.5 0.55 0.5])
 champ(x, x, fx, fy, arfact=1.7)
 gce().colored = "on";
 title("arfact=1.7, .colored=""on""", "fontsize",3)
-L = sqrt(fx.^2 + fy.^2);
-colorbar(min(L), max(L));
+colorbar
 
 // Интенсивность поля = цвету, + расширенные пределы
 subplot(2,2,4)
@@ -217,8 +216,7 @@ title(".colored = ""on""", "fontsize",3)
 gce().colored = "on";
 
 gcf().color_map = jetcolormap(100);
-L = sqrt(fx.^2 + fy.^2);
-colorbar(min(L), max(L));
+colorbar
 ]]></programlisting>
         <scilab:image>
             x = -1.2:0.11:0.7;
index 53915bf..90d9da7 100644 (file)
@@ -645,6 +645,7 @@ datatipSetOrientation_1.png=195794e45b7ae088da862c074079b9e8
 datatipSetStyle_1.png=6c902d69034f718ca0e7ca418512126f
 datatips_1.png=d8254c1e9ef203384cdc9c45044737c2
 datatips_2.png=4052a4546ac5ee65fa61ed0dbe165513
+dawson_1.png=8337670f1b3d342ac563847ee9766b58
 detrend_1.png=2eccb4bd13c0ab0b23b0b8a36477116b
 detrend_2.png=87e3a6b831bea33f9497349bafa3ff14
 drawaxis_1.png=08e796fb40ab072abf4067a37542a620
diff --git a/scilab/modules/helptools/images/dawson_1.png b/scilab/modules/helptools/images/dawson_1.png
new file mode 100644 (file)
index 0000000..cc13b14
Binary files /dev/null and b/scilab/modules/helptools/images/dawson_1.png differ
index 77c93e8..5a6c9f8 100644 (file)
  * along with this program.
  *
  -->
-<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="en" xml:id="lsq">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
+          xml:lang="en" xml:id="lsq">
     <refnamediv>
         <refname>lsq</refname>
-        <refpurpose>linear least square problems.  </refpurpose>
+        <refpurpose>linear least square solution of A*X=B with minimal norm(X)</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Syntax</title>
-        <synopsis>X=lsq(A,B [,tol])</synopsis>
+        <synopsis>
+            X = lsq(A, B)
+            X = lsq(A, B, tol)
+        </synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Arguments</title>
@@ -43,7 +49,7 @@
                     <para>positive scalar,  used to determine the effective rank of A
                         (defined as the order of the largest leading triangular
                         submatrix R11 in the QR factorization with pivoting of A,
-                        whose estimated condition number &lt;= 1/tol. The tol default value is
+                        whose estimated condition number &lt;= 1/tol). The tol default value is
                         set to <literal>sqrt(%eps)</literal>.
                     </para>
                 </listitem>
@@ -61,7 +67,7 @@
         <para>
             <literal>X=lsq(A,B)</literal> computes the minimum norm least square solution of
             the equation <literal>A*X=B</literal>, while <literal>X=A \ B</literal> compute a least square
-            solution with at at most <literal>rank(A)</literal>  nonzero components per column.
+            solution with at most <literal>rank(A)</literal> nonzero components per column.
         </para>
     </refsection>
     <refsection>
index 93222c1..e0e7d96 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="lsq">
+<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="lsq">
 
     <refnamediv>
 
         <refname>lsq</refname>
 
-        <refpurpose>線形最小二乗問題.  </refpurpose>
+        <refpurpose>norm(X)が最小の A*X=B の線形最小二乗解</refpurpose>
 
     </refnamediv>
 
 
         <title>呼び出し手順</title>
 
-        <synopsis>X=lsq(A,B [,tol])</synopsis>
+        <synopsis>
+            X = lsq(A, B)
+            X = lsq(A, B, tol)
+        </synopsis>
 
     </refsynopsisdiv>
 
index f771ae2..f5df322 100644 (file)
  * along with this program.
  *
  -->
-<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns: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="lsq" xml:lang="pt">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml"
+          xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
+          xmlns:scilab="http://www.scilab.org" xml:id="lsq" xml:lang="pt">
     <refnamediv>
         <refname>lsq</refname>
-        <refpurpose>problemas de mínimos quadrados lineares</refpurpose>
+        <refpurpose>
+            Solução de A*X=B de mínimos quadrados lineares, com norm(X) mínima
+        </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title> Seqüência de Chamamento </title>
-        <synopsis>X=lsq(A,B [,tol])</synopsis>
+        <synopsis>
+            X = lsq(A, B)
+            X = lsq(A, B, tol)
+        </synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Parâmetros</title>
diff --git a/scilab/modules/linear_algebra/help/ru_RU/linear/lsq.xml b/scilab/modules/linear_algebra/help/ru_RU/linear/lsq.xml
new file mode 100644 (file)
index 0000000..b3d2609
--- /dev/null
@@ -0,0 +1,127 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2008 - INRIA
+ *
+ * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ *
+ * This file is hereby licensed under the terms of the GNU GPL v2.0,
+ * pursuant to article 5.3.4 of the CeCILL v.2.1.
+ * This file was originally licensed under the terms of the CeCILL v2.1,
+ * and continues to be available under such terms.
+ * For more information, see the COPYING file which you should have received
+ * along with this program.
+ *
+ -->
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
+          xml:lang="ru" xml:id="lsq">
+    <refnamediv>
+        <refname>lsq</refname>
+        <refpurpose>
+            линейное решение наименьших квадратов A*X=B с минимальной norm(X)
+        </refpurpose>
+    </refnamediv>
+    <refsynopsisdiv>
+        <title>Синтаксис</title>
+        <synopsis>
+            X = lsq(A, B)
+            X = lsq(A, B, tol)
+        </synopsis>
+    </refsynopsisdiv>
+    <refsection>
+        <title>Аргументы</title>
+        <variablelist>
+            <varlistentry>
+                <term>A</term>
+                <listitem>
+                    <para>вещественная или комплексная матрица (m x n)</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>B</term>
+                <listitem>
+                    <para>вещественная или комплексная матрица (m x p)</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>tol</term>
+                <listitem>
+                    <para>
+                        положительный скаляр, используемый для определения действительного ранга
+                        <varname>A</varname> (определяемого как порядок наибольшей главной
+                        треугольной подматрицы <literal>R11</literal> в QR-разложении с выбором
+                        ведущего элемента <varname>A</varname>, чьё оцененое число
+                        обусловленности &lt;= 1/tol. Значение <varname>tol</varname> по
+                        умолчанию устанавливается равным <literal>sqrt(%eps)</literal>.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>X</term>
+                <listitem>
+                    <para>вещественная или комплексная матрица (n x p)</para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    <refsection>
+        <title>Описание</title>
+        <para>
+            <literal>X=lsq(A,B)</literal> вычисляет решение наименьших квадратов с минимальной
+            нормой уравнения <literal>A*X=B</literal>, при этом <literal>X = A \ B</literal>
+            вычисляет решение наименьших квадратов с ненулевыми компонентами не более
+            <literal>rank(A)</literal> на столбец.
+        </para>
+    </refsection>
+    <refsection>
+        <title>Сcылки</title>
+        <para>
+            Функция <literal>lsq</literal> основана на функциях LApack DGELSY для
+            вещественных матриц и ZGELSY для комплексных матриц.
+        </para>
+    </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+//Build the data
+x=(1:10)';
+
+y1=3*x+4.5+3*rand(x,'normal');
+y2=1.8*x+0.5+2*rand(x,'normal');
+plot2d(x,[y1,y2],[-2,-3])
+//Find the linear regression
+A=[x,ones(x)];B=[y1,y2];
+X=lsq(A,B);
+
+y1e=X(1,1)*x+X(2,1);
+y2e=X(1,2)*x+X(2,2);
+plot2d(x,[y1e,y2e],[2,3])
+
+// Разница между lsq(A,b) и A\b
+A=rand(4,2)*rand(2,3);//ранг матрицы 2
+b=rand(4,1);
+X1=lsq(A,b)
+X2=A\b
+[A*X1-b, A*X2-b] //остатки от деления одинаковы
+ ]]></programlisting>
+    </refsection>
+    <refsection role="see also">
+        <title>Смотрите также</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="backslash">обратная косая черта</link>
+            </member>
+            <member>
+                <link linkend="inv">inv</link>
+            </member>
+            <member>
+                <link linkend="pinv">pinv</link>
+            </member>
+            <member>
+                <link linkend="rank">rank</link>
+            </member>
+        </simplelist>
+    </refsection>
+</refentry>
index b2764dc..c9c893d 100644 (file)
@@ -53,7 +53,7 @@
         <para>
             Calculates the convolution <literal>y= h*x</literal> of two discrete
             sequences by using the fft. The convolution is defined as follows:
-            <latex style="display" alt="y_k = sum_j( h_j * x_{k+1-k} )">
+            <latex style="display" alt="y_k = sum_j( h_j * x_{k+1-j} )">
                 y_k \,= \sum_j h_j \; x_{k+1-j}
             </latex>
         </para>
index b26f664..6e2be69 100644 (file)
         </para>
         <para>
             The cross-spectrum of two signal <varname>x</varname> and <varname>y</varname> is defined to be
-            <latex style="display"
-                alt="S_xy(ω) = (∑{n=0…N-1} x(n) exp(-i ω n)).
-                               (∑{n=0…N-1} y'(n) exp(i ω n)) / N">
+            <latex style="display" alt="S_xy(ω) = (∑{n=0…N-1} x(n) exp(-iωn)) . (∑{n=0…N-1} y'(n) exp(iωn)) / N">
                 S_{xy} (\omega) = {1 \over N}
                 \left(\sum_{n=0}^{N-1} x(n)\,e^{-i \omega n}\right)
                 \left( \sum_{n=0}^{N-1} \bar{y}(n)\,e^{i \omega n} \right)
index 64c3163..09439d9 100644 (file)
         <para>
             The cross spectrum of two signal <varname>x</varname> and  <varname>y</varname>
             is defined as
-            <latex style="display"
-                alt="S_xy(ω) = (∑{n=0…N-1} x(n) exp(-i ω n)).
-                               (∑{n=0…N-1} y'(n) exp(i ω n)) / N">
+            <latex alt="S_xy(ω) = (∑{n=0…N-1} x(n) exp(-iωn)) . (∑{n=0…N-1} y'(n) exp(iωn)) / N" style="display">
                 S_{xy} (\omega) = {1 \over N}
                 \left(\sum_{n=0}^{N-1} x(n)\,e^{-i \omega n}\right)
                 \left( \sum_{n=0}^{N-1} \bar{y}(n)\,e^{i \omega n} \right)
index d276341..ec5bc12 100644 (file)
@@ -55,7 +55,7 @@
             fftを用いて2つの離散シーケンスの畳込み <literal>y= h*x</literal>
             を計算します.
             畳込みは以下のように定義されます:
-            <latex style="display" alt="y_k = sum_j( h_j * x_{k+1-k} )">
+            <latex style="display" alt="y_k = sum_j( h_j * x_{k+1-j} )">
                 y_k \,= \sum_j h_j \; x_{k+1-j}
             </latex>
         </para>
index 9ae45fe..eaab48f 100644 (file)
             信号の相互スペクトル,そうでない場合は <literal>x</literal>を計算します.
             スペクトル密度は相関法により得られます.
             <latex style="display"
-                alt="S_xy(ω) = (∑{n=0…N-1} x(n) exp(-i ω n)).
-                               (∑{n=0…N-1} y'(n) exp(i ω n)) / N">
+                alt="S_xy(ω) = (∑{n=0…N-1} x(n) exp(-iωn)) . (∑{n=0…N-1} y'(n) exp(iωn)) / N">
                 S_{xy} (\omega) = {1 \over N}
                 \left(\sum_{n=0}^{N-1} x(n)\,e^{-i \omega n}\right)
                 \left( \sum_{n=0}^{N-1} \bar{y}(n)\,e^{i \omega n} \right)
index ac8eef2..e945ab9 100644 (file)
             2つの信号<literal>x</literal> および  <literal>y</literal>の
             相互スペクトルは以下のように定義されます
             <latex style="display"
-                alt="S_xy(ω) = (∑{n=0…N-1} x(n) exp(-i ω n)).
-                               (∑{n=0…N-1} y'(n) exp(i ω n)) / N">
+                alt="S_xy(ω) = (∑{n=0…N-1} x(n) exp(-iωn)) . (∑{n=0…N-1} y'(n) exp(iωn)) / N">
                 S_{xy} (\omega) = {1 \over N}
                 \left(\sum_{n=0}^{N-1} x(n)\,e^{-i \omega n}\right)
                 \left( \sum_{n=0}^{N-1} \bar{y}(n)\,e^{i \omega n} \right)
index 01a78f1..0e653f4 100644 (file)
@@ -1,5 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns3="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="convol" xml:lang="ru">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns3="http://www.w3.org/1999/xhtml"
+          xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
+          xmlns:scilab="http://www.scilab.org" xml:id="convol" xml:lang="ru">
     <refnamediv>
         <refname>convol</refname>
         <refpurpose>Свёртка</refpurpose>
@@ -58,7 +61,7 @@
             Вычисляет свёртку <literal>y= h*x</literal> двух дискретных
             последовательностей с помощю БПФ (fft). Свёртка определяется следующим
             образом:
-            <latex style="display" alt="y_k = sum_j( h_j * x_{k+1-k} )">
+            <latex alt="y_k = sum_j( h_j * x_{k+1-j} )" style="display">
                 y_k \,= \sum_j h_j \; x_{k+1-j}
             </latex>
         </para>
index 1b74a2b..9c3ca28 100644 (file)
             Кросс-спектр двух сигналов <varname>x</varname> и  <varname>y</varname>
             определяется как
             <latex style="display"
-                alt="S_xy(ω) = (∑{n=0…N-1} x(n) exp(-i ω n)).
-                               (∑{n=0…N-1} y'(n) exp(i ω n)) / N">
+                alt="S_xy(ω) = (∑{n=0…N-1} x(n) exp(-iωn)) . (∑{n=0…N-1} y'(n) exp(iωn)) / N">
                 S_{xy} (\omega) = {1 \over N}
                 \left(\sum_{n=0}^{N-1} x(n)\,e^{-i \omega n}\right)
                 \left( \sum_{n=0}^{N-1} \bar{y}(n)\,e^{i \omega n} \right)
index d47a98a..072a6ad 100644 (file)
             Кросс-спектр двух сигналов <varname>x</varname> и  <varname>y</varname>
             определяется как
             <latex style="display"
-                alt="S_xy(ω) = (∑{n=0…N-1} x(n) exp(-i ω n)).
-                               (∑{n=0…N-1} y'(n) exp(i ω n)) / N">
+                alt="S_xy(ω) = (∑{n=0…N-1} x(n) exp(-iωn)) . (∑{n=0…N-1} y'(n) exp(iωn)) / N">
                 S_{xy} (\omega) = {1 \over N}
                 \left(\sum_{n=0}^{N-1} x(n)\,e^{-i \omega n}\right)
                 \left( \sum_{n=0}^{N-1} \bar{y}(n)\,e^{i \omega n} \right)
index 20528f3..d344cff 100644 (file)
@@ -2,8 +2,8 @@
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) 2008 - INRIA
- *
  * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ * Copyright (C) 2020 - Samuel GOUGEON
  *
  * This file is hereby licensed under the terms of the GNU GPL v2.0,
  * pursuant to article 5.3.4 of the CeCILL v.2.1.
  * along with this program.
  *
  -->
-<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns: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="dawson" xml:lang="en">
+<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="dawson" xml:lang="en">
     <refnamediv>
         <refname>dawson</refname>
         <refpurpose>Compute the Dawson (scaled imaginary error) function.</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Syntax</title>
-        <synopsis>y = dawson(x)</synopsis>
+        <synopsis>y = dawson(z)</synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Arguments</title>
         <variablelist>
             <varlistentry>
-                <term>x</term>
+                <term>z</term>
                 <listitem>
-                    <para>vector or matrix</para>
+                    vector or matrix of real or complex numbers
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>y</term>
                 <listitem>
-                    <para>vector or matrix (of same size than x)</para>
+                    vector or matrix of real or complex numbers (of same size than x).
                 </listitem>
             </varlistentry>
         </variablelist>
     <refsection>
         <title>Description</title>
         <para>
-            <literal>dawson</literal> computes scaled imaginary error function
-            function:
+            <literal>dawson</literal> computes the scaled imaginary error function, defined as
         </para>
         <para>
-            <latex>
+            <latex alt="Dawson(z)=exp(-z^2).erfi(z).√π /2">
                 \mathrm{Dawson}(z) = \frac{\sqrt{\pi}}{2} e^{-z^2} \mathrm{erfi}(z)
             </latex>
         </para>
     <refsection>
         <title>Examples</title>
         <programlisting role="example"><![CDATA[
-x = [0.1, 1, 1+2*%i,-1+2*%i,1e-4+2e-4*%i,0+2*%i];
-dawson(x)
-dawson(-x)
+i = %i;
+x = [0, 0.01, 1, 100, i, 2*i, 4*i, 8*i,  1-i, 1+i, 2+i, 1e-4+2e-4*i].';
+[x, dawson(x), dawson(-x)]
  ]]></programlisting>
+    <screen><![CDATA[
+--> [x, dawson(x), dawson(-x)]
+ ans  =
+   0.     + 0.i       0.        + 0.i          0.        + 0.i
+   0.01   + 0.i       0.0099993 + 0.i         -0.0099993 + 0.i
+   1.     + 0.i       0.5380795 + 0.i         -0.5380795 + 0.i
+   100.   + 0.i       0.0050003 + 0.i         -0.0050003 + 0.i
+   0.     + i         0.        + 2.0300785i   0.        - 2.0300785i
+   0.     + 2.i       0.        + 48.160012i   0.        - 48.160012i
+   0.     + 4.i       0.        + 7875110.3i   0.        - 7875110.3i
+   0.     + 8.i       0.        + 5.526D+27i   0.        - 5.526D+27i
+   1.     - i         0.9903731 + 0.6388731i  -0.9903731 - 0.6388731i
+   1.     + i         0.9903731 - 0.6388731i  -0.9903731 + 0.6388731i
+   2.     + i         0.1635394 - 0.1531246i  -0.1635394 + 0.1531246i
+   0.0001 + 0.0002i   0.0001    + 0.0002i     -0.0001    - 0.0002i
+]]></screen>
+        <para/>
+        <programlisting role="example"><![CDATA[
+clf
+subplot(1,2,1)
+x = logspace(-20,20,100);
+y = dawson(x);         // the imaginary part is zero
+plot("ll", x, y)
+xlabel x fontsize 3
+title dawson(x) fontsize 3.5
+xgrid(color("grey60"))
+
+subplot(1,2,2)
+x = logspace(-7,1,100);
+y = imag(dawson(x*%i)); // the real part is zero
+plot("ll", x, y)
+xlabel x fontsize 3
+title imag(dawson(x.i)) fontsize 3.5
+xgrid(color("grey60"))
+     ]]></programlisting>
+        <scilab:image>
+            clf
+            subplot(1,2,1)
+            x = logspace(-20,20,100);
+            y = dawson(x);         // the imaginary part is zero
+            plot("ll", x, y)
+            xlabel x fontsize 3
+            title dawson(x) fontsize 3.5
+            xgrid(color("grey60"))
+
+            subplot(1,2,2)
+            x = logspace(-7,1,100);
+            y = imag(dawson(x*%i)); // the real part is zero
+            plot("ll", x, y)
+            xlabel x fontsize 3
+            title imag(dawson(x.i)) fontsize 3.5
+            xgrid(color("grey60"))
+
+            gcf().axes_size = [700 380];
+        </scilab:image>
     </refsection>
     <refsection>
         <title>Algorithms</title>
index 1bccbe1..a66b02a 100644 (file)
@@ -2,8 +2,8 @@
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) 2008 - INRIA
- *
  * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ * Copyright (C) 2020 - Samuel GOUGEON
  *
  * This file is hereby licensed under the terms of the GNU GPL v2.0,
  * pursuant to article 5.3.4 of the CeCILL v.2.1.
  * along with this program.
  *
  -->
-<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns: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="dawson" xml:lang="ja">
+<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="dawson" xml:lang="ja">
     <refnamediv>
         <refname>dawson</refname>
         <refpurpose>Dawson (スケーリングされた虚数の誤差) 関数を計算.</refpurpose>
             <varlistentry>
                 <term>x</term>
                 <listitem>
-                    <para>ベクトルまたは行列</para>
+                    ベクトルまたは行列
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>y</term>
                 <listitem>
-                    <para>(xと同じ大きさ)ベクトルまたは行列</para>
+                    (xと同じ大きさ)ベクトルまたは行列
                 </listitem>
             </varlistentry>
         </variablelist>
@@ -45,7 +48,7 @@
             <literal>dawson</literal> はスケーリングされた虚数の誤差関数を計算します:
         </para>
         <para>
-            <latex>
+            <latex alt="Dawson(z)=exp(-z^2).erfi(z).√π /2">
                 \mathrm{Dawson}(z) = \frac{\sqrt{\pi}}{2} e^{-z^2} \mathrm{erfi}(z)
             </latex>
         </para>
     <refsection>
         <title>例</title>
         <programlisting role="example"><![CDATA[
-x = [0.1, 1, 1+2*%i,-1+2*%i,1e-4+2e-4*%i,0+2*%i];
-dawson(x)
-dawson(-x)
- ]]></programlisting>
+i = %i;
+x = [0, 0.01, 1, 100, i, 2*i, 4*i, 8*i,  1-i, 1+i, 2+i, 1e-4+2e-4*i].';
+[x, dawson(x), dawson(-x)]
+     ]]></programlisting>
+        <screen><![CDATA[
+--> [x, dawson(x), dawson(-x)]
+ ans  =
+   0.     + 0.i       0.        + 0.i          0.        + 0.i
+   0.01   + 0.i       0.0099993 + 0.i         -0.0099993 + 0.i
+   1.     + 0.i       0.5380795 + 0.i         -0.5380795 + 0.i
+   100.   + 0.i       0.0050003 + 0.i         -0.0050003 + 0.i
+   0.     + i         0.        + 2.0300785i   0.        - 2.0300785i
+   0.     + 2.i       0.        + 48.160012i   0.        - 48.160012i
+   0.     + 4.i       0.        + 7875110.3i   0.        - 7875110.3i
+   0.     + 8.i       0.        + 5.526D+27i   0.        - 5.526D+27i
+   1.     - i         0.9903731 + 0.6388731i  -0.9903731 - 0.6388731i
+   1.     + i         0.9903731 - 0.6388731i  -0.9903731 + 0.6388731i
+   2.     + i         0.1635394 - 0.1531246i  -0.1635394 + 0.1531246i
+   0.0001 + 0.0002i   0.0001    + 0.0002i     -0.0001    - 0.0002i
+]]></screen>
+        <para/>
+        <programlisting role="example"><![CDATA[
+clf
+subplot(1,2,1)
+x = logspace(-20,20,100);
+y = dawson(x);         // the imaginary part is zero
+plot("ll", x, y)
+xlabel x fontsize 3
+title dawson(x) fontsize 3.5
+xgrid(color("grey60"))
+
+subplot(1,2,2)
+x = logspace(-7,1,100);
+y = imag(dawson(x*%i)); // the real part is zero
+plot("ll", x, y)
+xlabel x fontsize 3
+title imag(dawson(x.i)) fontsize 3.5
+xgrid(color("grey60"))
+     ]]></programlisting>
+        <scilab:image>
+            clf
+            subplot(1,2,1)
+            x = logspace(-20,20,100);
+            y = dawson(x);         // the imaginary part is zero
+            plot("ll", x, y)
+            xlabel x fontsize 3
+            title dawson(x) fontsize 3.5
+            xgrid(color("grey60"))
+
+            subplot(1,2,2)
+            x = logspace(-7,1,100);
+            y = imag(dawson(x*%i)); // the real part is zero
+            plot("ll", x, y)
+            xlabel x fontsize 3
+            title imag(dawson(x.i)) fontsize 3.5
+            xgrid(color("grey60"))
+
+            gcf().axes_size = [700 380];
+        </scilab:image>
     </refsection>
     <refsection>
         <title>アルゴリズム</title>
diff --git a/scilab/modules/special_functions/help/ru_RU/dawson.xml b/scilab/modules/special_functions/help/ru_RU/dawson.xml
new file mode 100644 (file)
index 0000000..c6ac218
--- /dev/null
@@ -0,0 +1,148 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2008 - INRIA
+ * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ * Copyright (C) 2020 - Samuel GOUGEON
+ *
+ * This file is hereby licensed under the terms of the GNU GPL v2.0,
+ * pursuant to article 5.3.4 of the CeCILL v.2.1.
+ * This file was originally licensed under the terms of the CeCILL v2.1,
+ * and continues to be available under such terms.
+ * For more information, see the COPYING file which you should have received
+ * along with this program.
+ *
+ -->
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns: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="dawson" xml:lang="ru">
+    <refnamediv>
+        <refname>dawson</refname>
+        <refpurpose>Вычислить функцию Доусона (масштабированная мнимая часть ошибки).</refpurpose>
+    </refnamediv>
+    <refsynopsisdiv>
+        <title>Синтаксис</title>
+        <synopsis>y = dawson(z)</synopsis>
+    </refsynopsisdiv>
+    <refsection>
+        <title>Аргументы</title>
+        <variablelist>
+            <varlistentry>
+                <term>z</term>
+                <listitem>
+                    вектор или матрица вещественных или комплексных чисел
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>y</term>
+                <listitem>
+                    вектор или матрица вещественных или комплексных чисел (того же размера, что и <varname>x</varname>).
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    <refsection>
+        <title>Описание</title>
+        <para>
+            <literal>dawson</literal> вычисляет масштабированную мнимую часть функции ошибки определённую как
+        </para>
+        <para>
+            <latex alt="Dawson(z)=exp(-z^2).erfi(z).√π /2">
+                \mathrm{Dawson}(z) = \frac{\sqrt{\pi}}{2} e^{-z^2} \mathrm{erfi}(z)
+            </latex>
+        </para>
+    </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+i = %i;
+x = [0, 0.01, 1, 100, i, 2*i, 4*i, 8*i,  1-i, 1+i, 2+i, 1e-4+2e-4*i].';
+[x, dawson(x), dawson(-x)]
+ ]]></programlisting>
+    <screen><![CDATA[
+--> [x, dawson(x), dawson(-x)]
+ ans  =
+   0.     + 0.i       0.        + 0.i          0.        + 0.i
+   0.01   + 0.i       0.0099993 + 0.i         -0.0099993 + 0.i
+   1.     + 0.i       0.5380795 + 0.i         -0.5380795 + 0.i
+   100.   + 0.i       0.0050003 + 0.i         -0.0050003 + 0.i
+   0.     + i         0.        + 2.0300785i   0.        - 2.0300785i
+   0.     + 2.i       0.        + 48.160012i   0.        - 48.160012i
+   0.     + 4.i       0.        + 7875110.3i   0.        - 7875110.3i
+   0.     + 8.i       0.        + 5.526D+27i   0.        - 5.526D+27i
+   1.     - i         0.9903731 + 0.6388731i  -0.9903731 - 0.6388731i
+   1.     + i         0.9903731 - 0.6388731i  -0.9903731 + 0.6388731i
+   2.     + i         0.1635394 - 0.1531246i  -0.1635394 + 0.1531246i
+   0.0001 + 0.0002i   0.0001    + 0.0002i     -0.0001    - 0.0002i
+]]></screen>
+        <para/>
+        <programlisting role="example"><![CDATA[
+clf
+subplot(1,2,1)
+x = logspace(-20,20,100);
+y = dawson(x);         // мнимая часть равна нулю
+plot("ll", x, y)
+xlabel x fontsize 3
+title dawson(x) fontsize 3.5
+xgrid(color("grey60"))
+
+subplot(1,2,2)
+x = logspace(-7,1,100);
+y = imag(dawson(x*%i)); // вещественная часть равна нулю
+plot("ll", x, y)
+xlabel x fontsize 3
+title imag(dawson(x.i)) fontsize 3.5
+xgrid(color("grey60"))
+     ]]></programlisting>
+        <scilab:image>
+            clf
+            subplot(1,2,1)
+            x = logspace(-20,20,100);
+            y = dawson(x);         // the imaginary part is zero
+            plot("ll", x, y)
+            xlabel x fontsize 3
+            title dawson(x) fontsize 3.5
+            xgrid(color("grey60"))
+
+            subplot(1,2,2)
+            x = logspace(-7,1,100);
+            y = imag(dawson(x*%i)); // the real part is zero
+            plot("ll", x, y)
+            xlabel x fontsize 3
+            title imag(dawson(x.i)) fontsize 3.5
+            xgrid(color("grey60"))
+
+            gcf().axes_size = [700 380];
+        </scilab:image>
+    </refsection>
+    <refsection>
+        <title>Алгоритмы</title>
+        <para>
+            Эта функция основана на библиотеке <ulink url="http://ab-initio.mit.edu/Faddeeva">пакета Фаддеевой</ulink> library.
+        </para>
+    </refsection>
+    <refsection role="see also">
+        <title>Смотрите также</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="erf">erf</link>
+            </member>
+            <member>
+                <link linkend="erfc">erfc</link>
+            </member>
+            <member>
+                <link linkend="calerf">calerf</link>
+            </member>
+        </simplelist>
+    </refsection>
+    <refsection>
+        <title>История</title>
+        <revhistory>
+            <revision>
+                <revnumber>5.5.0</revnumber>
+                <revremark>Введена функция Доусона</revremark>
+            </revision>
+        </revhistory>
+    </refsection>
+</refentry>
index 40e6442..889cae8 100644 (file)
@@ -20,7 +20,7 @@
           xmlns:scilab="http://www.scilab.org" xml:id="xmlGetValues" xml:lang="en">
     <refnamediv>
         <refname>xmlGetValues</refname>
-        <refpurpose>Parses and gets values of chosen tags attributes in a XML file of preferences</refpurpose>
+        <refpurpose>Parses and gets values of chosen tags attributes in a XML file</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Syntax</title>
index b567e25..62ad034 100644 (file)
@@ -19,7 +19,7 @@
           xmlns:scilab="http://www.scilab.org" xml:id="xmlGetValues" xml:lang="ja">
     <refnamediv>
         <refname>xmlGetValues</refname>
-        <refpurpose>設定値を取得</refpurpose>
+        <refpurpose>XMLファイルで選択されたタグ属性の値を解析して取得する</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>呼び出し手順</title>