Conrec_family_params(3NCARG)

💖 Conrec_family_params — NCAR GRAPHICS (3NCARG) 💖

okay bestie, gather round, because this page is literally just the lore drop for every internal parameter of the Conrec_family utility 🫶

✨ NAME ✨

Conrec_family_params — includes a brief description of all Conrec_family internal parameters. that's it, that's the whole job, and honestly? iconic. 💅

🌸 DESCRIPTION 🌸

so here's the tea: there are no parameter setting functions available for the Conrec_family utility. none. zero. nada. 🙈 Instead, parameters were set through the common blocks CONRE1 and CONRE4. yes, you read that right — you're setting params the old-school way.

also, plot twist (not really a plot twist, it's in the docs): there are three versions of the CONREC code. the normal version lives in the standard NCAR Graphics library 👑. the other two versions live in optional libraries, and one of them gets linked when the ncargf77 option -quick, or -super is declared on the command line.

the CONREC and EZCNTR entries can be invoked in four different ways to create contour plots which vary considerably in appearance. the four variations are:

• quick
• normal
• smooth
• super

contour lines, obviously. 💫 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.

🧚 For normal or smooth options, the parameter set is:

 COMMON /CONRE1/ IOFFP      ,SPVAL
 COMMON /CONRE4/ ISIZEL     ,ISIZEM     ,ISIZEP     ,NREP       ,
 1                NCRT       ,ILAB       ,NULBLL     ,IOFFD      ,
 2                EXT        ,IOFFM      ,ISOLID     ,NLA        ,
 3                NLM        ,XLT        ,YBT        ,SIDE

⚡ For the quick option, the parameter set is:

 COMMON /CONRE1/ IOFFP      ,SPVAL
 COMMON /CONRE4/ ISIZEM     ,ISIZEP     ,NLA        ,NLM        ,
 1                XLT        ,YBT        ,SIDE       ,ISOLID     ,
 2                EXT        ,IOFFD      ,IOFFM

🌈 For the super option, the parameter set is:

 COMMON /CONRE1/ IOFFP      ,SPVAL      ,IHILO
 DATA ISIZEL,ISIZEM,ISIZEP,NLA,NLM,XLT,YBT,SIDE,ISOLID,NREP,NCRT/
 1       1,  2,   0, 16, 40,.05,.05,  .9,  1023,   6,   4/
 DATA EXT,IOFFD,NULBLL,IOFFM,ILAB/.25,0,3,0,1/

👑 Definitions of the inclusive set (aka the full roster, no skips) 👑

• ISIZEL — size of line labels in Plotter Address Units (PAUs).
  • 0 = 8 PAUs
  • 1 = 12 PAUs
  • 2 = 16 PAUs
  • 3 = 24 PAUs
  • > 3 means use this number of PAUs.
  • [Default = 1]
• ISIZEM — size of labels for minimums and maximums, as per the size definitions given for ISIZEL. [Default = 2]
• ISIZEP — size of labels for data point values as per the size definitions given for ISIZEL. [Default = 0]
• NLA — approximate number of contour levels when internally generated. [Default = 16]
• NLM — maximum number of contour levels. 🚨 if this is to be increased, the dimensions of CL and RWORK in conrec.f must be increased by the same amount. don't skip this step bestie, fr fr. [Default = 40]
• XLT — left hand edge of the plot (0.0 is the left edge of the frame and 1.0 is the right edge of the frame.) [Default = .05]
• YBT — bottom edge of the plot (0.0 is the bottom of the frame and 1.0 is the top of the frame.) [Default = .05]
• SIDE — length of longer edge of plot (see also EXT). [Default = .90]
• NREP — number of repetitions of the dash pattern between line labels. [Default = 6]
• NCRT — number of CRT units per element (bit) in the dash pattern. [Default = 4]
• ILAB — flag to control the drawing of line labels.
  • ILAB non-zero means label the lines.
  • ILAB = 0 means do not label the lines.
  • [Default = 1]
• NULBUL — number of unlabeled lines between labeled lines. for example, when NULBLL = 3, every fourth level is labeled. [Default = 3]
• IOFFD — flag to control normalization of label numbers.
  • IOFFD = 0 means include decimal point when possible (do not normalize unless required).
  • IOFFD non-zero means normalize all label numbers and output a scale factor in the message below the graph.
  • [Default = 0]
• EXT — lengths of the sides of the plot are proportional to M and N (when CONREC sets the window and viewport). in extreme cases, when MIN(M,N)/MAX(M,N) is less than EXT, Conrec produces a square plot. 📐 [Default = .25]
• IOFFP — flag to control special value feature.
  • IOFFP = 0 means the special value feature is not in use.
  • IOFFP non-zero means the special value feature is in use. (SPVAL is set to the special value.) Contour lines will then be omitted from any cell with any corner equal to the special value.
  • [Default = 0]
• SPVAL — contains the special value when IOFFP is non-zero. [Default = 0.]
• IOFFM — flag to control the message below the plot.
  • IOFFM = 0 if the message is to be plotted.
  • IOFFM non-zero if the message is to be omitted.
  • [Default = 0]
• ISOLID — dash pattern for non-negative contour lines. [Default = 1023]

🔥 SEE ALSO 🔥

Online: conrec_family, conpack, conpack_params, ezcntr, conrec

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.

no cap, that's the whole page. go forth and contour responsibly, bestie 🦋✨

and that's a wrap on the UNIX version from March 1993, page Conrec_family_params(3NCARG) — mwah, take care of her, she's vintage 💅🎀