File: balanc.man

package info (click to toggle)
scilab 2.4-1
  • links: PTS
  • area: non-free
  • in suites: potato, slink
  • size: 55,196 kB
  • ctags: 38,019
  • sloc: ansic: 231,970; fortran: 148,976; tcl: 7,099; makefile: 4,585; sh: 2,978; csh: 154; cpp: 101; asm: 39; sed: 5
file content (48 lines) | stat: -rw-r--r-- 1,025 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
.TH balanc 2 "April 1993" "Scilab Group" "Scilab Function"
.so ../sci.an
.SH NAME
balanc - matrix or pencil balancing
.SH CALLING SEQUENCE
.nf
[Ab,X]=balanc(A)
[Eb,Ab,X,Y]=balanc(E,A)
.fi
.SH PARAMETERS
.TP 10
A:
a real square matrix
.TP
X:
a real square invertible matrix
.TP
E:
a real square matrix (same dimension as \fVA\fR)
.TP
Y:
a real square invertible matrix.
.SH DESCRIPTION
Balance a square matrix to improve its condition number.
.LP
.Vb [Ab,X] = balanc(A) 
finds a similarity transformation \fVX\fR such that
.Vb Ab = inv(X)*A*X 
has approximately equal row and column norms.
.LP
For matrix pencils,balancing is done for improving the
generalized eigenvalue problem.
.LP
.Vb [Eb,Ab,X,Y] = balanc(E,A)
returns left and right transformations \fVX\fR and \fVY\fR
such that
.Vb Eb=X*E*Y      Ab=X*A*Y
.SH Remark
Balancing is made in the functions \fVbdiag\fR and \fVspec\fR.
.SH EXAMPLE
.nf
A=[1/2^10,1/2^10;2^10,2^10];
[Ab,X]=balanc(A);
norm(A(1,:))/norm(A(2,:))
norm(Ab(1,:))/norm(Ab(2,:))
.fi
.SH SEE ALSO 
bdiag