1Conran_family(3NCARG) NCAR GRAPHICS Conran_family(3NCARG)
2
6 Conran_family - is a set of two dimensional contour mapping routines
7 for irregularly distributed data.
8 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
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
24 CONRAN - Provides the standard and smooth versions for contouring of
25 irregularly gridded data.
26 CONRAQ - Provides the quick form of the package. It does not have as
28 many available options as the other entries.
29 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 CONOP1 - Sets values of internal parameters of type logical.
34 Specifically, CONOP1 is used to turn options "OFF", or "ON".
35 CONOP2 - Sets values of internal parameters of type integer.
37 CONOP3 - Sets values of internal parameters of type real.
39 CONOP4 - Sets values of internal parameters of type character.
41
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 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 quick -- additionally load the conraq library.
53 smooth -- additionally load the dashsmth library.
55 super -- additionally load the conras and dashsupr libraries.
57 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 QUICK Command: "ncargf77 -quick mycode.f"
64 mycode.f has one or more calls to entry CONRAQ.
66 NORMAL Command: "ncargf77 mycode.f"
68 mycode.f has one or more calls to entry CONRAN.
70 SMOOTH Command: "ncargf77 -smooth mycode.f"
72 mycode.f has one or more calls to entry CONRAN.
74 SUPER Command: "ncargf77 -super mycode.f"
76 mycode.f has one or more calls to entry CONRAS.
78 Warning: mycode.f can only call one of the three entries,
80 CONRAQ, CONRAN, or CONRAS.
81
83 Error messages generated by CONRAN routines include:
84 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 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 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 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 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 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 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 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 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 CONTNG IDENTICAL INPUT DATA POINTS FOUND
132 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
139 Online: conran, conraq, conras, conran_family_params, conop1, conop2,
140 conop3, conop4, conpack, conpack_params, cpcnrc, bivar,
141 dashline_family, ncargf77
142 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-2007
148 University Corporation for Atmospheric Research
149 This documentation is free software; you can redistribute it and/or
151 modify it under the terms of the GNU General Public License as
152 published by the Free Software Foundation; either version 2 of the
153 License, or (at your option) any later version.
154 This software is distributed in the hope that it will be useful, but
156 WITHOUT ANY WARRANTY; without even the implied warranty of
157 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
158 General Public License for more details.
159 You should have received a copy of the GNU General Public License along
161 with this software; if not, write to the Free Software Foundation,
162 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
163UNIX March 1993 Conran_family(3NCARG)