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

NAME

6       Conran_family - is a set of two dimensional contour mapping routines
7       for irregularly distributed data.
8
9       There are three Conran_family entries, CONRAN, CONRAQ, and CONRAS.
10       CONRAN can be invoked in two ways.  One generates smoothed contours,
11       the other does not.  CONRAQ is a quick version of the package which has
12       a more limited set of options than the other entries.  CONRAS is the
13       super version of the package.
14

STATUS

16       The Conran_family is approaching obsolescence.  If you have available
17       an interpolation package which can do a random to gridded interpolation
18       equal to that built into the Conran_family, then we recommend that you
19       grid your dataset and use the Conpack utility instead.  Refer to the
20       conpack and conpack_params man pages as well as the NCAR Graphics
21       Contouring and Mapping Tutorial.
22

SYNOPSIS

24       CONRAN - Provides the standard and smooth versions for contouring of
25       irregularly gridded data.
26
27       CONRAQ - Provides the quick form of the package.  It does not have as
28       many available options as the other entries.
29
30       CONRAS - This is the super version of the package.  Not only does it
31       smooth and label contour lines, it can also reduce line crowding.
32
33       CONOP1 - Sets values of internal parameters of type logical.
34       Specifically, CONOP1 is used to turn options "OFF", or "ON".
35
36       CONOP2 - Sets values of internal parameters of type integer.
37
38       CONOP3 - Sets values of internal parameters of type real.
39
40       CONOP4 - Sets values of internal parameters of type character.
41

ACCESS

43       There are three entries in the Conran_family which create contour
44       plots: CONRAQ (quick), CONRAS (super), and CONRAN (standard and
45       smooth.)
46
47       To use standard CONRAN, load the NCAR Graphics libraries ncarg,
48       ncarg_gks, and ncarg_c, preferably in that order.  To run any of the
49       other three options (quick, super, or smooth), one or more additional
50       libraries is needed as follows:
51
52       quick -- additionally load the conraq library.
53
54       smooth -- additionally load the dashsmth library.
55
56       super -- additionally load the conras and dashsupr libraries.
57
58       These libraries can also be implicitly loaded by using the -quick,
59       -smooth, or -super option of the ncargf77 command.  For example, to run
60       a code called mycode.f which has one or more calls to a Conran_family
61       entry, issue one of the commands:
62
63       QUICK     Command: "ncargf77 -quick mycode.f"
64
65                 mycode.f has one or more calls to entry CONRAQ.
66
67       NORMAL    Command: "ncargf77 mycode.f"
68
69                 mycode.f has one or more calls to entry CONRAN.
70
71       SMOOTH    Command: "ncargf77 -smooth mycode.f"
72
73                 mycode.f has one or more calls to entry CONRAN.
74
75       SUPER     Command: "ncargf77 -super mycode.f"
76
77                 mycode.f has one or more calls to entry CONRAS.
78
79                 Warning:  mycode.f can only call one of the three entries,
80                 CONRAQ, CONRAN, or CONRAS.
81

MESSAGES

83       Error messages generated by CONRAN routines include:
84
85
86       CONCLS    CONSTANT INPUT FIELD
87                 The input data all has a constant value.  This may indicate
88                 that the data has not been input correctly in the user
89                 program.
90
91       CONDRW    CONTOUR STORAGE EXHAUSTED
92                 This error is trapped and nullified by CONRAN.  It serves to
93                 signal the user that a contour level may not be complete.
94
95       CONOP     UNDEFINED OPTION
96                 The parameter name has either been misspelled in a CONOP
97                 call, or an out of range parameter value has been specified.
98                 This message can be generated by CONOP1, CONOP2, CONOP3, or
99                 CONOP4.
100
101       CONOP3    ILLEGAL USE OF CON OPTION WITH CIL OR CHL OPTIONS
102                 Review the definitions of these three parameters using man
103                 page conran_family_params.
104
105       CONOP3    NUMBER OF CONTOUR LEVELS EXCEEDS 30
106                 Reduce the requested number of contour levels specified by
107                 parameter CON to 30 or less.
108
109       CONRAN    INPUT PARAMETER NDP LT NCP
110                 NDP is the total number of input values for contouring.  NCP
111                 is the number of points used for partial derivative
112                 estimation.  NCP cannot exceed NDP.  This error message also
113                 occurs in CONRAS and CONRAQ.
114
115       CONRAN    NCP LT 2 OR GT NCPSZ
116                 The legal value of NCP must be between NCPSZ (dimension size
117                 allowed) and 2.  This error message also occurs in CONRAS and
118                 CONRAQ.
119
120       CONSTP    ASPECT RATIO OF X AND Y GREATER THAN 5 TO 1.
121                 (This error may cause a poor quality plot.  Usually this can
122                 be fixed by multiplying X or Y by a constant factor.  If this
123                 solution is unacceptable then increasing internal parameter
124                 SSZ to a very large value may help.  Note:  This can be
125                 expensive.)
126
127       CONTNG    ALL COLINEAR DATA POINTS
128                 Indicates that the input data set to be contoured all lies
129                 along a straight line.  Thus, triangulation cannot occur.
130
131       CONTNG    IDENTICAL INPUT DATA POINTS FOUND
132
133                 The errors listed above are defined as recoverable errors
134                 should the user wish to use them in that fashion.  The
135                 documentation on the ERPRT77 package explains how to recover
136                 from an error.
137

SEE ALSO

139       Online: conran, conraq, conras, conran_family_params, conop1, conop2,
140       conop3, conop4, conpack, conpack_params, cpcnrc, bivar,
141       dashline_family, ncargf77
142
143       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial; NCAR Graphics
144       Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics
145
147       Copyright (C) 1987-2009
148       University Corporation for Atmospheric Research
149       The use of this Software is governed by a License Agreement.
150
151
152
153UNIX                              March 1993             Conran_family(3NCARG)
Impressum