1CONOP1(3NCARG)                   NCAR GRAPHICS                  CONOP1(3NCARG)
2
3
4

NAME

6       CONOP1 - sets option switches for the Conran_family utility.
7

SYNOPSIS

9       CALL CONOP1 (IOPT)
10

DESCRIPTION

12       IOPT        Character, input -- Selects an internal parameter and sets
13                   an option switch.  The possibilities are:
14
15                    'DEF'
16                    'EXT=ON' or 'EXT=OFF'
17                    'GRI=ON' or 'GRI=OFF'
18                    'ITP=C1' or 'ITP=LIN'
19                    'LAB=ON' or 'LAB=OFF'
20                    'LOT=ON' or 'LOT=OFF'
21                    'MES=ON' or 'MES=OFF'
22                    'PDV=ON' or 'PDV=OFF'
23                    'PER=ON' or 'PER=OFF'
24                    'PMM=ON' or 'PMM=OFF'
25                    'PSL=ON' or 'PSL=OFF'
26                    'REP=ON' or 'REP=OFF'
27                    'SCA=ON' or 'SCA=OFF' or 'SCA=PRI'
28                    'TFR=ON' or 'TFR=OFF'
29                    'TOP=ON' or 'TOP=OFF'
30                    'TRI=ON' or 'TRI=OFF'
31
32                   The following options are defined by this subroutine:
33
34       DEF         This option resets ALL parameters to their default values.
35                   DEF has no 'ON' or 'OFF' states.
36
37                   To activate: CALL CONOP1('DEF')
38
39       EXT         Parameter to set extrapolation.  Normally all CONRAN
40                   versions will only plot the boundaries of the convex hull
41                   defined by the user's data.  To have the contours fill the
42                   rectangular area of the frame, set the EXT switch ON.  The
43                   default is OFF.
44
45                   To turn on: CALL CONOP1('EXT=ON')
46
47                   To turn off: CALL CONOP1('EXT=OFF')
48
49       GRI         The parameter to display the grid.  GRI is OFF by default.
50
51                   To turn on: CALL CONOP1('GRI=ON')
52
53                   To turn off: CALL CONOP1('GRI=OFF')
54
55                   Note: If GRI=ON, the virtual grid will be superimposed over
56                   the contour plot.  The X and Y tick intervals will be
57                   displayed under the map only if PER=ON.  (see PER)
58
59       ITP         Set the interpolation scheme.  There are two schemes  --
60                   C1 surfaces and linear.  The C1 method takes longer but
61                   will give the best results when the data is sparse (less
62                   than 100 points).  The linear method will produce a better
63                   plot when there is a dense data set.  The default is C1
64                   surface.
65
66                   For C1 surface CALL CONOP1('ITP=C1')
67
68                   For linear  CALL CONOP1('ITP=LIN')
69
70       LAB         This parameter can be set to either label the contours
71                   (LAB=ON) or not (LAB=OFF).  The default value is LAB=ON.
72                   (Does not apply to entry CONRAQ.)
73
74                   To turn on: CALL CONOP1('LAB=ON')
75
76                   To turn off: CALL CONOP1('LAB=OFF')
77
78       LOT         The parameter to list options on the printer.  The default
79                   value is OFF: no options are displayed.
80
81                   To turn on: CALL CONOP1('LOT=ON')
82
83                   To turn off: CALL CONOP1('LOT=OFF')
84
85                   Note: Print is directed to the standard output unit.
86
87       MES         The parameter to plot a message.  The default is ON.
88
89                   To turn on: CALL CONOP1('MES=ON')
90
91                   To turn off: CALL CONOP1('MES=OFF')
92
93                   Note: If MES=ON, a message is printed below the plot giving
94                   contour intervals and execution time in seconds.  If PER or
95                   GRI is ON, the message also contains the X and Y tick
96                   intervals.
97
98       PDV         The parameter to plot the input data values.  The default
99                   value is PDV=OFF.
100
101                   To turn on: CALL CONOP1('PDV=ON')
102
103                   To turn off: CALL CONOP1('PDV=OFF')
104
105                   Note: If PDV=ON, the input data values are plotted relative
106                   to their location on the contour map.  If you only wish to
107                   see the locations and not the values, set PDV=ON and change
108                   FMT to produce an asterisk (*) such as (I1).
109
110       PER         The parameter to draw a perimeter.  The default value is
111                   PER=ON, which causes a perimeter to be drawn around the
112                   contour plot.
113
114                   To turn on: CALL CONOP1('PER=ON')
115
116                   To turn off: CALL CONOP1('PER=OFF')
117
118                   Note: If MES is ON, the X and Y tick intervals will be
119                   given.  These are the intervals in user coordinates that
120                   each tick mark represents.
121
122       PMM         The parameter to plot relative minima and maxima.  (Does
123                   not apply to entry CONRAQ.)  This parameter is OFF by
124                   default.
125
126                   To turn off:  CALL CONOP1('PMM=OFF')
127
128                   To turn on:  CALL CONOP1('PMM=ON')
129
130       PSL         The parameter which sets the plot shield option.  The
131                   outline of the shield will be drawn on the same frame as
132                   the contour plot.  (Does not apply to entry CONRAQ.)  By
133                   default this option is OFF.
134
135                   Draw the shield: CALL CONOP1('PSL=ON')
136
137                   Don't draw it: CALL CONOP1('PSL=OFF')
138
139                   Note:  See parameter SLD using "man conop3" to see how the
140                   polygon is entered which defines the shield.
141
142       REP         The parameter indicating the use of the same data in a new
143                   execution.  The default value is OFF.
144
145                   To turn on: CALL CONOP1('REP=ON')
146
147                   To turn off: CALL CONOP1('REP=OFF')
148
149                   Note: If REP=ON, the same X-Y data and triangulation are to
150                   be used, but it is assumed that the user has changed the
151                   contour values or resolution for this run.  Scratch arrays
152                   WK and IWK must remain unchanged.
153
154       SCA         The parameter for scaling of the plot on a frame.  This
155                   parameter is ON by default.
156
157                   User scaling:  CALL CONOP1('SCA=OFF')
158
159                   Program scaling: CALL CONOP1('SCA=ON')
160
161                   Prior window:  CALL CONOP1('SCA=PRI')
162
163                   If SCA=OFF, plotting instructions are issued using the
164                   user's input coordinates.  SCA=OFF should be used to
165                   interface with EZMAP.  If SCA=ON, a viewport is established
166                   such that the plot will fit into the center 90 percent of
167                   the frame.  If SCA=PRI, the program maps the user's plot
168                   instructions into the portion of the frame defined by the
169                   current normalization transformation.
170
171       TFR         The parameter to advance the frame before triangulation.
172                   The default value is TFR=ON, which means that the contours
173                   and the triangles will be plotted on separate frames.
174
175                   If program set: CALL CONOP1('TFR=ON')
176
177                   To turn off:  CALL CONOP1('TFR=OFF')
178
179                   Note: Triangles are plotted after the contouring is
180                   completed.  To see the triangles over the contours, set
181                   TFR=OFF.
182
183       TOP         The parameter to plot only the triangles.
184
185                   To turn off: CALL CONOP1('TOP=OFF')
186
187                   To turn on: CALL CONOP1('TOP=ON')
188
189                   Setting TOP=ON causes parameters TRI and TFR to be set to
190                   TRI=ON, and TFR=OFF.  Setting TOP=OFF results in TRI=OFF
191                   and TFR=ON.  If another setting is wanted for either TRI or
192                   TFR, it should be reset after the TOP call.
193
194                   Note: The user may wish to overlay the triangles on some
195                   other plot.  'TOP=ON' will allow that.
196
197       TRI         The parameter to plot the triangulation.  The default is
198                   OFF and therefore the triangles are not drawn.
199
200                   To turn on: CALL CONOP1('TRI=ON')
201
202                   To turn off: CALL CONOP1('TRI=OFF')
203
204                   Note: Plotting the triangles will indicate to the user
205                   where good and bad points of interpolation are occurring in
206                   the contour map.  Equilateral triangles are optimal for
207                   interpolation.  Quality degrades as triangles approach a
208                   long and narrow shape.  The convex hull of the
209                   triangulation is also a poor point of interpolation.
210

USAGE

212       CONOP1 is called to toggle Conran_family options before entries CONRAN,
213       CONRAQ, or CONRAS are called to generate the contour plot.
214

EXAMPLES

216       Use the command ncargex to see the following examples: tconaq, tconan,
217       and tconas.
218

ACCESS

220       To use CONOP1 load the NCAR Graphics libraries ncarg, ncarg_gks, and
221       ncarg_c, preferably in that order.
222

MESSAGES

224       See the conran_family man page for a description of all Conran_family
225       error messages and/or informational messages.
226

SEE ALSO

228       Online: conran_family, conran_family_params, conran, conraq, conras,
229       conop2, conop3, conop4, conpack, conpack_params
230
231       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial; NCAR Graphics
232       Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics
233
235       Copyright (C) 1987-2009
236       University Corporation for Atmospheric Research
237       The use of this Software is governed by a License Agreement.
238
239
240
241UNIX                              March 1993                    CONOP1(3NCARG)
Impressum