c4254b54d0fda0564b881d8aa14e307074b61481
[scilab.git] / scilab / modules / sparse / help / ja_JP / decomposition / luget.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) XXXX-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="luget">
14     <refnamediv>
15         <refname>luget</refname>
16         <refpurpose>疎行列LU分解の展開</refpurpose>
17     </refnamediv>
18     <refsynopsisdiv>
19         <title>呼び出し手順</title>
20         <synopsis>[P,L,U,Q]=luget(hand)</synopsis>
21     </refsynopsisdiv>
22     <refsection>
23         <title>パラメータ</title>
24         <variablelist>
25             <varlistentry>
26                 <term>hand</term>
27                 <listitem>
28                     <para>
29                         ハンドル, <literal>lufact</literal>の出力
30                     </para>
31                 </listitem>
32             </varlistentry>
33             <varlistentry>
34                 <term>P</term>
35                 <listitem>
36                     <para>疎交換行列</para>
37                 </listitem>
38             </varlistentry>
39             <varlistentry>
40                 <term>L</term>
41                 <listitem>
42                     <para>
43                         疎行列, lower triangular if <literal>hand</literal>が
44                         正則行列から得られた場合は上三角
45                     </para>
46                 </listitem>
47             </varlistentry>
48             <varlistentry>
49                 <term>U</term>
50                 <listitem>
51                     <para>正方正則上三角疎行列(主対角項は1)</para>
52                 </listitem>
53             </varlistentry>
54             <varlistentry>
55                 <term>Q</term>
56                 <listitem>
57                     <para>疎交換行列</para>
58                 </listitem>
59             </varlistentry>
60         </variablelist>
61     </refsection>
62     <refsection>
63         <title>説明</title>
64         <para>
65             疎行列 <literal>A</literal>に関して
66             コマンド<literal>[hand,rk]=lufact(A)</literal>により得られた
67             <literal>hand</literal>を指定すると,<literal>[P,L,U,Q]=luget(hand)</literal>
68             は,<literal>P*L*U*Q=A</literal>となるような4つの疎行列を返します.
69         </para>
70         <para>
71             行列Aはフルランクである必要はありませんが正方行列である必要があります
72             (Aは疎行列と仮定されるため,正方化するために必要に応じて0を追加することができます).
73         </para>
74         <para>
75             <literal>A</literal>が正則でない場合,
76             行列<literal>L</literal>は(<literal>rk</literal>個の
77             独立した非ゼロ列について)列圧縮されます
78             正則な疎行列  <literal>Q'*inv(U)</literal> は
79             <literal>A</literal>を列圧縮します.
80         </para>
81     </refsection>
82     <refsection>
83         <title>例</title>
84         <programlisting role="example"><![CDATA[ 
85 a=rand(5,2)*rand(2,5);A=sparse(a);
86 [hand,rk]=lufact(A);[P,L,U,Q]=luget(hand);
87 full(L), P*L*U*Q-A
88 clean(P*L*U*Q-A)
89 ludel(hand)
90  ]]></programlisting>
91     </refsection>
92     <refsection role="see also">
93         <title>参照</title>
94         <simplelist type="inline">
95             <member>
96                 <link linkend="sparse">sparse</link>
97             </member>
98             <member>
99                 <link linkend="lusolve">lusolve</link>
100             </member>
101             <member>
102                 <link linkend="luget">luget</link>
103             </member>
104             <member>
105                 <link linkend="clean">clean</link>
106             </member>
107         </simplelist>
108     </refsection>
109 </refentry>