1Conpack(3NCARG)                  NCAR GRAPHICS                 Conpack(3NCARG)
2
3
4

NAME

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

SYNOPSIS

11       CPBACK - Draws a background for a contour plot.
12
13       CPCICA - Incorporates into a user's cell array color indices determined
14       by examining where the user's contours lie relative to the cell array.
15
16       CPCLAM - Adds contour lines to an area map. This is part of the process
17       of drawing a solid-fill contour plot.
18
19       CPCLDM - Draws contour lines masked by an existing area map. The object
20       of this may be simply to avoid drawing contour lines through label
21       boxes, but the routine may be used for more complicated tasks, like
22       limiting the drawing of contour lines to the ocean areas on an Ezmap
23       background.
24
25       CPCLDR - Draws contour lines.
26
27       CPCLTR - Traces the contour lines at a given level and retrieves them
28       for some sort of user-defined processing.
29
30       CPCNRC - Draws black and white contours with a single call.  Simulates
31       the behavior of the old routine CONREC; it has the same arguments and
32       produces similar output.
33
34       CPEZCT - Draws black and white contours with a single call.  Simulates
35       the behavior of the old subroutine EZCNTR in Conrec_family; it has the
36       same arguments and will produce similar output.
37
38       CPGETC - Retrieves the current value of an internal parameter of type
39       CHARACTER.
40
41       CPGETI - Retrieves the current value of an internal parameter of type
42       INTEGER.
43
44       CPGETR - Retrieves the current value of an internal parameter of type
45       REAL.
46
47       CPLBAM - Adds label boxes (for the informational label, high and low
48       labels, and contour-line labels) to an area map. The ultimate object of
49       this will usually be to prevent contour lines drawn by CPCLDM from
50       passing through labels or to prevent fill of the label boxes as contour
51       bands are filled.
52
53       CPLBDR - Draws labels (an informational label, high and low labels, and
54       line labels).
55
56       CPMVIW - Moves the contents of an old integer workspace to a new one.
57
58       CPMVRW - Moves the contents of an old real workspace to a new one.
59
60       CPPKCL - Picks a set of contour levels.
61
62       CPPKLB - Picks a set of labels for labeled contour levels.
63
64       CPRECT - Initializes the contouring of a rectangular array of data.
65
66       CPRSET - Resets all parameters to their initial default values.
67
68       CPSETC - Sets the value of an internal parameter of type CHARACTER.
69
70       CPSETI - Sets the value of an internal parameter of type INTEGER.
71
72       CPSETR - Sets the value of an internal parameter of type REAL.
73
74       CPSPS1 - Interpolates from an array of data on a "sparse" rectangular
75       grid which is regularly spaced in X and Y to an array of data on a
76       "dense" rectangular grid and to initialize contouring from the array on
77       the dense grid. (By a "sparse" grid is meant one whose dimensions are
78       smaller than one would like, so that contour lines constructed directly
79       on it are composed of long straight segments.) CPSPS1 may be viewed as
80       a data smoothing routine.
81
82       CPSPS2 - Interpolates from an array of data on a "sparse" rectangular
83       grid which is irregularly spaced in X and Y to an array of data on a
84       "dense" rectangular grid and to initialize contouring from the array on
85       the dense grid. (By a "sparse" grid is meant one whose dimensions are
86       smaller than one would like, so that contour lines constructed directly
87       on it are composed of long straight segments.) CPSPS2 may be viewed as
88       a data smoothing routine.
89

C-BINDING SYNOPSIS

91       c_cpback
92       c_cpcica
93       c_cpclam
94       c_cpcldm
95       c_cpcldr
96       c_cpcltr
97       c_cpcnrc
98       c_cpezct
99       c_cpgetc
100       c_cpgeti
101       c_cpgetr
102       c_cplbam
103       c_cplbdr
104       c_cppkcl
105       c_cppklb
106       c_cprect
107       c_cprset
108       c_cpsetc
109       c_cpseti
110       c_cpsetr
111       c_cpsps1
112       c_cpsps2
113

USER-MODIFIABLE INTERNAL ROUTINES

115       CPCHCF - Provides user control as a constant-field message is drawn.
116
117       CPCHCL - Provides user control as contour lines are drawn.
118
119       CPCHHL - Provides user control as high and low labels are drawn.
120
121       CPCHIL - Provides user control as the informational label is drawn.
122
123       CPCHLL - Provides user control as contour line labels are drawn.
124
125       CPDRPL - Provides a useful polyline-drawer for the routine CPCLDM.
126
127       CPMPXY - Maps Conpack output from a rectangular coordinate system
128       superimposed on the data grid to some other coordinate system.
129
130       CPSCAE - Updates a particular element of a user's cell array.
131

ACCESS

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

MESSAGES

137       Various error conditions can occur in Conpack.  Each of these results
138       in a call to the error-handling routine SETER, with a final argument
139       indicating that the error is recoverable; by default, an error message
140       is printed and execution is terminated, but, if you turn on error
141       recovery (as described in the "man" page for "error_handling"), you can
142       get control back.
143
144       The error messages are as follows:
145
146            CPBACK - INITIALIZATION CALL NOT DONE
147            CPBACK - UNCLEARED PRIOR ERROR
148            CPCFLB - ERROR EXIT FROM GQCLIP
149            CPCFLB - ERROR EXIT FROM GQFACI
150            CPCFLB - ERROR EXIT FROM GQLWSC
151            CPCFLB - ERROR EXIT FROM GQPLCI
152            CPCFLB - ERROR EXIT FROM GQTXCI
153            CPCICA - CANNOT CONTINUE - CPMPXY DOES NOT DO INVERSE MAPPINGS
154            CPCICA - INITIALIZATION CALL NOT DONE
155            CPCICA - ONE OF THE CORNER POINTS OF THE CELL ARRAY IS INCORRECT
156            CPCICA - THE DIMENSIONS OF THE CELL ARRAY ARE INCORRECT
157            CPCICA - UNCLEARED PRIOR ERROR
158            CPCLAM - CONTRADICTORY AREA-IDENTIFIER INFORMATION
159            CPCLAM - INITIALIZATION CALL NOT DONE
160            CPCLAM - UNCLEARED PRIOR ERROR
161            CPCLDM - ERROR EXIT FROM GQLWSC
162            CPCLDM - ERROR EXIT FROM GQPLCI
163            CPCLDM - ERROR EXIT FROM GQTXCI
164            CPCLDM - INITIALIZATION CALL NOT DONE
165            CPCLDM - UNCLEARED PRIOR ERROR
166            CPCLDR - ERROR EXIT FROM GQLWSC
167            CPCLDR - ERROR EXIT FROM GQPLCI
168            CPCLDR - ERROR EXIT FROM GQTXCI
169            CPCLDR - INITIALIZATION CALL NOT DONE
170            CPCLDR - UNCLEARED PRIOR ERROR
171            CPCLTR - INITIALIZATION CALL NOT DONE
172            CPCLTR - UNCLEARED PRIOR ERROR
173            CPCNRC - UNCLEARED PRIOR ERROR
174            CPEZCT - UNCLEARED PRIOR ERROR
175            CPGETC - GETTING X - PAI INCORRECT
176            CPGETC - PARAMETER NAME NOT KNOWN - X
177            CPGETC - PARAMETER NAME TOO SHORT - X
178            CPGETC - UNCLEARED PRIOR ERROR
179            CPGETI - UNCLEARED PRIOR ERROR
180            CPGETR - GETTING X - PAI INCORRECT
181            CPGETR - PARAMETER NAME NOT KNOWN - X
182            CPGETR - PARAMETER NAME TOO SHORT - X
183            CPGETR - UNCLEARED PRIOR ERROR
184            CPGIWS - ARGUMENT ERROR - SEE SPECIALIST
185            CPGIWS - INTEGER WORKSPACE OVERFLOW
186            CPGRWS - ARGUMENT ERROR - SEE SPECIALIST
187            CPGRWS - REAL WORKSPACE OVERFLOW
188            CPHLLB - ERROR EXIT FROM GQFACI
189            CPHLLB - ERROR EXIT FROM GQLWSC
190            CPHLLB - ERROR EXIT FROM GQPLCI
191            CPHLLB - ERROR EXIT FROM GQTXCI
192            CPINLB - ERROR EXIT FROM GQCLIP
193            CPINLB - ERROR EXIT FROM GQFACI
194            CPINLB - ERROR EXIT FROM GQLWSC
195            CPINLB - ERROR EXIT FROM GQPLCI
196            CPINLB - ERROR EXIT FROM GQTXCI
197            CPLBAM - INITIALIZATION CALL NOT DONE
198            CPLBAM - UNCLEARED PRIOR ERROR
199            CPLBDR - ERROR EXIT FROM GQCLIP
200            CPLBDR - ERROR EXIT FROM GQFACI
201            CPLBDR - ERROR EXIT FROM GQLWSC
202            CPLBDR - ERROR EXIT FROM GQPLCI
203            CPLBDR - ERROR EXIT FROM GQTXCI
204            CPLBDR - INITIALIZATION CALL NOT DONE
205            CPLBDR - UNCLEARED PRIOR ERROR
206            CPMVIW - NEW WORKSPACE ARRAY IS TOO SMALL
207            CPMVIW - UNCLEARED PRIOR ERROR
208            CPMVRW - NEW WORKSPACE ARRAY IS TOO SMALL
209            CPMVRW - UNCLEARED PRIOR ERROR
210            CPPKCL - INITIALIZATION CALL NOT DONE
211            CPPKCL - TOO MANY CONTOUR LEVELS
212            CPPKCL - UNCLEARED PRIOR ERROR
213            CPPKLB - INITIALIZATION CALL NOT DONE
214            CPPKLB - UNCLEARED PRIOR ERROR
215            CPPKLP - INITIALIZATION CALL NOT DONE
216            CPPKLP - UNCLEARED PRIOR ERROR
217            CPRECT - UNCLEARED PRIOR ERROR
218            CPRSET - UNCLEARED PRIOR ERROR
219            CPSETC - PARAMETER NAME NOT KNOWN - X
220            CPSETC - PARAMETER NAME TOO SHORT - X
221            CPSETC - SETTING X - PAI INCORRECT
222            CPSETC - UNCLEARED PRIOR ERROR
223            CPSETI - UNCLEARED PRIOR ERROR
224            CPSETR - NCL LESS THAN 1 OR GREATER THAN n
225            CPSETR - PARAMETER NAME NOT KNOWN - X
226            CPSETR - PARAMETER NAME TOO SHORT - X
227            CPSETR - SETTING X - PAI INCORRECT
228            CPSETR - UNCLEARED PRIOR ERROR
229            CPSPRS - UNCLEARED PRIOR ERROR
230            CPSPS1 - CANNOT CONTINUE WITHOUT WORKSPACE
231            CPSPS1 - IZD1, IZDM, OR IZDN SET INCORRECTLY
232            CPSPS1 - SPECIAL-VALUE REPLACEMENT FAILURE
233            CPSPS1 - UNCLEARED PRIOR ERROR
234            CPSPS2 - CANNOT CONTINUE WITHOUT WORKSPACE
235            CPSPS2 - ERROR IN CALL TO MSSRF1
236            CPSPS2 - IZD1, IZDM, OR IZDN SET INCORRECTLY
237            CPSPS2 - SPECIAL-VALUE REPLACEMENT FAILURE
238            CPSPS2 - UNCLEARED PRIOR ERROR
239            CPTRES - ALGORITHM FAILURE - SEE SPECIALIST
240
241

SEE ALSO

243       Online: conpack_params, cpback, cpchcf, cpchcl, cpchhl, cpchil, cpchll,
244       cpcica, cpclam, cpcldm, cpcldr, cpcltr, cpcnrc, cpdrpl, cpezct, cpgetc,
245       cpgeti, cpgetr, cplbam, cplbdr, cpmpxy, cpmviw, cpmvrw, cppkcl, cppklb,
246       cprect, cprset, cpscae, cpsetc, cpseti, cpsetr, cpsprs, cpsps1, cpsps2,
247       ncarg_cbind
248
249       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
250
252       Copyright (C) 1987-2007
253       University Corporation for Atmospheric Research
254
255       This documentation is free software; you can redistribute it and/or
256       modify it under the terms of the GNU General Public License as
257       published by the Free Software Foundation; either version 2 of the
258       License, or (at your option) any later version.
259
260       This software is distributed in the hope that it will be useful, but
261       WITHOUT ANY WARRANTY; without even the implied warranty of
262       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
263       General Public License for more details.
264
265       You should have received a copy of the GNU General Public License along
266       with this software; if not, write to the Free Software Foundation,
267       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
268
269
270
271UNIX                              March 1993                   Conpack(3NCARG)
Impressum