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

NAME

6       CPPKCL - Picks a set of contour levels.
7

SYNOPSIS

9       CALL CPPKCL (ZDAT, RWRK, IWRK)
10

C-BINDING SYNOPSIS

12       #include <ncarg/ncargC.h>
13
14       void c_cppkcl (float *zdat, float *rwrk, int *iwrk)
15

DESCRIPTION

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
21       ZDAT        (REAL array, dimensioned as specified in the last call to
22                   CPRECT, CPSPS1, or CPSPS2, input) is the data array.
23
24       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
28       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

C-BINDING DESCRIPTION

33       The C-binding argument descriptions are the same as the FORTRAN
34       argument descriptions.
35

USAGE

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
45       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
54       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
60
61       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
67       CLC = -1                   Contour line color
68       LLC = -1                   Contour line label color
69       CLL = 0.                   Contour line line width
70
71       Thus, after CPPKCL is called, the situation for each contour level is
72       as follows:
73
74       ·      Contour lines at the level are to be drawn by calls to CPCLDM or
75              CPCLDR.
76
77       ·      The lines will be labeled if 'CLU'=3, but not if 'CLU'=1.
78
79       ·      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
83       ·      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
87       ·      The text of the label associated with the level is, as yet,
88              unspecified.
89
90       By resetting elements in these parameter arrays, the user can change
91       the situation in various ways.
92

EXAMPLES

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

ACCESS

101       To use CPPKCL or c_cppkcl, load the NCAR Graphics libraries ncarg,
102       ncarg_gks, and ncarg_c, preferably in that order.
103

MESSAGES

105       See the conpack man page for a description of all Conpack error
106       messages and/or informational messages.
107

SEE ALSO

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
114       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
115

117       Copyright (C) 1987-2009
118       University Corporation for Atmospheric Research
119
120       The use of this Software is governed by a License Agreement.
121
122
123
124UNIX                              March 1993                    CPPKCL(3NCARG)
Impressum