NAME

       Conpack - Provides a sort of tool kit of FORTRAN subroutines that can be called in various
       combinations to draw different kinds of contour plots.

SYNOPSIS

       CPBACK - Draws a background for a contour plot.

       CPCICA - Incorporates into a user's cell array color indices determined by examining where
       the user's contours lie relative to the cell array.

       CPCLAM - Adds contour lines to an area map. This is part of the process of drawing a
       solid-fill contour plot.

       CPCLDM - Draws contour lines masked by an existing area map. The object of this may be
       simply to avoid drawing contour lines through label boxes, but the routine may be used for
       more complicated tasks, like limiting the drawing of contour lines to the ocean areas on
       an Ezmap background.

       CPCLDR - Draws contour lines.

       CPCLTR - Traces the contour lines at a given level and retrieves them for some sort of
       user-defined processing.

       CPCNRC - Draws black and white contours with a single call.  Simulates the behavior of the
       old routine CONREC; it has the same arguments and produces similar output.

       CPEZCT - Draws black and white contours with a single call.  Simulates the behavior of the
       old subroutine EZCNTR in Conrec_family; it has the same arguments and will produce similar
       output.

       CPGETC - Retrieves the current value of an internal parameter of type CHARACTER.

       CPGETI - Retrieves the current value of an internal parameter of type INTEGER.

       CPGETR - Retrieves the current value of an internal parameter of type REAL.

       CPLBAM - Adds label boxes (for the informational label, high and low labels, and contour-
       line labels) to an area map. The ultimate object of this will usually be to prevent
       contour lines drawn by CPCLDM from passing through labels or to prevent fill of the label
       boxes as contour bands are filled.

       CPLBDR - Draws labels (an informational label, high and low labels, and line labels).

       CPMVIW - Moves the contents of an old integer workspace to a new one.

       CPMVRW - Moves the contents of an old real workspace to a new one.

       CPPKCL - Picks a set of contour levels.

       CPPKLB - Picks a set of labels for labeled contour levels.

       CPRECT - Initializes the contouring of a rectangular array of data.

       CPRSET - Resets all parameters to their initial default values.

       CPSETC - Sets the value of an internal parameter of type CHARACTER.

       CPSETI - Sets the value of an internal parameter of type INTEGER.

       CPSETR - Sets the value of an internal parameter of type REAL.

       CPSPS1 - Interpolates from an array of data on a "sparse" rectangular grid which is
       regularly spaced in X and Y to an array of data on a "dense" rectangular grid and to
       initialize contouring from the array on the dense grid. (By a "sparse" grid is meant one
       whose dimensions are smaller than one would like, so that contour lines constructed
       directly on it are composed of long straight segments.) CPSPS1 may be viewed as a data
       smoothing routine.

       CPSPS2 - Interpolates from an array of data on a "sparse" rectangular grid which is
       irregularly spaced in X and Y to an array of data on a "dense" rectangular grid and to
       initialize contouring from the array on the dense grid. (By a "sparse" grid is meant one
       whose dimensions are smaller than one would like, so that contour lines constructed
       directly on it are composed of long straight segments.) CPSPS2 may be viewed as a data
       smoothing routine.

C-BINDING SYNOPSIS

       c_cpback
       c_cpcica
       c_cpclam
       c_cpcldm
       c_cpcldr
       c_cpcltr
       c_cpcnrc
       c_cpezct
       c_cpgetc
       c_cpgeti
       c_cpgetr
       c_cplbam
       c_cplbdr
       c_cppkcl
       c_cppklb
       c_cprect
       c_cprset
       c_cpsetc
       c_cpseti
       c_cpsetr
       c_cpsps1
       c_cpsps2

USER-MODIFIABLE INTERNAL ROUTINES

       CPCHCF - Provides user control as a constant-field message is drawn.

       CPCHCL - Provides user control as contour lines are drawn.

       CPCHHL - Provides user control as high and low labels are drawn.

       CPCHIL - Provides user control as the informational label is drawn.

       CPCHLL - Provides user control as contour line labels are drawn.

       CPDRPL - Provides a useful polyline-drawer for the routine CPCLDM.

       CPMPXY - Maps Conpack output from a rectangular coordinate system superimposed on the data
       grid to some other coordinate system.

       CPSCAE - Updates a particular element of a user's cell array.

ACCESS

       To use the Conpack Fortran or C routines, load the NCAR Graphics libraries ncarg,
       ncarg_gks, and ncarg_c, preferably in that order.

MESSAGES

       Various error conditions can occur in Conpack.  Each of these results in a call to the
       error-handling routine SETER, with a final argument indicating that the error is
       recoverable; by default, an error message is printed and execution is terminated, but, if
       you turn on error recovery (as described in the "man" page for "error_handling"), you can
       get control back.

       The error messages are as follows:

            CPBACK - INITIALIZATION CALL NOT DONE
            CPBACK - UNCLEARED PRIOR ERROR
            CPCFLB - ERROR EXIT FROM GQCLIP
            CPCFLB - ERROR EXIT FROM GQFACI
            CPCFLB - ERROR EXIT FROM GQLWSC
            CPCFLB - ERROR EXIT FROM GQPLCI
            CPCFLB - ERROR EXIT FROM GQTXCI
            CPCICA - CANNOT CONTINUE - CPMPXY DOES NOT DO INVERSE MAPPINGS
            CPCICA - INITIALIZATION CALL NOT DONE
            CPCICA - ONE OF THE CORNER POINTS OF THE CELL ARRAY IS INCORRECT
            CPCICA - THE DIMENSIONS OF THE CELL ARRAY ARE INCORRECT
            CPCICA - UNCLEARED PRIOR ERROR
            CPCLAM - CONTRADICTORY AREA-IDENTIFIER INFORMATION
            CPCLAM - INITIALIZATION CALL NOT DONE
            CPCLAM - UNCLEARED PRIOR ERROR
            CPCLDM - ERROR EXIT FROM GQLWSC
            CPCLDM - ERROR EXIT FROM GQPLCI
            CPCLDM - ERROR EXIT FROM GQTXCI
            CPCLDM - INITIALIZATION CALL NOT DONE
            CPCLDM - UNCLEARED PRIOR ERROR
            CPCLDR - ERROR EXIT FROM GQLWSC
            CPCLDR - ERROR EXIT FROM GQPLCI
            CPCLDR - ERROR EXIT FROM GQTXCI
            CPCLDR - INITIALIZATION CALL NOT DONE
            CPCLDR - UNCLEARED PRIOR ERROR
            CPCLTR - INITIALIZATION CALL NOT DONE
            CPCLTR - UNCLEARED PRIOR ERROR
            CPCNRC - UNCLEARED PRIOR ERROR
            CPEZCT - UNCLEARED PRIOR ERROR
            CPGETC - GETTING X - PAI INCORRECT
            CPGETC - PARAMETER NAME NOT KNOWN - X
            CPGETC - PARAMETER NAME TOO SHORT - X
            CPGETC - UNCLEARED PRIOR ERROR
            CPGETI - UNCLEARED PRIOR ERROR
            CPGETR - GETTING X - PAI INCORRECT
            CPGETR - PARAMETER NAME NOT KNOWN - X
            CPGETR - PARAMETER NAME TOO SHORT - X
            CPGETR - UNCLEARED PRIOR ERROR
            CPGIWS - ARGUMENT ERROR - SEE SPECIALIST
            CPGIWS - INTEGER WORKSPACE OVERFLOW
            CPGRWS - ARGUMENT ERROR - SEE SPECIALIST
            CPGRWS - REAL WORKSPACE OVERFLOW
            CPHLLB - ERROR EXIT FROM GQFACI
            CPHLLB - ERROR EXIT FROM GQLWSC
            CPHLLB - ERROR EXIT FROM GQPLCI
            CPHLLB - ERROR EXIT FROM GQTXCI
            CPINLB - ERROR EXIT FROM GQCLIP
            CPINLB - ERROR EXIT FROM GQFACI
            CPINLB - ERROR EXIT FROM GQLWSC
            CPINLB - ERROR EXIT FROM GQPLCI
            CPINLB - ERROR EXIT FROM GQTXCI
            CPLBAM - INITIALIZATION CALL NOT DONE
            CPLBAM - UNCLEARED PRIOR ERROR
            CPLBDR - ERROR EXIT FROM GQCLIP
            CPLBDR - ERROR EXIT FROM GQFACI
            CPLBDR - ERROR EXIT FROM GQLWSC
            CPLBDR - ERROR EXIT FROM GQPLCI
            CPLBDR - ERROR EXIT FROM GQTXCI
            CPLBDR - INITIALIZATION CALL NOT DONE
            CPLBDR - UNCLEARED PRIOR ERROR
            CPMVIW - NEW WORKSPACE ARRAY IS TOO SMALL
            CPMVIW - UNCLEARED PRIOR ERROR
            CPMVRW - NEW WORKSPACE ARRAY IS TOO SMALL
            CPMVRW - UNCLEARED PRIOR ERROR
            CPPKCL - INITIALIZATION CALL NOT DONE
            CPPKCL - TOO MANY CONTOUR LEVELS
            CPPKCL - UNCLEARED PRIOR ERROR
            CPPKLB - INITIALIZATION CALL NOT DONE
            CPPKLB - UNCLEARED PRIOR ERROR
            CPPKLP - INITIALIZATION CALL NOT DONE
            CPPKLP - UNCLEARED PRIOR ERROR
            CPRECT - UNCLEARED PRIOR ERROR
            CPRSET - UNCLEARED PRIOR ERROR
            CPSETC - PARAMETER NAME NOT KNOWN - X
            CPSETC - PARAMETER NAME TOO SHORT - X
            CPSETC - SETTING X - PAI INCORRECT
            CPSETC - UNCLEARED PRIOR ERROR
            CPSETI - UNCLEARED PRIOR ERROR
            CPSETR - NCL LESS THAN 1 OR GREATER THAN n
            CPSETR - PARAMETER NAME NOT KNOWN - X
            CPSETR - PARAMETER NAME TOO SHORT - X
            CPSETR - SETTING X - PAI INCORRECT
            CPSETR - UNCLEARED PRIOR ERROR
            CPSPRS - UNCLEARED PRIOR ERROR
            CPSPS1 - CANNOT CONTINUE WITHOUT WORKSPACE
            CPSPS1 - IZD1, IZDM, OR IZDN SET INCORRECTLY
            CPSPS1 - SPECIAL-VALUE REPLACEMENT FAILURE
            CPSPS1 - UNCLEARED PRIOR ERROR
            CPSPS2 - CANNOT CONTINUE WITHOUT WORKSPACE
            CPSPS2 - ERROR IN CALL TO MSSRF1
            CPSPS2 - IZD1, IZDM, OR IZDN SET INCORRECTLY
            CPSPS2 - SPECIAL-VALUE REPLACEMENT FAILURE
            CPSPS2 - UNCLEARED PRIOR ERROR
            CPTRES - ALGORITHM FAILURE - SEE SPECIALIST

SEE ALSO

       Online: conpack_params, cpback, cpchcf, cpchcl, cpchhl, cpchil, cpchll, cpcica, cpclam,
       cpcldm, cpcldr, cpcltr, cpcnrc, cpdrpl, cpezct, cpgetc, cpgeti, cpgetr, cplbam, cplbdr,
       cpmpxy, cpmviw, cpmvrw, cppkcl, cppklb, cprect, cprset, cpscae, cpsetc, cpseti, cpsetr,
       cpsprs, cpsps1, cpsps2, ncarg_cbind

       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.