scilab/modules/polynomials/help/en_US/rational.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <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="rational">
   3     <refnamediv>
   4         <refname>rational</refname>
   5         <refpurpose>Scilab objects, rational in Scilab</refpurpose>
   6     </refnamediv>
   7     <refsection>
   8         <title>Description</title>
   9         <para>
  10             A rational <literal>r</literal> is a quotient of two polynomials <literal>r=num/den</literal>.
  11             The internal representation of a rational is a list.
  12             <literal>r=tlist(['r','num','den','dt'],num,den,[])</literal> is the same as <literal>r=num/den</literal>.
  13             A rational matrix can be defined with the usual syntax
  14             e.g. <literal>[r11,r12;r21,r22]</literal> is a 2x2 matrix where <literal>rij</literal> are
  15             1x1 rationals.
  16             A rational matrix can also be defined as above as a list
  17             <literal>rlist(num,den,[])</literal> with <literal>num</literal> and <literal>den</literal> polynomial matrices.
  18         </para>
  19     </refsection>
  20     <refsection>
  21         <title>Examples</title>
  22         <programlisting role="example"><![CDATA[
  23 s=poly(0,'s');
  24 W=[1/s,1/(s+1)]
  25 W'*W
  26 Num=[s,s+2;1,s];Den=[s*s,s;s,s*s];
  27 rlist(Num,Den,[])
  28 H=Num./Den
  29 syslin('c',Num,Den)
  30 syslin('c',H)
  31 [Num1,Den1]=simp(Num,Den)
  32  ]]></programlisting>
  33     </refsection>
  34     <refsection role="see also">
  35         <title>See Also</title>
  36         <simplelist type="inline">
  37             <member>
  38                 <link linkend="poly">poly</link>
  39             </member>
  40             <member>
  41                 <link linkend="syslin">syslin</link>
  42             </member>
  43             <member>
  44                 <link linkend="simp">simp</link>
  45             </member>
  46         </simplelist>
  47     </refsection>
  48 </refentry>