Conran_family(3NCARG)

✨ Conran_family ✨ (that's the 3NCARG manual, bestie 💖)

okay so. Conran_family is literally a whole set of two-dimensional contour mapping routines for irregularly distributed data. irregularly distributed. not gridded. just vibes and scattered points, and it'll contour them anyway. iconic behavior honestly 🌸

There are three Conran_family entries, and you need to know their names: CONRAN, CONRAQ, and CONRAS. Now — plot twist — CONRAN can be invoked in two ways. One generates smoothed contours, the other does not. CONRAQ is the quick version of the package, and she has a more limited set of options than the other entries (she's the low-effort queen, we respect her 💅). CONRAS is the super version of the package. super. capital S super 👑

---

🚨 STATUS 🚨

ngl bestie, the Conran_family is approaching obsolescence. it's giving "senior year, already checked out" 😭. If you have available an interpolation package which can do a random to gridded interpolation equal to that built into the Conran_family, then we recommend that you grid your dataset and use the Conpack utility instead. Refer to the conpack and conpack_params man pages as well as the NCAR Graphics Contouring and Mapping Tutorial. that's the glow-up path fr fr ✨

---

🦋 SYNOPSIS 🦋

• CONRAN — Provides the standard and smooth versions for contouring of irregularly gridded data.
• CONRAQ — Provides the quick form of the package. It does not have as many available options as the other entries.
• CONRAS — This is the super version of the package. Not only does it smooth and label contour lines, it can also reduce line crowding. (crowding reduction?? she's thoughtful 🫶)
• CONOP1 — Sets values of internal parameters of type logical. Specifically, CONOP1 is used to turn options "OFF", or "ON".
• CONOP2 — Sets values of internal parameters of type integer.
• CONOP3 — Sets values of internal parameters of type real.
• CONOP4 — Sets values of internal parameters of type character.

---

🎀 ACCESS 🎀

There are three entries in the Conran_family which create contour plots: CONRAQ (quick), CONRAS (super), and CONRAN (standard and smooth.)

To use standard CONRAN, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. (order matters, don't be chaotic about it 🙈). To run any of the other three options (quick, super, or smooth), one or more additional libraries is needed as follows:

• quick — additionally load the conraq library.
• smooth — additionally load the dashsmth library.
• super — additionally load the conras and dashsupr libraries.

These libraries can also be implicitly loaded by using the -quick, -smooth, or -super option of the ncargf77 command. For example, to run a code called mycode.f which has one or more calls to a Conran_family entry, issue one of the commands:

QUICK

Command: "ncargf77 -quick mycode.f"

mycode.f has one or more calls to entry CONRAQ.

NORMAL

Command: "ncargf77 mycode.f"

mycode.f has one or more calls to entry CONRAN.

SMOOTH

Command: "ncargf77 -smooth mycode.f"

mycode.f has one or more calls to entry CONRAN.

SUPER

Command: "ncargf77 -super mycode.f"

mycode.f has one or more calls to entry CONRAS.

⚠️ Warning: mycode.f can only call one of the three entries, CONRAQ, CONRAN, or CONRAS. pick one. commit. no polyamory with these entries 💀

---

💬 MESSAGES 💬

Error messages generated by CONRAN routines include:

• CONCLS — CONSTANT INPUT FIELD The input data all has a constant value. This may indicate that the data has not been input correctly in the user program. (every single point the same?? suspicious bestie, check your input 🍓)
• CONDRW — CONTOUR STORAGE EXHAUSTED This error is trapped and nullified by CONRAN. It serves to signal the user that a contour level may not be complete. (she's not mad, she's just letting you know a level might be unfinished 😭)
• CONOP — UNDEFINED OPTION The parameter name has either been misspelled in a CONOP call, or an out of range parameter value has been specified. This message can be generated by CONOP1, CONOP2, CONOP3, or CONOP4.
• CONOP3 — ILLEGAL USE OF CON OPTION WITH CIL OR CHL OPTIONS Review the definitions of these three parameters using man page conran_family_params.
• CONOP3 — NUMBER OF CONTOUR LEVELS EXCEEDS 30 Reduce the requested number of contour levels specified by parameter CON to 30 or less. (30 is the limit, bestie, that's the ceiling, no cap 🧚)
• CONRAN — INPUT PARAMETER NDP LT NCP NDP is the total number of input values for contouring. NCP is the number of points used for partial derivative estimation. NCP cannot exceed NDP. This error message also occurs in CONRAS and CONRAQ.
• CONRAN — NCP LT 2 OR GT NCPSZ The legal value of NCP must be between NCPSZ (dimension size allowed) and 2. This error message also occurs in CONRAS and CONRAQ.
• CONSTP — ASPECT RATIO OF X AND Y GREATER THAN 5 TO 1. (This error may cause a poor quality plot. Usually this can be fixed by multiplying X or Y by a constant factor. If this solution is unacceptable then increasing internal parameter SSZ to a very large value may help. Note: This can be expensive.) 🤑 expensive as in compute, not as in your wallet, but still — noted.
• CONTNG — ALL COLINEAR DATA POINTS Indicates that the input data set to be contoured all lies along a straight line. Thus, triangulation cannot occur. (a straight line has zero triangle energy, it's giving flat 💀)
• CONTNG — IDENTICAL INPUT DATA POINTS FOUND

The errors listed above are defined as recoverable errors should the user wish to use them in that fashion. The documentation on the ERPRT77 package explains how to recover from an error. so you can bounce back from these, you just gotta read the lore 📖

---

👀 SEE ALSO 👀

Online: conran, conraq, conras, conran_family_params, conop1, conop2, conop3, conop4, conpack, conpack_params, cpcnrc, bivar, 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.

---

okay that's the whole page bestie, you ate it, you're basically a contouring main character now 👑 this was the Conran_family(3NCARG) page from the UNIX manual, dated March 1993, and it lives in the NCAR GRAPHICS section. go make some irregularly distributed data look gorgeous ✨🦋💖