Provided by: liblapack-doc_3.12.0-3build2_all 
      
    
NAME
       upgtr - {up,op}gtr: generate Q from hetrd
SYNOPSIS
   Functions
       subroutine cupgtr (uplo, n, ap, tau, q, ldq, work, info)
           CUPGTR
       subroutine dopgtr (uplo, n, ap, tau, q, ldq, work, info)
           DOPGTR
       subroutine sopgtr (uplo, n, ap, tau, q, ldq, work, info)
           SOPGTR
       subroutine zupgtr (uplo, n, ap, tau, q, ldq, work, info)
           ZUPGTR
Detailed Description
Function Documentation
   subroutine cupgtr (character uplo, integer n, complex, dimension( * ) ap, complex, dimension( * ) tau,
       complex, dimension( ldq, * ) q, integer ldq, complex, dimension( * ) work, integer info)
       CUPGTR
       Purpose:
            CUPGTR generates a complex unitary matrix Q which is defined as the
            product of n-1 elementary reflectors H(i) of order n, as returned by
            CHPTRD using packed storage:
            if UPLO = 'U', Q = H(n-1) . . . H(2) H(1),
            if UPLO = 'L', Q = H(1) H(2) . . . H(n-1).
       Parameters
           UPLO
                     UPLO is CHARACTER*1
                     = 'U': Upper triangular packed storage used in previous
                            call to CHPTRD;
                     = 'L': Lower triangular packed storage used in previous
                            call to CHPTRD.
           N
                     N is INTEGER
                     The order of the matrix Q. N >= 0.
           AP
                     AP is COMPLEX array, dimension (N*(N+1)/2)
                     The vectors which define the elementary reflectors, as
                     returned by CHPTRD.
           TAU
                     TAU is COMPLEX array, dimension (N-1)
                     TAU(i) must contain the scalar factor of the elementary
                     reflector H(i), as returned by CHPTRD.
           Q
                     Q is COMPLEX array, dimension (LDQ,N)
                     The N-by-N unitary matrix Q.
           LDQ
                     LDQ is INTEGER
                     The leading dimension of the array Q. LDQ >= max(1,N).
           WORK
                     WORK is COMPLEX array, dimension (N-1)
           INFO
                     INFO is INTEGER
                     = 0:  successful exit
                     < 0:  if INFO = -i, the i-th argument had an illegal value
       Author
           Univ. of Tennessee
           Univ. of California Berkeley
           Univ. of Colorado Denver
           NAG Ltd.
   subroutine dopgtr (character uplo, integer n, double precision, dimension( * ) ap, double precision,
       dimension( * ) tau, double precision, dimension( ldq, * ) q, integer ldq, double precision, dimension( *
       ) work, integer info)
       DOPGTR
       Purpose:
            DOPGTR generates a real orthogonal matrix Q which is defined as the
            product of n-1 elementary reflectors H(i) of order n, as returned by
            DSPTRD using packed storage:
            if UPLO = 'U', Q = H(n-1) . . . H(2) H(1),
            if UPLO = 'L', Q = H(1) H(2) . . . H(n-1).
       Parameters
           UPLO
                     UPLO is CHARACTER*1
                     = 'U': Upper triangular packed storage used in previous
                            call to DSPTRD;
                     = 'L': Lower triangular packed storage used in previous
                            call to DSPTRD.
           N
                     N is INTEGER
                     The order of the matrix Q. N >= 0.
           AP
                     AP is DOUBLE PRECISION array, dimension (N*(N+1)/2)
                     The vectors which define the elementary reflectors, as
                     returned by DSPTRD.
           TAU
                     TAU is DOUBLE PRECISION array, dimension (N-1)
                     TAU(i) must contain the scalar factor of the elementary
                     reflector H(i), as returned by DSPTRD.
           Q
                     Q is DOUBLE PRECISION array, dimension (LDQ,N)
                     The N-by-N orthogonal matrix Q.
           LDQ
                     LDQ is INTEGER
                     The leading dimension of the array Q. LDQ >= max(1,N).
           WORK
                     WORK is DOUBLE PRECISION array, dimension (N-1)
           INFO
                     INFO is INTEGER
                     = 0:  successful exit
                     < 0:  if INFO = -i, the i-th argument had an illegal value
       Author
           Univ. of Tennessee
           Univ. of California Berkeley
           Univ. of Colorado Denver
           NAG Ltd.
   subroutine sopgtr (character uplo, integer n, real, dimension( * ) ap, real, dimension( * ) tau, real,
       dimension( ldq, * ) q, integer ldq, real, dimension( * ) work, integer info)
       SOPGTR
       Purpose:
            SOPGTR generates a real orthogonal matrix Q which is defined as the
            product of n-1 elementary reflectors H(i) of order n, as returned by
            SSPTRD using packed storage:
            if UPLO = 'U', Q = H(n-1) . . . H(2) H(1),
            if UPLO = 'L', Q = H(1) H(2) . . . H(n-1).
       Parameters
           UPLO
                     UPLO is CHARACTER*1
                     = 'U': Upper triangular packed storage used in previous
                            call to SSPTRD;
                     = 'L': Lower triangular packed storage used in previous
                            call to SSPTRD.
           N
                     N is INTEGER
                     The order of the matrix Q. N >= 0.
           AP
                     AP is REAL array, dimension (N*(N+1)/2)
                     The vectors which define the elementary reflectors, as
                     returned by SSPTRD.
           TAU
                     TAU is REAL array, dimension (N-1)
                     TAU(i) must contain the scalar factor of the elementary
                     reflector H(i), as returned by SSPTRD.
           Q
                     Q is REAL array, dimension (LDQ,N)
                     The N-by-N orthogonal matrix Q.
           LDQ
                     LDQ is INTEGER
                     The leading dimension of the array Q. LDQ >= max(1,N).
           WORK
                     WORK is REAL array, dimension (N-1)
           INFO
                     INFO is INTEGER
                     = 0:  successful exit
                     < 0:  if INFO = -i, the i-th argument had an illegal value
       Author
           Univ. of Tennessee
           Univ. of California Berkeley
           Univ. of Colorado Denver
           NAG Ltd.
   subroutine zupgtr (character uplo, integer n, complex*16, dimension( * ) ap, complex*16, dimension( * ) tau,
       complex*16, dimension( ldq, * ) q, integer ldq, complex*16, dimension( * ) work, integer info)
       ZUPGTR
       Purpose:
            ZUPGTR generates a complex unitary matrix Q which is defined as the
            product of n-1 elementary reflectors H(i) of order n, as returned by
            ZHPTRD using packed storage:
            if UPLO = 'U', Q = H(n-1) . . . H(2) H(1),
            if UPLO = 'L', Q = H(1) H(2) . . . H(n-1).
       Parameters
           UPLO
                     UPLO is CHARACTER*1
                     = 'U': Upper triangular packed storage used in previous
                            call to ZHPTRD;
                     = 'L': Lower triangular packed storage used in previous
                            call to ZHPTRD.
           N
                     N is INTEGER
                     The order of the matrix Q. N >= 0.
           AP
                     AP is COMPLEX*16 array, dimension (N*(N+1)/2)
                     The vectors which define the elementary reflectors, as
                     returned by ZHPTRD.
           TAU
                     TAU is COMPLEX*16 array, dimension (N-1)
                     TAU(i) must contain the scalar factor of the elementary
                     reflector H(i), as returned by ZHPTRD.
           Q
                     Q is COMPLEX*16 array, dimension (LDQ,N)
                     The N-by-N unitary matrix Q.
           LDQ
                     LDQ is INTEGER
                     The leading dimension of the array Q. LDQ >= max(1,N).
           WORK
                     WORK is COMPLEX*16 array, dimension (N-1)
           INFO
                     INFO is INTEGER
                     = 0:  successful exit
                     < 0:  if INFO = -i, the i-th argument had an illegal value
       Author
           Univ. of Tennessee
           Univ. of California Berkeley
           Univ. of Colorado Denver
           NAG Ltd.
Author
       Generated automatically by Doxygen for LAPACK from the source code.
Version 3.12.0                               Thu Aug 8 2024 12:55:44                                    upgtr(3)