CUPMTR man page on IRIX

Man page or keyword search:  
man Server   31559 pages
apropos Keyword Search (all sections)
Output format
IRIX logo
[printable version]



CUPMTR(3F)							    CUPMTR(3F)

NAME
     CUPMTR - overwrite the general complex M-by-N matrix C with   SIDE = 'L'
     SIDE = 'R' TRANS = 'N'

SYNOPSIS
     SUBROUTINE CUPMTR( SIDE, UPLO, TRANS, M, N, AP, TAU, C, LDC, WORK, INFO )

	 CHARACTER	SIDE, TRANS, UPLO

	 INTEGER	INFO, LDC, M, N

	 COMPLEX	AP( * ), C( LDC, * ), TAU( * ), WORK( * )

PURPOSE
     CUPMTR overwrites the general complex M-by-N matrix C with TRANS = 'C':
     Q**H * C	    C * Q**H

     where Q is a complex unitary matrix of order nq, with nq = m if SIDE =
     'L' and nq = n if SIDE = 'R'. Q is defined as the product of nq-1
     elementary reflectors, as returned by CHPTRD using packed storage:

     if UPLO = 'U', Q = H(nq-1) . . . H(2) H(1);

     if UPLO = 'L', Q = H(1) H(2) . . . H(nq-1).

ARGUMENTS
     SIDE    (input) CHARACTER*1
	     = 'L': apply Q or Q**H from the Left;
	     = 'R': apply Q or Q**H from the Right.

     UPLO    (input) CHARACTER*1
	     = 'U': Upper triangular packed storage used in previous call to
	     CHPTRD; = 'L': Lower triangular packed storage used in previous
	     call to CHPTRD.

     TRANS   (input) CHARACTER*1
	     = 'N':  No transpose, apply Q;
	     = 'C':  Conjugate transpose, apply Q**H.

     M	     (input) INTEGER
	     The number of rows of the matrix C. M >= 0.

     N	     (input) INTEGER
	     The number of columns of the matrix C. N >= 0.

     AP	     (input) COMPLEX array, dimension
	     (M*(M+1)/2) if SIDE = 'L' (N*(N+1)/2) if SIDE = 'R' The vectors
	     which define the elementary reflectors, as returned by CHPTRD.
	     AP is modified by the routine but restored on exit.

									Page 1

CUPMTR(3F)							    CUPMTR(3F)

     TAU     (input) COMPLEX array, dimension (M-1) if SIDE = 'L'
	     or (N-1) if SIDE = 'R' TAU(i) must contain the scalar factor of
	     the elementary reflector H(i), as returned by CHPTRD.

     C	     (input/output) COMPLEX array, dimension (LDC,N)
	     On entry, the M-by-N matrix C.  On exit, C is overwritten by Q*C
	     or Q**H*C or C*Q**H or C*Q.

     LDC     (input) INTEGER
	     The leading dimension of the array C. LDC >= max(1,M).

     WORK    (workspace) COMPLEX array, dimension
	     (N) if SIDE = 'L' (M) if SIDE = 'R'

     INFO    (output) INTEGER
	     = 0:  successful exit
	     < 0:  if INFO = -i, the i-th argument had an illegal value

									Page 2

[top]

List of man pages available for IRIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net