.TH Conpack 3NCARG "March 1993" UNIX "NCAR GRAPHICS"
.na
.nh
.SH 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.
.SH SYNOPSIS
CPBACK - Draws a background for a contour plot.
.sp
CPCICA -
Incorporates into a user's cell array color
indices determined by examining where the user's contours
lie relative to the cell array.
.sp
CPCLAM - Adds contour lines to an area map. This is part of the
process of drawing a solid-fill contour plot.
.sp
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.
.sp
CPCLDR - Draws contour lines.
.sp
CPCLTR -
Traces the contour lines at a given level and
retrieves them for some sort of user-defined processing.
.sp
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.
.sp
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.
.sp
CPGETC - Retrieves the current value of an internal
parameter of type CHARACTER.
.sp
CPGETI - Retrieves the current value of an internal
parameter of type INTEGER.
.sp
CPGETR - Retrieves the current value of an internal
parameter of type REAL. 
.sp
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.
.sp
CPLBDR -
Draws labels (an informational label, high and
low labels, and line labels).
.sp
CPMVIW -
Moves the contents of an old integer workspace to a new one.
.sp
CPMVRW -
Moves the contents of an old real workspace to a new one.
.sp
CPPKCL - Picks a set of contour levels.
.sp
CPPKLB - Picks a set of labels for labeled contour levels.
.sp
CPRECT - Initializes the contouring of a rectangular array
of data.
.sp
CPRSET - Resets all parameters to their initial default
values.
.sp
CPSETC - Sets the value of an internal parameter of
type CHARACTER.
.sp
CPSETI -
Sets the value of an internal parameter of
type INTEGER.
.sp
CPSETR -
Sets the value of an internal parameter of
type REAL.
.sp
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.
.sp
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.
.SH C-BINDING SYNOPSIS
c_cpback
.br
c_cpcica
.br
c_cpclam
.br
c_cpcldm
.br
c_cpcldr
.br
c_cpcltr
.br
c_cpcnrc
.br
c_cpezct
.br
c_cpgetc
.br
c_cpgeti
.br
c_cpgetr
.br
c_cplbam
.br
c_cplbdr
.br
c_cppkcl
.br
c_cppklb
.br
c_cprect
.br
c_cprset
.br
c_cpsetc
.br
c_cpseti
.br
c_cpsetr
.br
c_cpsps1
.br
c_cpsps2
.SH USER-MODIFIABLE INTERNAL ROUTINES
CPCHCF -
Provides user control as a constant-field
message is drawn.
.sp
CPCHCL -
Provides user control as contour lines are
drawn.
.sp
CPCHHL -
Provides user control as high and low labels
are drawn.
.sp
CPCHIL - Provides user control as the informational label is
drawn.
.sp
CPCHLL - Provides user control as contour line labels are
drawn.
.sp
CPDRPL -
Provides a useful polyline-drawer for the
routine CPCLDM.
.sp
CPMPXY -
Maps Conpack output from a rectangular
coordinate system superimposed on the data grid to some
other coordinate system.
.sp
CPSCAE -
Updates a particular element of a user's cell array.	
.SH ACCESS 
To use the Conpack Fortran or C routines, load the NCAR Graphics
libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.
.SH 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.
.sp
The error messages are as follows:
.sp
.in +5
CPBACK - INITIALIZATION CALL NOT DONE
.br
CPBACK - UNCLEARED PRIOR ERROR
.br
CPCFLB - ERROR EXIT FROM GQCLIP
.br
CPCFLB - ERROR EXIT FROM GQFACI
.br
CPCFLB - ERROR EXIT FROM GQLWSC
.br
CPCFLB - ERROR EXIT FROM GQPLCI
.br
CPCFLB - ERROR EXIT FROM GQTXCI
.br
CPCICA - CANNOT CONTINUE - CPMPXY DOES NOT DO INVERSE MAPPINGS
.br
CPCICA - INITIALIZATION CALL NOT DONE
.br
CPCICA - ONE OF THE CORNER POINTS OF THE CELL ARRAY IS INCORRECT
.br
CPCICA - THE DIMENSIONS OF THE CELL ARRAY ARE INCORRECT
.br
CPCICA - UNCLEARED PRIOR ERROR
.br
CPCLAM - CONTRADICTORY AREA-IDENTIFIER INFORMATION
.br
CPCLAM - INITIALIZATION CALL NOT DONE
.br
CPCLAM - UNCLEARED PRIOR ERROR
.br
CPCLDM - ERROR EXIT FROM GQLWSC
.br
CPCLDM - ERROR EXIT FROM GQPLCI
.br
CPCLDM - ERROR EXIT FROM GQTXCI
.br
CPCLDM - INITIALIZATION CALL NOT DONE
.br
CPCLDM - UNCLEARED PRIOR ERROR
.br
CPCLDR - ERROR EXIT FROM GQLWSC
.br
CPCLDR - ERROR EXIT FROM GQPLCI
.br
CPCLDR - ERROR EXIT FROM GQTXCI
.br
CPCLDR - INITIALIZATION CALL NOT DONE
.br
CPCLDR - UNCLEARED PRIOR ERROR
.br
CPCLTR - INITIALIZATION CALL NOT DONE
.br
CPCLTR - UNCLEARED PRIOR ERROR
.br
CPCNRC - UNCLEARED PRIOR ERROR
.br
CPEZCT - UNCLEARED PRIOR ERROR
.br
CPGETC - GETTING X - PAI INCORRECT
.br
CPGETC - PARAMETER NAME NOT KNOWN - X
.br
CPGETC - PARAMETER NAME TOO SHORT - X
.br
CPGETC - UNCLEARED PRIOR ERROR
.br
CPGETI - UNCLEARED PRIOR ERROR
.br
CPGETR - GETTING X - PAI INCORRECT
.br
CPGETR - PARAMETER NAME NOT KNOWN - X
.br
CPGETR - PARAMETER NAME TOO SHORT - X
.br
CPGETR - UNCLEARED PRIOR ERROR
.br
CPGIWS - ARGUMENT ERROR - SEE SPECIALIST
.br
CPGIWS - INTEGER WORKSPACE OVERFLOW
.br
CPGRWS - ARGUMENT ERROR - SEE SPECIALIST
.br
CPGRWS - REAL WORKSPACE OVERFLOW
.br
CPHLLB - ERROR EXIT FROM GQFACI
.br
CPHLLB - ERROR EXIT FROM GQLWSC
.br
CPHLLB - ERROR EXIT FROM GQPLCI
.br
CPHLLB - ERROR EXIT FROM GQTXCI
.br
CPINLB - ERROR EXIT FROM GQCLIP
.br
CPINLB - ERROR EXIT FROM GQFACI
.br
CPINLB - ERROR EXIT FROM GQLWSC
.br
CPINLB - ERROR EXIT FROM GQPLCI
.br
CPINLB - ERROR EXIT FROM GQTXCI
.br
CPLBAM - INITIALIZATION CALL NOT DONE
.br
CPLBAM - UNCLEARED PRIOR ERROR
.br
CPLBDR - ERROR EXIT FROM GQCLIP
.br
CPLBDR - ERROR EXIT FROM GQFACI
.br
CPLBDR - ERROR EXIT FROM GQLWSC
.br
CPLBDR - ERROR EXIT FROM GQPLCI
.br
CPLBDR - ERROR EXIT FROM GQTXCI
.br
CPLBDR - INITIALIZATION CALL NOT DONE
.br
CPLBDR - UNCLEARED PRIOR ERROR
.br
CPMVIW - NEW WORKSPACE ARRAY IS TOO SMALL
.br
CPMVIW - UNCLEARED PRIOR ERROR
.br
CPMVRW - NEW WORKSPACE ARRAY IS TOO SMALL
.br
CPMVRW - UNCLEARED PRIOR ERROR
.br
CPPKCL - INITIALIZATION CALL NOT DONE
.br
CPPKCL - TOO MANY CONTOUR LEVELS
.br
CPPKCL - UNCLEARED PRIOR ERROR
.br
CPPKLB - INITIALIZATION CALL NOT DONE
.br
CPPKLB - UNCLEARED PRIOR ERROR
.br
CPPKLP - INITIALIZATION CALL NOT DONE
.br
CPPKLP - UNCLEARED PRIOR ERROR
.br
CPRECT - UNCLEARED PRIOR ERROR
.br
CPRSET - UNCLEARED PRIOR ERROR
.br
CPSETC - PARAMETER NAME NOT KNOWN - X
.br
CPSETC - PARAMETER NAME TOO SHORT - X
.br
CPSETC - SETTING X - PAI INCORRECT
.br
CPSETC - UNCLEARED PRIOR ERROR
.br
CPSETI - UNCLEARED PRIOR ERROR
.br
CPSETR - NCL LESS THAN 1 OR GREATER THAN n
.br
CPSETR - PARAMETER NAME NOT KNOWN - X
.br
CPSETR - PARAMETER NAME TOO SHORT - X
.br
CPSETR - SETTING X - PAI INCORRECT
.br
CPSETR - UNCLEARED PRIOR ERROR
.br
CPSPRS - UNCLEARED PRIOR ERROR
.br
CPSPS1 - CANNOT CONTINUE WITHOUT WORKSPACE
.br
CPSPS1 - IZD1, IZDM, OR IZDN SET INCORRECTLY
.br
CPSPS1 - SPECIAL-VALUE REPLACEMENT FAILURE
.br
CPSPS1 - UNCLEARED PRIOR ERROR
.br
CPSPS2 - CANNOT CONTINUE WITHOUT WORKSPACE
.br
CPSPS2 - ERROR IN CALL TO MSSRF1
.br
CPSPS2 - IZD1, IZDM, OR IZDN SET INCORRECTLY
.br
CPSPS2 - SPECIAL-VALUE REPLACEMENT FAILURE
.br
CPSPS2 - UNCLEARED PRIOR ERROR
.br
CPTRES - ALGORITHM FAILURE - SEE SPECIALIST
.in -5
.sp
.SH 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
.sp
Hardcopy:
NCAR Graphics Contouring and Mapping Tutorial
.SH COPYRIGHT
Copyright (C) 1987-2000
.br
University Corporation for Atmospheric Research
.br

This documentation is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as published
by the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This software is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this software; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
USA.
