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

NAME

6       CPPKLB - Picks a set of labels for labeled contour levels.
7

SYNOPSIS

9       CALL CPPKLB (ZDAT, RWRK, IWRK)
10

C-BINDING SYNOPSIS

12       #include <ncarg/ncargC.h>
13
14       void c_cppklb (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, CPPKLB is called by Conpack when labels for the contour
38       levels are needed.  You can call CPPKLB directly (after the
39       initialization call to CPRECT, CPSPS1 or CPSPS2) when you want to
40       modify the resulting parameter arrays that specify the labels.
41
42       If the constant-field-flag 'CFF' is non-zero, indicating that, during
43       the last call to CPRECT, CPSPS1, or CPSPS2, the data were found to be
44       essentially constant, CPPKLB does nothing.  Otherwise, CPPKLB examines
45       the first 'NCL' elements of the parameter array 'CLV', which defines
46       the contour levels, and the associated parameter arrays, looking for
47       levels that are to be labeled ('CLU' = 2 or 3) for which no label is
48       specified (the associated element of 'LLT' is ' ', a single blank.) If
49       any such levels are found, labels are generated for them.
50
51       The scale factor 'SFU' may be set as a byproduct of choosing the
52       labels.  See the description of the parameters 'SFU' (scale factor
53       used) and 'SFS' (scale factor selector) in the conpack_params man page.
54
55       After calling CPPKLB, a user program may examine the generated labels
56       and change them in various ways.
57

EXAMPLES

59       Use the ncargex command to see the following relevant example: ccpklb.
60

ACCESS

62       To use CPPKLB or c_cppklb, load the NCAR Graphics libraries ncarg,
63       ncarg_gks, and ncarg_c, preferably in that order.
64

MESSAGES

66       See the conpack man page for a description of all Conpack error
67       messages and/or informational messages.
68

SEE ALSO

70       Online: conpack, cpback, cpchcf, cpchcl, cpchhl, cpchil, cpchll,
71       cpcica, cpclam, cpcldm, cpcldr, cpcltr, cpcnrc, cpdrpl, cpezct, cpgetc,
72       cpgeti, cpgetr, cplbam, cplbdr, cpmpxy, cpmviw, cpmvrw, cppkcl, cprect,
73       cprset, cpscae, cpsetc, cpseti, cpsetr, cpsps1, cpsps2, ncarg_cbind
74
75       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
76

78       Copyright (C) 1987-2009
79       University Corporation for Atmospheric Research
80
81       The use of this Software is governed by a License Agreement.
82
83
84
85UNIX                              March 1993                    CPPKLB(3NCARG)
Impressum