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

RELATED TO conpack…

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.