CPPKCL(3NCARG)

💖 CPPKCL 💖 — the NCAR GRAPHICS page, bestie edition

okay so welcome to CPPKCL, a lil' routine from the NCAR GRAPHICS manual, 3NCARG section. she's here to pick your contour levels for you. no thoughts, just vibes, just math. ✨

---

✨ NAME ✨

CPPKCL — Picks a set of contour levels. that's it, that's her whole job. 🎀

---

🌸 SYNOPSIS 🌸

CALL CPPKCL (ZDAT, RWRK, IWRK)

---

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/ncargC.h>

void c_cppkcl (float *zdat, float *rwrk, int *iwrk)

---

💅 DESCRIPTION 💅

so here's the tea: all three arguments are arrays that were used in the last call to CPRECT, CPSPS1, or CPSPS2. and like... the contents must NOT have been changed since that call. do not touch. do not breathe on them. hands off. 🙈

• ZDAT — (REAL array, dimensioned as specified in the last call to CPRECT, CPSPS1, or CPSPS2, input) is the data array. the actual numbers. the moment. 👑
• RWRK — (REAL array, dimensioned as specified in the last call to CPRECT, CPSPS1, or CPSPS2, input/output) is the real workspace array. she works, she holds reals. 🫶
• IWRK — (INTEGER array, dimensioned as specified in the last call to CPRECT, CPSPS1, or CPSPS2, input/output) is the integer workspace array. same energy, but integers. 🔥

---

🧚 C-BINDING DESCRIPTION 🧚

The C-binding argument descriptions are the same as the FORTRAN argument descriptions. literally identical. matching outfits. 👯

---

🌈 USAGE 🌈

ngl, normally CPPKCL is called by CONPACK when the contour levels are needed. but she can also be called directly by the user when you wanna modify the resulting parameter arrays that specify contour levels and associated quantities in some way. main character behavior. 💅

CPPKCL must be called after initialization has been done (by a call to one of the initialization routines CPRECT, CPSPS1, or CPSPS2); this is because CPPKCL depends on values set during initialization. no init, no levels. periodt.

If the contour-level-selection parameter 'CLS' is zero (meaning the user intends to pick contour levels themselves, iconic, we respect it), or if the constant-field-flag 'CFF' is non-zero (meaning that, during initialization, the data were found to be essentially constant — flat, beige, no notes), then CPPKCL does nothing. she simply does not. 😌

Otherwise? CPPKCL picks a set of contour levels. ✨ The way in which it picks these levels is determined by the value of the internal parameter 'CLS' — go read the description of this parameter in the conpack_params man page for the full lore. 📖

When CPPKCL picks contour levels, it sets the value of the internal parameter 'NCL' equal to the number of contour levels picked. Then it sets the values of elements 1 through 'NCL' of the parameter array 'CLV' (contour level values) to the levels chosen. slay. 🎉

The Ith elements of the associated parameter arrays are set as follows:

• CLU = 1 or 3 — Contour level use flag
• AIA = I+1 — Area identifier above the level
• AIB = I — Area identifier below the level
• LLT = ' ' (single blank) — Contour line label text
• CLD = '$$$$$$$$$$$$$' — Contour line dash pattern
• CLC = -1 — Contour line color
• LLC = -1 — Contour line label color
• CLL = 0. — Contour line line width

---

💜 so after CPPKCL is called, here's the situation for each contour level 💜

• Contour lines at the level are to be drawn by calls to CPCLDM or CPCLDR. 🖊️
• The lines will be labeled if 'CLU'=3, but not if 'CLU'=1. iykyk.
• If CPCLAM is called, lines at the level will be added to the area map; the area identifiers for areas "above" the level and for areas "below" the level are as specified by 'AIA' and 'AIB'. 🗺️
• The dash pattern for the level is solid, and neither the color of the line, the color of the labels on it, nor its width are to be set. unbothered. uncolored. undefined width energy. 🍓
• The text of the label associated with the level is, as yet, unspecified. mystery. a secret. 🙈

By resetting elements in these parameter arrays, the user can change the situation in various ways. go off, customize, make it yours. 👑

---

🔥 EXAMPLES 🔥

Use the ncargex command to see the following relevant examples:

• ccpclc
• ccpcld
• ccpcldm
• ccpcll
• ccpklb
• ccplbam
• ccplbdr
• ccpllb
• ccpllc
• ccplll
• ccpllo
• ccpllp
• ccpllt
• ccpllw
• ccppc
• ccppc1
• ccppc2
• ccppc3
• ccppc4
• ccppkcl
• ccprc
• ccprwc
• ccpscam
• cpex01
• cpex02
• cpex03
• cpex06
• vvex01
• fcover
• ffex03
• ffex05

---

🎀 ACCESS 🎀

To use CPPKCL or c_cppkcl, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. order matters bestie, don't be chaotic with your link line. ⭐

---

💀 MESSAGES 💀

See the conpack man page for a description of all Conpack error messages and/or informational messages. she will tell you what went wrong. listen to her. 🫶

---

🌸 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, cppklb, 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. 📜 (read it, bestie, it's giving legally binding.)

---

and that's the whole page!! 💖✨🎀🦋🌸💅🫶😭🔥👑🌈⭐💀🙈🍓🧚💜

cute sign-off time: this lil' masterpiece is from the UNIX manual, dated March 1993, and its source/version tag is CPPKCL(3NCARG). iconic since '93. no cap. 💅