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

NAME

6       CPCLDR - Draws contour lines.
7

SYNOPSIS

9       CALL CPCLDR (ZDAT, RWRK, IWRK)
10

C-BINDING SYNOPSIS

12       #include <ncarg/ncargC.h>
13
14       void c_cpcldr (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       The routine CPCLDR, which draws contour lines, may be called at any
38       time after the initialization call to CPRECT, CPSPS1, or CPSPS2.  The
39       contour lines drawn are those specified by the first 'NCL' elements of
40       the parameter arrays 'CLV' and 'CLU'.  If 'NCL' is zero, CPPKCL is
41       called to generate these values.  Each element of 'CLV' specifies a
42       contour level, and the corresponding element of 'CLU' specifies whether
43       or not contour lines are to be drawn at that level and whether or not
44       the lines are to be labeled.  If the parameter 'T2D' has a non-zero
45       value, the contour lines are smoothed, using cubic splines under
46       tension.
47
48       If the element of the parameter array 'CLU' corresponding to 'PAI' = -1
49       is non-zero, the edge of the grid is also drawn.  If the element of
50       'CLU' corresponding to 'PAI' = -2 is non-zero, the edges of special-
51       value areas, if any, are drawn.  If the element of 'CLU' corresponding
52       to 'PAI' = -3 is non-zero, the edges of out-of-range areas, if any, are
53       drawn.  The default values are such that none of these edges are drawn.
54
55       Groups of lines are drawn in the following order:
56
57       ·  contour lines for each of the specified levels, in ascending numeric
58          order,
59
60       ·  the edges of special-value areas, if any,
61
62       ·  the edges of out-of-range areas, if any, and
63
64       ·  the edge of the grid.
65
66       The color, dash pattern, and line width to be used for the lines drawn
67       may be specified by elements of the parameter arrays 'CLC', 'CLD', and
68       'CLL', respectively.  Each of these contains elements corresponding to
69       values of 'PAI' from 1 to 'NCL' and three special elements,
70       corresponding to 'PAI' = -1, -2, and -3.  Before and after each group
71       of lines is drawn, the routine CPCHCL is called.  You can supply your
72       own version of CPCHCL to override the settings of color, dash pattern,
73       and line width.
74
75       The dash-pattern-usage parameter ('DPU') affects the pattern used to
76       draw the lines.  Set the value of 'DPU' as follows:
77
78       Value       Description
79
80       < 0 or = 0  Lines are drawn by calling the SPPS routine CURVE.  Lines
81                   are all solid and unlabeled; specified dash patterns are
82                   not used.
83
84       > 0         Lines are drawn by calling the Dashline routine CURVED.
85                   Lines are solid or dashed, depending on the dash pattern
86                   specified by the appropriate element of 'CLD'.
87
88                   If ABS('LLP') = 1, then the dash pattern for those lines
89                   that are to be labeled is constructed by replicating, 'DPU'
90                   times, the dash pattern specified by the appropriate
91                   element of 'CLD', and then appending to it the characters
92                   specified by the appropriate element of 'LLT'.
93
94                   If ABS('LLP') is greater than 1, then the lines drawn will
95                   pass through any labels drawn by CPLBDR.  If this is
96                   undesirable, you can call CPLBAM to put the label boxes
97                   into an area map and then call CPCLDM instead of CPCLDR to
98                   draw only those portions of the contour lines which do not
99                   lie inside the label boxes.
100
101       If, during the last call to CPRECT or CPSPRS, the data being contoured
102       were found to be essentially constant, then no contour lines are drawn;
103       instead, the constant-field label is written.  Other lines are still
104       drawn.
105

EXAMPLES

107       Use the ncargex command to see the following relevant examples: caredg,
108       ccpcff, ccpcfx, ccpcica, ccpcir, ccpcis, ccpcit, ccpclc, ccpcld,
109       ccpcldr, ccpcll, ccpclu, ccpdflt, ccpfil, ccpga, ccphand, ccphcf,
110       ccphl, ccphlt, ccpila, ccpilt, ccpklb, ccplbdr, ccpline, ccpllp,
111       ccpmap, ccpmovi, ccpmpxy, ccpncls, ccpnet, ccpnof, ccpnsd, ccppkcl,
112       ccprect, ccprwc, ccprwu, ccpset, ccpsps1, ccpsps2, ccpspv, ccpt2d,
113       ccptitle, ccpvp, ccpvs, cidsfft, cpex01, cpex05, cpex07, tconpa,
114       fsfsgfa.
115

ACCESS

117       To use CPCLDR or c_cpcldr, load the NCAR Graphics libraries ncarg,
118       ncarg_gks, and ncarg_c, preferably in that order.
119

MESSAGES

121       See the conpack man page for a description of all Conpack error
122       messages and/or informational messages.
123

SEE ALSO

125       Online: conpack, cpback, cpchcf, cpchcl, cpchhl, cpchil, cpchll,
126       cpcica, cpclam, cpcldm, cpcltr, cpcnrc, cpdrpl, cpezct, cpgetc, cpgeti,
127       cpgetr, cplbam, cplbdr, cpmpxy, cpmviw, cpmvrw, cppkcl, cppklb, cprect,
128       cprset, cpscae, cpsetc, cpseti, cpsetr, cpsps1, cpsps2, ncarg_cbind
129
130       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
131
133       Copyright (C) 1987-2009
134       University Corporation for Atmospheric Research
135
136       The use of this Software is governed by a License Agreement.
137
138
139
140UNIX                              March 1993                    CPCLDR(3NCARG)
Impressum