1CPPKCL(3NCARG) NCAR GRAPHICS CPPKCL(3NCARG)
2
6 CPPKCL - Picks a set of contour levels.
7
9 CALL CPPKCL (ZDAT, RWRK, IWRK)
10
12 #include <ncarg/ncargC.h>
13 void c_cppkcl (float *zdat, float *rwrk, int *iwrk)
15
17 All three arguments are arrays used in the last call to CPRECT, CPSPS1,
18 or CPSPS2, the contents of which must not have been changed since that
19 call.
20 ZDAT (REAL array, dimensioned as specified in the last call to
22 CPRECT, CPSPS1, or CPSPS2, input) is the data array.
23 RWRK (REAL array, dimensioned as specified in the last call to
25 CPRECT, CPSPS1, or CPSPS2, input/output) is the real
26 workspace array.
27 IWRK (INTEGER array, dimensioned as specified in the last call
29 to CPRECT, CPSPS1, or CPSPS2, input/output) is the integer
30 workspace array.
31
33 The C-binding argument descriptions are the same as the FORTRAN
34 argument descriptions.
35
37 Normally, CPPKCL is called by CONPACK when the contour levels are
38 needed; it may be called directly by the user when it is desired to
39 modify the resulting parameter arrays specifying contour levels and
40 associated quantities in some way. CPPKCL must be called after
41 initialization has been done (by a call to one of the initialization
42 routines CPRECT, CPSPS1, or CPSPS2); this is because CPPKCL depends on
43 values set during initialization.
44 If the contour-level-selection parameter 'CLS' is zero (indicating that
46 the user intends to pick contour levels), or if the constant-field-flag
47 'CFF' is non-zero (indicating that, during initialization, the data
48 were found to be essentially constant), CPPKCL does nothing.
49 Otherwise, CPPKCL picks a set of contour levels. The way in which it
50 picks these levels is determined by the value of the internal parameter
51 'CLS'; see the description of this parameter in the conpack_params man
52 page.
53 When CPPKCL picks contour levels, it sets the value of the internal
55 parameter 'NCL' equal to the number of contour levels picked. It then
56 sets the values of elements 1 through 'NCL' of the parameter array
57 'CLV' (contour level values) to the levels chosen. The Ith elements of
58 the associated parameter arrays are set as follows:
59 CLU = 1 or 3 Contour level use flag
62 AIA = I+1 Area identifier above the level
63 AIB = I Area identifier below the level
64 LLT = ' ' (single blank) Contour line label text
65 CLD = '$$$$$$$$$$$$$' Contour line dash pattern
66 CLC = -1 Contour line color
68 LLC = -1 Contour line label color
69 CLL = 0. Contour line line width
70 Thus, after CPPKCL is called, the situation for each contour level is
72 as follows:
73 · Contour lines at the level are to be drawn by calls to CPCLDM or
75 CPCLDR.
76 · The lines will be labeled if 'CLU'=3, but not if 'CLU'=1.
78 · If CPCLAM is called, lines at the level will be added to the
80 area map; the area identifiers for areas "above" the level and
81 for areas "below" the level are as specified by 'AIA' and 'AIB'.
82 · The dash pattern for the level is solid, and neither the color
84 of the line, the color of the labels on it, nor its width are to
85 be set.
86 · The text of the label associated with the level is, as yet,
88 unspecified.
89 By resetting elements in these parameter arrays, the user can change
91 the situation in various ways.
92
94 Use the ncargex command to see the following relevant examples: ccpclc,
95 ccpcld, ccpcldm, ccpcll, ccpklb, ccplbam, ccplbdr, ccpllb, ccpllc,
96 ccplll, ccpllo, ccpllp, ccpllt, ccpllw, ccppc, ccppc1, ccppc2, ccppc3,
97 ccppc4, ccppkcl, ccprc, ccprwc, ccpscam, cpex01, cpex02, cpex03,
98 cpex06, vvex01, fcover, ffex03, ffex05.
99
101 To use CPPKCL or c_cppkcl, load the NCAR Graphics libraries ncarg,
102 ncarg_gks, and ncarg_c, preferably in that order.
103
105 See the conpack man page for a description of all Conpack error
106 messages and/or informational messages.
107
109 Online: conpack, cpback, cpchcf, cpchcl, cpchhl, cpchil, cpchll,
110 cpcica, cpclam, cpcldm, cpcldr, cpcltr, cpcnrc, cpdrpl, cpezct, cpgetc,
111 cpgeti, cpgetr, cplbam, cplbdr, cpmpxy, cpmviw, cpmvrw, cppklb, cprect,
112 cprset, cpscae, cpsetc, cpseti, cpsetr, cpsps1, cpsps2, ncarg_cbind
113 Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
115
117 Copyright (C) 1987-2007
118 University Corporation for Atmospheric Research
119 This documentation is free software; you can redistribute it and/or
121 modify it under the terms of the GNU General Public License as
122 published by the Free Software Foundation; either version 2 of the
123 License, or (at your option) any later version.
124 This software is distributed in the hope that it will be useful, but
126 WITHOUT ANY WARRANTY; without even the implied warranty of
127 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
128 General Public License for more details.
129 You should have received a copy of the GNU General Public License along
131 with this software; if not, write to the Free Software Foundation,
132 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
133UNIX March 1993 CPPKCL(3NCARG)