File: slasy2.l

package info (click to toggle)
lapack 3.0.20000531a-28
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 61,920 kB
  • ctags: 46,200
  • sloc: fortran: 584,835; perl: 8,226; makefile: 2,331; awk: 71; sh: 45
file content (94 lines) | stat: -rwxr-xr-x 2,569 bytes parent folder | download | duplicates (4)
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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
.TH SLASY2 l "15 June 2000" "LAPACK version 3.0" ")"
.SH NAME
SLASY2 - solve for the N1 by N2 matrix X, 1 <= N1,N2 <= 2, in  op(TL)*X + ISGN*X*op(TR) = SCALE*B,
.SH SYNOPSIS
.TP 19
SUBROUTINE SLASY2(
LTRANL, LTRANR, ISGN, N1, N2, TL, LDTL, TR,
LDTR, B, LDB, SCALE, X, LDX, XNORM, INFO )
.TP 19
.ti +4
LOGICAL
LTRANL, LTRANR
.TP 19
.ti +4
INTEGER
INFO, ISGN, LDB, LDTL, LDTR, LDX, N1, N2
.TP 19
.ti +4
REAL
SCALE, XNORM
.TP 19
.ti +4
REAL
B( LDB, * ), TL( LDTL, * ), TR( LDTR, * ),
X( LDX, * )
.SH PURPOSE
SLASY2 solves for the N1 by N2 matrix X, 1 <= N1,N2 <= 2, in op(TL)*X + ISGN*X*op(TR) = SCALE*B, 
where TL is N1 by N1, TR is N2 by N2, B is N1 by N2, and ISGN = 1 or
-1.  op(T) = T or T', where T' denotes the transpose of T.

.SH ARGUMENTS
.TP 8
LTRANL  (input) LOGICAL
On entry, LTRANL specifies the op(TL):
= .FALSE., op(TL) = TL,
= .TRUE., op(TL) = TL'.
.TP 8
LTRANR  (input) LOGICAL
On entry, LTRANR specifies the op(TR):
= .FALSE., op(TR) = TR,
= .TRUE., op(TR) = TR'.
.TP 8
ISGN    (input) INTEGER
On entry, ISGN specifies the sign of the equation
as described before. ISGN may only be 1 or -1.
.TP 8
N1      (input) INTEGER
On entry, N1 specifies the order of matrix TL.
N1 may only be 0, 1 or 2.
.TP 8
N2      (input) INTEGER
On entry, N2 specifies the order of matrix TR.
N2 may only be 0, 1 or 2.
.TP 8
TL      (input) REAL array, dimension (LDTL,2)
On entry, TL contains an N1 by N1 matrix.
.TP 8
LDTL    (input) INTEGER
The leading dimension of the matrix TL. LDTL >= max(1,N1).
.TP 8
TR      (input) REAL array, dimension (LDTR,2)
On entry, TR contains an N2 by N2 matrix.
.TP 8
LDTR    (input) INTEGER
The leading dimension of the matrix TR. LDTR >= max(1,N2).
.TP 8
B       (input) REAL array, dimension (LDB,2)
On entry, the N1 by N2 matrix B contains the right-hand
side of the equation.
.TP 8
LDB     (input) INTEGER
The leading dimension of the matrix B. LDB >= max(1,N1).
.TP 8
SCALE   (output) REAL
On exit, SCALE contains the scale factor. SCALE is chosen
less than or equal to 1 to prevent the solution overflowing.
.TP 8
X       (output) REAL array, dimension (LDX,2)
On exit, X contains the N1 by N2 solution.
.TP 8
LDX     (input) INTEGER
The leading dimension of the matrix X. LDX >= max(1,N1).
.TP 8
XNORM   (output) REAL
On exit, XNORM is the infinity-norm of the solution.
.TP 8
INFO    (output) INTEGER
On exit, INFO is set to
0: successful exit.
.br
1: TL and TR have too close eigenvalues, so TL or
TR is perturbed to get a nonsingular equation.
NOTE: In the interests of speed, this routine does not
check the inputs for errors.