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.