ncarg_conop4(3)

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

NAME

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

SYNOPSIS

10       CONOP4 (IOPT,CHARS,NUMC,IFMT)
11

DESCRIPTION

13       IOPT        Character, input -- Selects an internal parameter and sets
14                   an option switch.  The possibilities are:
15
16                     'DAS=ON', 'DAS=OFF', 'DAS=GTR', 'DAS=EQU', 'DAS=LSS', and
17                   'DAS=ALL'
18                     'FMT=ON' or 'FMT=OFF'
19                     'TLE=ON' or 'TLE=OFF'
20
21                   If the value of an IOPT option is 'OFF', then the next
22                   three arguments of the CONOP4 call, CHARS, NUMC, and IFMT
23                   can be given any dummy value.  Option settings will be
24                   returned to their default values.
25
26                   If an option is other than 'OFF', then the CHARS, NUMC, and
27                   IFMT arguments can be used to override the default settings
28                   of that option.
29
30       CHARS       Character, input -- A string of up to 64 characters.
31
32       NUMC        Integer, input -- The number of characters in string CHARS.
33
34       IFMT        Integer, input -- The maximum number of digits which can be
35                   printed by the output format loaded into CHARS when
36                   IOPT='FMT=ON'.  IFMT is not used with any other value of
37                   IOPT.
38
39                   The following options are defined by this subroutine:
40
41       DAS     This parameter determines which contours are represented by
42               dashed lines.  The dashed line pattern is set in argument
43               CHARS.  Arguments NUMC and IFMT are not used.  They can assume
44               any dummy value.
45
46               If IOPT='DAS=OFF', only solid lines are used.  This is the
47               default.
48
49               All solid lines: CALL CONOP4('DAS=OFF',' ',0,0)
50
51               To assign a specified line pattern to all contours:
52
53               CALL CONOP4('DAS=ALL',CHARS,0,0)
54
55               To assign a specified line pattern to selected contours:
56
57               Contour > DBP:  CALL CONOP4('DAS=GTR',CHARS,0,0)
58
59               Contour = DBP:  CALL CONOP4('DAS=EQU',CHARS,0,0)
60
61               Contour < DBP:  CALL CONOP4('DAS=LSS',CHARS,0,0)
62
63               The breakpoint for changing the line pattern, parameter DBP, is
64               set by a call to entry CONOP3.  DBP = 0. is the default.  See
65               parameter DBP in "man conop3".
66
67               If DAS has a value other than OFF, CHARS is a dashed line
68               pattern described by a ten character string with a dollar sign
69               ($) for solid and a single quote (') for blank.  Recall that in
70               FORTRAN 77, in a quoted string a single quote is represented by
71               two single quotes ('').
72
73               Example:  CALL CONOP4('DAS=GTR','$$$$$''$$$$',0,0)
74
75       FMT     A parameter which specifies a format for output of the data
76               values.
77
78               If FMT=ON, the user must specify values for CHARS, NUMC, and
79               IFMT.  CHARS is an output print format.  It has beginning and
80               ending parenthesis as in (F8.2).  NUMC is the number of
81               characters in CHARS.  It is 6 for (F8.2).  IFMT is the maximum
82               number of digits which can be printed by this format.  It is 8
83               for an F8.2.
84
85               Example:
86               CHARS = '(F8.2)'
87               NUMC  = 6
88               IFMT = 8
89               CALL CONOP4('FMT=ON',CHARS,NUMC,IFMT)
90
91               Warning:  IFMT cannot be greater than 10; however, CONRAN will
92               not test for a valid format.  Thus, a format which results in
93               IFMT > 10 will cause an undetected error.
94
95               If FMT=OFF, the default values are: CHARS='(G10.3)', NUMC=7,
96               and IFMT=10, respectively.
97
98               To return to default settings use:
99               CALL CONOP4('FMT=OFF',' ',0,0)
100
101       TLE     The parameter to place a title at the top of the plot.  CHARS
102               contains the title, NUMC is the number of characters in the
103               title and IFMT is not used.
104
105               Example: CALL CONOP4('TLE=ON','VECTOR REVIEW',13,0)
106

USAGE

108       CONOP4 is called to set parameters of type CHARACTER before entries
109       CONRAN, CONRAS, or CONRAQ are called to generate the contour plots.
110

EXAMPLES

112       Use the ncargex command to see pertinent examples tconaq, tconas and
113       tconan.
114

ACCESS

116       To use CONOP4 load the NCAR Graphics libraries ncarg, ncarg_gks, and
117       ncarg_c, preferably in that order.
118

MESSAGES

120       See the conran_family man page for a description of all Conran_family
121       error messages and/or informational messages.
122

COPYRIGHT

130       Copyright (C) 1987-2007
131       University Corporation for Atmospheric Research
132
133       This documentation is free software; you can redistribute it and/or
134       modify it under the terms of the GNU General Public License as
135       published by the Free Software Foundation; either version 2 of the
136       License, or (at your option) any later version.
137
138       This software is distributed in the hope that it will be useful, but
139       WITHOUT ANY WARRANTY; without even the implied warranty of
140       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
141       General Public License for more details.
142
143       You should have received a copy of the GNU General Public License along
144       with this software; if not, write to the Free Software Foundation,
145       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
146
147
148
149UNIX                              March 1993                    CONOP4(3NCARG)