~ubuntu-branches/ubuntu/hoary/scilab/hoary

« back to all changes in this revision

Viewing changes to man/linear/im_inv.cat

  • Committer: Bazaar Package Importer
  • Author(s): Torsten Werner
  • Date: 2005-01-09 22:58:21 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20050109225821-473xr8vhgugxxx5j
Tags: 3.0-12
changed configure.in to build scilab's own malloc.o, closes: #255869

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
im_inv            Scilab Group            Scilab Function            im_inv
2
 
NAME
3
 
   im_inv - inverse image
4
 
  
5
 
CALLING SEQUENCE
6
 
 [X,dim]=im_inv(A,B [,tol])
7
 
 [X,dim,Y]=im_inv(A,B, [,tol]) 
8
 
PARAMETERS
9
 
 A,B        : two real or complex matrices with equal number of columns
10
 
            
11
 
 X          : orthogonal or unitary square matrix of order equal to the 
12
 
            number of columns of A
13
 
            
14
 
 dim        : integer (dimension of subspace)
15
 
            
16
 
 Y          : orthogonal matrix of order equal to the number of rows  of A
17
 
            and B.
18
 
            
19
 
DESCRIPTION
20
 
   computes 
21
 
  
22
 
   (A^-1)(B)
23
 
  
24
 
    i.e vectors whose image through A are in range(B)
25
 
  
26
 
   The dim first columns of X span 
27
 
  
28
 
   (A^-1) (B)
29
 
  
30
 
   tol is a threshold used to test if subspace inclusion; default value is
31
 
  tol = 100*%eps. If Y is returned, then [Y*A*X,Y*B] is partitioned as
32
 
  follows:
33
 
  
34
 
 [A11,A12;0,A22],[B1;0]
35
 
   where B1 has full row rank (equals rank(B)) and A22 has full column rank
36
 
  and has dim columns.
37
 
  
38
 
EXAMPLE
39
 
 A=[rand(2,5);[zeros(3,4),rand(3,1)]];B=[[1,1;1,1];zeros(3,2)];
40
 
 W=rand(5,5);A=W*A;B=W*B;
41
 
 [X,dim]=im_inv(A,B)
42
 
 svd([A*X(:,1:dim),B])   //vectors A*X(:,1:dim) belong to range(B)
43
 
 [X,dim,Y]=im_inv(A,B);[Y*A*X,Y*B]
44
 
SEE ALSO
45
 
   rowcomp, spaninter, spanplus, linsolve
46
 
  
47
 
AUTHOR
48
 
   F. D.  
49