 
      CALL SEQUENCE...
       ggvecps  UIN VIN NUOUT NVOUT SUOUT SVOUT INPUT OUTPUT [ -dgrw VAL1 ]
       ggvecz   UIN VIN  UOUT  VOUT [THETA]                  [ -kind VAL1 ]
 
 
      DESCRIPTION...
       ggvecps - TRANSFORM LAT-LONG GRID VECTORS TO PS REPRESENTATION
       ggvecz  - TRANSFORM LAT-LONG GRID VECTORS TO/FROM ROTATED Z GRIDS
 
 
      AUTHORS - R.Laprise, L.Lefaivre - MAY 18/84
      LAST REVISION: $Header: /data/armnraid1/cvs/RMNLIB/utils/rdiag/lspgm/ggvecps.ptn,v 4.15 2008/05/03 21:06:30 dugas Exp $
 
 
      PURPOSE - 1) GGVECPS IS MEANT TO TRANSFORM WIND VECTORS FROM
                LAT-LONG GRIDS TO POLAR STEREOGRAPHIC REPRESENTATION
                AND 2) GGVECZ DOES THE SAME THING FOR THE CMC/RPN
                GEM FORECAST MODEL NATIVE Z-TYPE GRIDS.
 
      NOTES  1) THE GGVECPS TRANSFORMATION MATRIX INVOLVES A LINEAR
                COMBINATION OF SINES AND COSINES OF LONGITUDE.
             2) THE GGVECPS INPUT GRID TYPE IS ALWAYS ASSUMED
                TO BE GAUSSIAN WHEN DEALING WITH CCCma FILES.
             3) FOR RPN/CMC STANDARD FILES, THE GGVECPS INPUT GRID
                TYPES CAN BE G (GAUSSIAN), A (LAT-LONG), B (LAT-LONG
                WITH POLES AND EQUATOR) AND L (GENERALIZED LAT-LONG).
             4) THE INPUT/OUTPUT GRIDS FOR GGVECZ ARE ALWAYS TYPE Z.
             5) MISSING VALUE TREATMENT IS SUPPORTED VIA EITHER THE
               "MISSING_VALUE" ENVIRONMENT VARIABLE OR THE "-mvalue"
                COMMAND-LINE ARGUMENT. PLEASE SEE THE R.DIAG WEB
                DOCUMENTAION FOR MORE DETAILS.
 
 
      INPUT FILES...
       UIN   = FILE OF LAT-LONG GRID U WIND COMPONENTS.
       VIN   = FILE OF LAT-LONG GRID V WIND COMPONENTS.
 
      OUTPUT FILES (ggvecps)
       NUOUT = FILE OF U WINDS TO BE USED FOR NH PS MAPS
       NVOUT = FILE OF V WINDS TO BE USED FOR NH PS MAPS
       SUOUT = FILE OF U WINDS TO BE USED FOR SH PS MAPS
       SVOUT = FILE OF V WINDS TO BE USED FOR SH PS MAPS
 
      OUTPUT FILES (ggvecz)
       UOUT  = FILE OF UN-ROTATED U WINDS
       VOUT  = FILE OF UN-ROTATED V WINDS
       THETA = (OPTIONAL) LOCAL ROTATION ANGLES
 
 
      PARAMETERS (ggvecps)...
 
       DGRW = GRID ORIENTATION WITH RESPECT TO GRENWICH MERIDIAN.
              BLANK INPUT DEFAULTS TO -10.0 DEGREES.
 
       READ( 5,5010 ) DGRW
 5010  FORMAT(10X,E10.0)
 
 
      PARAMETERS (ggvecz)...
 
       KIND = 1, FROM ROTATED Z-GRID TO LAT-LONG VECTOR ORIENTATION (DEFAULT)
              2, FROM LAT-LONG TO ROTATED Z-GRID VECTOR ORIENTATION
 
 
 
      EXAMPLE OF GGVECPS INPUT CARD...
 
  GGVECPS      -10.0
 
         0123456789012345678901234567890123456789012345678901234567890
         1         2         3         4         5         6         7
 
 
      EXIT CONDITIONS...
        0 NO PROBLEMS
        1 NO LEVELS IN FILE UIN
        2 PREMATURE EOF ON UIN
        3 PREMATURE EOF ON VIN
        4 FOUND U AND V NOT THE SAME SIZE
        5 ERROR READIND STDIN FOR PARAMETERS
        6 PROBLEM WITH VARIABLE NAMES
        7 UNSUPPORTED INPUT DATA TYPE
        8 OPERATING/INPUT MODE MITMATCH
