1EZCNTR(3NCARG) NCAR GRAPHICS EZCNTR(3NCARG)
2
6 EZCNTR - draws a two dimensional contour map from data stored in a
7 rectangular array. A number of contouring defaults are used.
8
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 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
22 CALL EZCNTR(Z,M,N) - draws a contour map based upon a set of default
23 options.
24
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 M (an input parameter of type INTEGER) which is the first
30 dimension of the Z array.
31 N (an input parameter of type INTEGER) which is the second
33 dimension of the Z array.
34
36 Use the ncargex command to see the relevant examples tconre, tcnqck,
37 tcnsmt, and tcnsup.
38
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 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 NORMAL Command: "ncargf77 mycode.f"
55 The contours will be drawn as unsmoothed dashed or solid
57 lines that can include characters along the lines.
58 QUICK Command: "ncargf77 -quick mycode.f"
62 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 SMOOTH Command: "ncargf77 -smooth 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.
77 SUPER Command: "ncargf77 -super mycode.f"
81 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
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 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
98 Online: conrec, conrec_family_params, conrec_family, conpack,
99 conpack_params, cpcnrc, ncargf77
100 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-2007
106 University Corporation for Atmospheric Research
107 This documentation is free software; you can redistribute it and/or
109 modify it under the terms of the GNU General Public License as
110 published by the Free Software Foundation; either version 2 of the
111 License, or (at your option) any later version.
112 This software is distributed in the hope that it will be useful, but
114 WITHOUT ANY WARRANTY; without even the implied warranty of
115 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
116 General Public License for more details.
117 You should have received a copy of the GNU General Public License along
119 with this software; if not, write to the Free Software Foundation,
120 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
121UNIX March 1993 EZCNTR(3NCARG)