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

NAME

6       CONRAN - draws a two dimensional contour map from irregularly
7       distributed data.  The contour lines may be smoothed.
8

STATUS

10       CONRAN is approaching obsolescence.  If you have available an
11       interpolation package which can do a random to gridded interpolation
12       equal to that built into the Conran_family, then we recommend that you
13       grid your dataset and use the Conpack utility instead.  Refer to the
14       conpack and conpack_params man pages as well as the NCAR Graphics
15       Contouring and Mapping Tutorial.
16

UTILITY

18       This routine is part of the Conran_family in NCAR Graphics.  To see the
19       overview man page for this utility, type "man conran_family".
20

SYNOPSIS

22       CONRAN (XD,YD,ZD,NDP,WK,IWK,SCRARR)
23

DESCRIPTION

25       XD          Input, real array -- of dimension NDP containing the X
26                   coordinates of the data points.
27
28       YD          Input, real array -- of dimension NDP containing the Y
29                   coordinates of the data points.
30
31       ZD          Input, real array -- of dimension NDP containing the data
32                   values at the points.
33
34       NDP         Input, integer -- is the number of data points to be
35                   contoured.  NDP must be 4 or larger.
36
37       WK          Input, real array -- workspace of dimension 15*NDP.
38
39       IWK         Input, integer array -- workspace which must be dimensioned
40                   at least IWK((27+NCP)*NDP).
41
42                   The parameter NCP controls the number of data points to be
43                   used in the interpolation.  Increasing NCP causes more of
44                   the surrounding data to influence the point of
45                   interpolation.  In the case of linear interpolation NCP is
46                   always 4.  In the case of C1 interpolation, NCP can vary
47                   from 2 to 25 with 4 as the default.
48
49                   The interpolation option is selected using parameter ITP.
50                   See the conran_family_params man page for a description of
51                   all internal parameters.
52
53       SCRARR      Real work array of dimension at least (RESOLUTION**2) where
54                   RESOLUTION is 40 by default.
55
56                   Alternate resolutions are set using parameter SSZ.  See the
57                   conran_family_params man page.
58

USAGE

60       The contours will be drawn as smoothed dashed or solid lines using
61       splines under tension.  There may be characters along the lines.  Many
62       other options are available through the use of internal parameters.
63       See the conran_family_params man page.
64
65       Quick and super versions of the Conran_family are also available
66       through entries CONRAQ and CONRAS, respectively.
67

EXAMPLES

69       Use the ncargex command to see the relevant example tconan.
70

ACCESS

72       CONRAN can be invoked in two different ways.  The standard version
73       produces contour plots which connect interpolated values on the
74       boundary of the interpolation triangles.  The smooth version produces
75       contours which are smoothed using splines under tension.
76
77       To use standard CONRAN, load the NCAR Graphics libraries ncarg,
78       ncarg_gks, and ncarg_c, preferably in that order.  To run the smooth
79       option an additional library, dashsmth is needed.  It can be loaded by
80       the user directly, along with the above three standard libraries, or
81       loaded implicitly through the use of the -smooth option of the ncargf77
82       command.  To run a code called mycode.f which has one or more calls to
83       entry CONRAN, issue one of the commands:
84
85
86       NORMAL    Command: "ncargf77 mycode.f"
87
88                 The contours will be drawn as unsmoothed dashed or solid
89                 lines that can include characters along the lines.
90
91
92
93       SMOOTH    Command: "ncargf77 -smooth mycode.f"
94
95                 The contours will be drawn as smoothed dashed or solid lines
96                 that can include characters along the lines.
97

MESSAGES

99       See the conran_family man page for a description of all Conran_family
100       error messages and/or informational messages.
101

SEE ALSO

103       Online: conraq, conras, conran_family_params, conran_family, conop1,
104       conop2, conop3, conop4, conpack, conpack_params, bivar,
105       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                    CONRAN(3NCARG)
Impressum