← Back to branch summary

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

« back to all changes in this revision

Viewing changes to man/linear/pencan.cat

  • 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/pencan.cat
 
1
pencan            Scilab Group            Scilab Function            pencan
 
2
NAME
 
3
   pencan - canonical form of matrix pencil
 
4
  
 
5
CALLING SEQUENCE
 
6
 [Q,M,i1]=pencan(Fs)
 
7
 [Q,M,i1]=pencan(E,A)
 
8
PARAMETERS
 
9
 Fs       : a regular pencil s*E-A
 
10
          
 
11
 E,A      : two real square matrices
 
12
          
 
13
 Q,M      : two non-singular real matrices
 
14
          
 
15
 i1       : integer
 
16
          
 
17
DESCRIPTION
 
18
   Given the regular pencil Fs=s*E-A, pencan returns matrices Q  and M such
 
19
  than M*(s*E-A)*Q is in "canonical" form.
 
20
  
 
21
   M*E*Q is a block matrix 
 
22
  
 
23
 [I,0;
 
24
  0,N]
 
25
   with N nilpotent and i1 = size of the I matrix above.
 
26
  
 
27
   M*A*Q is a block matrix:
 
28
  
 
29
 [Ar,0;
 
30
  0,I]
 
31
EXAMPLE
 
32
 F=randpencil([],[1,2],[1,2,3],[]);
 
33
 F=rand(6,6)*F*rand(6,6);
 
34
 [Q,M,i1]=pencan(F);
 
35
 W=clean(M*F*Q)
 
36
 roots(det(W(1:i1,1:i1)))
 
37
 det(W($-2:$,$-2:$))
 
38
SEE ALSO
 
39
   glever,  penlaur, rowshuff
 
40
  
 
41
AUTHOR
 
42
   F. D.  
 
43