1CONOP2(3NCARG) NCAR GRAPHICS CONOP2(3NCARG)
2
6 CONOP2 - sets option switches and specifys various INTEGER parameters
7 to be used by the Conran_family utility.
8
10 CALL CONOP2 (IOPT, IVAL)
11
13 IOPT Character, input -- Selects an internal parameter and sets
14 an option switch. The possibilities are:
15 '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 IVAL Integer, input -- Sets an internal parameter.
25 If IOPT is not 'OFF', then the IVAL argument is used to
27 override the default setting of that option.
28 If IOPT is 'OFF', the IVAL argument can have any dummy
30 value. Option settings will be returned to their default
31 values.
32 The following options are defined by this subroutine:
34 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 If program set: CALL CONOP2('INT=OFF',0)
43 All the same: CALL CONOP2('INT=ALL',IVAL)
45 Major lines: CALL CONOP2('INT=MAJ',IVAL)
47 Minor lines: CALL CONOP2('INT=MIN',IVAL)
49 Title and message: CALL CONOP2('INT=LAB',IVAL)
51 Data values: CALL CONOP2('INT=DAT',IVAL)
53 Note: 'INT=DAT' relates to the plotted data values and the
55 plotted maximums and minimums.
56 Note: IVAL is the intensity desired. IVAL values range from 0
58 to 255.
59 Example: CALL CONOP2('INT=ALL',110)
61 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 Example: CALL CONOP2('LSZ=ON',12)
68 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 Example: CALL CONOP2('NCP=ON',2)
75 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 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 Example: CALL CONOP2('SML=ON',12)
87 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 Example: CALL CONOP2('SPD=ON',12)
93 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 Warning: The scratch array (7th argument in the CONRAN call)
100 must be dimensioned IVAL**2 or larger.
101 Example:
103 DIMENSION SCR(10000)
105 CALL CONOP2('SSZ=ON',100)
106 CALL CONRAN(XD,YD,ZD,NDP,WK,IWK,SCR)
107 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 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 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 Example: CALL CONOP2('STL=ON',14)
123 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
129 CONOP2 is called to set parameters of type INTEGER before CONRAN,
130 CONRAQ, or CONRAS are called to generate the contour plot.
131
133 Use the command ncargex to see the following examples: tconaq, tconan,
134 and tconas.
135
137 To use CONOP2 load the NCAR Graphics libraries ncarg, ncarg_gks, and
138 ncarg_c, preferably in that order.
139
141 See the conran_family man page for a description of all Conran_family
142 error messages and/or informational messages.
143
145 Online: conran_family, conran_family_params, conran, conraq, conras,
146 conop1, conop3, conop4, conpack, conpack_params
147 Hardcopy: NCAR Graphics Contouring and Mapping Tutorial; NCAR Graphics
149 Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics
150
152 Copyright (C) 1987-2007
153 University Corporation for Atmospheric Research
154 This documentation is free software; you can redistribute it and/or
156 modify it under the terms of the GNU General Public License as
157 published by the Free Software Foundation; either version 2 of the
158 License, or (at your option) any later version.
159 This software is distributed in the hope that it will be useful, but
161 WITHOUT ANY WARRANTY; without even the implied warranty of
162 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
163 General Public License for more details.
164 You should have received a copy of the GNU General Public License along
166 with this software; if not, write to the Free Software Foundation,
167 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
168UNIX March 1993 CONOP2(3NCARG)