Translation of help page for numdiff into Russian. 12/9112/1
Stanislav KROTER [Mon, 24 Sep 2012 00:28:01 +0000 (06:28 +0600)]
Change-Id: Ie62b2d62f4f4c59b1627645bc1fdab256daa9a4e

scilab/modules/differential_equations/help/ru_RU/numdiff.xml [new file with mode: 0644]

diff --git a/scilab/modules/differential_equations/help/ru_RU/numdiff.xml b/scilab/modules/differential_equations/help/ru_RU/numdiff.xml
new file mode 100644 (file)
index 0000000..94d2ddb
--- /dev/null
@@ -0,0 +1,126 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2008 - INRIA
+ * 
+ * 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-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="numdiff" xml:lang="ru">
+    <refnamediv>
+        <refname>numdiff</refname>
+        <refpurpose>числовая оценка градиента</refpurpose>
+    </refnamediv>
+    <refsynopsisdiv>
+        <title>Последовательность вызова</title>
+        <synopsis>g = numdiff(fun, x [,dx])</synopsis>
+    </refsynopsisdiv>
+    <refsection>
+        <title>Аргументы</title>
+        <variablelist>
+            <varlistentry>
+                <term>fun</term>
+                <listitem>
+                    <para>
+                      внешняя функция или подпрограмма, функция Scilab'а или список. См.
+                      ниже последовательность вызова, см. также <link linkend="external">external</link> о подробностях о внешних
+                      функциях.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>x</term>
+                <listitem>
+                    <para>вектор, аргумент функции <varname>fun</varname>.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>dx</term>
+                <listitem>
+                    <para>
+                      вектор, шаг конечной разности. Значение по умолчанию равно
+                      <code>dx=sqrt(%eps)*(1+1d-3*abs(x))</code>.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>g</term>
+                <listitem>
+                    <para>вектор, оцененный градиент</para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    <refsection>
+        <title>Описание</title>
+        <para>
+            Заданная функция <code>fun(x)</code> от
+            <code>R^n</code> до <code>R^p</code> вычисляет такую матрицу
+            <varname>g</varname>, что
+        </para>
+        <programlisting role="no-scilab-exec"><![CDATA[
+g(i,j) = (df_i)/(dx_j)
+ ]]></programlisting>
+        <para>
+          используя методы конечной разницы. Использует формулу порядка 1.
+        </para>
+        <para>
+          Без параметров функция последовательность вызова <varname>fun</varname>
+          <code>y=fun(x)</code>, и <function>numdiff</function> может быть вызвана в виде
+          <code>g=numdiff(fun,x)</code>. Иначе последовательность вызова <varname>fun</varname>
+          должна быть <literal>y = fun(x, param_1, pararm_2, ..., param_q)</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>
+        <para>
+            См. <link linkend="derivative">derivative</link> относительно проблем числовой точности и сравнение между двумя алгоритмами.
+        </para>
+    </refsection>
+    <refsection>
+        <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
+x=[5 8]
+g=numdiff(myfun,x)
+// Точный градиент (т. е. производная принадлежит x(1): первый элемент
+// и производная принадлежит x(2): второй элемент) равен
+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)
+// Точный градиент, то есть производная принадлежит x(1), равен:
+exact2=c*(x+a)^(c-1)
+ ]]></programlisting>
+    </refsection>
+    <refsection role="see also">
+        <title>Смотрите также</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="optim">optim</link>
+            </member>
+            <member>
+                <link linkend="derivative">derivative</link>
+            </member>
+            <member>
+                <link linkend="external">external</link>
+            </member>
+        </simplelist>
+    </refsection>
+</refentry>