bionic (3) conran.3NCARG.gz

Provided by: libncarg-dev_6.4.0-9_amd64 bug

NAME

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

STATUS

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

UTILITY

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

SYNOPSIS

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

DESCRIPTION

       XD          Input, real array -- of dimension NDP containing the X coordinates of the data points.

       YD          Input, real array -- of dimension NDP containing the Y coordinates of the data points.

       ZD          Input, real array -- of dimension NDP containing the data values at the points.

       NDP         Input, integer -- is the number of data points to be contoured.  NDP must be 4 or larger.

       WK          Input, real array -- workspace of dimension 15*NDP.

       IWK         Input, integer array -- workspace which must be dimensioned at least IWK((27+NCP)*NDP).

                   The parameter NCP controls the number of data points to be used in the interpolation.
                   Increasing NCP causes more of the surrounding data to influence the point of interpolation.
                   In the case of linear interpolation NCP is always 4.  In the case of C1 interpolation, NCP
                   can vary from 2 to 25 with 4 as the default.

                   The interpolation option is selected using parameter ITP.  See the conran_family_params man
                   page for a description of all internal parameters.

       SCRARR      Real work array of dimension at least (RESOLUTION**2) where RESOLUTION is 40 by default.

                   Alternate resolutions are set using parameter SSZ.  See the conran_family_params man page.

USAGE

       The contours will be drawn as smoothed dashed or solid lines using splines under tension.  There may be
       characters along the lines.  Many other options are available through the use of internal parameters.
       See the conran_family_params man page.

       Quick and super versions of the Conran_family are also available through entries CONRAQ and CONRAS,
       respectively.

EXAMPLES

       Use the ncargex command to see the relevant example tconan.

ACCESS

       CONRAN can be invoked in two different ways.  The standard version produces contour plots which connect
       interpolated values on the boundary of the interpolation triangles.  The smooth version produces contours
       which are smoothed using splines under tension.

       To use standard CONRAN, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in
       that order.  To run the smooth option an additional library, dashsmth is needed.  It can be loaded by the
       user directly, along with the above three standard libraries, or loaded implicitly through the use of the
       -smooth option of the ncargf77 command.  To run a code called mycode.f which has one or more calls to
       entry CONRAN, issue one of the commands:

       NORMAL    Command: "ncargf77 mycode.f"

                 The contours will be drawn as unsmoothed dashed or solid lines that can include characters
                 along the lines.

       SMOOTH    Command: "ncargf77 -smooth mycode.f"

                 The contours will be drawn as smoothed dashed or solid lines that can include characters along
                 the lines.

MESSAGES

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

SEE ALSO

       Online: conraq, conras, conran_family_params, conran_family, conop1, conop2, conop3, conop4, conpack,
       conpack_params, bivar, dashline_family, ncargf77

       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial; NCAR Graphics Fundamentals, UNIX Version; User's
       Guide for NCAR GKS-0A Graphics

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.