CONOP1(3NCARG)

💖 CONOP1 💖 — the vibe-setting queen of the Conran_family 💅

okay bestie, welcome to CONOP1, a little subroutine from the NCAR Graphics manual (3NCARG), and she is literally the switchboard for the whole Conran_family. think of her as the group chat admin who flips everyone's settings before the contour plot even shows up. no cap. 🎀

---

✨ NAME ✨

CONOP1 — sets option switches for the Conran_family utility. that's it, that's the job, and she ate. 👑

---

🌸 SYNOPSIS 🌸

CALL CONOP1 (IOPT)

---

🦋 DESCRIPTION 🦋

• IOPT — Character, input. she picks an internal parameter and sets an option switch for you. the possibilities are:

'DEF'
'EXT=ON' or 'EXT=OFF'
'GRI=ON' or 'GRI=OFF'
'ITP=C1' or 'ITP=LIN'
'LAB=ON' or 'LAB=OFF'
'LOT=ON' or 'LOT=OFF'
'MES=ON' or 'MES=OFF'
'PDV=ON' or 'PDV=OFF'
'PER=ON' or 'PER=OFF'
'PMM=ON' or 'PMM=OFF'
'PSL=ON' or 'PSL=OFF'
'REP=ON' or 'REP=OFF'
'SCA=ON' or 'SCA=OFF' or 'SCA=PRI'
'TFR=ON' or 'TFR=OFF'
'TOP=ON' or 'TOP=OFF'
'TRI=ON' or 'TRI=OFF'

so here's the full roster of options this subroutine defines, one by one, no skipping, periodt:

👑 DEF

this one resets ALL parameters to their default values. she's the "restore to factory settings" button, the hard reset, the breathe, we're starting over moment. DEF has no 'ON' or 'OFF' states, she simply is.

To activate: CALL CONOP1('DEF')

---

🔥 EXT

the parameter that sets extrapolation. normally all CONRAN versions will only plot the boundaries of the convex hull defined by the user's data. but if you want those contours to fill the rectangular area of the frame, flip the EXT switch ON. default is OFF.

To turn on: CALL CONOP1('EXT=ON')

To turn off: CALL CONOP1('EXT=OFF')

---

🌈 GRI

the parameter that displays the grid. GRI is OFF by default.

To turn on: CALL CONOP1('GRI=ON')

To turn off: CALL CONOP1('GRI=OFF')

Note: if GRI=ON, the virtual grid gets superimposed over the contour plot. the X and Y tick intervals will be displayed under the map only if PER=ON. (see PER)

---

✨ ITP

sets the interpolation scheme. there are two schemes — C1 surfaces and linear. the C1 method takes longer but gives the best results when the data is sparse (less than 100 points). the linear method produces a better plot when you've got a dense data set. the default is C1 surface.

For C1 surface: CALL CONOP1('ITP=C1')

For linear: CALL CONOP1('ITP=LIN')

---

🎀 LAB

this parameter can be set to either label the contours (LAB=ON) or not (LAB=OFF). default value is LAB=ON. (Does not apply to entry CONRAQ.)

To turn on: CALL CONOP1('LAB=ON')

To turn off: CALL CONOP1('LAB=OFF')

---

💜 LOT

the parameter that lists options on the printer. default value is OFF: no options are displayed. she's shy by default, i fear.

To turn on: CALL CONOP1('LOT=ON')

To turn off: CALL CONOP1('LOT=OFF')

Note: print is directed to the standard output unit.

---

🫶 MES

the parameter that plots a message. default is ON.

To turn on: CALL CONOP1('MES=ON')

To turn off: CALL CONOP1('MES=OFF')

Note: if MES=ON, a message is printed below the plot giving contour intervals and execution time in seconds. if PER or GRI is ON, the message also contains the X and Y tick intervals.

---

🍓 PDV

the parameter that plots the input data values. default value is PDV=OFF.

To turn on: CALL CONOP1('PDV=ON')

To turn off: CALL CONOP1('PDV=OFF')

Note: if PDV=ON, the input data values are plotted relative to their location on the contour map. if you only wish to see the locations and not the values, set PDV=ON and change FMT to produce an asterisk (*) such as (I1).

---

🧚 PER

the parameter that draws a perimeter. default value is PER=ON, which causes a perimeter to be drawn around the contour plot.

To turn on: CALL CONOP1('PER=ON')

To turn off: CALL CONOP1('PER=OFF')

Note: if MES is ON, the X and Y tick intervals will be given. these are the intervals in user coordinates that each tick mark represents.

---

💀 PMM

the parameter that plots relative minima and maxima. (Does not apply to entry CONRAQ.) this parameter is OFF by default.

To turn off: CALL CONOP1('PMM=OFF')

To turn on: CALL CONOP1('PMM=ON')

---

🦋 PSL

the parameter that sets the plot shield option. the outline of the shield will be drawn on the same frame as the contour plot. (Does not apply to entry CONRAQ.) by default this option is OFF.

Draw the shield: CALL CONOP1('PSL=ON')

Don't draw it: CALL CONOP1('PSL=OFF')

Note: see parameter SLD using man conop3 to see how the polygon is entered which defines the shield.

---

🌟 REP

the parameter indicating the use of the same data in a new execution. default value is OFF.

To turn on: CALL CONOP1('REP=ON')

To turn off: CALL CONOP1('REP=OFF')

Note: if REP=ON, the same X-Y data and triangulation are to be used, but it is assumed that the user has changed the contour values or resolution for this run. scratch arrays WK and IWK must remain unchanged.

---

💅 SCA

the parameter for scaling of the plot on a frame. this parameter is ON by default.

User scaling: CALL CONOP1('SCA=OFF')

Program scaling: CALL CONOP1('SCA=ON')

Prior window: CALL CONOP1('SCA=PRI')

if SCA=OFF, plotting instructions are issued using the user's input coordinates. SCA=OFF should be used to interface with EZMAP. if SCA=ON, a viewport is established such that the plot will fit into the center 90 percent of the frame. if SCA=PRI, the program maps the user's plot instructions into the portion of the frame defined by the current normalization transformation.

---

🌈 TFR

the parameter to advance the frame before triangulation. default value is TFR=ON, which means that the contours and the triangles will be plotted on separate frames.

If program set: CALL CONOP1('TFR=ON')

To turn off: CALL CONOP1('TFR=OFF')

Note: triangles are plotted after the contouring is completed. to see the triangles over the contours, set TFR=OFF.

---

⭐ TOP

the parameter to plot only the triangles.

To turn off: CALL CONOP1('TOP=OFF')

To turn on: CALL CONOP1('TOP=ON')

setting TOP=ON causes parameters TRI and TFR to be set to TRI=ON, and TFR=OFF. setting TOP=OFF results in TRI=OFF and TFR=ON. if another setting is wanted for either TRI or TFR, it should be reset after the TOP call.

Note: the user may wish to overlay the triangles on some other plot. 'TOP=ON' will allow that.

---

🔥 TRI

the parameter to plot the triangulation. default is OFF and therefore the triangles are not drawn.

To turn on: CALL CONOP1('TRI=ON')

To turn off: CALL CONOP1('TRI=OFF')

Note: plotting the triangles will indicate to the user where good and bad points of interpolation are occurring in the contour map. equilateral triangles are optimal for interpolation. quality degrades as triangles approach a long and narrow shape. the convex hull of the triangulation is also a poor point of interpolation.

---

🌸 USAGE 🌸

CONOP1 is called to toggle Conran_family options before entries CONRAN, CONRAQ, or CONRAS are called to generate the contour plot. so like, set your vibe first, then make the plot. iykyk. ✨

---

💖 EXAMPLES 💖

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

---

🎀 ACCESS 🎀

to use CONOP1, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. order matters bestie, don't be chaotic. 💅

---

🫶 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, conop2, 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.

---

and that's the whole page, bestie. she's from the UNIX manual, dated March 1993, filed under CONOP1(3NCARG) — iconic, timeless, and still flipping switches like the main character she is. go forth and contour. 💜🦋✨