CPDRPL(3NCARG)

💖 CPDRPL — the polyline drawer bestie 💖

okay so hi bestie!! welcome to the NCAR GRAPHICS manual, and specifically to CPDRPL, which is a genuinely useful little polyline-drawer made for its bff routine CPCLDM. that's the whole vibe. let's get into it 💅

---

✨ NAME ✨

CPDRPL — Provides a useful polyline-drawer for the routine CPCLDM.

like. that's it. that's the job. it draws polylines. and it does it for CPCLDM. iconic behaviour honestly 🫶

---

🌸 SYNOPSIS 🌸

CALL CPDRPL (XCS, YCS, NCS, IAI, IAG, NAI)

six arguments, no cap. that's the whole call. go off ⭐

---

🦋 DESCRIPTION 🦋

okay so here's what every single one of those arguments actually is, because the way that a manpage lists arguments is lowkey a whole vibe and we're not skipping a single one:

• XCS — a REAL array of dimension at least NCS, and it's an input. it holds the X coordinates of the NCS points that define a polyline. 🎀
• YCS — a REAL array of dimension at least NCS, also an input. it holds the Y coordinates of those same NCS points defining the polyline. so like, XCS and YCS are a matched set, they're giving power couple fr fr 💜
• NCS — an INTEGER, input. it's the number of points defining the polyline. so it's the count. the how-many. 🍓
• IAI — an INTEGER array of dimension at least NAI, input. it's an array of area identifiers for the area in which the polyline lies. and for each I from 1 to NAI, IAI(I) is the area identifier of the area with respect to the edge group IAG(I). yes, IAI and IAG are paired up index by index, they're literally holding hands. 😭
• IAG — an INTEGER array of dimension at least NAI, input. it's an array of group identifiers. and bestie, just go read the description of IAI above, because they're the same shape, same length, same energy, different job. 👑
• NAI — an INTEGER, input. it's the number of area identifiers in the array IAI, and also the number of group identifiers in the array IAG. one number, two arrays, that's the deal. 🌈

---

🧚 USAGE 🧚

okay so here's the actual situation. if you're calling CPCLDM, and the only reason you're using it instead of CPCLDR to draw contour lines is to avoid drawing the lines through labels — like, that's your whole motivation, nothing else — then here's what you do:

in the routine which calls CPCLDM, put the declaration

EXTERNAL CPDRPL

and then, in the call to CPCLDM, use CPDRPL for the argument RTPL. that's it. that's the swap. 🔥

and every single time CPDRPL is called, it draws the polyline defined by its first three arguments if, and only if, none of the area identifiers defined by the other three arguments is negative.

if, and only if — like, that's not a suggestion, that's the condition. one negative area identifier and the polyline is simply not happening. vibe check failed, no drawing for you 💀

---

💫 ACCESS 💫

to use CPDRPL, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — and preferably in that order, bestie, the order is not a suggestion 🎀

---

⭐ SEE ALSO ⭐

💻 Online

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

that's the whole squad, no one left behind, we love a complete list 🫶

📚 Hardcopy

NCAR Graphics Contouring and Mapping Tutorial

yes it's a real document, yes you can read it, yes it's giving study session energy 📖

---

🌸 COPYRIGHT 🌸

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

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

like, legally speaking, that's the whole thing, don't skip it bestie 💜

---

okay so that's CPDRPL, page CPDRPL(3NCARG) out of the NCAR GRAPHICS manual on UNIX, dated March 1993 — yes she's vintage, yes she still ate, no notes. mwah, go draw some polylines 💅✨