Purpose
To apply the transformations created by the SLICOT Library routine MB02CX on other columns / rows of the generator, contained in the arrays A and B of positive and negative generators, respectively.Specification
SUBROUTINE MB02CY( TYPET, STRUCG, P, Q, N, K, A, LDA, B, LDB, H,
$ LDH, CS, LCS, DWORK, LDWORK, INFO )
C .. Scalar Arguments ..
INTEGER INFO, K, LDA, LDB, LCS, LDH, LDWORK, N, P, Q
CHARACTER STRUCG, TYPET
C .. Array Arguments ..
DOUBLE PRECISION A(LDA, *), B(LDB, *), CS(*), DWORK(*), H(LDH,*)
Arguments
Mode Parameters
TYPET CHARACTER*1
Specifies the type of the generator, as follows:
= 'R': A and B are additional columns of the generator;
= 'C': A and B are additional rows of the generator.
Note: in the sequel, the notation x / y means that
x corresponds to TYPET = 'R' and y corresponds to
TYPET = 'C'.
STRUCG CHARACTER*1
Information about the structure of the two generators,
as follows:
= 'T': the trailing block of the positive generator
is lower / upper triangular, and the trailing
block of the negative generator is zero;
= 'N': no special structure to mention.
Input/Output Parameters
P (input) INTEGER
The number of rows / columns in A containing the positive
generators. P >= 0.
Q (input) INTEGER
The number of rows / columns in B containing the negative
generators. Q >= 0.
N (input) INTEGER
The number of columns / rows in A and B to be processed.
N >= 0.
K (input) INTEGER
The number of columns / rows in H. P >= K >= 0.
A (input/output) DOUBLE PRECISION array, dimension
(LDA, N) / (LDA, P)
On entry, the leading P-by-N / N-by-P part of this array
must contain the positive part of the generator.
On exit, the leading P-by-N / N-by-P part of this array
contains the transformed positive part of the generator.
LDA INTEGER
The leading dimension of the array A.
LDA >= MAX(1,P), if TYPET = 'R';
LDA >= MAX(1,N), if TYPET = 'C'.
B (input/output) DOUBLE PRECISION array, dimension
(LDB, N) / (LDB, Q)
On entry, the leading Q-by-N / N-by-Q part of this array
must contain the negative part of the generator.
On exit, the leading Q-by-N / N-by-Q part of this array
contains the transformed negative part of the generator.
LDB INTEGER
The leading dimension of the array B.
LDB >= MAX(1,Q), if TYPET = 'R';
LDB >= MAX(1,N), if TYPET = 'C'.
H (input) DOUBLE PRECISION array, dimension
(LDH, K) / (LDH, Q)
The leading Q-by-K / K-by-Q part of this array must
contain part of the necessary information for the
Householder transformations computed by SLICOT Library
routine MB02CX.
LDH INTEGER
The leading dimension of the array H.
LDH >= MAX(1,Q), if TYPET = 'R';
LDH >= MAX(1,K), if TYPET = 'C'.
CS (input) DOUBLE PRECISION array, dimension (LCS)
The leading 2*K + MIN(K,Q) part of this array must
contain the necessary information for modified hyperbolic
rotations and the scalar factors of the Householder
transformations computed by SLICOT Library routine MB02CX.
LCS INTEGER
The length of the array CS. LCS >= 2*K + MIN(K,Q).
Workspace
DWORK DOUBLE PRECISION array, dimension (LDWORK)
On exit, if INFO = 0, DWORK(1) returns the optimal
value of LDWORK.
On exit, if INFO = -16, DWORK(1) returns the minimum
value of LDWORK.
LDWORK INTEGER
The length of the array DWORK. LDWORK >= MAX(1,N).
For optimum performance LDWORK should be larger.
Error Indicator
INFO INTEGER
= 0: succesful exit;
< 0: if INFO = -i, the i-th argument had an illegal
value.
Method
The Householder transformations and modified hyperbolic rotations computed by SLICOT Library routine MB02CX are applied to the corresponding parts of the matrices A and B.Further Comments
NoneExample
Program Text
NoneProgram Data
NoneProgram Results
None