[doc] misc. patchs & small improvements
[scilab.git] / scilab / modules / elementary_functions / help / ru_RU / discrete / rat.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) 2008 - INRIA
5  *
6  * Copyright (C) 2012 - 2016 - Scilab Enterprises
7  *
8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
10  * This file was originally licensed under the terms of the CeCILL v2.1,
11  * and continues to be available under such terms.
12  * For more information, see the COPYING file which you should have received
13  * along with this program.
14  *
15  -->
16 <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="rat" xml:lang="ru">
17     <refnamediv>
18         <refname>rat</refname>
19         <refpurpose>Приближение рациональными числами с плавающей запятой</refpurpose>
20     </refnamediv>
21     <refsynopsisdiv>
22         <title>Синтаксис</title>
23         <synopsis>[N,D]=rat(X [,tol])
24             Y=rat(X [,tol])
25         </synopsis>
26     </refsynopsisdiv>
27     <refsection>
28         <title>Аргументы</title>
29         <variablelist>
30             <varlistentry>
31                 <term>X</term>
32                 <listitem>
33                     <para>вещественный вектор или матрица</para>
34                 </listitem>
35             </varlistentry>
36             <varlistentry>
37                 <term>tol</term>
38                 <listitem>
39                     <para>вещественный положительный скаляр, допуск (см. ниже). Значение по умолчанию 1d-6.</para>
40                 </listitem>
41             </varlistentry>
42             <varlistentry>
43                 <term>N</term>
44                 <listitem>
45                     <para>вектор или матрица целочисленных значений</para>
46                 </listitem>
47             </varlistentry>
48             <varlistentry>
49                 <term>D</term>
50                 <listitem>
51                     <para>вектор или матрица целочисленных значений</para>
52                 </listitem>
53             </varlistentry>
54             <varlistentry>
55                 <term>Y</term>
56                 <listitem>
57                     <para>вектор или матрица вещественных значений</para>
58                 </listitem>
59             </varlistentry>
60         </variablelist>
61     </refsection>
62     <refsection>
63         <title>Описание</title>
64         <para>
65             <literal>[N,D] = rat(X,tol)</literal> возвращает две матрицы целочисленных значений, такие, что отношение <literal>N./D</literal> близко к <literal>X</literal> в том смысле, что <literal>abs(N./D - X) &lt;= tol*norm(X,1)*abs(X)</literal>.
66         </para>
67         <para>
68             <literal>y=rat(x,tol)</literal> возвращает частное <literal>N./D</literal>
69         </para>
70         <para>
71             Рациональные приближения формируются отсечением разложения в бесконечную цепную дробь.
72         </para>
73     </refsection>
74     <refsection>
75         <title>Примеры</title>
76         <programlisting role="example"><![CDATA[
77 [n,d]=rat([3.5, 1.333333,-0.8])
78 [n,d]=rat(%pi)
79 [n,d]=rat(%pi,1.d-12)
80 n/d-%pi
81  ]]></programlisting>
82     </refsection>
83     <refsection role="see also">
84         <title>Смотрите также</title>
85         <simplelist type="inline">
86             <member>
87                 <link linkend="int">int</link>
88             </member>
89             <member>
90                 <link linkend="round">round</link>
91             </member>
92         </simplelist>
93     </refsection>
94 </refentry>