← Back to branch summary

~ubuntu-branches/ubuntu/raring/scilab/raring-proposed

« back to all changes in this revision

Viewing changes to modules/linear_algebra/help/pt_BR/linear/aff2ab.xml

  • Committer: Package Import Robot
  • Author(s): Sylvestre Ledru
  • Date: 2012-08-30 14:42:38 UTC
  • mfrom: (1.4.7)
  • Revision ID: package-import@ubuntu.com-20120830144238-c1y2og7dbm7m9nig
Tags: 5.4.0-beta-3-1~exp1
* New upstream release
* Update the scirenderer dep
* Get ride of libjhdf5-java dependency

Show diffs side-by-side

added added

removed removed

Lines of Context:
modules/linear_algebra/help/pt_BR/linear/aff2ab.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
 * 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-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:ns3="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="aff2ab" xml:lang="en">
 
14
  <refnamediv>
 
15
    <refname>aff2ab</refname>
 
16
    <refpurpose>Convers�o de uma fun��o linear (afim) para forma
 
17
      A,b
 
18
    </refpurpose>
 
19
  </refnamediv>
 
20
  <refsynopsisdiv>
 
21
    <title>Seq��ncia de Chamamento</title>
 
22
    <synopsis>[A,b]=aff2ab(afunction,dimX,D [,flag])</synopsis>
 
23
  </refsynopsisdiv>
 
24
  <refsection>
 
25
    <title>Par�metros</title>
 
26
    <variablelist>
 
27
      <varlistentry>
 
28
        <term>afunction</term>
 
29
        <listitem>
 
30
          <para>
 
31
            uma fun��o do Scilab <literal> Y =fct(X,D) </literal> onde
 
32
            <literal>X, D, Y</literal> s�o <literal>lists</literal> de
 
33
            matrizes
 
34
          </para>
 
35
        </listitem>
 
36
      </varlistentry>
 
37
      <varlistentry>
 
38
        <term>dimX</term>
 
39
        <listitem>
 
40
          <para>
 
41
            uma matriz de inteiros p x 2 (<literal>p</literal> � o n�mero
 
42
            de matrizes em X)
 
43
          </para>
 
44
        </listitem>
 
45
      </varlistentry>
 
46
      <varlistentry>
 
47
        <term>D</term>
 
48
        <listitem>
 
49
          <para>
 
50
            uma <literal>list</literal> de matrizes de reais (ou qualquer
 
51
            outro objeto Scilab v�lido).
 
52
          </para>
 
53
        </listitem>
 
54
      </varlistentry>
 
55
      <varlistentry>
 
56
        <term>flag</term>
 
57
        <listitem>
 
58
          <para>
 
59
            par�metro opcional (<literal>flag='f'</literal> ou
 
60
            <literal>flag='sp'</literal>)
 
61
          </para>
 
62
        </listitem>
 
63
      </varlistentry>
 
64
      <varlistentry>
 
65
        <term>A</term>
 
66
        <listitem>
 
67
          <para>uma matriz de reais</para>
 
68
        </listitem>
 
69
      </varlistentry>
 
70
      <varlistentry>
 
71
        <term>b</term>
 
72
        <listitem>
 
73
          <para>um vetor de reais tendo a mesma dimens�o de linha que
 
74
            <literal>A</literal>
 
75
          </para>
 
76
        </listitem>
 
77
      </varlistentry>
 
78
    </variablelist>
 
79
  </refsection>
 
80
  <refsection>
 
81
    <title>Descri��o</title>
 
82
    <para>
 
83
      <literal>aff2ab</literal> retorna a representa��o matricial de uma
 
84
      fun��o afim (na base can�nica).
 
85
    </para>
 
86
    <para>
 
87
      <literal>afunction</literal> � uma fun��o com sintaxe imposta:
 
88
      <literal> Y=afunction(X,D) </literal> onde <literal> X=list(X1,X2,...,Xp)
 
89
      </literal>
 
90
      � uma lista de p matrizes de reais, e <literal>
 
91
        Y=list(Y1,...,Yq) 
 
92
      </literal>
 
93
      �uma lista de q matrizes reais que dependem
 
94
      linearmente das <literal> Xi</literal>'s. A entrada (opcional) <literal>
 
95
        D
 
96
      </literal>
 
97
      cont�m par�metros necess�rios para computar Y como uma fun��o
 
98
      de X (geralmente � uma lista de matrizes).
 
99
    </para>
 
100
    <para>
 
101
      <literal> dimX</literal> � uma matriz p x 2:
 
102
      <literal>dimX(i)=[nri,nci]</literal> � o n�mero real de linhas e colunas
 
103
      da matriz <literal>Xi</literal>. Estas dimens�es determinam
 
104
      <literal>na</literal>, a dimens�o de coluna da matriz resultante
 
105
      <literal>A</literal>: <literal>na=nr1*nc1 +...+ nrp*ncp</literal>.
 
106
    </para>
 
107
    <para>
 
108
      Se o par�metro opcional <literal>flag='sp'</literal> a matriz
 
109
      resultante A � retornada como uma esparsa.
 
110
    </para>
 
111
    <para>Esta fun��o � �til para resolver um sistema de equa��es lineares
 
112
      onde as inc�gnitas s�o matrizes.
 
113
    </para>
 
114
  </refsection>
 
115
  <refsection>
 
116
    <title>Exemplos</title>
 
117
    <programlisting role="example"><![CDATA[ 
 
118
// solucionador de equa��o de Lyapunov (uma inc�gnita, uma restri��o)
 
119
deff('Y=lyapunov(X,D)','[A,Q]=D(:);Xm=X(:); Y=list(A''*Xm+Xm*A-Q)')
 
120
A=rand(3,3);Q=rand(3,3);Q=Q+Q';D=list(A,Q);dimX=[3,3];
 
121
[Aly,bly]=aff2ab(lyapunov,dimX,D);
 
122
[Xl,kerA]=linsolve(Aly,bly); Xv=vec2list(Xl,dimX); lyapunov(Xv,D)
 
123
Xm=Xv(:); A'*Xm+Xm*A-Q
 
124
 
 
125
// solucionador de equa��o de Lyapunov com restri��o redundante X=X'
 
126
// (uma vari�vel, uma restri��o) D � vari�vel global
 
127
deff('Y=ly2(X,D)','[A,Q]=D(:);Xm=X(:); Y=list(A''*Xm+Xm*A-Q,Xm''-Xm)')
 
128
A=rand(3,3);Q=rand(3,3);Q=Q+Q';D=list(A,Q);dimX=[3,3];
 
129
[Aly,bly]=aff2ab(ly2,dimX,D);
 
130
[Xl,kerA]=linsolve(Aly,bly); Xv=vec2list(Xl,dimX); ly2(Xv,D)
 
131
 
 
132
// equa��es de Francis
 
133
// Achando matrizes X1 e X2 tais que:
 
134
// A1*X1 - X1*A2 + B*X2 -A3 = 0
 
135
// D1*X1 -D2 = 0 
 
136
deff('Y=bruce(X,D)','[A1,A2,A3,B,D1,D2]=D(:),...
 
137
[X1,X2]=X(:);Y=list(A1*X1-X1*A2+B*X2-A3,D1*X1-D2)')
 
138
A1=[-4,10;-1,2];A3=[1;2];B=[0;1];A2=1;D1=[0,1];D2=1;
 
139
D=list(A1,A2,A3,B,D1,D2);
 
140
[n1,m1]=size(A1);[n2,m2]=size(A2);[n3,m3]=size(B);
 
141
dimX=[[m1,n2];[m3,m2]];
 
142
[Af,bf]=aff2ab(bruce,dimX,D);
 
143
[Xf,KerAf]=linsolve(Af,bf);Xsol=vec2list(Xf,dimX)
 
144
bruce(Xsol,D)
 
145
 
 
146
// Achando todas as X que comutam com A
 
147
deff('y=f(X,D)','y=list(D(:)*X(:)-X(:)*D(:))')
 
148
A=rand(3,3);dimX=[3,3];[Af,bf]=aff2ab(f,dimX,list(A));
 
149
[Xf,KerAf]=linsolve(Af,bf);[p,q]=size(KerAf);
 
150
Xsol=vec2list(Xf+KerAf*rand(q,1),dimX);
 
151
C=Xsol(:); A*C-C*A
 
152
 ]]></programlisting>
 
153
  </refsection>
 
154
  <refsection role="see also">
 
155
    <title>Ver Tamb�m</title>
 
156
    <simplelist type="inline">
 
157
      <member>
 
158
        <link linkend="linsolve">linsolve</link>
 
159
      </member>
 
160
    </simplelist>
 
161
  </refsection>
 
162
</refentry>