NAME

       EZMXY - Draws, in a manner determined by the current values of the control parameters, a
       complete graph of one or more curves, each defined by a set of points (XDRA(I),YDRA(I,J))
       (or (XDRA(I),YDRA(J,I)) or (XDRA(I,J),YDRA(I,J)) or (XDRA(J,I),YDRA(J,I)), depending on
       the current value of 'ROW.'), for I from 1 to NPTS. The curve number J runs from 1 to
       MANY. The argument GLAB may be used to specify a "graph label", to be placed at the top of
       the graph.

SYNOPSIS

       CALL EZMXY (XDRA,YDRA,IDXY,MANY,NPTS,GLAB)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_ezmxy(float *xdra, float *ydra, int idxy, int many, \
       int npts, char *glab)

DESCRIPTION

       XDRA        (an input array of type REAL, dimensioned NPTS or IDXY x MANY or IDXY x NPTS,
                   depending on the current value of 'ROW.') contains curve-point X coordinates.
                   The current value of 'NULL/1.' (default value "1.E36") may be used in XDRA to
                   signal missing points; curve segments on either side of a missing point are
                   not drawn. Note:  Because all non-missing coordinates are used in figuring the
                   minimum and maximum user values along a given axis, it is safest to mark both
                   coordinates as "missing".

                   •      If 'ROW.' has the absolute value "1." (the default), XDRA is singly-
                          dimensioned. It is subscripted by point number.

                   •      If 'ROW.' has the absolute value "2." or greater, XDRA is doubly-
                          dimensioned. It is subscripted by point number and curve number, in
                          that order if 'ROW.' is positive (the default), and in the reverse
                          order if 'ROW.' is negative.

       YDRA        (an input array of type REAL, dimensioned IDXY x MANY or IDXY x NPTS,
                   depending on the current value of 'ROW.')  contains curve-point Y coordinates.
                   The current value of 'NULL/1.' (default value "1.E36") may be used in YDRA to
                   signal missing points; curve segments on either side of a missing point are
                   not drawn. Note:  Because all non-missing coordinates are used in figuring the
                   minimum and maximum user values along a given axis, it is safest to mark both
                   coordinates as "missing".

                   •      If 'ROW.' is positive (the default), YDRA is subscripted by point
                          number and curve number, in that order.

                   •      If 'ROW.' is negative, YDRA is subscripted by curve number and point
                          number, in that order.

       IDXY        (an input expression of type INTEGER) is the first dimension of the arrays
                   XDRA (if it is doubly-dimensioned) and YDRA (unconditionally), required by
                   EZMXY in order to index these arrays properly.

                   •      If 'ROW.' is positive (the default), IDXY must be greater than or equal
                          to NPTS.

                   •      If 'ROW.' is negative, IDXY must be greater than or equal to MANY.

       MANY        (an input expression of type INTEGER) is the number of curves to be drawn by
                   EZMXY.

       NPTS        (an input expression of type INTEGER) is the number of points defining each
                   curve to be drawn by EZMXY.

       GLAB        (an input expression of type CHARACTER) defines a new "graph label". (If the
                   first character of this expression is "CHAR(0)", no new "graph label" is
                   defined; the current one will continue to be used.)  A character string
                   defining a new graph label must either be of the exact length specified by the
                   current value of 'LINE/MAXIMUM.' (default: 40 characters), or shorter; if
                   shorter, it must be terminated by the character defined by the current value
                   of 'LINE/END.' (default: a '$'). The string becomes the new text of line
                   number 100 of the label named 'T'.

C-BINDING DESCRIPTION

       The C-binding argument descriptions are the same as the FORTRAN argument descriptions.

EXAMPLES

       Use the ncargex command to see the following relevant examples: agex04, agex05, agex07,
       agex08, tagupw, tautog, fagaxclr, fagaxlbl, fagaxmax, fagcuclr, fagcudsh, fagezmxy,
       fagilclr, fagovrvw.

ACCESS

       To use EZMXY or c_ezmxy, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c,
       preferably in that order.    To get smoother curves, drawn using spline interpolation,
       also load libdashsmth.o.  Or, you can use the ncargf77 command to compile your program and
       load the above libraries, then, to get smoother curves, use the -dashsmth option.

SEE ALSO

       Online: autograph, autograph_params, agback, agbnch, agchax, agchcu, agchil, agchnl,
       agcurv, agdshn, aggetc, aggetf, aggeti, aggetp, aggetr, agpwrt, agrstr, agsave, agsetc,
       agsetf, agseti, agsetp, agsetr, agstup, agutol, anotat, displa, ezmy, ezxy, ezy

       Hardcopy: NCAR Graphics Fundamentals, UNIX Version

COPYRIGHT

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