ncl_conpack - Man Page

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

Info

March 1993 UNIX NCAR GRAPHICS