Conrec_family(3NCARG)

💖 Conrec_family — the contour queen of 3NCARG 💖

okay bestie, pull up a chair, we're talking about Conrec_family, a whole little family of two-dimensional contour mapping routines from the NCAR Graphics manual. yes, the manual — that's the 3NCARG energy you're sensing. 🎀

What's in the box? Options for generating standard contours, smoothing contour lines, labeling the contours, and removing crowded lines. a full glow-up kit for your data. ✨

---

🚨 STATUS 🚨

ngl bestie, Conrec_family is obsolete. it got replaced by the contouring package, Conpack. for a simple CONREC replacement, go look at the Conpack entry CPCNRC. for more complex examples, refer to the conpack and conpack_params man pages, plus the NCAR Graphics Contouring and Mapping Tutorial.

Conrec_family is still hanging around for compatibility of early NCAR Graphics codes. if you're writing new code? we suggest you use the more general and rigorous Conpack contouring package instead. the good news: all Conrec_family options are available via Conpack parameters. so it's not a loss, it's a migration. 💅

---

✨ SYNOPSIS ✨

EZCNTR(Z,M,N) - draws a contour map based upon a set of default options.
CONREC(Z,L,M,N,FLO,HI,FINC,NSET,NHI,NDOT) - draws a contour map using
options specified as input arguments.

literally two entries, doing the contour thing. that's the whole synopsis, periodt.

---

🔥 ACCESS 🔥

The Conrec family contains only two user callable entries: EZCNTR and CONREC. but here's the gag — those two entries can be invoked in four different ways, and the contour plots vary considerably in appearance. 🌈

The four variations:

• quick
• normal
• smooth
• super

This progression is 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. 👑

To use EZCNTR or CONREC, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. 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 or CONREC, 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. speed demon behavior, honestly. 💀

💜 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. soft. graceful. 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. 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. 🙈

STLINE - WARNING FROM ROUTINE STLINE IN CONREC--WORK ARRAY OVERFLOW

This warning message is printed to standard output if the number of contour lines for a contour level would exceed the dimension size of work array IR in routine STLINE.

Should this happen the following messages are also sent to the output plot file:

**WARNING--PICTURE INCOMPLETE**
WORK ARRAY OVERFLOW IN STLINE

Processing stops before the actual array overflow occurs and control is returned to the calling program. so like, it catches itself. still not ideal bestie.

---

🌸 SEE ALSO 🌸

Online: conrec, ezcntr, conrec_family_params, conpack, conpack_params, cpcnrc, dashline_family, 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 version is from the UNIX manual, dated March 1993, and it lives under the name Conrec_family(3NCARG) — so if you ever need to cite it, that's the glow-up signature. mwah, go contour something gorgeous. 💅✨🦋