LAQGE - 5.2 English - 68552

AOCL API Guide (68552)

Document ID
68552
Release Date
2025-12-29
Version
5.2 English
template<typename T>
void laqge(integer *m, integer *n, T *a, integer *lda, T *r, T *c, T *rowcnd, T *colcnd, T *amax, char *equed)#

LAQGE scales a general rectangular matrix, using row and column scaling factors computed by geequ.

Purpose:

   LAQGE equilibrates a general M by N matrix A using the row and
   column scaling factors in the vectors R and C.
Parameters:
  • M[in]

    M is INTEGER

    The number of rows of the matrix A. M >= 0.

  • N[in]

    N is INTEGER

    The number of columns of the matrix A. N >= 0.

  • A[inout]

    A is REAL array, dimension (LDA,N)

    On entry, the M by N matrix A. On exit, the equilibrated matrix. See EQUED for the form of the equilibrated matrix.

  • LDA[in]

    LDA is INTEGER

    The leading dimension of the array A. LDA >= fla_max(M,1).

  • R[in]

    R is REAL array, dimension (M)

    The row scale factors for A.

  • C[in]

    C is REAL array, dimension (N)

    The column scale factors for A.

  • ROWCND[in]

    ROWCND is REAL

    Ratio of the smallest R(i) to the largest R(i).

  • COLCND[in]

    COLCND is REAL

    Ratio of the smallest C(i) to the largest C(i).

  • AMAX[in]

    AMAX is REAL

    Absolute value of largest matrix entry.

  • EQUED[out]

    EQUED is CHARACTER*1

    Specifies the form of equilibration that was done.

    = ‘N’: No equilibration

    = ‘R’: Row equilibration, i.e., A has been premultiplied by diag(R).

    = ‘C’: Column equilibration, i.e., A has been postmultiplied by diag(C).

    = ‘B’: Both row and column equilibration, i.e., A has been replaced by diag(R) * A * diag(C).

template<typename T, typename Ta>
void laqge(integer *m, integer *n, T *a, integer *lda, Ta *r, Ta *c, Ta *rowcnd, Ta *colcnd, Ta *amax, char *equed)#