ncarg_conop3(3)

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

NAME

6       CONOP3 - sets option switches and specifys various REAL parameters to
7       be used by the Conran_family utility.
8

SYNOPSIS

10       CALL CONOP3 (IOPT, ARRAY, LENA)
11

DESCRIPTION

13       IOPT        Character, input -- Selects an internal parameter and sets
14                   an option switch.  The possibilities are:
15
16                    'CHL=ON' or 'CHL=OFF'
17                    'CIL=ON' or 'CIL=OFF'
18                    'CON=ON' or 'CON=OFF'
19                    'DBP=ON' or 'DBP=OFF'
20                    'SDC=ON' or 'SDC=OFF'
21                    'SLD=ON' or 'SLD=OFF'
22                    'TEN=ON' or 'TEN=OFF'
23
24       ARRAY       Real array, input -- Sets an internal parameter.
25
26       LENA        Integer, input -- The length of array ARRAY.
27
28                   If an option is turned 'ON', then the remaining CONOP3
29                   arguments can be used to override the default settings of
30                   that option.
31
32                   If the option is 'OFF', then the remaining arguments of the
33                   CONOP3 call can be any dummy values.  Option settings will
34                   be returned to their default values.
35
36                   The following options are defined by this subroutine:
37
38       CHL     This parameter determines how the high and low contour values
39               are set.  These contour values may be set by the program or by
40               the user.  If CHL=OFF, the program examines the user's input
41               data and determines both the high and low values.  If CHL=ON,
42               the user must specify the desired high (HI) and low (FLO)
43               values.  The default is CHL=OFF.
44
45               If program set: CALL CONOP3('CHL=OFF',0.,0)
46
47               If user set: CALL CONOP3('CHL=ON',ARRAY,2) where ARRAY(1)=HI,
48               ARRAY(2)=FLO
49
50               Note: The values supplied for contour increment and contour
51               high and low values assume unscaled data values.  See the SDC
52               parameter, below.
53
54       CIL     This parameter determines how the contour increment (CINC) is
55               set.  The increment is either calculated by the program
56               (CIL=OFF) using the range of high and low values from the
57               user's input data, or set by the user (CIL=ON).  The default is
58               CIL=OFF.
59
60               If program set: CALL CONOP3('CIL=OFF',0.,0)
61
62               If user set:  CALL CONOP3('CIL=ON',CINC,1)
63
64               Note: By default, ('CIL=OFF') the program will examine the
65               user's input data and determine the contour interval (CINC) at
66               some appropriate range between the level of high and low values
67               supplied, usually generating between 15 and 20 contour levels.
68
69               Example:   CALL CONOP3('CIL=ON',10.,1)
70               will generate contours at increments of 10. units in user
71               coordinates.
72
73       CON     This parameter determines how the contour levels are set.  If
74               CON=ON, the user must specify an array of contour values and
75               the number of contour levels.  A maximum of NCL=30 contour
76               levels is permitted.  If CON=OFF, NCL and the contour values
77               are computed.  The default is OFF.
78
79               If program set: CALL CONOP3('CON=OFF',0.,0)
80
81               If user set: CALL CONOP3('CON=ON',ARRAY,NCL)
82
83               Note: The real array (ARRAY) must have the contour levels
84               ordered from smallest to largest.
85
86               Warning: It is illegal to use the CON option when either CIL or
87               CHL are activated.  If this is done, the option call that
88               detected the error will not be executed.
89
90       DBP     This parameter determines how the dash pattern break point (BP)
91               is set.  (Does not apply to entry CONRAQ.)  If DBP=ON, BP must
92               be set by the user.  If DBP=OFF, the program will set BP to 0.
93               This is the default.
94
95               If program set: CALL CONOP3('DBP=OFF',0.,0)
96
97               If user set:  CALL CONOP3('DBP=ON',BP,1)
98
99               Note: BP is a floating point number where the break for GTR and
100               LSS contour dash patterns are defined.  BP is assumed to be
101               given relative to the untransformed contours.
102
103               To see how various dash line patterns can be assigned to
104               various contours see parameter DBP in "man conop4".
105
106       SDC     The parameter to determine how to scale the input data from
107               which the contours are generated.  (Does not apply to entry
108               CONRAQ.)  If SDC=ON, the scaling factor is set to ARRAY(1).  If
109               SDC=OFF, the default scale factor of 1. is used.
110
111               If program set: CALL CONOP3('SDC=OFF',0.,0)
112
113               If user set:  CALL CONOP3('SDC=ON',ARRAY,1)
114
115               Note: The data plotted on contour lines and the data plotted
116               for relative minimums and maximums will be scaled by ARRAY.
117
118       SLD     Input a polygon to define the extent of area to be contoured.
119               (Does not apply to entry CONRAQ.)  When this option is
120               activated, only those contours within the shield are drawn.
121               The shield is a polygon specified by the user which must be
122               given in the same coordinate range as the the data.  It must
123               define only one polygon.
124
125               To input a shield:
126                 CALL CONOP3('SLD=ON',ARRAY,LENA)
127
128               Otherwise:
129                 CALL CONOP3('SLD=OFF',0.,0)
130
131               Note: ARRAY is a real array LENA elements long.  The first
132               LENA/2 elements are X coordinates and the second LENA/2
133               elements are Y coordinates.  This polygon must be closed, that
134               is the first and last points in ARRAY must be the same.
135
136               Example:
137
138                DIMENSION SHLD(10)
139                DATA SHLD/ 7.,10.,10.,7.,7.,
140               1            7.,7.,10.,10.,7./
141                CALL CONOP3 ('SLD=ON',SHLD,10)
142
143       TEN     The parameter to determine the tension factor applied when
144               smoothing contour lines using splines under tension.  (Does not
145               apply to entry CONRAQ.)  If user set, the allowed range is from
146               greater than zero to 30.  The higher the tension the less
147               smoothing occurs.  The default value (TEN=OFF) is 2.5.
148
149               If program set: CALL CONOP3('TEN=OFF',0.,0)
150
151               If user set:  CALL CONOP3('TEN=ON',TENS,1)
152
153               Note: This option is not available in the standard version of
154               CONRAN.
155

USAGE

157       CONOP3 is called to set parameters of type REAL before CONRAN, CONRAQ,
158       or CONRAS are called to generate the contour plot.
159

EXAMPLES

161       Use the command ncargex to see the following examples: tconaq, tconan,
162       and tconas.
163

ACCESS

165       To use CONOP3 load the NCAR Graphics libraries ncarg, ncarg_gks, and
166       ncarg_c, preferably in that order.
167

MESSAGES

169       See the conran_family man page for a description of all Conran_family
170       error messages and/or informational messages.
171

COPYRIGHT

180       Copyright (C) 1987-2007
181       University Corporation for Atmospheric Research
182
183       This documentation is free software; you can redistribute it and/or
184       modify it under the terms of the GNU General Public License as
185       published by the Free Software Foundation; either version 2 of the
186       License, or (at your option) any later version.
187
188       This software is distributed in the hope that it will be useful, but
189       WITHOUT ANY WARRANTY; without even the implied warranty of
190       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
191       General Public License for more details.
192
193       You should have received a copy of the GNU General Public License along
194       with this software; if not, write to the Free Software Foundation,
195       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
196
197
198
199UNIX                              March 1993                    CONOP3(3NCARG)