help format: (fr) added
[scilab.git] / scilab / modules / linear_algebra / help / ja_JP / eigen / gschur.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2
3 <!--
4  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
5  * Copyright (C) 2008 - INRIA
6  * 
7  * Copyright (C) 2012 - 2016 - Scilab Enterprises
8  *
9  * This file is hereby licensed under the terms of the GNU GPL v2.0,
10  * pursuant to article 5.3.4 of the CeCILL v.2.1.
11  * This file was originally licensed under the terms of the CeCILL v2.1,
12  * and continues to be available under such terms.
13  * For more information, see the COPYING file which you should have received
14  * along with this program.
15  *
16  -->
17
18 <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">
19     
20     <refnamediv>
21         
22         <refname>gschur</refname>
23         
24         <refpurpose>
25             
26             一般化Schur分解.
27             
28             <emphasis role="bold">この関数は廃止されました.</emphasis>
29             
30         </refpurpose>
31         
32     </refnamediv>
33     
34     <refsynopsisdiv>
35         
36         <title>呼び出し手順</title>
37         
38         <synopsis>[As,Es]=gschur(A,E)
39             
40             [As,Es,Q,Z]=gschur(A,E)
41             
42             [As,Es,Z,dim] = gschur(A,E,flag)
43             
44             [As,Es,Z,dim]= gschur(A,E,extern)
45             
46         </synopsis>
47         
48     </refsynopsisdiv>
49     
50     <refsection>
51         
52         <title>説明</title>
53         
54         <para>
55             
56             この関数は廃止されており, <literal>schur</literal>関数に統合されています.
57             
58             多くの場合, <literal>gschur</literal>関数は以前と同様に動作しますが,
59             
60             将来のリリースでは削除される予定です.
61             
62         </para>
63         
64         <para>
65             
66             最初の3つの構文は以下のように置き換えることができます
67             
68         </para>
69         
70         <programlisting role=""><![CDATA[ 
71 [As,Es]=schur(A,E)
72 [As,Es,Q,Z]=schur(A,E);Q=Q' //NOTE THE TRANPOSITION HERE
73 [As,Es,Z,dim] = schur(A,E,flag) 
74  ]]></programlisting>
75         
76         <para>
77             
78             最後の構文はさらに若干の調整が必要です:
79             
80         </para>
81         
82         <variablelist>
83             
84             <varlistentry>
85                 
86                 <term>もし,</term>
87                 
88                 <listitem>
89                     
90                     <para>
91                         
92                         extern が Scilab関数の場合,
93                         
94                         Nextern を以下のように定義すると,
95                         
96                         新しい呼び出し手順は,
97                         
98                         <literal>[As,Es,Z,dim]= schur(A,E,Nextern)</literal>
99                         
100                         となります:
101                         
102                     </para>
103                     
104                     <programlisting role=""><![CDATA[ 
105 function t=Nextern(R)
106 if R(2)==0 then
107   t=extern([1,R(1),R(3)])==1
108 else
109   c=(R(1)+%i*R(2))/R(3)
110   t=extern([2,real(c+c'),real(c*c')])==1
111 end
112 endfunction
113  ]]></programlisting>
114                     
115                 </listitem>
116                 
117             </varlistentry>
118             
119             <varlistentry>
120                 
121                 <term>もし,</term>
122                 
123                 <listitem>
124                     
125                     <para>
126                         
127                         extern は,Fortran または Cで記述された外部関数の名前の場合,
128                         
129                         nextern を以下のように定義すると
130                         
131                         新しい呼び出し手順は,
132                         
133                         <literal>[As,Es,Z,dim]=    schur(A,E,'nextern')</literal> 
134                         
135                         のようになります:
136                         
137                     </para>
138                     
139                 </listitem>
140                 
141             </varlistentry>
142             
143         </variablelist>
144         
145         <programlisting role=""><![CDATA[ 
146 logical function nextern(ar,ai,beta)
147 double precision ar,ai,beta
148 integer r,extern
149 if (ai.eq.0.0d0) then
150   r=extern(1,ar,beta,0.0d0,0.0d0)
151 else
152   r=extern(2,0.0d0,0.0d0,2.0d0*ar,ar*ar+ai*ai)
153 endif
154 nextern=r.eq.1
155 end
156  ]]></programlisting>
157         
158     </refsection>
159     
160     <refsection role="see also">
161         
162         <title>参照</title>
163         
164         <simplelist type="inline">
165             
166             <member>
167                 
168                 <link linkend="external">external</link>
169                 
170             </member>
171             
172             <member>
173                 
174                 <link linkend="schur">schur</link>
175                 
176             </member>
177             
178         </simplelist>
179         
180     </refsection>
181     
182 </refentry>
183