Routine: PDORGR2()  File: SRC\pdorgr2.f

 
 
# lines: 281
  # code: 281
  # comment: 0
  # blank:0
# Variables:41
# Callers:1
# Callings:2
# Words:125
# Keywords:67
 

 

..
     .. Array Arguments ..
     ..
  Purpose
  =======
  PDORGR2 generates an M-by-N real distributed matrix Q denoting
  A(IA:IA+M-1,JA:JA+N-1) with orthonormal rows, which is defined as the
  last M rows of a product of K elementary reflectors of order N
        Q  =  H(1) H(2) . . . H(k)
  as returned by PDGERQF.
  Notes
  =====
  Each global data object is described by an associated description
  vector.  This vector stores the information required to establish
  the mapping between an object element and its corresponding process
  and memory location.
  Let A be a generic term for any 2D block cyclicly distributed array.
  Such a global array has an associated description vector DESCA.
  In the following comments, the character _ should be read as
  "of the global array".
  NOTATION        STORED IN      EXPLANATION
  --------------- -------------- --------------------------------------
  DTYPE_A(global) DESCA( DTYPE_ )The descriptor type.  In this case,
                                 DTYPE_A = 1.
  CTXT_A (global) DESCA( CTXT_ ) The BLACS context handle, indicating
                                 the BLACS process grid A is distribu-
                                 ted over. The context itself is glo-
                                 bal, but the handle (the integer
                                 value) may vary.
  M_A    (global) DESCA( M_ )    The number of rows in the global
                                 array A.
  N_A    (global) DESCA( N_ )    The number of columns in the global
                                 array A.
  MB_A   (global) DESCA( MB_ )   The blocking factor used to distribute
                                 the rows of the array.
  NB_A   (global) DESCA( NB_ )   The blocking factor used to distribute
                                 the columns of the array.
  RSRC_A (global) DESCA( RSRC_ ) The process row over which the first
                                 row of the array A is distributed.
  CSRC_A (global) DESCA( CSRC_ ) The process column over which the
                                 first column of the array A is
                                 distributed.
  LLD_A  (local)  DESCA( LLD_ )  The leading dimension of the local
                                 array.  LLD_A >= MAX(1,LOCr(M_A)).
  Let K be the number of rows or columns of a distributed matrix,
  and assume that its process grid has dimension p x q.
  LOCr( K ) denotes the number of elements of K that a process
  would receive if K were distributed over the p processes of its
  process column.
  Similarly, LOCc( K ) denotes the number of elements of K that a
  process would receive if K were distributed over the q processes of
  its process row.
  The values of LOCr() and LOCc() may be determined via a call to the
  ScaLAPACK tool function, NUMROC:
          LOCr( M ) = NUMROC( M, MB_A, MYROW, RSRC_A, NPROW ),
          LOCc( N ) = NUMROC( N, NB_A, MYCOL, CSRC_A, NPCOL ).
  An upper bound for these quantities may be computed by:
          LOCr( M ) <= ceil( ceil(M/MB_A)/NPROW )*MB_A
          LOCc( N ) <= ceil( ceil(N/NB_A)/NPCOL )*NB_A
  Arguments
  =========
  M       (global input) INTEGER
          The number of rows to be operated on i.e the number of rows
          of the distributed submatrix Q. M >= 0.
  N       (global input) INTEGER
          The number of columns to be operated on i.e the number of
          columns of the distributed submatrix Q. N >= M >= 0.
  K       (global input) INTEGER
          The number of elementary reflectors whose product defines the
          matrix Q. M >= K >= 0.
  A       (local input/local output) DOUBLE PRECISION pointer into the
          local memory to an array of dimension (LLD_A,LOCc(JA+N-1)).
          On entry, the i-th row must contain the vector which defines
          the elementary reflector H(i), IA+M-K <= i <= IA+M-1, as
          returned by PDGERQF in the K rows of its distributed
          matrix argument A(IA+M-K:IA+M-1,JA:*). On exit, this array
          contains the local pieces of the M-by-N distributed matrix Q.
  IA      (global input) INTEGER
          The row index in the global array A indicating the first
          row of sub( A ).
  JA      (global input) INTEGER
          The column index in the global array A indicating the
          first column of sub( A ).
  DESCA   (global and local input) INTEGER array of dimension DLEN_.
          The array descriptor for the distributed matrix A.
  TAU     (local input) DOUBLE PRECISION array, dimension LOCr(IA+M-1)
          This array contains the scalar factors TAU(i) of the
          elementary reflectors H(i) as returned by PDGERQF.
          TAU is tied to the distributed matrix A.
  WORK    (local workspace/local output) DOUBLE PRECISION array,
                                                   dimension (LWORK)
          On exit, WORK(1) returns the minimal and optimal LWORK.
  LWORK   (local or global input) INTEGER
          The dimension of the array WORK.
          LWORK is local input and must be at least
          LWORK >= NqA0 + MAX( 1, MpA0 ), where
          IROFFA = MOD( IA-1, MB_A ), ICOFFA = MOD( JA-1, NB_A ),
          IAROW = INDXG2P( IA, MB_A, MYROW, RSRC_A, NPROW ),
          IACOL = INDXG2P( JA, NB_A, MYCOL, CSRC_A, NPCOL ),
          MpA0 = NUMROC( M+IROFFA, MB_A, MYROW, IAROW, NPROW ),
          NqA0 = NUMROC( N+ICOFFA, NB_A, MYCOL, IACOL, NPCOL ),
          INDXG2P and NUMROC are ScaLAPACK tool functions;
          MYROW, MYCOL, NPROW and NPCOL can be determined by calling
          the subroutine BLACS_GRIDINFO.
          If LWORK = -1, then LWORK is global input and a workspace
          query is assumed; the routine only calculates the minimum
          and optimal size for all work arrays. Each of these
          values is returned in the first entry of the corresponding
          work array, and no error message is issued by PXERBLA.
  INFO    (local output) INTEGER
          = 0:  successful exit
          < 0:  If the i-th argument is an array and the j-entry had
                an illegal value, then INFO = -(i*100+j), if the i-th
                argument is a scalar and had an illegal value, then
                INFO = -i.
  =====================================================================
     .. Parameters ..

 
Display dynamic version Find AutoScroll Reload FontSize: - + Hide Comments Hide Blanks Frame FullScreen MailPrint

 
001        SUBROUTINE PDORGR2( M , N , K , A , IA , JA , DESCA , TAU , WORK , LWORK ,
002       $INFO )
003  
004  *     -- ScaLAPACK routine(version 1.7) --
005  *     University of Tennessee , Knoxville , Oak Ridge National Laboratory ,
006  *     and University of California , Berkeley.
007  *     May 25 , 2001
008  
009  *     .. Scalar Arguments ..
010        INTEGER IA , INFO , JA , K , LWORK , M , N
011        INTEGER BLOCK_CYCLIC_2D , CSRC_ , CTXT_ , DLEN_ , DTYPE_ ,
012       $LLD_ , MB_ , M_ , NB_ , N_ , RSRC_
013        PARAMETER( BLOCK_CYCLIC_2D = 1 , DLEN_ = 9 , DTYPE_ = 1 ,
014       $CTXT_ = 2 , M_ = 3 , N_ = 4 , MB_ = 5 , NB_ = 6 ,
015       $RSRC_ = 7 , CSRC_ = 8 , LLD_ = 9 )
016        DOUBLE PRECISION ONE , ZERO
017        PARAMETER( ONE = 1.0D + 0 , ZERO = 0.0D + 0 )
018  *     ..
019  *     .. Local Scalars ..
020        LOGICAL LQUERY
021        CHARACTER COLBTOP , ROWBTOP
022        INTEGER IACOL , IAROW , I , ICTXT , II , LWMIN , MP , MPA0 ,
023       $MYCOL , MYROW , NPCOL , NPROW , NQA0
024        DOUBLE PRECISION TAUI
025  *     ..
026  *     .. External Subroutines ..
027        EXTERNAL BLACS_ABORT , BLACS_GRIDINFO , CHK1MAT , PDELSET ,
028       $PDLARF , PDLASET , PDSCAL , PB_TOPGET ,
029       $PB_TOPSET , PXERBLA
030  *     ..
031  *     .. External Functions ..
032        INTEGER INDXG2L , INDXG2P , NUMROC
033        EXTERNAL INDXG2L , INDXG2P , NUMROC
034  *     ..
035  *     .. Intrinsic Functions ..
036        INTRINSIC DBLE , MAX , MIN , MOD
037  *     ..
038  *     .. Executable Statements ..
039  
040  *     Get grid parameters
041  
042        ICTXT = DESCA( CTXT_ )
043        CALL BLACS_GRIDINFO( ICTXT , NPROW , NPCOL , MYROW , MYCOL )
044  
045  *     Test the input parameters
046  
047        INFO = 0
048        IF( NPROW.EQ. - 1 ) THEN
049            INFO = - (700 + CTXT_)
050        ELSE
051            CALL CHK1MAT( M , 1 , N , 2 , IA , JA , DESCA , 7 , INFO )
052            IF( INFO.EQ.0 ) THEN
053                IAROW = INDXG2P( IA , DESCA( MB_ ) , MYROW , DESCA( RSRC_ ) ,
054       $        NPROW )
055                IACOL = INDXG2P( JA , DESCA( NB_ ) , MYCOL , DESCA( CSRC_ ) ,
056       $        NPCOL )
057                MPA0 = NUMROC( M + MOD( IA - 1 , DESCA( MB_ ) ) , DESCA( MB_ ) ,
058       $        MYROW , IAROW , NPROW )
059                NQA0 = NUMROC( N + MOD( JA - 1 , DESCA( NB_ ) ) , DESCA( NB_ ) ,
060       $        MYCOL , IACOL , NPCOL )
061                LWMIN = NQA0 + MAX( 1 , MPA0 )
062  
063                WORK( 1 ) = DBLE( LWMIN )
064                LQUERY =( LWORK.EQ. - 1 )
065                IF( N.LT.M ) THEN
066                    INFO = - 2
067                ELSE IF( K.LT.0 .OR. K.GT.M ) THEN
068                    INFO = - 3
069                ELSE IF( LWORK.LT.LWMIN .AND. .NOT.LQUERY ) THEN
070                    INFO = - 10
071                END IF
072            END IF
073        END IF
074        IF( INFO.NE.0 ) THEN
075            CALL PXERBLA( ICTXT , 'PDORGR2' , - INFO )
076            CALL BLACS_ABORT( ICTXT , 1 )
077            RETURN
078        ELSE IF( LQUERY ) THEN
079            RETURN
080        END IF
081  
082  *     Quick return if possible
083  
084        IF( M.LE.0 )
085       $    RETURN
086  
087            CALL PB_TOPGET( ICTXT , 'Broadcast' , 'Rowwise' , ROWBTOP )
088            CALL PB_TOPGET( ICTXT , 'Broadcast' , 'Columnwise' , COLBTOP )
089            CALL PB_TOPSET( ICTXT , 'Broadcast' , 'Rowwise' , ' ' )
090            CALL PB_TOPSET( ICTXT , 'Broadcast' , 'Columnwise' , 'I - ring' )
091  
092            IF( K.LT.M ) THEN
093  
094  *             Initialise rows ia : ia + m - k - 1 to rows of the unit matrix
095  
096                CALL PDLASET ( 'All' , M - K , N - M , ZERO , ZERO , A , IA , JA , DESCA )
097                CALL PDLASET ( 'All' , M - K , M , ZERO , ONE , A , IA , JA + N - M , DESCA )
098  
099            END IF
100  
101            TAUI = ZERO
102            MP = NUMROC( IA + M - 1 , DESCA( MB_ ) , MYROW , DESCA( RSRC_ ) , NPROW )
103  
104            DO 10 I = IA + M - K , IA + M - 1
105  
106  *             Apply H(i) to A(ia : i , ja : ja + n - k + i - 1) from the right
107  
108                CALL PDELSET( A , I , JA + N - M + I - IA , DESCA , ONE )
109                CALL PDLARF ( 'Right' , I - IA , I - IA + N - M + 1 , A , I , JA , DESCA ,
110       $        DESCA( M_ ) , TAU , A , IA , JA , DESCA , WORK )
111                II = INDXG2L( I , DESCA( MB_ ) , MYROW , DESCA( RSRC_ ) , NPROW )
112                IAROW = INDXG2P( I , DESCA( MB_ ) , MYROW , DESCA( RSRC_ ) ,
113       $        NPROW )
114                IF( MYROW.EQ.IAROW )
115       $            TAUI = TAU( MIN( II , MP ) )
116                    CALL PDSCAL( I - IA + N - M , - TAUI , A , I , JA , DESCA , DESCA( M_ ) )
117                    CALL PDELSET( A , I , JA + N - M + I - IA , DESCA , ONE - TAUI )
118  
119  *                 Set A(i , ja + n - m + i - ia + 1 : ja + n - 1) to zero
120  
121                    CALL PDLASET ( 'All' , 1 , IA + M - 1 - I , ZERO , ZERO , A , I ,
122       $            JA + N - M + I - IA + 1 , DESCA )
123  
124     10     CONTINUE
125  
126            CALL PB_TOPSET( ICTXT , 'Broadcast' , 'Rowwise' , ROWBTOP )
127            CALL PB_TOPSET( ICTXT , 'Broadcast' , 'Columnwise' , COLBTOP )
128  
129            WORK( 1 ) = DBLE( LWMIN )
130  
131            RETURN
132  
133  *         End of PDORGR2
134  
135        END