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

NAME

6       CPRECT - Initializes the contouring of a rectangular array of data.
7

SYNOPSIS

9       CALL CPRECT (ZDAT, KZDT, MZDT, NZDT, RWRK, LRWK, IWRK, LIWK)
10

C-BINDING SYNOPSIS

12       #include <ncarg/ncargC.h>
13
14       void c_cprect (float *zdat, int kzdt, int mzdt, int nzdt,
15       float *rwrk, int lrwk, int *iwrk, int liwk)
16

DESCRIPTION

18       ZDAT        (REAL array, dimensioned KZDT x n, where "n" is greater
19                   than or equal to NZDT, input) is the array of data to be
20                   contoured.
21
22       KZDT        (INTEGER, input) is the first dimension of the array ZDAT.
23
24       MZDT        (INTEGER, input) is the first dimension of the array of
25                   data in ZDAT. MZDT must be less than or equal to KZDT.
26
27       NZDT        (INTEGER, input) is the second dimension of the array of
28                   data in ZDAT. NZDT must be less than or equal to the
29                   declared second dimension of the array ZDAT.
30
31       RWRK        (REAL array, dimensioned LRWK, input/output) is the real
32                   work array.
33
34       LRWK        (INTEGER, input) is the length of RWRK.
35
36       IWRK        (INTEGER array, dimensioned LIWK, input/output) is the
37                   integer work array.
38
39       LIWK        (INTEGER, input) is the length of IWRK.
40

C-BINDING DESCRIPTION

42       The C-binding argument descriptions are the same as the FORTRAN
43       argument descriptions with the following exceptions:
44
45       zdat(l,kzdt)
46                   zdat is dimensioned l by kzdt, where l ≥ nzdt.
47
48       kzdt        The second dimension of the array zdat.
49
50       mzdt        The second dimension of the array of data in zdat. mzdt ≤
51                   kzdt.
52
53       nzdt        The first dimension of the array of data in zdat. nzdt ≤ l,
54                   where l is the declared first dimension of the array zdat.
55

USAGE

57       The routine CPRECT is called to initialize the process of drawing a
58       contour plot from a rectangular array of data.  The arguments define
59       the data array, a real workspace array, and an integer workspace array.
60       The dimensions of all the arrays are transferred to variables in
61       COMMON, so that, in calls to other Conpack routines, those dimensions
62       may be omitted.
63
64       CPRECT initializes the internal pointers that manage workspace use;
65       also, it decides the appropriate ranges of X and Y coordinates for
66       drawing contour lines and positioning labels.
67
68       If Conpack is to call SET, appropriate arguments are determined and SET
69       is called; otherwise, GETSET is called to retrieve the arguments from
70       the user's call to SET.
71
72       The list of label positions (if any) left over from previous calls to
73       the package is discarded.
74
75       If contour levels are to be chosen by Conpack, 'NCL' is zeroed so that
76       the levels will be chosen when they are needed.
77
78       The minimum and maximum values in the data array are located and it is
79       decided whether the data are essentially constant.
80
81       Numeric-label parameters that depend on the range of values in the data
82       array are initialized.
83
84       A scale factor may be chosen.
85

EXAMPLES

87       Use the ncargex command to see the following relevant examples: caredg,
88       ccpback, ccpcff, ccpcfx, ccpcica, ccpci, ccpcis, ccpcit, ccpclc,
89       ccpcld, ccpcldm, ccpcldr, ccpcll, ccpclu, ccpdflt, ccpfil, ccpga,
90       ccphand, ccphcf, ccphl, ccphlt, ccpila, ccpils, ccpilt, ccpklb,
91       ccplbam, ccplbdr, ccpllb, ccpllc, ccplll, ccpllo, ccpllp, ccpllt,
92       ccpmap, ccpmovi, ccpmpxy, ccpncls, ccpnet, ccpnof, ccpnsd, ccppc,
93       ccppc1, ccppc2, ccppc3, ccppc4, ccppkcl, ccppole, ccprc, ccprect,
94       ccprwc, ccprwu, ccpscam, ccpset, ccpspv, ccpt2d, ccptitle, ccpvp,
95       ccpvs, cidsfft, colcon, cpex01, cpex02, cpex03, cpex04, cpex05, cpex06,
96       cpex07, cpex08, cbex01, vvex01, tconpa, fcover, ffex03, ffex05,
97       fsfsgfa.
98

ACCESS

100       To use CPRECT or c_cprect, load the NCAR Graphics libraries ncarg,
101       ncarg_gks, and ncarg_c, preferably in that order.
102

SEE ALSO

104       Online: conpack, cpback, cpchcf, cpchcl, cpchhl, cpchil, cpchll,
105       cpcica, cpclam, cpcldm, cpcldr, cpcltr, cpcnrc, cpdrpl, cpezct, cpgetc,
106       cpgeti, cpgetr, cplbam, cplbdr, cpmpxy, cpmviw, cpmvrw, cppkcl, cppklb,
107       cprset, cpscae, cpsetc, cpseti, cpsetr, cpsps1, cpsps2, ncarg_cbind
108
109       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
110

112       Copyright (C) 1987-2007
113       University Corporation for Atmospheric Research
114
115       This documentation is free software; you can redistribute it and/or
116       modify it under the terms of the GNU General Public License as
117       published by the Free Software Foundation; either version 2 of the
118       License, or (at your option) any later version.
119
120       This software is distributed in the hope that it will be useful, but
121       WITHOUT ANY WARRANTY; without even the implied warranty of
122       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
123       General Public License for more details.
124
125       You should have received a copy of the GNU General Public License along
126       with this software; if not, write to the Free Software Foundation,
127       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
128
129
130
131
132UNIX                              March 1993                    CPRECT(3NCARG)
Impressum