?la_gbrcond

Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

Download PDF

ID 766686

Date 4/28/2026

Version

Public

?la_gbrcond_x

Computes the infinity norm condition number of op(A)*diag(x) for general banded matrices.

Syntax

call cla_gbrcond_x ( trans , n , kl , ku , ab , ldab , afb , ldafb , ipiv , x , info , work , rwork )

call zla_gbrcond_x ( trans , n , kl , ku , ab , ldab , afb , ldafb , ipiv , x , info , work , rwork )

Include Files

mkl.fi

Description

The function computes the infinity norm condition number of

op(A) * diag(x)

where the x is a COMPLEX vector for cla_gbrcond_x and a DOUBLE COMPLEX vector for zla_gbrcond_x .

Input Parameters

trans

CHARACTER*1 . Must be ‘N’ or ‘T’ or ‘C’ .

Specifies the form of the system of equations:

If trans = 'N' , the system has the form A*X = B (No transpose)

If trans = 'T' , the system has the form A^:code:`T`*X = B (Transpose)

If trans = 'C' , the system has the form A^:code:`H`*X = B (Conjugate Transpose = Transpose)

n

INTEGER . The number of linear equations, that is, the order of the matrix A ; n ≥ 0.

kl

INTEGER . The number of subdiagonals within the band of A ; kl ≥ 0.

ku

INTEGER . The number of superdiagonals within the band of A ; ku ≥ 0.

ab , afb , x , work

COMPLEX for cla_gbrcond_x

DOUBLE COMPLEX for zla_gbrcond_x

Arrays:

ab ( ldab ,*) contains the original band matrix A stored in rows from 1 to kl + ku + 1. The j -th column of A is stored in the j -th column of the array ab as follows:

ab(ku+1+i-j,j) = A(i,j)

for

max(1,j-ku) ≤i≤ min(n,j+kl)

afb ( ldafb ,*) contains details of the LU factorization of the band matrix A , as returned by ?gbtrf . U is stored as an upper triangular band matrix with kl+ku superdiagonals in rows 1 to kl+ku+1 , and the multipliers used during the factorization are stored in rows kl+ku+2 to 2*kl+ku+1 .

x , DIMENSION n . The vector x in the formula op(A) * diag(x) .

work is a workspace array of DIMENSION (2* n ).

The second dimension of ab and afb must be at least max(1, n) .

ldab

INTEGER . The leading dimension of the array ab . ldab ≥ kl+ku+1 .

ldafb

INTEGER . The leading dimension of afb . ldafb ≥ 2*kl+ku+1 .

ipiv

INTEGER .

Array with DIMENSION n . The pivot indices from the factorization A = P*L*U as computed by ?gbtrf . Row i of the matrix was interchanged with row ipiv(i) .

rwork

REAL for cla_gbrcond_x

DOUBLE PRECISION for zla_gbrcond_x

Array rwork with DIMENSION n is a workspace.

Output Parameters

info

INTEGER .

If info = 0, the execution is successful.
If i > 0, the i -th parameter is invalid.

NOTE:

?gbtrf

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in