MA02ID - SLICOT Library Routine Documentation

## MA02ID

### Matrix 1-, Frobenius, or infinity norms of a skew-Hamiltonian matrix

[Specification] [Arguments] [Method] [References] [Comments] [Example]

Purpose

      To compute the value of the one norm, or the Frobenius norm, or
      the infinity norm, or the element of largest absolute value
      of a real skew-Hamiltonian matrix

                    [  A   G  ]          T         T
              X  =  [       T ],   G = -G,   Q = -Q,
                    [  Q   A  ]

      or of a real Hamiltonian matrix

                    [  A   G  ]          T         T
              X  =  [       T ],   G =  G,   Q =  Q,
                    [  Q  -A  ]

      where A, G and Q are real n-by-n matrices.

      Note that for this kind of matrices the infinity norm is equal
      to the one norm.

Specification

          DOUBLE PRECISION FUNCTION MA02ID( TYP, NORM, N, A, LDA, QG,
         $                                  LDQG, DWORK )
    C     .. Scalar Arguments ..
          CHARACTER          NORM, TYP
          INTEGER            LDA, LDQG, N
    C     .. Array Arguments ..
          DOUBLE PRECISION   A(LDA,*), DWORK(*), QG(LDQG,*)

Function Value

      MA02ID  DOUBLE PRECISION
              The computed norm.

Arguments

Mode Parameters

      TYP     CHARACTER*1
              Specifies the type of the input matrix X:
              = 'S':         X is skew-Hamiltonian;
              = 'H':         X is Hamiltonian.

      NORM    CHARACTER*1
              Specifies the value to be returned in MA02ID:
              = '1' or 'O':  one norm of X;
              = 'F' or 'E':  Frobenius norm of X;
              = 'I':         infinity norm of X;
              = 'M':         max(abs(X(i,j)).

Input/Output Parameters

      N       (input) INTEGER
              The order of the matrix A.  N >= 0.

      A       (input) DOUBLE PRECISION array, dimension (LDA,N)
              On entry, the leading N-by-N part of this array must
              contain the matrix A.

      LDA     INTEGER
              The leading dimension of the array A.  LDA >= MAX(1,N).

      QG      (input) DOUBLE PRECISION array, dimension (LDQG,N+1)
              On entry, the leading N-by-N+1 part of this array must
              contain in columns 1:N the lower triangular part of the
              matrix Q and in columns 2:N+1 the upper triangular part
              of the matrix G. If TYP = 'S', the parts containing the
              diagonal and the first supdiagonal of this array are not
              referenced.

      LDQG    INTEGER
              The leading dimension of the array QG.  LDQG >= MAX(1,N).

Workspace

      DWORK   DOUBLE PRECISION array, dimension (LDWORK)
              where LDWORK >= 2*N when NORM = '1', NORM = 'I' or
              NORM = 'O'; otherwise, DWORK is not referenced.

Further Comments

      None

Example

Program Text

      None

Program Data

      None

Program Results

      None

Return to Supporting Routines index