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

« back to all changes in this revision

Viewing changes to man/linear/colcomp.man

  • Committer: Bazaar Package Importer
  • Author(s): Torsten Werner
  • Date: 2002-03-21 16:57:43 UTC
  • Revision ID: james.westby@ubuntu.com-20020321165743-e9mv12c1tb1plztg
Tags: upstream-2.6
ImportĀ upstreamĀ versionĀ 2.6

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH colcomp 1 "April 1993" "Scilab Group" "Scilab Function"
 
2
.so ../sci.an
 
3
.SH NAME
 
4
colcomp - column compression, kernel, nullspace
 
5
.SH CALLING SEQUENCE
 
6
.nf
 
7
[W,rk]=colcomp(A [,flag] [,tol])
 
8
.fi
 
9
.SH PARAMETERS
 
10
.TP 10
 
11
A
 
12
: real or complex matrix
 
13
.TP 10
 
14
flag
 
15
: character string
 
16
.TP 10
 
17
tol
 
18
:
 
19
real number
 
20
.TP
 
21
W
 
22
: square non-singular matrix (change of basis)
 
23
.TP
 
24
rk
 
25
: integer (rank of \fVA\fR)
 
26
.SH DESCRIPTION
 
27
Column compression of \fVA\fR: \fVAc = A*W\fR is 
 
28
column compressed i.e 
 
29
.LP
 
30
\fVAc=[0,Af]\fR with \fVAf\fR full column rank, 
 
31
rank(\fVAf\fR) = rank(\fVA\fR) = \fVrk\fR.
 
32
.LP
 
33
\fVflag\fR and \fVtol\fR are optional parameters: \fVflag = 'qr'\fR 
 
34
or \fV'svd'\fR (default is \fV'svd'\fR).
 
35
.LP
 
36
\fVtol\fR = tolerance parameter (of order \fV%eps\fR as default value).
 
37
.LP
 
38
The \fVma-rk\fR first columns of \fVW\fR span the kernel of \fVA\fR 
 
39
when \fVsize(A)=(na,ma)\fR
 
40
.SH EXAMPLE
 
41
.nf
 
42
A=rand(5,2)*rand(2,5);
 
43
[X,r]=colcomp(A);
 
44
norm(A*X(:,1:$-r),1)
 
45
.fi
 
46
.SH SEE ALSO
 
47
rowcomp, fullrf, fullrfk, kernel
 
48
.SH AUTHOR
 
49
F.D.
 
50