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

NAME

6       EZCNTR - draws a two dimensional contour map from data stored in a
7       rectangular array.  A number of contouring defaults are used.
8

STATUS

10       EZCNTR is obsolete.  It has been superseded by the contouring package,
11       Conpack.  See the Conpack entry CPCNRC for a simple EZCNTR replacement.
12       For more complex examples refer to the conpack and conpack_params man
13       pages as well as the NCAR Graphics Contouring and Mapping Tutorial.
14
15       EZCNTR continues to be provided for compatibility of early NCAR
16       Graphics codes.  If you are writing new code, we suggest that you use
17       the more general and rigorous Conpack contouring package.  All EZCNTR
18       options set by default can be duplicated by the proper selection of
19       Conpack parameters.
20

SYNOPSIS

22       CALL EZCNTR(Z,M,N) - draws a contour map based upon a set of default
23       options.
24

DESCRIPTION

26       Z           (an input array of type REAL) defining a two-dimensional
27                   field of extent M by N, which is to be contoured.
28
29       M           (an input parameter of type INTEGER)  which is the first
30                   dimension of the Z array.
31
32       N           (an input parameter of type INTEGER)  which is the second
33                   dimension of the Z array.
34

EXAMPLES

36       Use the ncargex command to see the relevant examples tconre, tcnqck,
37       tcnsmt, and tcnsup.
38

ACCESS

40       EZCNTR can be invoked in four different ways to create contour plots
41       which vary considerably in appearance.  The four variations include
42       quick, normal, smooth, and super contour lines.  This progression
43       represents a tradeoff between speed of computation and the appearance
44       of the contour plots.  These variations are specified through selected
45       command line options of the ncargf77 command.
46
47       To use EZCNTR, load the NCAR Graphics libraries ncarg, ncarg_gks, and
48       ncarg_c, preferably in that order.  Other optional libraries to create
49       the quick, smooth, and super contours will automatically be linked by
50       the ncargf77 command.  To run a code called mycode.f which has one or
51       more calls to entry EZCNTR, issue one of the commands:
52
53
54       NORMAL    Command:  "ncargf77 mycode.f"
55
56                 The contours will be drawn as unsmoothed dashed or solid
57                 lines that can include characters along the lines.
58
59
60
61       QUICK     Command:  "ncargf77 -quick mycode.f"
62
63                 The contours will be drawn as unsmoothed dashed or solid
64                 lines without characters along the lines.  The QUICK drawing
65                 algorithm is faster and cruder than that used for NORMAL
66                 contour lines.  QUICK uses a cell-by-cell analysis rather
67                 than following each contour line to completion in sequence as
68                 is done in the NORMAL algorithm.
69
70
71
72       SMOOTH    Command:  "ncargf77 -smooth 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.
77
78
79
80       SUPER     Command:  "ncargf77 -super mycode.f"
81
82                 The contours will be drawn as smoothed dashed or solid lines
83                 using splines under tension.  There may be characters along
84                 the lines.  Crowded lines can be thinned.
85

MESSAGES

87       When error conditions are detected, the support routine SETER is called
88       in such a way that it writes a message to the standard error file (as
89       defined by I1MACH(4)) and then terminates execution. The possible error
90       messages are as follows:
91
92       CONREC  - DIMENSION ERROR - M*N .GT. (2**IARTH)
93       The array to be contoured is dimensioned M by N.  This is larger than
94       the address space on this computer (2**IARTH) where IARTH is the size
95       of an address integer.  Check your dimension sizes.
96

SEE ALSO

98       Online: conrec, conrec_family_params, conrec_family, conpack,
99       conpack_params, cpcnrc, ncargf77
100
101       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial; NCAR Graphics
102       Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics
103
105       Copyright (C) 1987-2009
106       University Corporation for Atmospheric Research
107       The use of this Software is governed by a License Agreement.
108
109
110
111UNIX                              March 1993                    EZCNTR(3NCARG)
Impressum