 
      CALL SEQUENCE...
       randeof  INCOMP OUTCOMP INEOF OUTEOF INPUT OUTPUT\
                     [-a VAL1 -b VAL2 -c VAL3 -kind VAL4]
 
 
      AUTHOR - B.Dugas, AVRIL 21/87.
      LAST REVISION: $Header: /data/armnraid1/cvs/RMNLIB/utils/rdiag/lspgm/randeof.ptn,v 4.4 2008/05/03 21:06:30 dugas Exp $
 
 
      DESCRIPTION...
       CALCUL DU TEST Q  DE PREISENDORFER ET AL. POUR LES  COMPOSANTES 
       PRINCIPALES (REF. "FOUNDATIONS OF PRINCIPAL COMPONENT SELECTION 
       RULES", SIO REFERENCE  SERIES 81-4, 1981, 192 PP.) APPLIQUE IN- 
       DIVIDUELLEMENT  A CHACUNE  D'ENTRE ELLES. LES VECTEURS  PROPRES 
       DE LA MATRICE DE COVARIANCE CORRESPONDANT AUX COMPOSANTES RETE- 
       NUES LE SONT AUSSI. IL DOIT Y AVOIR AUTANT DE ECTEURS  PROPRES
       QUE DE COMPOSANTES PRINCIPALES.
 
 
      PARAMETERS...
       K    (a) = DEPHASAGE MAXIMAL (DOIT ETRE << LONGUEUR TOTALE / 2).
       CRIT (b) = VALEUR CRITIQUE DU REFUS DE L'HYPOTHESE NULLE. 
       NMAX (c) = NOMBRE DE COMPOSANTES A CONSERVER (TRIEES SELON 
                  LEUR SCORE AU TEST Q). SI NMAX EST EGAL A ZERO,
                  TOUS LES MODES QUI PASSENT LE TEST SONT RETENUS.
       KIND     = 1, SI INCOMP CONTIENT LA TRANSPOSEE DE LA MATRICE
                     DES COMPOSANTES PRINCIPALES
                  0, SINON (VALEUR PAR DEFAUT).
 
       READ( 5,5000 ) K,CRIT,NMAX,KIND
 5000  FORMAT(10X,I5,E10.0,2I5)
 
 
      EXAMPLES OF INPUT CARD...
 
  RANDEOF    10  23.20924    9    0   !  AT 99%
  RANDEOF    10  18.30704    9    0   !  AT 95%
  RANDEOF    10  15.98718    9    0   !  AT 90%
  RANDEOF    20  37.56625    9    0   !  AT 99%
  RANDEOF    20  31.41043    9    0   !  AT 95%
  RANDEOF    20  28.41198    9    0   !  AT 90%
  RANDEOF    30  50.89220    9    0   !  AT 99%
  RANDEOF    30  43.77297    9    0   !  AT 95%
  RANDEOF    30  40.25603    9    0   !  AT 90%
 
         0123456789012345678901234567890123456789012345678901234567890
         1         2         3         4         5         6         7
 
 
 
      EXIT CONDITIONS...
        0 NO PROBLEMS
        1 INCOMP AND INPUT DATA NOT COHERENT
        2 INCOMP AND INEOF ARE INCONSISTENT
        3 MEMORY ALLOCATION PROBLEMS
        4 ERROR DECODING FIRST COMPONENT
        5 NOT AS MANY EOF SETS AS PRINCIPAL COMPONENTS
        6 PREMATURE END OF FILE ON INPUT
        7 PREMATURE END OF FILE ON INCOMP
        8 PREMATURE END OF FILE ON INEOF
