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

NAME

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

STATUS

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

SYNOPSIS

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

ACCESS

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
38       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
45
46       NORMAL    Command:  "ncargf77 mycode.f"
47
48                 The contours will be drawn as unsmoothed dashed or solid
49                 lines that can include characters along the lines.
50
51
52
53       QUICK     Command:  "ncargf77 -quick mycode.f"
54
55                 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
62
63
64       SMOOTH    Command:  "ncargf77 -smooth mycode.f"
65
66                 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
70
71
72       SUPER     Command:  "ncargf77 -super mycode.f"
73
74                 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

MESSAGES

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
84       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
89       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
94       Should this happen the following messages are also sent to the output
95       plot file:
96
97       **WARNING--PICTURE INCOMPLETE**
98       WORK ARRAY OVERFLOW IN STLINE
99
100       Processing stops before the actual array overflow occurs and control is
101       returned to the calling program.
102

SEE ALSO

104       Online: conrec, ezcntr, conrec_family_params, conpack, conpack_params,
105       cpcnrc, dashline_family, ncargf77
106
107       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-2009
112       University Corporation for Atmospheric Research
113       The use of this Software is governed by a License Agreement.
114
115
116
117UNIX                              March 1993             Conrec_family(3NCARG)
Impressum