NAME¶
CPPKLB - Picks a set of labels for labeled contour levels.
SYNOPSIS¶
CALL CPPKLB (ZDAT, RWRK, IWRK)
C-BINDING SYNOPSIS¶
#include <ncarg/ncargC.h>
void c_cppklb (float *zdat, float *rwrk, int *iwrk)
DESCRIPTION¶
All three arguments are arrays used in the last call to CPRECT, CPSPS1, or
CPSPS2, the contents of which must not have been changed since that call.
- ZDAT
- (REAL array, dimensioned as specified in the last call to CPRECT, CPSPS1,
or CPSPS2, input) is the data array.
- RWRK
- (REAL array, dimensioned as specified in the last call to CPRECT, CPSPS1,
or CPSPS2, input/output) is the real workspace array.
- IWRK
- (INTEGER array, dimensioned as specified in the last call to CPRECT,
CPSPS1, or CPSPS2, input/output) is the integer workspace array.
C-BINDING DESCRIPTION¶
The C-binding argument descriptions are the same as the FORTRAN argument
descriptions.
USAGE¶
Normally, CPPKLB is called by Conpack when labels for the contour levels are
needed. You can call CPPKLB directly (after the initialization call to CPRECT,
CPSPS1 or CPSPS2) when you want to modify the resulting parameter arrays that
specify the labels.
If the constant-field-flag 'CFF' is non-zero, indicating that, during the last
call to CPRECT, CPSPS1, or CPSPS2, the data were found to be essentially
constant, CPPKLB does nothing. Otherwise, CPPKLB examines the first 'NCL'
elements of the parameter array 'CLV', which defines the contour levels, and
the associated parameter arrays, looking for levels that are to be labeled
('CLU' = 2 or 3) for which no label is specified (the associated element of
'LLT' is ' ', a single blank.) If any such levels are found, labels are
generated for them.
The scale factor 'SFU' may be set as a byproduct of choosing the labels. See the
description of the parameters 'SFU' (scale factor used) and 'SFS' (scale
factor selector) in the conpack_params man page.
After calling CPPKLB, a user program may examine the generated labels and change
them in various ways.
EXAMPLES¶
Use the ncargex command to see the following relevant example: ccpklb.
ACCESS¶
To use CPPKLB or c_cppklb, load the NCAR Graphics libraries ncarg, ncarg_gks,
and ncarg_c, preferably in that order.
MESSAGES¶
See the conpack man page for a description of all Conpack error messages and/or
informational messages.
SEE ALSO¶
Online: conpack, cpback, cpchcf, cpchcl, cpchhl, cpchil, cpchll, cpcica, cpclam,
cpcldm, cpcldr, cpcltr, cpcnrc, cpdrpl, cpezct, cpgetc, cpgeti, cpgetr,
cplbam, cplbdr, cpmpxy, cpmviw, cpmvrw, cppkcl, cprect, cprset, cpscae,
cpsetc, cpseti, cpsetr, cpsps1, cpsps2, ncarg_cbind
Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
COPYRIGHT¶
Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.