← Back to branch summary

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

« back to all changes in this revision

Viewing changes to man/control/pfss.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/control/pfss.man
 
1
.TH pfss 1 "April 1993" "Scilab Group" "Scilab Function"
 
2
.so ../sci.an 
 
3
.SH NAME
 
4
pfss - partial fraction decomposition
 
5
.SH CALLING SEQUENCE
 
6
.nf
 
7
elts=pfss(Sl)
 
8
elts=pfss(Sl,rmax)
 
9
elts=pfss(Sl,'cord')
 
10
elts=pfss(Sl,rmax,'cord')
 
11
.fi
 
12
.SH PARAMETERS
 
13
Sl
 
14
: \fVsyslin\fR list (state-space or transfer linear system)
 
15
rmax
 
16
: real number controlling the conditioning of block diagoanalization
 
17
cord
 
18
: character string \fV'c'\fR or \fV'd'\fR.
 
19
.SH DESCRIPTION
 
20
Partial fraction decomposition of the linear system \fVSl\fR (in state-space 
 
21
form, transfer matrices are automatically converted to state-space form
 
22
by \fVtf2ss\fR):
 
23
.LP
 
24
\fVelts\fR is the list of linear systems which add up to \fVSl\fR
 
25
i.e. \fVelts=list(S1,S2,S3,...,Sn)\fR with:
 
26
.LP
 
27
\fVSl = S1 + S2 +... +Sn\fR.
 
28
.LP
 
29
Each \fVSi\fR contains some poles of \fV\fRS according to the 
 
30
block-diagonalization of the \fVA\fR matrix of \fVS\fR.
 
31
.LP
 
32
For non proper systems the polynomial part of \fVSl\fR is put
 
33
in the last entry of \fVelts\fR.
 
34
.LP
 
35
If \fVSl\fR is given in transfer form, it is first converted into state-space
 
36
and each subsystem \fVSi\fR is then converted in transfer form.
 
37
.LP
 
38
The A matrix is of the state-space is put into block diagonal form
 
39
by function \fVbdiag\fR. The optional parameter \fVrmax\fR is sent to
 
40
\fVbdiag\fR. If \fVrmax\fR should be set to a large number to enforce
 
41
block-diagonalization. 
 
42
.LP
 
43
If the optional flag \fVcord='c'\fR is given the elements in \fVelts\fR
 
44
are sorted according to the real part (resp. magnitude if \fVcord='d'\fR)
 
45
of the eigenvalues of A matrices.
 
46
.SH EXAMPLE
 
47
.nf
 
48
W=ssrand(1,1,6);
 
49
elts=pfss(W); 
 
50
W1=0;for k=1:size(elts), W1=W1+ss2tf(elts(k));end
 
51
clean(ss2tf(W)-W1)
 
52
.fi 
 
53
.SH SEE ALSO
 
54
pbig, bdiag, coffg, dtsi
 
55
.SH AUTHOR
 
56
F.D.
 
57