← Back to branch summary

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

« back to all changes in this revision

Viewing changes to man/linear/randpencil.man

  • 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
http://bugs.debian.org/255869
changed configure.in to build scilab's own malloc.o, closes: #255869

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/linear/randpencil.man
1
 
.TH quaskro 1 "April 1993" "Scilab Group" "Scilab Function"
2
 
.so ../sci.an
3
 
.SH NAME
4
 
randpencil - random pencil
5
 
.SH CALLING SEQUENCE
6
 
.nf
7
 
F=randpencil(eps,infi,fin,eta)
8
 
.fi
9
 
.SH PARAMETERS
10
 
.TP
11
 
eps
12
 
: vector of integers
13
 
.TP
14
 
infi
15
 
: vector of integers
16
 
.TP
17
 
fin
18
 
: real vector, or monic polynomial, or vector of monic polynomial
19
 
.TP
20
 
eta
21
 
:
22
 
vector of integers
23
 
.TP
24
 
F
25
 
:
26
 
real matrix pencil \fVF=s*E-A\fR  (\fVs=poly(0,'s')\fR)
27
 
.SH DESCRIPTION
28
 
Utility function.
29
 
\fVF=randpencil(eps,infi,fin,eta)\fR returns a random pencil \fVF\fR
30
 
with given Kronecker structure. The structure is given by:
31
 
\fVeps=[eps1,...,epsk]\fR: structure of epsilon blocks (size eps1x(eps1+1),....)
32
 
\fVfin=[l1,...,ln]\fR  set of finite eigenvalues (assumed real)  (possibly [])
33
 
\fVinfi=[k1,...,kp]\fR size of J-blocks at infinity
34
 
\fVki>=1\fR  (infi=[] if no J blocks).
35
 
\fVeta=[eta1,...,etap]\fR: structure ofeta blocks (size eta1+1)xeta1,...)
36
 
.LP
37
 
\fVepsi\fR's should be >=0, \fVetai\fR's should be >=0, \fVinfi\fR's should 
38
 
be >=1.
39
 
.LP 
40
 
If \fVfin\fR is a (monic) polynomial, the finite block admits the roots of 
41
 
\fVfin\fR as eigenvalues.
42
 
.LP
43
 
If \fVfin\fR is a vector of polynomial, they are the finite elementary
44
 
divisors of \fVF\fR i.e. the roots of \fVp(i)\fR are finite
45
 
eigenvalues of \fVF\fR.
46
 
.SH EXAMPLE
47
 
.nf
48
 
F=randpencil([0,1],[2],[-1,0,1],[3]);
49
 
[Q,Z,Qd,Zd,numbeps,numbeta]=kroneck(F);
50
 
Qd, Zd
51
 
s=poly(0,'s');
52
 
F=randpencil([],[1,2],s^3-2,[]); //regular pencil
53
 
det(F)
54
 
.fi
55
 
.SH SEE ALSO
56
 
kroneck, pencan, penlaur
57
 
 
58
 
 
59
 
 
60