13
13
<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" version="5.0-subset Scilab" xml:id="rat" xml:lang="en">
15
<refname>rat</refname>
16
<refpurpose>Floating point rational approximation</refpurpose>
19
<title>Calling Sequence</title>
20
<synopsis>[N,D]=rat(X [,tol])
25
<title>Arguments</title>
30
<para>real vector or matrix</para>
36
<para>real positive scalar, the tolerance (see below). Default value is 1d-6.</para>
42
<para>integer vector or matrix</para>
48
<para>integer vector or matrix</para>
54
<para>real vector or matrix</para>
60
<title>Description</title>
62
<literal>[N,D] = rat(X,tol)</literal> returns two integer matrices
63
so that <literal>N./D</literal> is close to<literal>X</literal> in the
64
sense that <literal>abs(N./D - X) <= tol*norm(X,1)*abs(X)</literal>.
67
<literal>y=rat(x,tol)</literal> return the quotient
68
<literal>N./D</literal>
71
The rational approximations are generated by truncating
72
continued fraction expansions.
76
<title>Examples</title>
77
<programlisting role="example"><![CDATA[
15
<refname>rat</refname>
16
<refpurpose>Floating point rational approximation</refpurpose>
19
<title>Calling Sequence</title>
20
<synopsis>[N,D]=rat(X [,tol])
25
<title>Arguments</title>
30
<para>real vector or matrix</para>
36
<para>real positive scalar, the tolerance (see below). Default value is 1d-6.</para>
42
<para>integer vector or matrix</para>
48
<para>integer vector or matrix</para>
54
<para>real vector or matrix</para>
60
<title>Description</title>
62
<literal>[N,D] = rat(X,tol)</literal> returns two integer matrices
63
so that <literal>N./D</literal> is close to<literal>X</literal> in the
64
sense that <literal>abs(N./D - X) <= tol*norm(X,1)*abs(X)</literal>.
67
<literal>y=rat(x,tol)</literal> return the quotient
68
<literal>N./D</literal>
71
The rational approximations are generated by truncating
72
continued fraction expansions.
76
<title>Examples</title>
77
<programlisting role="example"><![CDATA[
78
78
[n,d]=rat([3.5, 1.333333,-0.8])
80
80
[n,d]=rat(%pi,1.d-12)
82
82
]]></programlisting>
84
<refsection role="see also">
85
<title>See Also</title>
86
<simplelist type="inline">
88
<link linkend="int">int</link>
91
<link linkend="round">round</link>
84
<refsection role="see also">
85
<title>See Also</title>
86
<simplelist type="inline">
88
<link linkend="int">int</link>
91
<link linkend="round">round</link>