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

NAME

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

SYNOPSIS

10       CALL CONOP2 (IOPT, IVAL)
11

DESCRIPTION

13       IOPT        Character, input -- Selects an internal parameter and sets
14                   an option switch.  The possibilities are:
15
16                    'INT=OFF', 'INT=ALL', 'INT=MAJ', 'INT=MIN', 'INT=LAB', 'INT=DAT'
17                    'LSZ=ON' or 'LSZ=OFF'
18                    'NCP=ON' or 'NCP=OFF'
19                    'SML=ON' or 'SML=OFF'
20                    'SPD=ON' or 'SPD=OFF'
21                    'SSZ=ON' or 'SSZ=OFF'
22                    'STL=ON' or 'STL=OFF'
23
24       IVAL        Integer, input -- Sets an internal parameter.
25
26                   If IOPT is not 'OFF', then the IVAL argument is used to
27                   override the default setting of that option.
28
29                   If IOPT is 'OFF', the IVAL argument can have any dummy
30                   value.  Option settings will be returned to their default
31                   values.
32
33                   The following options are defined by this subroutine:
34
35       INT     The parameter to determine the intensities of the contour lines
36               and other parts of the plot.  If INT=OFF, all intensities are
37               set to the default values.  If INT=ALL, all intensities are set
38               to IVAL.  If INT is set to one of the other possible options
39               (MAJ, MIN, LAB or DAT), the intensity level for that option is
40               set to IVAL.
41
42               If program set: CALL CONOP2('INT=OFF',0)
43
44               All the same:  CALL CONOP2('INT=ALL',IVAL)
45
46               Major lines:  CALL CONOP2('INT=MAJ',IVAL)
47
48               Minor lines:  CALL CONOP2('INT=MIN',IVAL)
49
50               Title and message:  CALL CONOP2('INT=LAB',IVAL)
51
52               Data values:  CALL CONOP2('INT=DAT',IVAL)
53
54               Note: 'INT=DAT' relates to the plotted data values and the
55               plotted maximums and minimums.
56
57               Note: IVAL is the intensity desired.  IVAL values range from 0
58               to 255.
59
60               Example:   CALL CONOP2('INT=ALL',110)
61
62       LSZ     This parameter determines the label size.  (Does not apply to
63               entry CONRAQ.)  The value of LSZ is the desired length in NDCs
64               multiplied by 1023.  If LSZ=ON, the label size is set to IVAL.
65               If LSZ=OFF, the default label size is 9./1023.  NDCs.
66
67               Example: CALL CONOP2('LSZ=ON',12)
68
69       NCP     The parameter to indicate the number of data points used for
70               the partial derivative estimation.  If NCP=OFF, IVAL is set to
71               4, which is the default value.  If NCP=ON, the user must
72               specify IVAL greater than or equal to 2.
73
74               Example:  CALL CONOP2('NCP=ON',2)
75
76               Note: IVAL = number of data points used for estimation.
77               Changing this value affects the contours produced and the size
78               of input array IWK.
79
80       SML     The parameter to determine the size of minimum and maximum
81               contour labels in integer scaled NDC units.  (Does not apply to
82               entry CONRAQ.)  The value of SML is the desired length in NDCs
83               multiplied by 1023.  If SML=OFF, the default label size is
84               15./1023. NDCs.  If SML=ON, the user must specify IVAL.
85
86               Example: CALL CONOP2('SML=ON',12)
87
88       SPD     The parameter for the size of the plotted input data values in
89               integer scaled NDC units.  If SPD=OFF, the default label size
90               is 8./1023. NDCs.  If SPD=ON, the user must specify IVAL.
91
92               Example: CALL CONOP2('SPD=ON',12)
93
94       SSZ     The parameter to determine the resolution (number of steps in
95               each direction).  If SSZ=ON, the user sets IVAL, or, if
96               SSZ=OFF, the program will automatically set IVAL to the default
97               value of 40.
98
99               Warning:  The scratch array (7th argument in the CONRAN call)
100               must be dimensioned IVAL**2 or larger.
101
102               Example:
103
104                     DIMENSION SCR(10000)
105                     CALL CONOP2('SSZ=ON',100)
106                     CALL CONRAN(XD,YD,ZD,NDP,WK,IWK,SCR)
107
108               Note: IVAL is an integer specifying the density of the virtual
109               grid.  In most cases, the default value of 40 produces pleasing
110               contours.  For coarser but quicker contours, lower the value.
111               For smoother contours at the expense of taking a longer time,
112               raise the value.
113
114               Warning:  For step sizes greater than 200 in CONRAN, the arrays
115               PV in common block CONRA1 and ITLOC in common block CONRA9,
116               must be expanded to about 10 more than IVAL.
117
118       STL     The parameter to determine the character size of the main title
119               in integer scaled NDC units.  If STL=OFF, the default label
120               size is 16./1023. NDCs.  If STL=ON, the user must specify IVAL.
121
122               Example: CALL CONOP2('STL=ON',14)
123
124               Note: When 30 or 40 characters are used for the title, the
125               default size of 16 integer scaled NDC units works well.  For
126               longer titles, a smaller title size is required.
127

USAGE

129       CONOP2 is called to set parameters of type INTEGER before CONRAN,
130       CONRAQ, or CONRAS are called to generate the contour plot.
131

EXAMPLES

133       Use the command ncargex to see the following examples: tconaq, tconan,
134       and tconas.
135

ACCESS

137       To use CONOP2 load the NCAR Graphics libraries ncarg, ncarg_gks, and
138       ncarg_c, preferably in that order.
139

MESSAGES

141       See the conran_family man page for a description of all Conran_family
142       error messages and/or informational messages.
143

SEE ALSO

145       Online: conran_family, conran_family_params, conran, conraq, conras,
146       conop1, conop3, conop4, conpack, conpack_params
147
148       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial; NCAR Graphics
149       Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics
150

COPYRIGHT

152       Copyright (C) 1987-2009
153       University Corporation for Atmospheric Research
154       The use of this Software is governed by a License Agreement.
155
156
157
158UNIX                              March 1993                    CONOP2(3NCARG)