1EZMXY(3NCARG) NCAR GRAPHICS EZMXY(3NCARG)
2
3
4
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
15 CALL EZMXY (XDRA,YDRA,IDXY,MANY,NPTS,GLAB)
16
18 #include <ncarg/ncargC.h>
19
20 void c_ezmxy(float *xdra, float *ydra, int idxy, int many, \
21 int npts, char *glab)
22
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
90 The C-binding argument descriptions are the same as the FORTRAN
91 argument descriptions.
92
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
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
107 Online: autograph, autograph_params, agback, agbnch, agchax, agchcu,
108 agchil, agchnl, agcurv, agdshn, aggetc, aggetf, aggeti, aggetp, aggetr,
109 agpwrt, agrstr, agsave, agsetc, agsetf, agseti, agsetp, agsetr, agstup,
110 agutol, anotat, displa, ezmy, ezxy, ezy
111
112 Hardcopy: NCAR Graphics Fundamentals, UNIX Version
113
115 Copyright (C) 1987-2007
116 University Corporation for Atmospheric Research
117
118 This documentation is free software; you can redistribute it and/or
119 modify it under the terms of the GNU General Public License as
120 published by the Free Software Foundation; either version 2 of the
121 License, or (at your option) any later version.
122
123 This software is distributed in the hope that it will be useful, but
124 WITHOUT ANY WARRANTY; without even the implied warranty of
125 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
126 General Public License for more details.
127
128 You should have received a copy of the GNU General Public License along
129 with this software; if not, write to the Free Software Foundation,
130 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
131
132
133
134UNIX March 1993 EZMXY(3NCARG)