pdsyevr.f

Go to the documentation of this file.

      SUBROUTINE pdsyevr( JOBZ, RANGE, UPLO, N, A, IA, JA, 
     $                    DESCA, VL, VU, IL, IU, M, NZ, W, Z, IZ,
     $                    JZ, DESCZ, WORK, LWORK, IWORK, LIWORK,
     $                    INFO )
 
      IMPLICIT NONE
*
*  -- ScaLAPACK routine (version 2.0.2) --
*     Univ. of Tennessee, Univ. of California Berkeley, Univ. of Colorado Denver
*     May 1 2012
*
*     .. Scalar Arguments ..
      CHARACTER          JOBZ, RANGE, UPLO
      INTEGER            IA, IL, INFO, IU, IZ, JA, JZ, LIWORK, LWORK, M,
     $                   N, NZ
      DOUBLE PRECISION VL, VU
*     ..
*     .. Array Arguments ..
      INTEGER            DESCA( * ), DESCZ( * ), IWORK( * )
      DOUBLE PRECISION   A( * ), W( * ), WORK( * ), Z( * )
*     ..
*
*  Purpose
*  =======
*
*  PDSYEVR computes selected eigenvalues and, optionally, eigenvectors
*  of a real symmetric matrix A distributed in 2D blockcyclic format
*  by calling the recommended sequence of ScaLAPACK routines.  
*
*  First, the matrix A is reduced to real symmetric tridiagonal form.
*  Then, the eigenproblem is solved using the parallel MRRR algorithm.
*  Last, if eigenvectors have been computed, a backtransformation is done.
*
*  Upon successful completion, each processor stores a copy of all computed
*  eigenvalues in W. The eigenvector matrix Z is stored in 
*  2D blockcyclic format distributed over all processors.
*
*  Note that subsets of eigenvalues/vectors can be selected by
*  specifying a range of values or a range of indices for the desired
*  eigenvalues.
*
*  For constructive feedback and comments, please contact cvoemel@lbl.gov
*  C. Voemel
*
*  Arguments
*  =========
*
*  JOBZ    (global input) CHARACTER*1
*          Specifies whether or not to compute the eigenvectors:
*          = 'N':  Compute eigenvalues only.
*          = 'V':  Compute eigenvalues and eigenvectors.
*
*  RANGE   (global input) CHARACTER*1
*          = 'A': all eigenvalues will be found.
*          = 'V': all eigenvalues in the interval [VL,VU] will be found.
*          = 'I': the IL-th through IU-th eigenvalues will be found.
*
*  UPLO    (global input) CHARACTER*1
*          Specifies whether the upper or lower triangular part of the
*          symmetric matrix A is stored:
*          = 'U':  Upper triangular
*          = 'L':  Lower triangular
*
*  N       (global input) INTEGER
*          The number of rows and columns of the matrix A.  N >= 0
*
*  A       (local input/workspace) 2D block cyclic DOUBLE PRECISION array,
*          global dimension (N, N),
*          local dimension ( LLD_A, LOCc(JA+N-1) ),
*          (see Notes below for more detailed explanation of 2d arrays)  
*
*          On entry, the symmetric matrix A.  If UPLO = 'U', only the
*          upper triangular part of A is used to define the elements of
*          the symmetric matrix.  If UPLO = 'L', only the lower
*          triangular part of A is used to define the elements of the
*          symmetric matrix.
*
*          On exit, the lower triangle (if UPLO='L') or the upper
*          triangle (if UPLO='U') of A, including the diagonal, is
*          destroyed.
*
*  IA      (global input) INTEGER
*          A's global row index, which points to the beginning of the
*          submatrix which is to be operated on. 
*          It should be set to 1 when operating on a full matrix.
*
*  JA      (global input) INTEGER
*          A's global column index, which points to the beginning of
*          the submatrix which is to be operated on.
*          It should be set to 1 when operating on a full matrix.
*
*  DESCA   (global and local input) INTEGER array of dimension DLEN=9.
*          The array descriptor for the distributed matrix A.
*          The descriptor stores details about the 2D block-cyclic 
*          storage, see the notes below.
*          If DESCA is incorrect, PDSYEVR cannot guarantee
*          correct error reporting.
*          Also note the array alignment requirements specified below.
*
*  VL      (global input) DOUBLE PRECISION 
*          If RANGE='V', the lower bound of the interval to be searched
*          for eigenvalues.  Not referenced if RANGE = 'A' or 'I'.
*
*  VU      (global input) DOUBLE PRECISION 
*          If RANGE='V', the upper bound of the interval to be searched
*          for eigenvalues.  Not referenced if RANGE = 'A' or 'I'.
*
*  IL      (global input) INTEGER
*          If RANGE='I', the index (from smallest to largest) of the
*          smallest eigenvalue to be returned.  IL >= 1.
*          Not referenced if RANGE = 'A'.
*
*  IU      (global input) INTEGER
*          If RANGE='I', the index (from smallest to largest) of the
*          largest eigenvalue to be returned.  min(IL,N) <= IU <= N.
*          Not referenced if RANGE = 'A'.
*
*  M       (global output) INTEGER
*          Total number of eigenvalues found.  0 <= M <= N.
*
*  NZ      (global output) INTEGER
*          Total number of eigenvectors computed.  0 <= NZ <= M.
*          The number of columns of Z that are filled.
*          If JOBZ .NE. 'V', NZ is not referenced.
*          If JOBZ .EQ. 'V', NZ = M 
*
*  W       (global output) DOUBLE PRECISION array, dimension (N)
*          Upon successful exit, the first M entries contain the selected
*          eigenvalues in ascending order.
*
*  Z       (local output) DOUBLE PRECISION array,
*          global dimension (N, N),
*          local dimension ( LLD_Z, LOCc(JZ+N-1) )
*          (see Notes below for more detailed explanation of 2d arrays)  
*          If JOBZ = 'V', then on normal exit the first M columns of Z
*          contain the orthonormal eigenvectors of the matrix
*          corresponding to the selected eigenvalues.
*          If JOBZ = 'N', then Z is not referenced.
*
*  IZ      (global input) INTEGER
*          Z's global row index, which points to the beginning of the
*          submatrix which is to be operated on.
*          It should be set to 1 when operating on a full matrix.
*
*  JZ      (global input) INTEGER
*          Z's global column index, which points to the beginning of
*          the submatrix which is to be operated on.
*          It should be set to 1 when operating on a full matrix.
*
*  DESCZ   (global and local input) INTEGER array of dimension DLEN_.
*          The array descriptor for the distributed matrix Z.
*          The context DESCZ( CTXT_ ) must equal DESCA( CTXT_ ).
*          Also note the array alignment requirements specified below.
*
*  WORK    (local workspace/output) DOUBLE PRECISION  array,
*          dimension (LWORK)
*          On return, WORK(1) contains the optimal amount of
*          workspace required for efficient execution.
*          if JOBZ='N' WORK(1) = optimal amount of workspace
*             required to compute the eigenvalues.
*          if JOBZ='V' WORK(1) = optimal amount of workspace
*             required to compute eigenvalues and eigenvectors.
*
*  LWORK   (local input) INTEGER
*          Size of WORK, must be at least 3.
*          See below for definitions of variables used to define LWORK.
*          If no eigenvectors are requested (JOBZ = 'N') then
*             LWORK >= 2 + 5*N + MAX( 12 * NN, NB * ( NP0 + 1 ) )
*          If eigenvectors are requested (JOBZ = 'V' ) then
*             the amount of workspace required is:
*             LWORK >= 2 + 5*N + MAX( 18*NN, NP0 * MQ0 + 2 * NB * NB ) +
*               (2 + ICEIL( NEIG, NPROW*NPCOL))*NN
*
*          Variable definitions:
*             NEIG = number of eigenvectors requested
*             NB = DESCA( MB_ ) = DESCA( NB_ ) =
*                  DESCZ( MB_ ) = DESCZ( NB_ )
*             NN = MAX( N, NB, 2 )
*             DESCA( RSRC_ ) = DESCA( NB_ ) = DESCZ( RSRC_ ) =
*                              DESCZ( CSRC_ ) = 0
*             NP0 = NUMROC( NN, NB, 0, 0, NPROW )
*             MQ0 = NUMROC( MAX( NEIG, NB, 2 ), NB, 0, 0, NPCOL )
*             ICEIL( X, Y ) is a ScaLAPACK function returning
*             ceiling(X/Y)
*
*          If LWORK = -1, then LWORK is global input and a workspace
*          query is assumed; the routine only calculates the size
*          required for optimal performance for all work arrays. Each of
*          these values is returned in the first entry of the
*          corresponding work arrays, and no error message is issued by
*          PXERBLA.
*          Note that in a workspace query, for performance the optimal 
*          workspace LWOPT is returned rather than the minimum necessary 
*          WORKSPACE LWMIN. For very small matrices, LWOPT >> LWMIN.
*
*  IWORK   (local workspace) INTEGER array
*          On return, IWORK(1) contains the amount of integer workspace
*          required.
*
*  LIWORK  (local input) INTEGER
*          size of IWORK
*
*          Let  NNP = MAX( N, NPROW*NPCOL + 1, 4 ). Then:
*          LIWORK >= 12*NNP + 2*N when the eigenvectors are desired
*          LIWORK >= 10*NNP + 2*N when only the eigenvalues have to be computed
*          
*          If LIWORK = -1, then LIWORK 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    (global 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.
*
*  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, 
*  or DESCZ for the descriptor of Z, etc. 
*  The length of a ScaLAPACK descriptor is nine.
*  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
*
*  PDSYEVR assumes IEEE 754 standard compliant arithmetic. 
*
*  Alignment requirements
*  ======================
*
*  The distributed submatrices A(IA:*, JA:*) and Z(IZ:IZ+M-1,JZ:JZ+N-1)
*  must satisfy the following alignment properties:
*
*  1.Identical (quadratic) dimension: 
*    DESCA(M_) = DESCZ(M_) = DESCA(N_) = DESCZ(N_)
*  2.Quadratic conformal blocking: 
*    DESCA(MB_) = DESCA(NB_) = DESCZ(MB_) = DESCZ(NB_)
*    DESCA(RSRC_) = DESCZ(RSRC_)
*  3.MOD( IA-1, MB_A ) = MOD( IZ-1, MB_Z ) = 0
*  4.IAROW = IZROW
*
*
*     .. Parameters ..
      INTEGER            CTXT_, M_, N_,
     $                   MB_, NB_, RSRC_, CSRC_
      PARAMETER          ( CTXT_ = 2, m_ = 3, n_ = 4, mb_ = 5, nb_ = 6,
     $                   rsrc_ = 7, csrc_ = 8 )
      DOUBLE PRECISION   ZERO
      parameter( zero = 0.0d0 )
*     ..
*     .. Local Scalars ..
      LOGICAL            ALLEIG, COLBRT, DOBCST, FINISH, FIRST, INDEIG,
     $                   LOWER, LQUERY, VALEIG, VSTART, WANTZ
      INTEGER            ANB, DOL, DOU, DSTCOL, DSTROW, EIGCNT, FRSTCL,
     $                   i, iarow, ictxt, iil, iinderr, iindwlc, iinfo,
     $                   iiu, im, indd, indd2, inde, inde2, inderr,
     $                   indilu, indrw, indtau, indwlc, indwork, ipil,
     $                   ipiu, iproc, izrow, lastcl, lengthi, lengthi2,
     $                   liwmin, llwork, lwmin, lwopt, maxcls, mq00,
     $                   mycol, myil, myiu, myproc, myrow, mz, nb,
     $                   ndepth, needil, neediu, nnp, np00, npcol,
     $                   nprocs, nprow, nps, nsplit, nsytrd_lwopt,
     $                   offset, parity, rlengthi, rlengthi2, rstarti,
     $                   size1, size2, sqnpc, srccol, srcrow, starti,
     $                   zoffset
 
      DOUBLE PRECISION            PIVMIN, SAFMIN, SCALE, VLL, VUU, WL,
     $                            WU
*
*     .. Local Arrays ..
      INTEGER            IDUM1( 4 ), IDUM2( 4 )
*     ..
*     .. External Functions ..
      LOGICAL            LSAME
      INTEGER            ICEIL, INDXG2P, NUMROC, PJLAENV
      DOUBLE PRECISION   PDLAMCH
      EXTERNAL            iceil, indxg2p, lsame, numroc, pdlamch,
     $                    pjlaenv
*     ..
*     .. External Subroutines ..
      EXTERNAL            blacs_gridinfo, chk1mat, dcopy, dgebr2d,
     $                    dgebs2d, dgerv2d, dgesd2d, dlarrc, dlasrt2,
     $                    dstegr2a, dstegr2b, dstegr2, igebr2d,
     $                    igebs2d, igerv2d, igesd2d, igsum2d, pchk1mat,
     $                    pchk2mat, pdelget, pdlaevswp, pdlared1d,
     $                    pdormtr, pdsyntrd, pxerbla
*     ..
*     .. Intrinsic Functions ..
      INTRINSIC          abs, dble, ichar, int, max, min, mod, sqrt
*     ..
*     .. Executable Statements ..
*
 
 
      info = 0
***********************************************************************
*
*     Decode character arguments to find out what the code should do
*
***********************************************************************
      wantz = lsame( jobz, 'V' )
      lower = lsame( uplo, 'L' )
      alleig = lsame( range, 'A' )
      valeig = lsame( range, 'V' )
      indeig = lsame( range, 'I' )
      lquery = ( lwork.EQ.-1 .OR. liwork.EQ.-1 )
 
***********************************************************************
*
*     GET MACHINE PARAMETERS
*
***********************************************************************
      ictxt = desca( ctxt_ )
      safmin = pdlamch( ictxt, 'Safe minimum' )
 
***********************************************************************
*
*     Set up pointers into the WORK array
*     
***********************************************************************
      indtau = 1
      indd = indtau + n
      inde = indd + n + 1
      indd2 = inde + n + 1
      inde2 = indd2 + n
      indwork = inde2 + n
      llwork = lwork - indwork + 1
 
***********************************************************************
*
*     BLACS PROCESSOR GRID SETUP
*
***********************************************************************
      CALL blacs_gridinfo( ictxt, nprow, npcol, myrow, mycol )
 
 
      nprocs = nprow * npcol
      myproc = myrow * npcol + mycol
      IF( nprow.EQ.-1 ) THEN
         info = -( 800+ctxt_ )
      ELSE IF( wantz ) THEN
         IF( ictxt.NE.descz( ctxt_ ) ) THEN
            info = -( 2100+ctxt_ )
         END IF
      END IF
 
***********************************************************************
*
*     COMPUTE REAL WORKSPACE
*
***********************************************************************
      IF ( alleig ) THEN
         mz = n
      ELSE IF ( indeig ) THEN
         mz = iu - il + 1
      ELSE
*        Take upper bound for VALEIG case
         mz = n
      END IF
*     
      nb =  desca( nb_ )
      IF ( wantz ) THEN
         np00 = numroc( n, nb, 0, 0, nprow )
         mq00 = numroc( mz, nb, 0, 0, npcol )            
         indrw = indwork + max(18*n, np00*mq00 + 2*nb*nb)
         lwmin = indrw - 1 + (iceil(mz, nprocs) + 2)*n
      ELSE
         indrw = indwork + 12*n
         lwmin = indrw - 1
      END IF
*     The code that validates the input requires 3 workspace entries
      lwmin = max(3, lwmin)
      lwopt = lwmin
      anb = pjlaenv( ictxt, 3, 'PDSYTTRD', 'L', 0, 0, 0, 0 )
      sqnpc = int( sqrt( dble( nprocs ) ) )
      nps = max( numroc( n, 1, 0, 0, sqnpc ), 2*anb )
      nsytrd_lwopt = 2*( anb+1 )*( 4*nps+2 ) + ( nps+4 )*nps
      lwopt = max( lwopt, 5*n+nsytrd_lwopt )
*
      size1 = indrw - indwork
 
***********************************************************************
*
*     COMPUTE INTEGER WORKSPACE
*
***********************************************************************
      nnp = max( n, nprocs+1, 4 )
      IF ( wantz ) THEN
        liwmin = 12*nnp + 2*n 
      ELSE
        liwmin = 10*nnp + 2*n
      END IF
 
***********************************************************************
*
*     Set up pointers into the IWORK array
*     
***********************************************************************
*     Pointer to eigenpair distribution over processors
      indilu = liwmin - 2*nprocs + 1            
      size2 = indilu - 2*n 
    
 
***********************************************************************
*
*     Test the input arguments.
*
***********************************************************************
      IF( info.EQ.0 ) THEN
         CALL chk1mat( n, 4, n, 4, ia, ja, desca, 8, info )
         IF( wantz )
     $      CALL chk1mat( n, 4, n, 4, iz, jz, descz, 21, info )
*
         IF( info.EQ.0 ) THEN
            IF( .NOT.( wantz .OR. lsame( jobz, 'N' ) ) ) THEN
               info = -1
            ELSE IF( .NOT.( alleig .OR. valeig .OR. indeig ) ) THEN
               info = -2
            ELSE IF( .NOT.( lower .OR. lsame( uplo, 'U' ) ) ) THEN
               info = -3
            ELSE IF( mod( ia-1, desca( mb_ ) ).NE.0 ) THEN
               info = -6
            ELSE IF( valeig .AND. n.GT.0 .AND. vu.LE.vl ) THEN
               info = -10
            ELSE IF( indeig .AND. ( il.LT.1 .OR. il.GT.max( 1, n ) ) )
     $                THEN
               info = -11
            ELSE IF( indeig .AND. ( iu.LT.min( n, il ) .OR. iu.GT.n ) )
     $                THEN
               info = -12
            ELSE IF( lwork.LT.lwmin .AND. .NOT.lquery ) THEN
               info = -21
            ELSE IF( liwork.LT.liwmin .AND. .NOT.lquery ) THEN
               info = -23
            ELSE IF( desca( mb_ ).NE.desca( nb_ ) ) THEN
               info = -( 800+nb_ )
            END IF
            IF( wantz ) THEN
               iarow = indxg2p( 1, desca( nb_ ), myrow, 
     $                       desca( rsrc_ ), nprow )
               izrow = indxg2p( 1, desca( nb_ ), myrow, 
     $                          descz( rsrc_ ), nprow )
               IF( iarow.NE.izrow ) THEN
                  info = -19
               ELSE IF( mod( ia-1, desca( mb_ ) ).NE.
     $             mod( iz-1, descz( mb_ ) ) ) THEN
                  info = -19
               ELSE IF( desca( m_ ).NE.descz( m_ ) ) THEN
                  info = -( 2100+m_ )
               ELSE IF( desca( n_ ).NE.descz( n_ ) ) THEN
                  info = -( 2100+n_ )
               ELSE IF( desca( mb_ ).NE.descz( mb_ ) ) THEN
                  info = -( 2100+mb_ )
               ELSE IF( desca( nb_ ).NE.descz( nb_ ) ) THEN
                  info = -( 2100+nb_ )
               ELSE IF( desca( rsrc_ ).NE.descz( rsrc_ ) ) THEN
                  info = -( 2100+rsrc_ )
               ELSE IF( desca( csrc_ ).NE.descz( csrc_ ) ) THEN
                  info = -( 2100+csrc_ )
               ELSE IF( ictxt.NE.descz( ctxt_ ) ) THEN
                  info = -( 2100+ctxt_ )
               END IF
            END IF
         END IF
         idum2( 1 ) = 1
         IF( lower ) THEN
            idum1( 2 ) = ichar( 'L' )
         ELSE
            idum1( 2 ) = ichar( 'U' )
         END IF
         idum2( 2 ) = 2
         IF( alleig ) THEN
            idum1( 3 ) = ichar( 'A' )
         ELSE IF( indeig ) THEN
            idum1( 3 ) = ichar( 'I' )
         ELSE
            idum1( 3 ) = ichar( 'V' )
         END IF
         idum2( 3 ) = 3
         IF( lquery ) THEN
            idum1( 4 ) = -1
         ELSE
            idum1( 4 ) = 1
         END IF
         idum2( 4 ) = 4
         IF( wantz ) THEN
            idum1( 1 ) = ichar( 'V' )
            CALL pchk2mat( n, 4, n, 4, ia, ja, desca, 8, n, 4, n, 4, iz,
     $                     jz, descz, 21, 4, idum1, idum2, info )
         ELSE
            idum1( 1 ) = ichar( 'N' )
            CALL pchk1mat( n, 4, n, 4, ia, ja, desca, 8, 4, idum1,
     $                     idum2, info )
         END IF
         work( 1 ) = dble( lwopt )
         iwork( 1 ) = liwmin
      END IF
*
      IF( info.NE.0 ) THEN
         CALL pxerbla( ictxt, 'PDSYEVR', -info )
         RETURN
      ELSE IF( lquery ) THEN
         RETURN
      END IF
 
***********************************************************************
*
*     Quick return if possible
*
***********************************************************************
      IF( n.EQ.0 ) THEN
         IF( wantz ) THEN
            nz = 0
         END IF
         m = 0
         work( 1 ) = dble( lwopt )
         iwork( 1 ) = liwmin
         RETURN
      END IF
 
      IF( valeig ) THEN
         vll = vl
         vuu = vu
      ELSE
         vll = zero
         vuu = zero
      END IF
*
*     No scaling done here, leave this to MRRR kernel.
*     Scale tridiagonal rather than full matrix.
*
***********************************************************************
*
*     REDUCE SYMMETRIC MATRIX TO TRIDIAGONAL FORM.
*
***********************************************************************
 
 
      CALL pdsyntrd( uplo, n, a, ia, ja, desca, work( indd ),
     $               work( inde ), work( indtau ), work( indwork ),
     $               llwork, iinfo )
 
 
      IF (iinfo .NE. 0) THEN
         CALL pxerbla( ictxt, 'PDSYNTRD', -iinfo )
         RETURN
      END IF
 
***********************************************************************
*
*     DISTRIBUTE TRIDIAGONAL TO ALL PROCESSORS
*
***********************************************************************
      offset = 0
      IF( ia.EQ.1 .AND. ja.EQ.1 .AND. 
     $    desca( rsrc_ ).EQ.0 .AND. desca( csrc_ ).EQ.0 )
     $   THEN
         CALL pdlared1d( n, ia, ja, desca, work( indd ), work( indd2 ),
     $                   work( indwork ), llwork )
*
         CALL pdlared1d( n, ia, ja, desca, work( inde ), work( inde2 ),
     $                   work( indwork ), llwork )
         IF( .NOT.lower )
     $      offset = 1
      ELSE
         DO 10 i = 1, n
            CALL pdelget( 'A', ' ', WORK( INDD2+I-1 ), A, I+IA-1,
     $                    I+JA-1, DESCA )
   10    CONTINUE
         IF( LSAME( UPLO, 'u' ) ) THEN
            DO 20 I = 1, N - 1
               CALL PDELGET( 'a', ' ', WORK( INDE2+I-1 ), A, I+IA-1,
     $                       I+JA, DESCA )
   20       CONTINUE
         ELSE
            DO 30 I = 1, N - 1
               CALL PDELGET( 'a', ' ', WORK( INDE2+I-1 ), A, I+IA,
     $                       I+JA-1, DESCA )
   30       CONTINUE
         END IF
      END IF
 
 
 
 
***********************************************************************
*
*     SET IIL, IIU
*
***********************************************************************
      IF ( ALLEIG ) THEN 
         IIL = 1
         IIU = N
      ELSE IF ( INDEIG ) THEN
         IIL = IL
         IIU = IU
      ELSE IF ( VALEIG ) THEN
         CALL DLARRC('t', N, VLL, VUU, WORK( INDD2 ), 
     $    WORK( INDE2 + OFFSET ), SAFMIN, EIGCNT, IIL, IIU, INFO)
*        Refine upper bound N that was taken 
         MZ = EIGCNT
         IIL = IIL + 1
      ENDIF
 
.EQ.      IF(MZ0) THEN
         M = 0
         IF( WANTZ ) THEN
            NZ = 0
         END IF
         WORK( 1 ) = DBLE( LWOPT )
         IWORK( 1 ) = LIWMIN
         RETURN
      END IF
 
      MYIL = 0
      MYIU = 0
      M = 0
      IM = 0
 
***********************************************************************
*
*     COMPUTE WORK ASSIGNMENTS
*
***********************************************************************
*
*     Each processor computes the work assignments for all processors
*
      CALL PMPIM2( IIL, IIU, NPROCS,
     $             IWORK(INDILU), IWORK(INDILU+NPROCS) )
*
*     Find local work assignment
*
      MYIL = IWORK(INDILU+MYPROC)
      MYIU = IWORK(INDILU+NPROCS+MYPROC)
 
 
      ZOFFSET = MAX(0, MYIL - IIL - 1) 
.EQ.      FIRST = ( MYIL  IIL )
 
 
***********************************************************************
*
*     CALLS TO MRRR KERNEL
*
***********************************************************************
.NOT.      IF(WANTZ) THEN
*
*        Compute eigenvalues only.
*
         IINFO = 0
.GT.         IF ( MYIL0 ) THEN
            DOL = 1
            DOU = MYIU - MYIL + 1
            CALL DSTEGR2( JOBZ, 'i', N,  WORK( INDD2 ),
     $                  WORK( INDE2+OFFSET ), VLL, VUU, MYIL, MYIU,
     $                  IM, W( 1 ), WORK( INDRW ), N, 
     $                  MYIU - MYIL + 1,
     $                  IWORK( 1 ), WORK( INDWORK ), SIZE1, 
     $                  IWORK( 2*N+1 ), SIZE2, 
     $                  DOL, DOU, ZOFFSET, IINFO )
*           DSTEGR2 zeroes out the entire W array, so we can't just give
*           it the part of W we need.  So here we copy the W entries into
*           their correct location
            DO 49 I = 1, IM
              W( MYIL-IIL+I ) = W( I )
 49         CONTINUE
*           W( MYIL ) is at W( MYIL - IIL + 1 )
*           W( X ) is at W(X - IIL + 1 )
         END IF
.NE.         IF (IINFO  0) THEN
            CALL PXERBLA( ICTXT, 'dstegr2', -IINFO )
            RETURN
         END IF
.AND..EQ.      ELSEIF ( WANTZ  NPROCS1 ) THEN
*
*        Compute eigenvalues and -vectors, but only on one processor
*
         IINFO = 0
.GT.         IF ( MYIL0 ) THEN
            DOL = MYIL - IIL + 1
            DOU = MYIU - IIL + 1
            CALL DSTEGR2( JOBZ, 'i', N,  WORK( INDD2 ),
     $                  WORK( INDE2+OFFSET ), VLL, VUU, IIL, IIU,
     $                  IM, W( 1 ), WORK( INDRW ), N, 
     $                  N,
     $                  IWORK( 1 ), WORK( INDWORK ), SIZE1, 
     $                  IWORK( 2*N+1 ), SIZE2, DOL, DOU,
     $                  ZOFFSET, IINFO )
         ENDIF
.NE.         IF (IINFO  0) THEN
            CALL PXERBLA( ICTXT, 'dstegr2', -IINFO )
            RETURN
         END IF
      ELSEIF ( WANTZ ) THEN
*
*        Compute representations in parallel.
*        Share eigenvalue computation for root between all processors
*        Then compute the eigenvectors. 
*
         IINFO = 0
*        Part 1. compute root representations and root eigenvalues
.GT.         IF ( MYIL0 ) THEN
            DOL = MYIL - IIL + 1
            DOU = MYIU - IIL + 1
            CALL DSTEGR2A( JOBZ, 'i', N,  WORK( INDD2 ),
     $                  WORK( INDE2+OFFSET ), VLL, VUU, IIL, IIU,
     $                  IM, W( 1 ), WORK( INDRW ), N, 
     $                  N, WORK( INDWORK ), SIZE1, 
     $                  IWORK( 2*N+1 ), SIZE2, DOL, 
     $                  DOU, NEEDIL, NEEDIU,
     $                  INDERR, NSPLIT, PIVMIN, SCALE, WL, WU,
     $                  IINFO )
         ENDIF
.NE.         IF (IINFO  0) THEN
            CALL PXERBLA( ICTXT, 'dstegr2a', -IINFO )
            RETURN
         END IF
*
*        The second part of parallel MRRR, the representation tree
*        construction begins. Upon successful completion, the 
*        eigenvectors have been computed. This is indicated by
*        the flag FINISH.
*
         VSTART = .TRUE.
.LE.         FINISH = (MYIL0)
C        Part 2. Share eigenvalues and uncertainties between all processors
         IINDERR = INDWORK + INDERR - 1
 
*
*
*        There are currently two ways to communicate eigenvalue information
*        using the BLACS.
*        1.) BROADCAST 
*        2.) POINT2POINT between collaborators (those processors working
*            jointly on a cluster.
*        For efficiency, BROADCAST has been disabled.
*        At a later stage, other more efficient communication algorithms 
*        might be implemented, e. g. group or tree-based communication.
*
         DOBCST = .FALSE.
         IF(DOBCST) THEN
*           First gather everything on the first processor.
*           Then use BROADCAST-based communication 
            DO 45 I = 2, NPROCS
.EQ.               IF (MYPROC  (I - 1)) THEN
                  DSTROW = 0
                  DSTCOL = 0
                  STARTI = DOL
                  IWORK(1) = STARTI
.GT.                  IF(MYIL0) THEN
                     LENGTHI = MYIU - MYIL + 1
                  ELSE
                     LENGTHI = 0
                  ENDIF
                  IWORK(2) = LENGTHI
                  CALL IGESD2D( ICTXT, 2, 1, IWORK, 2, 
     $                    DSTROW, DSTCOL )
.GE..AND..GE.                  IF (( STARTI1 )  ( LENGTHI1 )) THEN
                     LENGTHI2 = 2*LENGTHI
*                    Copy eigenvalues into communication buffer
                     CALL DCOPY(LENGTHI,W( STARTI ),1,
     $                          WORK( INDD ), 1)                    
*                    Copy uncertainties into communication buffer
                     CALL DCOPY(LENGTHI,WORK( IINDERR+STARTI-1 ),1,
     $                          WORK( INDD+LENGTHI ), 1)                    
*                    send buffer
                     CALL DGESD2D( ICTXT, LENGTHI2, 
     $                    1, WORK( INDD ), LENGTHI2,
     $                    DSTROW, DSTCOL )
                  END IF
.EQ.               ELSE IF (MYPROC  0) THEN
                  SRCROW = (I-1) / NPCOL
                  SRCCOL = MOD(I-1, NPCOL)
                  CALL IGERV2D( ICTXT, 2, 1, IWORK, 2, 
     $                    SRCROW, SRCCOL )
                  STARTI = IWORK(1)
                  LENGTHI = IWORK(2)
.GE..AND..GE.                  IF (( STARTI1 )  ( LENGTHI1 )) THEN
                     LENGTHI2 = 2*LENGTHI
*                    receive buffer
                     CALL DGERV2D( ICTXT, LENGTHI2, 1,
     $                 WORK(INDD), LENGTHI2, SRCROW, SRCCOL )
*                    copy eigenvalues from communication buffer
                     CALL DCOPY( LENGTHI, WORK(INDD), 1,
     $                          W( STARTI ), 1)                    
*                    copy uncertainties (errors) from communication buffer
                     CALL DCOPY(LENGTHI,WORK(INDD+LENGTHI),1,
     $                          WORK( IINDERR+STARTI-1 ), 1)     
                  END IF
               END IF
  45        CONTINUE
            LENGTHI = IIU - IIL + 1
            LENGTHI2 = LENGTHI * 2
.EQ.            IF (MYPROC  0) THEN
*              Broadcast eigenvalues and errors to all processors
               CALL DCOPY(LENGTHI,W ,1, WORK( INDD ), 1)                 
               CALL DCOPY(LENGTHI,WORK( IINDERR ),1,
     $                          WORK( INDD+LENGTHI ), 1)                    
               CALL DGEBS2D( ICTXT, 'a', ' ', LENGTHI2, 1, 
     $              WORK(INDD), LENGTHI2 )
            ELSE
               SRCROW = 0
               SRCCOL = 0
               CALL DGEBR2D( ICTXT, 'a', ' ', LENGTHI2, 1,
     $             WORK(INDD), LENGTHI2, SRCROW, SRCCOL )
               CALL DCOPY( LENGTHI, WORK(INDD), 1, W, 1)
               CALL DCOPY(LENGTHI,WORK(INDD+LENGTHI),1,
     $                          WORK( IINDERR ), 1)                   
            END IF
         ELSE
*
*           Enable point2point communication between collaborators
*
*           Find collaborators of MYPROC            
.GT..AND..GT.            IF( (NPROCS1)(MYIL0) ) THEN
               CALL PMPCOL( MYPROC, NPROCS, IIL, NEEDIL, NEEDIU, 
     $                   IWORK(INDILU), IWORK(INDILU+NPROCS),
     $                   COLBRT, FRSTCL, LASTCL )
            ELSE
               COLBRT = .FALSE.
            ENDIF
 
            IF(COLBRT) THEN
*              If the processor collaborates with others,
*              communicate information. 
               DO 47 IPROC = FRSTCL, LASTCL
.EQ.                  IF (MYPROC  IPROC) THEN
                     STARTI = DOL
                     IWORK(1) = STARTI
                     LENGTHI = MYIU - MYIL + 1
                     IWORK(2) = LENGTHI
                     
.GE..AND..GE.                     IF ((STARTI1)  (LENGTHI1)) THEN
*                       Copy eigenvalues into communication buffer
                        CALL DCOPY(LENGTHI,W( STARTI ),1,
     $                              WORK(INDD), 1)                    
*                       Copy uncertainties into communication buffer
                        CALL DCOPY(LENGTHI,
     $                          WORK( IINDERR+STARTI-1 ),1,
     $                          WORK(INDD+LENGTHI), 1)                    
                     ENDIF
 
                     DO 46 I = FRSTCL, LASTCL                      
.EQ.                        IF(IMYPROC) GOTO 46
                        DSTROW = I/ NPCOL
                        DSTCOL = MOD(I, NPCOL)
                        CALL IGESD2D( ICTXT, 2, 1, IWORK, 2, 
     $                             DSTROW, DSTCOL )
.GE..AND..GE.                        IF ((STARTI1)  (LENGTHI1)) THEN
                           LENGTHI2 = 2*LENGTHI
*                          send buffer
                           CALL DGESD2D( ICTXT, LENGTHI2, 
     $                          1, WORK(INDD), LENGTHI2,
     $                          DSTROW, DSTCOL )
                        END IF
  46                 CONTINUE
                  ELSE
                     SRCROW = IPROC / NPCOL
                     SRCCOL = MOD(IPROC, NPCOL)
                     CALL IGERV2D( ICTXT, 2, 1, IWORK, 2, 
     $                             SRCROW, SRCCOL )
                     RSTARTI = IWORK(1)
                     RLENGTHI = IWORK(2)
.GE..AND..GE.                     IF ((RSTARTI1 )  (RLENGTHI1 )) THEN
                        RLENGTHI2 = 2*RLENGTHI
                        CALL DGERV2D( ICTXT, RLENGTHI2, 1,
     $                      WORK(INDE), RLENGTHI2,
     $                      SRCROW, SRCCOL )
*                       copy eigenvalues from communication buffer
                        CALL DCOPY( RLENGTHI, WORK(INDE), 1,
     $                          W( RSTARTI ), 1)                    
*                       copy uncertainties (errors) from communication buffer
                        CALL DCOPY(RLENGTHI,WORK(INDE+RLENGTHI),1,
     $                          WORK( IINDERR+RSTARTI-1 ), 1)                    
                     END IF
                  END IF
  47           CONTINUE
            ENDIF
         ENDIF
 
*
*        Part 3. Compute representation tree and eigenvectors.
*                What follows is a loop in which the tree
*                is constructed in parallel from top to bottom,
*                on level at a time, until all eigenvectors
*                have been computed.
*      
 100     CONTINUE
.GT.         IF ( MYIL0 ) THEN
            CALL DSTEGR2B( JOBZ, N,  WORK( INDD2 ),
     $                  WORK( INDE2+OFFSET ), 
     $                  IM, W( 1 ), WORK( INDRW ), N, N,
     $                  IWORK( 1 ), WORK( INDWORK ), SIZE1, 
     $                  IWORK( 2*N+1 ), SIZE2, DOL, 
     $                  DOU, NEEDIL, NEEDIU, INDWLC,
     $                  PIVMIN, SCALE, WL, WU,
     $                  VSTART, FINISH, 
     $                  MAXCLS, NDEPTH, PARITY, ZOFFSET, IINFO )
            IINDWLC = INDWORK + INDWLC - 1
.NOT.            IF(FINISH) THEN
.LT..OR..GT.               IF((NEEDILDOL)(NEEDIUDOU)) THEN
                  CALL PMPCOL( MYPROC, NPROCS, IIL, NEEDIL, NEEDIU,
     $                 IWORK(INDILU), IWORK(INDILU+NPROCS),
     $                   COLBRT, FRSTCL, LASTCL )
               ELSE
                  COLBRT = .FALSE.
                  FRSTCL = MYPROC
                  LASTCL = MYPROC
               ENDIF
*
*              Check if this processor collaborates, i.e. 
*              communication is needed.
*
               IF(COLBRT) THEN
                  DO 147 IPROC = FRSTCL, LASTCL
.EQ.                     IF (MYPROC  IPROC) THEN
                        STARTI = DOL
                        IWORK(1) = STARTI
.GT.                        IF(MYIL0) THEN
                           LENGTHI = MYIU - MYIL + 1
                        ELSE
                           LENGTHI = 0
                        ENDIF
                        IWORK(2) = LENGTHI
.GE..AND..GE.                        IF ((STARTI1)(LENGTHI1)) THEN
*                          Copy eigenvalues into communication buffer
                           CALL DCOPY(LENGTHI,
     $                          WORK( IINDWLC+STARTI-1 ),1,
     $                          WORK(INDD), 1)                    
*                          Copy uncertainties into communication buffer
                           CALL DCOPY(LENGTHI,
     $                          WORK( IINDERR+STARTI-1 ),1,
     $                          WORK(INDD+LENGTHI), 1)                    
                        ENDIF
                     
                        DO 146 I = FRSTCL, LASTCL                      
.EQ.                           IF(IMYPROC) GOTO 146
                           DSTROW = I/ NPCOL
                           DSTCOL = MOD(I, NPCOL)
                           CALL IGESD2D( ICTXT, 2, 1, IWORK, 2, 
     $                             DSTROW, DSTCOL )
.GE..AND..GE.                           IF ((STARTI1)(LENGTHI1)) THEN
                              LENGTHI2 = 2*LENGTHI
*                             send buffer
                              CALL DGESD2D( ICTXT, LENGTHI2, 
     $                             1, WORK(INDD), LENGTHI2,
     $                             DSTROW, DSTCOL )
                           END IF
 146                    CONTINUE
                     ELSE
                        SRCROW = IPROC / NPCOL
                        SRCCOL = MOD(IPROC, NPCOL)
                        CALL IGERV2D( ICTXT, 2, 1, IWORK, 2, 
     $                             SRCROW, SRCCOL )
                        RSTARTI = IWORK(1)
                        RLENGTHI = IWORK(2)
.GE..AND..GE.                        IF ((RSTARTI1)(RLENGTHI1)) THEN
                           RLENGTHI2 = 2*RLENGTHI
                           CALL DGERV2D( ICTXT,RLENGTHI2, 1,
     $                         WORK(INDE),RLENGTHI2,
     $                         SRCROW, SRCCOL )
*                          copy eigenvalues from communication buffer
                           CALL DCOPY(RLENGTHI, WORK(INDE), 1,
     $                          WORK( IINDWLC+RSTARTI-1 ), 1)        
*                          copy uncertainties (errors) from communication buffer
                           CALL DCOPY(RLENGTHI,WORK(INDE+RLENGTHI),1,
     $                          WORK( IINDERR+RSTARTI-1 ), 1)            
                        END IF
                     END IF
 147              CONTINUE
               ENDIF
               GOTO 100         
            ENDIF
         ENDIF
.NE.         IF (IINFO  0) THEN
            CALL PXERBLA( ICTXT, 'dstegr2b', -IINFO )
            RETURN
         END IF
*
      ENDIF
 
*
***********************************************************************
*
*     MAIN PART ENDS HERE
*
***********************************************************************
*
***********************************************************************
*
*     ALLGATHER: EACH PROCESSOR SENDS ITS EIGENVALUES TO THE FIRST ONE,
*                THEN THE FIRST PROCESSOR BROADCASTS ALL EIGENVALUES
*
***********************************************************************
*
      DO 50 I = 2, NPROCS
.EQ.         IF (MYPROC  (I - 1)) THEN
            DSTROW = 0
            DSTCOL = 0
            STARTI = MYIL - IIL + 1
            IWORK(1) = STARTI
.GT.            IF(MYIL0) THEN
               LENGTHI = MYIU - MYIL + 1
            ELSE
               LENGTHI = 0
            ENDIF
            IWORK(2) = LENGTHI
            CALL IGESD2D( ICTXT, 2, 1, IWORK, 2, 
     $                    DSTROW, DSTCOL )
.GE..AND..GE.            IF ((STARTI1)(LENGTHI1)) THEN
               CALL DGESD2D( ICTXT, LENGTHI, 
     $              1, W( STARTI ), LENGTHI,
     $              DSTROW, DSTCOL )
            ENDIF
.EQ.         ELSE IF (MYPROC  0) THEN
            SRCROW = (I-1) / NPCOL
            SRCCOL = MOD(I-1, NPCOL)
            CALL IGERV2D( ICTXT, 2, 1, IWORK, 2, 
     $                    SRCROW, SRCCOL )
            STARTI = IWORK(1)
            LENGTHI = IWORK(2)
.GE..AND..GE.            IF ((STARTI1)(LENGTHI1)) THEN
               CALL DGERV2D( ICTXT, LENGTHI, 1,
     $                 W( STARTI ), LENGTHI, SRCROW, SRCCOL )
            ENDIF
         ENDIF
   50 CONTINUE
 
*     Accumulate M from all processors
      M = IM
      CALL IGSUM2D( ICTXT, 'a', ' ', 1, 1, M, 1, -1, -1 )
 
*     Broadcast eigenvalues to all processors
.EQ.      IF (MYPROC  0) THEN
*        Send eigenvalues
         CALL DGEBS2D( ICTXT, 'a', ' ', M, 1, W, M )
      ELSE
         SRCROW = 0
         SRCCOL = 0
         CALL DGEBR2D( ICTXT, 'a', ' ', M, 1,
     $           W, M, SRCROW, SRCCOL )
      END IF
*
*     Sort the eigenvalues and keep permutation in IWORK to
*     sort the eigenvectors accordingly
*
      DO 160 I = 1, M
         IWORK( NPROCS+1+I ) = I
  160 CONTINUE
      CALL DLASRT2( 'i', M, W, IWORK( NPROCS+2 ), IINFO )
.NE.      IF (IINFO0) THEN
         CALL PXERBLA( ICTXT, 'dlasrt2', -IINFO )
         RETURN
      END IF
 
***********************************************************************
*
*     TRANSFORM Z FROM 1D WORKSPACE INTO 2D BLOCKCYCLIC STORAGE     
*
***********************************************************************
      IF ( WANTZ ) THEN
         DO 170 I = 1, M
            IWORK( M+NPROCS+1+IWORK( NPROCS+1+I ) ) = I
  170    CONTINUE
*        Store NVS in IWORK(1:NPROCS+1) for PDLAEVSWP
         IWORK( 1 ) = 0
         DO 180 I = 1, NPROCS
*           Find IL and IU for processor i-1
*           Has already been computed by PMPIM2 and stored
            IPIL = IWORK(INDILU+I-1)
            IPIU = IWORK(INDILU+NPROCS+I-1)
.EQ.            IF (IPIL  0) THEN
               IWORK( I + 1 ) = IWORK( I )
            ELSE
               IWORK( I + 1 ) = IWORK( I ) + IPIU - IPIL + 1
            ENDIF
  180    CONTINUE
 
         IF ( FIRST ) THEN
            CALL PDLAEVSWP(N, WORK( INDRW ), N, Z, IZ, JZ, 
     $       DESCZ, IWORK( 1 ), IWORK( NPROCS+M+2 ), WORK( INDWORK ), 
     $       INDRW - INDWORK )
         ELSE
            CALL PDLAEVSWP(N, WORK( INDRW + N ), N, Z, IZ, JZ, 
     $       DESCZ, IWORK( 1 ), IWORK( NPROCS+M+2 ), WORK( INDWORK ), 
     $       INDRW - INDWORK )
         END IF
*
         NZ = M
*
 
***********************************************************************
*
*       Compute eigenvectors of A from eigenvectors of T
*
***********************************************************************
.GT.         IF( NZ0 ) THEN
           CALL PDORMTR( 'l', UPLO, 'n', N, NZ, A, IA, JA, DESCA,
     $                    WORK( INDTAU ), Z, IZ, JZ, DESCZ,
     $                    WORK( INDWORK ), SIZE1, IINFO )
         END IF
.NE.         IF (IINFO0) THEN
            CALL PXERBLA( ICTXT, 'pdormtr', -IINFO )
            RETURN
         END IF
*
 
      END IF
*
      WORK( 1 ) = DBLE( LWOPT )
      IWORK( 1 ) = LIWMIN
 
      RETURN
*
*     End of PDSYEVR
*
      END