ncl_ezmxy(3)

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

NAME

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

SYNOPSIS

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

C-BINDING SYNOPSIS

18       #include <ncarg/ncargC.h>
19
20       void c_ezmxy(float *xdra, float *ydra, int idxy, int many, \
21       int npts, char *glab)
22

DESCRIPTION

24       XDRA        (an input array of type REAL, dimensioned NPTS or IDXY x
25                   MANY or IDXY x NPTS, depending on the current value of
26                   'ROW.') contains curve-point X coordinates. The current
27                   value of 'NULL/1.' (default value "1.E36") may be used in
28                   XDRA to signal missing points; curve segments on either
29                   side of a missing point are not drawn. Note:  Because all
30                   non-missing coordinates are used in figuring the minimum
31                   and maximum user values along a given axis, it is safest to
32                   mark both coordinates as "missing".
33
34                   ·      If 'ROW.' has the absolute value "1." (the default),
35                          XDRA is singly-dimensioned. It is subscripted by
36                          point number.
37
38                   ·      If 'ROW.' has the absolute value "2." or greater,
39                          XDRA is doubly-dimensioned. It is subscripted by
40                          point number and curve number, in that order if
41                          'ROW.' is positive (the default), and in the reverse
42                          order if 'ROW.' is negative.
43
44       YDRA        (an input array of type REAL, dimensioned IDXY x MANY or
45                   IDXY x NPTS, depending on the current value of 'ROW.')
46                   contains curve-point Y coordinates. The current value of
47                   'NULL/1.' (default value "1.E36") may be used in YDRA to
48                   signal missing points; curve segments on either side of a
49                   missing point are not drawn. Note:  Because all non-missing
50                   coordinates are used in figuring the minimum and maximum
51                   user values along a given axis, it is safest to mark both
52                   coordinates as "missing".
53
54                   ·      If 'ROW.' is positive (the default), YDRA is
55                          subscripted by point number and curve number, in
56                          that order.
57
58                   ·      If 'ROW.' is negative, YDRA is subscripted by curve
59                          number and point number, in that order.
60
61       IDXY        (an input expression of type INTEGER) is the first
62                   dimension of the arrays XDRA (if it is doubly-dimensioned)
63                   and YDRA (unconditionally), required by EZMXY in order to
64                   index these arrays properly.
65
66                   ·      If 'ROW.' is positive (the default), IDXY must be
67                          greater than or equal to NPTS.
68
69                   ·      If 'ROW.' is negative, IDXY must be greater than or
70                          equal to MANY.
71
72       MANY        (an input expression of type INTEGER) is the number of
73                   curves to be drawn by EZMXY.
74
75       NPTS        (an input expression of type INTEGER) is the number of
76                   points defining each curve to be drawn by EZMXY.
77
78       GLAB        (an input expression of type CHARACTER) defines a new
79                   "graph label". (If the first character of this expression
80                   is "CHAR(0)", no new "graph label" is defined; the current
81                   one will continue to be used.)  A character string defining
82                   a new graph label must either be of the exact length
83                   specified by the current value of 'LINE/MAXIMUM.' (default:
84                   40 characters), or shorter; if shorter, it must be
85                   terminated by the character defined by the current value of
86                   'LINE/END.' (default: a '$'). The string becomes the new
87                   text of line number 100 of the label named 'T'.
88

C-BINDING DESCRIPTION

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

EXAMPLES

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

ACCESS

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

COPYRIGHT

115       Copyright (C) 1987-2009
116       University Corporation for Atmospheric Research
117       The use of this Software is governed by a License Agreement.
118
119
120
121UNIX                              March 1993                     EZMXY(3NCARG)