EZCNTR(3NCARG)

💖 EZCNTR — the NCAR Graphics manual page, but make it cute 💖

okay bestie, gather round, because we're talking about EZCNTR from NCAR Graphics (yes that's the 3NCARG manual, mwah) and she is vintage. sit down, sip your lil drink, let's go 🍓

---

✨ NAME ✨

EZCNTR — draws a two dimensional contour map from data stored in a rectangular array. A number of contouring defaults are used. she just does it for you, no config, no stress 💅

---

🫶 STATUS 🫶

okay so… EZCNTR is obsolete. not me delivering bad news first thing 😭 she has been superseded by the contouring package, Conpack.

• for a simple EZCNTR replacement, go peek at the Conpack entry CPCNRC 👑
• for the more complex examples, refer to the conpack and conpack_params man pages, plus the NCAR Graphics Contouring and Mapping Tutorial 📚

EZCNTR continues to be provided for compatibility of early NCAR Graphics codes (she's a legacy queen, we respect her). But if you are writing new code, we suggest you use the more general and rigorous Conpack contouring package instead. And yes, every EZCNTR option that gets set by default can be duplicated by the proper selection of Conpack parameters — no cap ✨

---

🌸 SYNOPSIS 🌸

CALL EZCNTR(Z,M,N) - draws a contour map based upon a set of default options.

---

💜 DESCRIPTION 💜

• Z — an input array of type REAL defining a two-dimensional field of extent M by N, which is to be contoured. this is the whole vibe right here, the actual data 💖
• M — an input parameter of type INTEGER which is the first dimension of the Z array.
• N — an input parameter of type INTEGER which is the second dimension of the Z array.

---

🎀 EXAMPLES 🎀

use the ncargex command to see the relevant examples tconre, tcnqck, tcnsmt, and tcnsup. literally go look, they're right there 🦋

---

🌈 ACCESS 🌈

EZCNTR can be invoked in four different ways to create contour plots which vary considerably in appearance. the four variations include quick, normal, smooth, and super contour lines. this progression represents a tradeoff between speed of computation and the appearance of the contour plots. these variations are specified through selected command line options of the ncargf77 command. pick your fighter 💅

to use EZCNTR, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order (order matters bestie, don't be chaotic 🙈). other optional libraries to create the quick, smooth, and super contours will automatically be linked by the ncargf77 command.

to run a code called mycode.f which has one or more calls to entry EZCNTR, issue one of the commands:

⚡ NORMAL

Command:

ncargf77 mycode.f

the contours will be drawn as unsmoothed dashed or solid lines that can include characters along the lines.

🔥 QUICK

Command:

ncargf77 -quick mycode.f

the contours will be drawn as unsmoothed dashed or solid lines without characters along the lines. the QUICK drawing algorithm is faster and cruder than that used for NORMAL contour lines. QUICK uses a cell-by-cell analysis rather than following each contour line to completion in sequence as is done in the NORMAL algorithm. she's fast, she's messy, we love her 💀

🧚 SMOOTH

Command:

ncargf77 -smooth mycode.f

the contours will be drawn as smoothed dashed or solid lines using splines under tension. there may be characters along the lines. glowing, ethereal, iconic ✨

👑 SUPER

Command:

ncargf77 -super mycode.f

the contours will be drawn as smoothed dashed or solid lines using splines under tension. there may be characters along the lines. crowded lines can be thinned. main character energy fr fr 🌟

---

😭 MESSAGES 😭

when error conditions are detected, the support routine SETER is called in such a way that it writes a message to the standard error file (as defined by I1MACH(4)) and then terminates execution. so like… it will end you, gently, with a note 📝

the possible error messages are as follows:

CONREC - DIMENSION ERROR - M*N .GT. (2**IARTH)

the array to be contoured is dimensioned M by N. this is larger than the address space on this computer (2**IARTH) where IARTH is the size of an address integer. check your dimension sizes. like genuinely, go check them 🫶

---

🦋 SEE ALSO 🦋

Online: conrec, conrec_family_params, conrec_family, conpack, conpack_params, cpcnrc, ncargf77

Hardcopy: NCAR Graphics Contouring and Mapping Tutorial; NCAR Graphics Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics

---

💖 COPYRIGHT 💖

Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.

---

and that's the whole page, bestie 🎀 this was the UNIX version of EZCNTR(3NCARG), dated March 1993 — yes, a whole vintage icon from back in the day, still serving looks. slay, stay contoured, and go use Conpack for new code, ily 💜✨