Provided by: libncarg-dev_6.6.2-10build2_amd64 
NAME
CONOP1 - sets option switches for the Conran_family utility.
SYNOPSIS
CALL CONOP1 (IOPT)
DESCRIPTION
IOPT Character, input -- Selects an internal parameter and sets an option switch. 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'
The following options are defined by this subroutine:
DEF This option resets ALL parameters to their default values. DEF has no 'ON' or 'OFF' states.
To activate: CALL CONOP1('DEF')
EXT Parameter to set extrapolation. Normally all CONRAN versions will only plot the boundaries
of the convex hull defined by the user's data. To have the contours fill the rectangular
area of the frame, set the EXT switch ON. The default is OFF.
To turn on: CALL CONOP1('EXT=ON')
To turn off: CALL CONOP1('EXT=OFF')
GRI The parameter to display 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 will be superimposed over the contour plot. The X and Y
tick intervals will be displayed under the map only if PER=ON. (see PER)
ITP Set the interpolation scheme. There are two schemes -- C1 surfaces and linear. The C1
method takes longer but will give the best results when the data is sparse (less than 100
points). The linear method will produce a better plot when there is 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). The
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 to list options on the printer. The default value is OFF: no options are
displayed.
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 to plot a message. The 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 to plot the input data values. The 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 to draw a perimeter. The 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 to plot 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 which 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. The 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. The 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. The 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.
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.
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.
UNIX March 1993 CONOP1(3NCARG)