help format: (fr) added
[scilab.git] / scilab / modules / linear_algebra / help / pt_BR / eigen / gschur.xml
1 <?xml version="1.0" encoding="ISO-8859-1"?>
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="gschur" xml:lang="en">
17     <refnamediv>
18         <refname>gschur</refname>
19         <refpurpose>forma de Schur generalizada (função obsoleta) </refpurpose>
20     </refnamediv>
21     <refsynopsisdiv>
22         <title> Seqüência de Chamamento</title>
23         <synopsis>[As,Es]=gschur(A,E)
24             [As,Es,Q,Z]=gschur(A,E)
25             [As,Es,Z,dim] = gschur(A,E,flag)
26             [As,Es,Z,dim]= gschur(A,E,extern)
27         </synopsis>
28     </refsynopsisdiv>
29     <refsection>
30         <title>Descrição</title>
31         <para>Esta função é obsoleta e agora está inclusa na função
32             <literal>schur</literal> function. Na maior parte dos casos, a função
33             <literal>gschur</literal> irá ainda trabalhar como antes, mas será
34             removida em um lançamento futuro do Scilab.
35         </para>
36         <para>As três sintaxes podem ser substituídas por</para>
37         <programlisting role=""><![CDATA[ 
38 [As,Es]=schur(A,E)
39 [As,Es,Q,Z]=schur(A,E);Q=Q' //NOTE A TRANSPOSIÇÃO AQUI
40 [As,Es,Z,dim] = schur(A,E,flag) 
41  ]]></programlisting>
42         <para>A última sintaxe requer algumas adaptações a mais: </para>
43         <variablelist>
44             <varlistentry>
45                 <term>if</term>
46                 <listitem>
47                     <para>é uma função do Scilab, a nova seqüência de chamamento deve
48                         ser <literal>[As,Es,Z,dim]= schur(A,E,Nextern)</literal> com Nextern
49                         definido como segue:
50                     </para>
51                     <programlisting role=""><![CDATA[ 
52 function t=Nextern(R)
53 if R(2)==0 then
54   t=extern([1,R(1),R(3)])==1
55 else
56   c=(R(1)+%i*R(2))/R(3)
57   t=extern([2,real(c+c'),real(c*c')])==1
58 end
59 endfunction
60  ]]></programlisting>
61                 </listitem>
62             </varlistentry>
63             <varlistentry>
64                 <term>if</term>
65                 <listitem>
66                     <para>é o nome de uma função externa codificada em FORTRAN ou C, a
67                         nova seqüência de chamamento deve ser <literal>[As,Es,Z,dim]=
68                             schur(A,E,'nextern')
69                         </literal>
70                         com nextern definido como
71                         segue:
72                     </para>
73                 </listitem>
74             </varlistentry>
75         </variablelist>
76         <programlisting role=""><![CDATA[ 
77 logical function nextern(ar,ai,beta)
78 double precision ar,ai,beta
79 integer r,extern
80 if (ai.eq.0.0d0) then
81   r=extern(1,ar,beta,0.0d0,0.0d0)
82 else
83   r=extern(2,0.0d0,0.0d0,2.0d0*ar,ar*ar+ai*ai)
84 endif
85 nextern=r.eq.1
86 end
87  ]]></programlisting>
88     </refsection>
89     <refsection>
90         <title> Ver Também</title>
91         <simplelist type="inline">
92             <member>
93                 <link linkend="external">external</link>
94             </member>
95             <member>
96                 <link linkend="schur">schur</link>
97             </member>
98         </simplelist>
99     </refsection>
100 </refentry>