22
22
* See the file ./license.txt
24
24
<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" version="5.0-subset Scilab" xml:id="MATLU">
26
<refname>MATLU</refname>
27
<refpurpose>LU Factorization</refpurpose>
30
<title>Block Screenshot</title>
34
<imagedata align="center" fileref="../../../../images/palettes/MATLU.png" valign="middle"/>
39
<refsection id="Contents_MATLU">
40
<title>Contents</title>
44
<link linkend="MATLU">LU Factorization</link>
51
<xref linkend="Palette_MATLU">Palette</xref>
56
<xref linkend="Description_MATLU">Description</xref>
61
<xref linkend="Dialogbox_MATLU">Dialog box</xref>
66
<xref linkend="Defaultproperties_MATLU">Default properties</xref>
71
<xref linkend="Interfacingfunction_MATLU">Interfacing function</xref>
76
<xref linkend="Computationalfunction_MATLU">Computational function</xref>
81
<xref linkend="Seealso_MATLU">See also</xref>
88
<refsection id="Palette_MATLU">
89
<title>Palette</title>
93
<link linkend="Matrix_pal">Matrix operation palette</link>
98
<refsection id="Description_MATLU">
99
<title>Description</title>
101
The MATLU Block outputs two matrices L and U, with row pivoting, from the LU factorization of a
102
square input matrix. If A is the input matrix then:
105
E*A=L*U where E is the permutation matrix, U an upper triangular matrix and L a lower triangular matrix.
108
The equivalent function of this block in Scilab is <link linkend="lu">[l,u,e]=lu(A)</link>.
112
<refsection id="Dialogbox_MATLU">
113
<title>Dialog box</title>
117
<imagedata align="center" fileref="../../../../images/gui/MATLU_gui.gif" valign="middle"/>
125
<emphasis role="bold">Datatype(1=real double 2=Complex)</emphasis>
128
It indicates the type of the output. It support only the two types double (1) and complex (2).
129
If we input another entry in this label xcos will print the message "Datatype is not supported".
131
<para>Properties : Type 'vec' of size 1.</para>
135
<refsection id="Defaultproperties_MATLU">
136
<title>Default properties</title>
140
<emphasis role="bold">always active:</emphasis> no
145
<emphasis role="bold">direct-feedthrough:</emphasis> yes
150
<emphasis role="bold">zero-crossing:</emphasis> no
155
<emphasis role="bold">mode:</emphasis> no
160
<emphasis role="bold">regular inputs:</emphasis>
163
<emphasis role="bold">- port 1 : size [-1,-1] / type 1</emphasis>
168
<emphasis role="bold">regular outputs:</emphasis>
171
<emphasis role="bold">- port 1 : size [-1,-1] / type 1</emphasis>
174
<emphasis role="bold">- port 2 : size [-1,-1] / type 1</emphasis>
179
<emphasis role="bold">number/sizes of activation inputs:</emphasis> 0
184
<emphasis role="bold">number/sizes of activation outputs:</emphasis> 0
189
<emphasis role="bold">continuous-time state:</emphasis> no
194
<emphasis role="bold">discrete-time state:</emphasis> no
199
<emphasis role="bold">object discrete-time state:</emphasis> no
204
<emphasis role="bold">name of computational function:</emphasis>
205
<emphasis role="italic">mat_lu</emphasis>
210
<refsection id="Interfacingfunction_MATLU">
211
<title>Interfacing function</title>
214
<para>SCI/modules/scicos_blocks/macros/MatrixOp/MATLU.sci</para>
218
<refsection id="Computationalfunction_MATLU">
219
<title>Computational function</title>
222
<para>SCI/modules/scicos_blocks/src/c/mat_lu.c</para>
225
<para>SCI/modules/scicos_blocks/src/c/matz_lu.c</para>
229
<refsection id="Seealso_MATLU">
230
<title>See also</title>
234
<link linkend="MATINV">MATINV - Matrix Inverse (xcos Block)</link>
239
<link linkend="lu">lu (Scilab function)</link>
26
<refname>MATLU</refname>
27
<refpurpose>LU Factorization</refpurpose>
30
<title>Block Screenshot</title>
34
<imagedata align="center" fileref="../../../../images/palettes/MATLU.png" valign="middle"/>
39
<refsection id="Contents_MATLU">
40
<title>Contents</title>
44
<link linkend="MATLU">LU Factorization</link>
51
<xref linkend="Palette_MATLU">Palette</xref>
56
<xref linkend="Description_MATLU">Description</xref>
61
<xref linkend="Dialogbox_MATLU">Dialog box</xref>
66
<xref linkend="Defaultproperties_MATLU">Default properties</xref>
71
<xref linkend="Interfacingfunction_MATLU">Interfacing function</xref>
76
<xref linkend="Computationalfunction_MATLU">Computational function</xref>
81
<xref linkend="Seealso_MATLU">See also</xref>
88
<refsection id="Palette_MATLU">
89
<title>Palette</title>
93
<link linkend="Matrix_pal">Matrix operation palette</link>
98
<refsection id="Description_MATLU">
99
<title>Description</title>
101
The MATLU Block outputs two matrices L and U, with row pivoting, from the LU factorization of a
102
square input matrix. If A is the input matrix then:
105
E*A=L*U where E is the permutation matrix, U an upper triangular matrix and L a lower triangular matrix.
108
The equivalent function of this block in Scilab is <link linkend="lu">[l,u,e]=lu(A)</link>.
112
<refsection id="Dialogbox_MATLU">
113
<title>Dialog box</title>
117
<imagedata align="center" fileref="../../../../images/gui/MATLU_gui.gif" valign="middle"/>
125
<emphasis role="bold">Datatype(1=real double 2=Complex)</emphasis>
128
It indicates the type of the output. It support only the two types double (1) and complex (2).
129
If we input another entry in this label xcos will print the message "Datatype is not supported".
131
<para>Properties : Type 'vec' of size 1.</para>
135
<refsection id="Defaultproperties_MATLU">
136
<title>Default properties</title>
140
<emphasis role="bold">always active:</emphasis> no
145
<emphasis role="bold">direct-feedthrough:</emphasis> yes
150
<emphasis role="bold">zero-crossing:</emphasis> no
155
<emphasis role="bold">mode:</emphasis> no
160
<emphasis role="bold">regular inputs:</emphasis>
163
<emphasis role="bold">- port 1 : size [-1,-1] / type 1</emphasis>
168
<emphasis role="bold">regular outputs:</emphasis>
171
<emphasis role="bold">- port 1 : size [-1,-1] / type 1</emphasis>
174
<emphasis role="bold">- port 2 : size [-1,-1] / type 1</emphasis>
179
<emphasis role="bold">number/sizes of activation inputs:</emphasis> 0
184
<emphasis role="bold">number/sizes of activation outputs:</emphasis> 0
189
<emphasis role="bold">continuous-time state:</emphasis> no
194
<emphasis role="bold">discrete-time state:</emphasis> no
199
<emphasis role="bold">object discrete-time state:</emphasis> no
204
<emphasis role="bold">name of computational function:</emphasis>
205
<emphasis role="italic">mat_lu</emphasis>
210
<refsection id="Interfacingfunction_MATLU">
211
<title>Interfacing function</title>
214
<para>SCI/modules/scicos_blocks/macros/MatrixOp/MATLU.sci</para>
218
<refsection id="Computationalfunction_MATLU">
219
<title>Computational function</title>
222
<para>SCI/modules/scicos_blocks/src/c/mat_lu.c</para>
225
<para>SCI/modules/scicos_blocks/src/c/matz_lu.c</para>
229
<refsection id="Seealso_MATLU">
230
<title>See also</title>
234
<link linkend="MATINV">MATINV - Matrix Inverse (xcos Block)</link>
239
<link linkend="lu">lu (Scilab function)</link>