1CONREC(3NCARG) NCAR GRAPHICS CONREC(3NCARG)
2
6 CONREC - draws a two dimensional contour map from data stored in a
7 rectangular array. The contour lines are labeled.
8
10 This routine is part of the conrec utility in NCAR Graphics. To see the
11 overview man page for this utility, type "man conrec_family".
12
14 CONREC is obsolete. It has been superseded by the contouring package,
15 Conpack. See the Conpack entry CPCNRC for a simple CONREC replacement.
16 For more complex examples refer to the conpack and conpack_params man
17 pages as well as the NCAR Graphics Contouring and Mapping Tutorial.
18 CONREC continues to be provided for compatibility of early NCAR
20 Graphics codes. If you are writing new code, we suggest that you use
21 the more general and rigorous Conpack contouring package. All CONREC
22 options can be duplicated by the proper selection of Conpack
23 parameters.
24
26 CALL CONREC(Z,L,M,N,FLO,HI,FINC,NSET,NHI,NDOT) - draws a contour map
27 using options specified as input arguments.
28
30 Z (an input array of type REAL) defining a two-dimensional
31 field to be contoured. A subset of Z of extent M by N can
32 be contoured.
33 L (an input parameter of type INTEGER) which is the first
35 dimension of the Z array.
36 M (an input parameter of type INTEGER) which is the extent of
38 the first dimension of array Z to be contoured. This
39 allows for a sub-array of Z to be contoured. M must be
40 less than or equal to L.
41 N (an input parameter of type INTEGER) which is the extent of
43 the second dimension of array Z to be contoured. This
44 allows for a sub-array of Z to be contoured. N must be
45 less than or equal to the second dimension of Z.
46 FLO (an input parameter of type REAL) defining a lowest level
48 for contouring. If FLO = HI = 0., a value rounded up from
49 the minimum value of Z will be generated by CONREC.
50 HI (an input parameter of type REAL) defining a highest level
52 for contouring. If HI = FLO = 0., a value rounded down
53 from the maximum value of Z will be generated by CONREC.
54 FINC (an input parameter of type REAL) which defines how the
56 contour levels are to be selected.
57 > 0., use this value for the increment between contour
59 levels. There will be (HI-FLO)/FINC contour lines
60 generated.
61 = 0., causes CONREC to generate a value which will result
63 in between 10 and 30 contours.
64 < 0., the number of contour levels is the integer absolute
66 value of this number (FINC.)
67 NSET (an input parameter of type INTEGER) which controls plot
69 scaling according to:
70 = 0, CONREC automatically sets the window and viewport
72 sizes. The viewport becomes by default .05 to .95 in the
73 larger dimension (M or N), and .05 to a proportionately
74 smaller number in the smaller dimension. The window
75 becomes 1. to FLOAT(M) in X, and 1. to FLOAT(N) in Y. The
76 PERIM entry of the Gridall utility is called to generate a
77 plot boundary with tick marks placed at the data grid
78 points.
79 > 0, CONREC assumes the window and viewport have been set
81 by the user. No plot boundary is drawn.
82 < 0, CONREC uses the existing viewport and sets the window
84 to 1. to FLOAT(M) in X, and 1. to FLOAT(N) in Y. No plot
85 boundary is drawn.
86 NHI (an input parameter of type INTEGER) which controls the
88 printing of extra information on the plot.
89 = 0, Symbols H and L are written where highs and lows occur
91 and the value of the high or low is written under the
92 symbol.
93 > 0, The Z data values are printed, centered at each grid
95 point.
96 < 0, Neither of the above is done.
98 NDOT (an input parameter of type INTEGER) which specifies the
100 line patterns to be used in drawing the contours. Only the
101 last 10 binary bits of NDOT are used in creating a binary
102 pattern is which 0's are no-line and 1's are line segments.
103 If the absolute value of NDOT is 0, 1, or 1023 a solid line
104 is drawn. 1023 in decimal converts to 1777 octal, or
105 1111111111 in binary.
106 > 0, The NDOT pattern is used to draw all contours.
108 < 0, The absolute value of NDOT is used for negative-valued
110 contours and solid lines are drawn for positive contours.
111
113 Use the ncargex command to see the relevant examples tconre, tcnqck,
114 tcnsmt, and tcnsup.
115
117 CONREC can be invoked in four different ways to create contour plots
118 which vary considerably in appearance. The four variations include
119 quick, normal, smooth, and super contour lines. This progression
120 represents a tradeoff between speed of computation and the appearance
121 of the contour plots. These variations are specified through selected
122 command line options of the ncargf77 command.
123 To use CONREC, load the NCAR Graphics libraries ncarg, ncarg_gks, and
125 ncarg_c, preferably in that order. Other optional libraries to create
126 the quick, smooth, and super contours will automatically be linked by
127 the ncargf77 command. To run a code called mycode.f which has one or
128 more calls to entry CONREC, issue one of the commands:
129 NORMAL Command: "ncargf77 mycode.f"
132 The contours will be drawn as unsmoothed dashed or solid
134 lines that can include characters along the lines.
135 QUICK Command: "ncargf77 -quick mycode.f"
139 The contours will be drawn as unsmoothed dashed or solid
141 lines without characters along the lines. The QUICK drawing
142 algorithm is faster and cruder than that used for NORMAL
143 contour lines. QUICK uses a cell-by-cell analysis rather
144 than following each contour line to completion in sequence as
145 is done in the NORMAL algorithm.
146 SMOOTH Command: "ncargf77 -smooth mycode.f"
150 The contours will be drawn as smoothed dashed or solid lines
152 using splines under tension. There may be characters along
153 the lines.
154 SUPER Command: "ncargf77 -super mycode.f"
158 The contours will be drawn as smoothed dashed or solid lines
160 using splines under tension. There may be characters along
161 the lines. Crowded lines can be thinned.
162
164 When error conditions are detected, the support routine SETER is called
165 in such a way that it writes a message to the standard error file (as
166 defined by I1MACH(4)) and then terminates execution. The possible error
167 messages are as follows:
168 CONREC - DIMENSION ERROR - M*N .GT. (2**IARTH)
170 The array to be contoured is dimensioned M by N. This is larger than
171 the address space on this computer (2**IARTH) where IARTH is the size
172 of an address integer. Check your dimension sizes.
173
175 Online: ezcntr, conrec_family_params, conrec_family, conpack,
176 conpack_params, cpcnrc, gridall, dashline_family, ncargf77
177 Hardcopy: NCAR Graphics Contouring and Mapping Tutorial; NCAR Graphics
179 Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics
180
182 Copyright (C) 1987-2007
183 University Corporation for Atmospheric Research
184 This documentation is free software; you can redistribute it and/or
186 modify it under the terms of the GNU General Public License as
187 published by the Free Software Foundation; either version 2 of the
188 License, or (at your option) any later version.
189 This software is distributed in the hope that it will be useful, but
191 WITHOUT ANY WARRANTY; without even the implied warranty of
192 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
193 General Public License for more details.
194 You should have received a copy of the GNU General Public License along
196 with this software; if not, write to the Free Software Foundation,
197 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
198UNIX March 1993 CONREC(3NCARG)