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

NAME

6       CONREC - draws a two dimensional contour map from data stored in a
7       rectangular array.  The contour lines are labeled.
8

UTILITY

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

STATUS

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
19       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

SYNOPSIS

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

DESCRIPTION

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
34       L           (an input parameter of type INTEGER) which is the first
35                   dimension of the Z array.
36
37       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
42       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
47       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
51       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
55       FINC        (an input parameter of type REAL) which defines how the
56                   contour levels are to be selected.
57
58                   > 0., use this value for the increment between contour
59                   levels.  There will be (HI-FLO)/FINC contour lines
60                   generated.
61
62                   = 0., causes CONREC to generate a value which will result
63                   in between 10 and 30 contours.
64
65                   < 0., the number of contour levels is the integer absolute
66                   value of this number (FINC.)
67
68       NSET        (an input parameter of type INTEGER) which controls plot
69                   scaling according to:
70
71                   = 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
80                   > 0, CONREC assumes the window and viewport have been set
81                   by the user.  No plot boundary is drawn.
82
83                   < 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
87       NHI         (an input parameter of type INTEGER) which controls the
88                   printing of extra information on the plot.
89
90                   = 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
94                   > 0, The Z data values are printed, centered at each grid
95                   point.
96
97                   < 0, Neither of the above is done.
98
99       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
107                   > 0, The NDOT pattern is used to draw all contours.
108
109                   < 0, The absolute value of NDOT is used for negative-valued
110                   contours and solid lines are drawn for positive contours.
111

EXAMPLES

113       Use the ncargex command to see the relevant examples tconre, tcnqck,
114       tcnsmt, and tcnsup.
115

ACCESS

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
124       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
130
131       NORMAL    Command:  "ncargf77 mycode.f"
132
133                 The contours will be drawn as unsmoothed dashed or solid
134                 lines that can include characters along the lines.
135
136
137
138       QUICK     Command:  "ncargf77 -quick mycode.f"
139
140                 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
147
148
149       SMOOTH    Command:  "ncargf77 -smooth mycode.f"
150
151                 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
155
156
157       SUPER     Command:  "ncargf77 -super mycode.f"
158
159                 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

MESSAGES

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
169       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

SEE ALSO

175       Online: ezcntr, conrec_family_params, conrec_family, conpack,
176       conpack_params, cpcnrc, gridall, dashline_family, ncargf77
177
178       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-2009
183       University Corporation for Atmospheric Research
184       The use of this Software is governed by a License Agreement.
185
186
187
188UNIX                              March 1993                    CONREC(3NCARG)
Impressum