CONOP2(3NCARG)

💖 CONOP2 💖 — the NCAR Graphics bestie that sets your options

okay so real talk: this is a page from the NCAR Graphics manual, section 3NCARG, and it's about a lil Fortran subroutine called CONOP2. she's the girl who sets the option switches and the INTEGER parameters for the Conran_family utility before you go plot anything. she doesn't draw the contours, she just preps the vibe. 💅

---

✨ NAME ✨

CONOP2 — sets option switches and specifys various INTEGER parameters to be used by the Conran_family utility.

(yes, "specifys" — we keep the original spelling, no cap, it's iconic 🫶)

---

🌸 SYNOPSIS 🌸

CALL CONOP2 (IOPT, IVAL)

---

🎀 DESCRIPTION 🎀

the arguments, bestie

• IOPT — Character, input. Selects an internal parameter and sets an option switch. The possibilities are literally these and only these:

'INT=OFF', 'INT=ALL', 'INT=MAJ', 'INT=MIN', 'INT=LAB', 'INT=DAT'
'LSZ=ON' or 'LSZ=OFF'
'NCP=ON' or 'NCP=OFF'
'SML=ON' or 'SML=OFF'
'SPD=ON' or 'SPD=OFF'
'SSZ=ON' or 'SSZ=OFF'
'STL=ON' or 'STL=OFF'

• IVAL — Integer, input. Sets an internal parameter.
  • If IOPT is not 'OFF', then the IVAL argument is used to override the default setting of that option.
  • If IOPT is 'OFF', the IVAL argument can have any dummy value. Option settings will be returned to their default values.

---

the options this subroutine defines 👑

INT

the parameter to determine the intensities of the contour lines and other parts of the plot. so:

• if INT=OFF, all intensities are set to the default values.
• if INT=ALL, all intensities are set to IVAL.
• if INT is set to one of the other possible options (MAJ, MIN, LAB or DAT), the intensity level for that option is set to IVAL.

the calls, in order:

If program set: CALL CONOP2('INT=OFF',0)

All the same:  CALL CONOP2('INT=ALL',IVAL)

Major lines:  CALL CONOP2('INT=MAJ',IVAL)

Minor lines:  CALL CONOP2('INT=MIN',IVAL)

Title and message:  CALL CONOP2('INT=LAB',IVAL)

Data values:  CALL CONOP2('INT=DAT',IVAL)

📌 Note: 'INT=DAT' relates to the plotted data values and the plotted maximums and minimums.

📌 Note: IVAL is the intensity desired. IVAL values range from 0 to 255.

Example, so you can see it in the wild:

CALL CONOP2('INT=ALL',110)

LSZ

this parameter determines the label size. (Does not apply to entry CONRAQ.) the value of LSZ is the desired length in NDCs multiplied by 1023. if LSZ=ON, the label size is set to IVAL. if LSZ=OFF, the default label size is 9./1023. NDCs.

Example: CALL CONOP2('LSZ=ON',12)

NCP

the parameter to indicate the number of data points used for the partial derivative estimation. if NCP=OFF, IVAL is set to 4, which is the default value. if NCP=ON, the user must specify IVAL greater than or equal to 2.

Example:  CALL CONOP2('NCP=ON',2)

📌 Note: IVAL = number of data points used for estimation. Changing this value affects the contours produced and the size of input array IWK.

SML

the parameter to determine the size of minimum and maximum contour labels in integer scaled NDC units. (Does not apply to entry CONRAQ.) the value of SML is the desired length in NDCs multiplied by 1023. if SML=OFF, the default label size is 15./1023. NDCs. if SML=ON, the user must specify IVAL.

Example: CALL CONOP2('SML=ON',12)

SPD

the parameter for the size of the plotted input data values in integer scaled NDC units. if SPD=OFF, the default label size is 8./1023. NDCs. if SPD=ON, the user must specify IVAL.

Example: CALL CONOP2('SPD=ON',12)

SSZ

the parameter to determine the resolution (number of steps in each direction). if SSZ=ON, the user sets IVAL, or, if SSZ=OFF, the program will automatically set IVAL to the default value of 40.

🚨 Warning: the scratch array (7th argument in the CONRAN call) must be dimensioned IVAL**2 or larger.

Example, because you need to see this one:

      DIMENSION SCR(10000)
      CALL CONOP2('SSZ=ON',100)
      CALL CONRAN(XD,YD,ZD,NDP,WK,IWK,SCR)

📌 Note: IVAL is an integer specifying the density of the virtual grid. in most cases, the default value of 40 produces pleasing contours. for coarser but quicker contours, lower the value. for smoother contours at the expense of taking a longer time, raise the value.

🚨 Warning: for step sizes greater than 200 in CONRAN, the arrays PV in common block CONRA1 and ITLOC in common block CONRA9, must be expanded to about 10 more than IVAL.

STL

the parameter to determine the character size of the main title in integer scaled NDC units. if STL=OFF, the default label size is 16./1023. NDCs. if STL=ON, the user must specify IVAL.

Example: CALL CONOP2('STL=ON',14)

📌 Note: when 30 or 40 characters are used for the title, the default size of 16 integer scaled NDC units works well. for longer titles, a smaller title size is required.

---

🦋 USAGE 🦋

CONOP2 is called to set parameters of type INTEGER before CONRAN, CONRAQ, or CONRAS are called to generate the contour plot. order matters, bestie. do the setup first. ✨

---

🌈 EXAMPLES 🌈

use the command ncargex to see the following examples: tconaq, tconan, and tconas.

---

👑 ACCESS 👑

to use CONOP2 load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.

---

💬 MESSAGES 💬

see the conran_family man page for a description of all Conran_family error messages and/or informational messages.

---

🔥 SEE ALSO 🔥

Online: conran_family, conran_family_params, conran, conraq, conras, conop1, conop3, conop4, conpack, conpack_params

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 and that's the whole page, fr fr 💖 this was the UNIX version, dated March 1993 (yes she's an elder icon and she ate), brought to you by the NCAR Graphics crew. go set your options and slay those contours 🎀✨🦋