← Back to branch summary

~ubuntu-branches/ubuntu/karmic/scilab/karmic

« back to all changes in this revision

Viewing changes to man/linear/psmall.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:
man/linear/psmall.man
 
1
.TH psmall 1 "April 1993" "Scilab Group" "Scilab Function"
 
2
.so ../sci.an
 
3
.SH NAME
 
4
psmall - spectral projection
 
5
.SH CALLING SEQUENCE
 
6
.nf
 
7
[Q,M]=psmall(A,thres,flag)
 
8
.fi
 
9
.SH PARAMETERS
 
10
.TP 12
 
11
A
 
12
: real square matrix
 
13
.TP 12
 
14
thres
 
15
: real number
 
16
.TP 12
 
17
flag
 
18
: character string (\fV'c'\fR or \fV'd'\fR)
 
19
.TP
 
20
Q,M
 
21
: real matrices
 
22
.SH DESCRIPTION
 
23
Projection on eigen-subspace associated with eigenvalues
 
24
with real part < \fVthres\fR (\fVflag='c'\fR) or with 
 
25
modulus < \fVthres\fR (\fVflag='d'\fR).
 
26
.LP
 
27
The projection is defined by \fVQ*M\fR, \fVQ\fR is full column rank,
 
28
\fVM\fR is full row rank and \fVM*Q=eye\fR.
 
29
.LP
 
30
If \fVflag='c'\fR, the eigenvalues of \fVM*A*Q\fR = eigenvalues
 
31
of \fVA\fR with real part < \fVthres\fR.
 
32
.LP
 
33
If \fVflag='d'\fR, the eigenvalues of \fVM*A*Q\fR = eigenvalues
 
34
of \fVA\fR with magnitude < \fVthres\fR.
 
35
.PP
 
36
If \fVflag='c'\fR and if \fV[Q1,M1]\fR = full rank factorization (\fVfullrf\fR) 
 
37
of \fVeye()-Q*M\fR then eigenvalues of  \fVM1*A*Q1\fR = eigenvalues 
 
38
of \fVA\fR with real part >= \fVthres\fR.
 
39
.LP
 
40
If \fVflag='d'\fR and if \fV[Q1,M1]\fR = full rank factorization (\fVfullrf\fR) 
 
41
of \fVeye()-Q*M\fR then eigenvalues of  \fVM1*A*Q1\fR = eigenvalues 
 
42
of \fVA\fR with magnitude >= \fVthres\fR.
 
43
.SH EXAMPLE
 
44
.nf
 
45
A=diag([1,2,3]);X=rand(A);A=inv(X)*A*X;
 
46
[Q,M]=psmall(A,2.5,'d');
 
47
spec(M*A*Q)
 
48
[Q1,M1]=fullrf(eye()-Q*M);
 
49
spec(M1*A*Q1)
 
50
.fi
 
51
.SH SEE ALSO
 
52
pbig, proj, projspec
 
53
.SH AUTHOR
 
54
F. D. (1988)
 
55