CPLBDR(3NCARG)

✨ CPLBDR ✨ (from the NCAR GRAPHICS girlies 💅)

okay bestie, sit down, hydrate, because today we're talking about CPLBDR, a lil routine from the NCAR GRAPHICS manual that draws labels. like... all the labels. the informational label, the high and low labels, AND the contour line labels. it's giving "one function, every label, no crumbs." 🎀

---

🌸 NAME 🌸

CPLBDR — draws labels (an informational label, high and low labels, and line labels).

no cap, that's the whole job. it labels. she's a labeler. 👑

---

🦋 SYNOPSIS 🦋

CALL CPLBDR (ZDAT, RWRK, IWRK)

💜 C-BINDING SYNOPSIS 💜

#include <ncarg/ncargC.h>

void c_cplbdr (float *zdat, float *rwk, int *iwrk)

wait bestie, let me redo that one exactly as the page says:

#include <ncarg/ncargC.h>

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

there we go. C girlies, you're covered too. 💖

---

🌈 DESCRIPTION 🌈

okay so all three arguments are arrays that got used in the last call to CPRECT, CPSPS1, or CPSPS2 — and here's the tea: their contents must not have been changed since that call. like, do not touch. do not breathe on them. they are frozen in time, iconic, untouchable. 🙈

• ZDAT — (REAL array, dimensioned as specified in the last call to CPRECT, CPSPS1, or CPSPS2, input) is the data array. the actual data. the moment. ✨
• RWRK — (REAL array, dimensioned as specified in the last call to CPRECT, CPSPS1, or CPSPS2, input/output) is the real workspace array. it goes in, it comes out, it's a whole journey. 🫶
• 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 with integers. 💅

🧚 C-BINDING DESCRIPTION 🧚

the C-binding argument descriptions are the same as the FORTRAN argument descriptions. literally identical. no notes. periodt. 💀

---

👑 USAGE 👑

CPLBDR may be called at any time after the initialization call to CPRECT, CPSPS1, or CPSPS2. whenever you want, bestie, she's ready.

BUT — plot twist — if, during the last call to CPRECT, CPSPS1, or CPSPS2, the data being contoured were found to be essentially constant, then the constant-field label is drawn. that's it. that's the whole drawing. flat data, flat vibes, one label. 😌

otherwise? otherwise we're in business, and the information label, the high and low labels, and/or the contour line labels get drawn, as follows:

• the information label is drawn only if the parameter 'ILT', which specifies the text of that label, is not blank.
• high labels are drawn only if the parameter 'HIT', which specifies the text of those labels, is not blank.
• low labels are drawn only if the parameter 'LOT', which specifies the text of those labels, is not blank.
• contour line labels are drawn only if the parameter 'LLP', which specifies how those labels are to be positioned, has an absolute value of 2 or 3, AND if, for some I between 1 and 'NCL' inclusive, the Ith element of the parameter array 'CLU' has a value implying that contour lines at the contour level specified by the Ith element of 'CLV' are to be labeled.

so yeah. blank text = no label. she's not drawing empty nothing for you. and the line labels need 'LLP' at 2 or 3 in absolute value, plus the whole 'CLU' / 'CLV' situation lining up. iykyk. 🔥

---

🍓 EXAMPLES 🍓

use the ncargex command to see the following relevant examples:

ccpcff, ccpcfx, ccpcldm, ccpfil, ccphl, ccphlt, ccpila, ccpils, ccpilt, ccplbam, ccplbdr, ccpllb, ccpllc, ccplll, ccpllo, ccpllp, ccpllt, ccpllw, ccpnet, ccpnof, ccpnsd, ccppc, ccppc1, ccppc2, ccppc3, ccppc4, ccprc, ccpscam, colcon, cpex01, cpex02, cpex03, cpex04, cpex06, cbex01, vvex01, fcover, ffex03, ffex05.

that's a LOT of examples and yes, they are all listed, because we do not gatekeep in this house. 💜

---

⭐ ACCESS ⭐

to use CPLBDR or c_cplbdr, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. order matters, bestie, it's not a vibe suggestion. 🌟

---

💌 MESSAGES 💌

see the conpack man page for a description of all Conpack error messages and/or informational messages. if she's yelling at you, that's where the translation lives. 😭

---

🔍 SEE ALSO 🔍

Online: conpack, cpback, cpchcf, cpchcl, cpchhl, cpchil, cpchll, cpcica, cpclam, cpcldm, cpcldr, cpcltr, cpcnrc, cpdrpl, cpezct, cpgetc, cpgeti, cpgetr, cplbam, cpmpxy, cpmviw, cpmvrw, cppkcl, cppklb, cprect, cprset, cpscae, cpsetc, cpseti, cpsetr, cpsps1, cpsps2, ncarg_cbind

Hardcopy: NCAR Graphics Contouring and Mapping Tutorial

go read the tutorial, it's lowkey the lore. 📚

---

🎀 COPYRIGHT 🎀

Copyright (C) 1987-2009 University Corporation for Atmospheric Research

The use of this Software is governed by a License Agreement.

like, legally speaking, respect the license. 💖

---

okay that's the whole page bestie, you ate, go draw some labels. this was CPLBDR(3NCARG) from the UNIX manual, NCAR GRAPHICS edition, dated March 1993 — yes she's vintage, yes she still slays, and no, we're not changing a single character of her. mwah. 💅✨🦋