76b5b600b3146cd5fbb748097e2a449e4126c62e
[scilab.git] / scilab / modules / linear_algebra / help / ja_JP / eigen / gschur.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  * This file must be used under the terms of the CeCILL.
7  * This source file is licensed as described in the file COPYING, which
8  * you should have received as part of this distribution.  The terms
9  * are also available at    
10  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
11  *
12  -->
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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="gschur">
14     <refnamediv>
15         <refname>gschur</refname>
16         <refpurpose>一般化Schur分解 (古い関数).  </refpurpose>
17     </refnamediv>
18     <refsynopsisdiv>
19         <title>呼び出し手順</title>
20         <synopsis>[As,Es]=gschur(A,E)
21             [As,Es,Q,Z]=gschur(A,E)
22             [As,Es,Z,dim] = gschur(A,E,flag)
23             [As,Es,Z,dim]= gschur(A,E,extern)
24         </synopsis>
25     </refsynopsisdiv>
26     <refsection>
27         <title>説明</title>
28         <para>
29             この関数は古い関数であり,  <literal>schur</literal>関数に統合されています.
30             多くの場合, <literal>gschur</literal>関数は以前と同様に動作しますが,
31             将来のリリースでは削除される予定です.
32         </para>
33         <para>
34             最初の3つの構文は以下のように置き換えることができます
35         </para>
36         <programlisting role=""><![CDATA[ 
37 [As,Es]=schur(A,E)
38 [As,Es,Q,Z]=schur(A,E);Q=Q' //NOTE THE TRANPOSITION HERE
39 [As,Es,Z,dim] = schur(A,E,flag) 
40  ]]></programlisting>
41         <para>
42             最後の構文はさらに若干の調整が必要です:
43         </para>
44         <variablelist>
45             <varlistentry>
46                 <term>もし,</term>
47                 <listitem>
48                     <para>extern が Scilab関数の場合,
49                         新しい呼び出し手順は, Nextern を以下のように定義するとき,
50                         <literal>[As,Es,Z,dim]= schur(A,E,Nextern)</literal>
51                         となります:
52                     </para>
53                     <programlisting role=""><![CDATA[ 
54 function t=Nextern(R)
55 if R(2)==0 then
56   t=extern([1,R(1),R(3)])==1
57 else
58   c=(R(1)+%i*R(2))/R(3)
59   t=extern([2,real(c+c'),real(c*c')])==1
60 end
61 endfunction
62  ]]></programlisting>
63                 </listitem>
64             </varlistentry>
65             <varlistentry>
66                 <term>if</term>
67                 <listitem>
68                     <para>extern は,Fortran または Cで記述された外部関数の名前です.
69                         新しい呼び出し手順は,
70                         nextern を以下のように定義すると
71                         <literal>[As,Es,Z,dim]=    schur(A,E,'nextern')</literal> 
72                         のようになります:
73                     </para>
74                 </listitem>
75             </varlistentry>
76         </variablelist>
77         <programlisting role=""><![CDATA[ 
78 logical function nextern(ar,ai,beta)
79 double precision ar,ai,beta
80 integer r,extern
81 if (ai.eq.0.0d0) then
82   r=extern(1,ar,beta,0.0d0,0.0d0)
83 else
84   r=extern(2,0.0d0,0.0d0,2.0d0*ar,ar*ar+ai*ai)
85 endif
86 nextern=r.eq.1
87 end
88  ]]></programlisting>
89     </refsection>
90     <refsection role="see also">
91         <title>参照</title>
92         <simplelist type="inline">
93             <member>
94                 <link linkend="external">external</link>
95             </member>
96             <member>
97                 <link linkend="schur">schur</link>
98             </member>
99         </simplelist>
100     </refsection>
101 </refentry>