 
      CALL SEQUENCE...
       ggdlon  GGIN GGOUT [LOLA] OUTPUT [ -a VAL1 -kind VAL2 ]
 
 
      DESCRIPTION...
       ggdlon - LONGITUDE DERIVATIVE OF A GRID SET
 
 
      AUTHOR  - J.D.Henderson, NOV 07/80.
      LAST REVISION: $Header: /data/armnraid1/cvs/RMNLIB/utils/rdiag/lspgm/ggdlon.ptn,v 4.11 2011/01/13 18:50:17 dugas Exp $
 
 
      PURPOSE - COMPUTES LONGITUDE DERIVATIVE OF LAT-LON OR GAUSSIAN
                GRIDS IN FILE GGIN USING FINITE DIFFERENCES AND STORES
                THE RESULT ON FILE GGOUT.
 
      NOTES: 1) THE INPUT GRID TYPE IS ALWAYS ASSUMED TO BE GAUSSIAN
                WHEN DEALING WITH CCCma FILES.
             2) FOR RPN/CMC STANDARD FILES, THE SUPPORTED INPUT GRID
                TYPES ARE G (GAUSSIAN), A (LAT-LONG), B (LAT-LONG WITH
                POLES AND EQUATOR), L (GENERALIZED LAT-LONG) AND
                ROTATED, Z (VARIABLE-RESOLUTION LAT-LONG).
             3) THE COMPUTED VALUE IS 1./COS(LAT) * D(GG)/D(LON).
 
      NOTES CONCERNING THE USE OF FILE LOLA...
             1) THE COORDINATES IN LOLA WILL GENERALLY REFER TO A
                NON-ROTATED STANDARD GEOGRAPHICAL FRAME OF REFERENCE.
             2) THE FILE SHOULD HOLD 2D 'LO' AND 'LA' VARIABLES, BOTH
                IN UNITS OF DEGREES.
             3) THIS FILE CAN ONLY BE USED WITH 'Z' GRID TYPES. IF IT
                IS NOT PROVIDED, OPERATIONS ON A 'Z' GRID WILL BE DONE
                IN THE GRID'S OWN FRAME OF REFERENCE.
 
 
      INPUT FILE...
       GGIN  = GLOBAL OR HEMISPHERIC GRIDS
       LOLA  = [OPTIONAL] 2D GRID POINT LONGITUDES AND LATITUDES.
 
 
      OUTPUT FILE...
       GGOUT = LONGITUDE DERIVATIVES.
 
 
      INPUT PARAMETERS (ONLY USED WHEN FILE LOLA IS SPECIFIED)...
 
       A     = DELTA LONGITUDE VALUE TO BE USED IN DERIVATIVE (IN DEGREES).
               THE FORWARD AND BACKWARD FINITE DIFFERENCE POINTS WILL BE
               INTERPOLATED FROM THEIR (LON,LAT) POSITION TO (LON+A,LAT)
               AND (LON-A,LAT) POSITIONS.
       KIND >= 0; INTERPOLATION TYPE
               1 FOR LINEAR,
               2 FOR NEAREST NEIGHBOR (only RPN/CMC Standard files)
                 OTHERWISE CUBIC
            <  0 INTERPOLATION IS LINEAR
 
 
      EXIT CONDITIONS...
        0 NO PROBLEMS
        1 ABORT ERROR READING GGIN
        2 UNSUPPORTED GRID TYPE
        3 ABORT ERROR READING LOLA
        4 LOLA AND GGIN ARRAYS DIFFER IN SIZE
        5 UNABLE TO READ LONGITUDE FROM LOLA
        6 UNABLE TO READ LATITUDE FROM LOLA
        7 ERROR READING A AND/OR KIND PARAMS
