1CPCLDR(3NCARG) NCAR GRAPHICS CPCLDR(3NCARG)
2
6 CPCLDR - Draws contour lines.
7
9 CALL CPCLDR (ZDAT, RWRK, IWRK)
10
12 #include <ncarg/ncargC.h>
13 void c_cpcldr (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 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 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 Groups of lines are drawn in the following order:
56 · contour lines for each of the specified levels, in ascending numeric
58 order,
59 · the edges of special-value areas, if any,
61 · the edges of out-of-range areas, if any, and
63 · the edge of the grid.
65 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 The dash-pattern-usage parameter ('DPU') affects the pattern used to
76 draw the lines. Set the value of 'DPU' as follows:
77 Value Description
79 < 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 > 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 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 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 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
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
117 To use CPCLDR or c_cpcldr, load the NCAR Graphics libraries ncarg,
118 ncarg_gks, and ncarg_c, preferably in that order.
119
121 See the conpack man page for a description of all Conpack error
122 messages and/or informational messages.
123
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 Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
131
133 Copyright (C) 1987-2007
134 University Corporation for Atmospheric Research
135 This documentation is free software; you can redistribute it and/or
137 modify it under the terms of the GNU General Public License as
138 published by the Free Software Foundation; either version 2 of the
139 License, or (at your option) any later version.
140 This software is distributed in the hope that it will be useful, but
142 WITHOUT ANY WARRANTY; without even the implied warranty of
143 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
144 General Public License for more details.
145 You should have received a copy of the GNU General Public License along
147 with this software; if not, write to the Free Software Foundation,
148 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
149UNIX March 1993 CPCLDR(3NCARG)