1CONOP1(3NCARG) NCAR GRAPHICS CONOP1(3NCARG)
2
6 CONOP1 - sets option switches for the Conran_family utility.
7
9 CALL CONOP1 (IOPT)
10
12 IOPT Character, input -- Selects an internal parameter and sets
13 an option switch. The possibilities are:
14 '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 The following options are defined by this subroutine:
33 DEF This option resets ALL parameters to their default values.
35 DEF has no 'ON' or 'OFF' states.
36 To activate: CALL CONOP1('DEF')
38 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 To turn on: CALL CONOP1('EXT=ON')
46 To turn off: CALL CONOP1('EXT=OFF')
48 GRI The parameter to display the grid. GRI is OFF by default.
50 To turn on: CALL CONOP1('GRI=ON')
52 To turn off: CALL CONOP1('GRI=OFF')
54 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 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 For C1 surface CALL CONOP1('ITP=C1')
67 For linear CALL CONOP1('ITP=LIN')
69 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 To turn on: CALL CONOP1('LAB=ON')
75 To turn off: CALL CONOP1('LAB=OFF')
77 LOT The parameter to list options on the printer. The default
79 value is OFF: no options are displayed.
80 To turn on: CALL CONOP1('LOT=ON')
82 To turn off: CALL CONOP1('LOT=OFF')
84 Note: Print is directed to the standard output unit.
86 MES The parameter to plot a message. The default is ON.
88 To turn on: CALL CONOP1('MES=ON')
90 To turn off: CALL CONOP1('MES=OFF')
92 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 PDV The parameter to plot the input data values. The default
99 value is PDV=OFF.
100 To turn on: CALL CONOP1('PDV=ON')
102 To turn off: CALL CONOP1('PDV=OFF')
104 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 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 To turn on: CALL CONOP1('PER=ON')
115 To turn off: CALL CONOP1('PER=OFF')
117 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 PMM The parameter to plot relative minima and maxima. (Does
123 not apply to entry CONRAQ.) This parameter is OFF by
124 default.
125 To turn off: CALL CONOP1('PMM=OFF')
127 To turn on: CALL CONOP1('PMM=ON')
129 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 Draw the shield: CALL CONOP1('PSL=ON')
136 Don't draw it: CALL CONOP1('PSL=OFF')
138 Note: See parameter SLD using "man conop3" to see how the
140 polygon is entered which defines the shield.
141 REP The parameter indicating the use of the same data in a new
143 execution. The default value is OFF.
144 To turn on: CALL CONOP1('REP=ON')
146 To turn off: CALL CONOP1('REP=OFF')
148 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 SCA The parameter for scaling of the plot on a frame. This
155 parameter is ON by default.
156 User scaling: CALL CONOP1('SCA=OFF')
158 Program scaling: CALL CONOP1('SCA=ON')
160 Prior window: CALL CONOP1('SCA=PRI')
162 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 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 If program set: CALL CONOP1('TFR=ON')
176 To turn off: CALL CONOP1('TFR=OFF')
178 Note: Triangles are plotted after the contouring is
180 completed. To see the triangles over the contours, set
181 TFR=OFF.
182 TOP The parameter to plot only the triangles.
184 To turn off: CALL CONOP1('TOP=OFF')
186 To turn on: CALL CONOP1('TOP=ON')
188 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 Note: The user may wish to overlay the triangles on some
195 other plot. 'TOP=ON' will allow that.
196 TRI The parameter to plot the triangulation. The default is
198 OFF and therefore the triangles are not drawn.
199 To turn on: CALL CONOP1('TRI=ON')
201 To turn off: CALL CONOP1('TRI=OFF')
203 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
212 CONOP1 is called to toggle Conran_family options before entries CONRAN,
213 CONRAQ, or CONRAS are called to generate the contour plot.
214
216 Use the command ncargex to see the following examples: tconaq, tconan,
217 and tconas.
218
220 To use CONOP1 load the NCAR Graphics libraries ncarg, ncarg_gks, and
221 ncarg_c, preferably in that order.
222
224 See the conran_family man page for a description of all Conran_family
225 error messages and/or informational messages.
226
228 Online: conran_family, conran_family_params, conran, conraq, conras,
229 conop2, conop3, conop4, conpack, conpack_params
230 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-2007
236 University Corporation for Atmospheric Research
237 This documentation is free software; you can redistribute it and/or
239 modify it under the terms of the GNU General Public License as
240 published by the Free Software Foundation; either version 2 of the
241 License, or (at your option) any later version.
242 This software is distributed in the hope that it will be useful, but
244 WITHOUT ANY WARRANTY; without even the implied warranty of
245 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
246 General Public License for more details.
247 You should have received a copy of the GNU General Public License along
249 with this software; if not, write to the Free Software Foundation,
250 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
251UNIX March 1993 CONOP1(3NCARG)