1Conrec_family(3NCARG) NCAR GRAPHICS Conrec_family(3NCARG)
2
6 Conrec_family - is a set of two dimensional contour mapping routines.
7 There are options for generating standard contours, smoothing contour
8 lines, labeling the contours, and removing crowded lines.
9
11 Conrec_family is obsolete. It has been replaced by the contouring
12 package, Conpack. See the Conpack entry CPCNRC for a simple CONREC
13 replacement. For more complex examples refer to the conpack and
14 conpack_params man pages as well as the NCAR Graphics Contouring and
15 Mapping Tutorial.
16 Conrec_family continues to be provided for compatibility of early NCAR
18 Graphics codes. If you are writing new code, we suggest that you use
19 the more general and rigorous Conpack contouring package. All
20 Conrec_family options are available via Conpack parameters.
21
23 EZCNTR(Z,M,N) - draws a contour map based upon a set of default
24 options.
25 CONREC(Z,L,M,N,FLO,HI,FINC,NSET,NHI,NDOT) - draws a contour map using
26 options specified as input arguments.
27
29 The Conrec family contains only two user callable entries, EZCNTR, and
30 CONREC. However, these two entries can be invoked in four different
31 ways to create contour plots which vary considerably in appearance.
32 The four variations include quick, normal, smooth, and super contour
33 lines. This progression represents a tradeoff between speed of
34 computation and the appearance of the contour plots. These variations
35 are specified through selected command line options of the ncargf77
36 command.
37 To use EZCNTR or CONREC, load the NCAR Graphics libraries ncarg,
39 ncarg_gks, and ncarg_c, preferably in that order. Other optional
40 libraries to create the quick, smooth, and super contours will
41 automatically be linked by the ncargf77 command. To run a code called
42 mycode.f which has one or more calls to entry EZCNTR or CONREC, issue
43 one of the commands:
44 NORMAL Command: "ncargf77 mycode.f"
47 The contours will be drawn as unsmoothed dashed or solid
49 lines that can include characters along the lines.
50 QUICK Command: "ncargf77 -quick mycode.f"
54 The contours will be drawn as unsmoothed dashed or solid
56 lines without characters along the lines. The QUICK drawing
57 algorithm is faster and cruder than that used for NORMAL
58 contour lines. QUICK uses a cell-by-cell analysis rather
59 than following each contour line to completion in sequence as
60 is done in the NORMAL algorithm.
61 SMOOTH Command: "ncargf77 -smooth mycode.f"
65 The contours will be drawn as smoothed dashed or solid lines
67 using splines under tension. There may be characters along
68 the lines.
69 SUPER Command: "ncargf77 -super mycode.f"
73 The contours will be drawn as smoothed dashed or solid lines
75 using splines under tension. There may be characters along
76 the lines. Crowded lines can be thinned.
77
79 When error conditions are detected, the support routine SETER is called
80 in such a way that it writes a message to the standard error file (as
81 defined by I1MACH(4)) and then terminates execution. The possible error
82 messages are as follows:
83 CONREC - DIMENSION ERROR - M*N .GT. (2**IARTH)
85 The array to be contoured is dimensioned M by N. This is larger than
86 the address space on this computer (2**IARTH) where IARTH is the size
87 of an address integer. Check your dimension sizes.
88 STLINE - WARNING FROM ROUTINE STLINE IN CONREC--WORK ARRAY OVERFLOW
90 This warning message is printed to standard output if the number of
91 contour lines for a contour level would exceed the dimension size of
92 work array IR in routine STLINE.
93 Should this happen the following messages are also sent to the output
95 plot file:
96 **WARNING--PICTURE INCOMPLETE**
98 WORK ARRAY OVERFLOW IN STLINE
99 Processing stops before the actual array overflow occurs and control is
101 returned to the calling program.
102
104 Online: conrec, ezcntr, conrec_family_params, conpack, conpack_params,
105 cpcnrc, dashline_family, ncargf77
106 Hardcopy: NCAR Graphics Contouring and Mapping Tutorial; NCAR Graphics
108 Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics
109
111 Copyright (C) 1987-2007
112 University Corporation for Atmospheric Research
113 This documentation is free software; you can redistribute it and/or
115 modify it under the terms of the GNU General Public License as
116 published by the Free Software Foundation; either version 2 of the
117 License, or (at your option) any later version.
118 This software is distributed in the hope that it will be useful, but
120 WITHOUT ANY WARRANTY; without even the implied warranty of
121 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
122 General Public License for more details.
123 You should have received a copy of the GNU General Public License along
125 with this software; if not, write to the Free Software Foundation,
126 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
127UNIX March 1993 Conrec_family(3NCARG)