1AGSTUP(3NCARG) NCAR GRAPHICS AGSTUP(3NCARG)
2
6 AGSTUP - Performs "set-up" tasks required before AGBACK and AGCURV may
7 be called. Basically, AGSTUP examines the current values of the primary
8 control parameters for errors and computes from them and from its
9 arguments the values of secondary control parameters. The primary and
10 secondary control parameters together determine how the routines AGBACK
11 and AGCURV will behave.
12
14 CALL AGSTUP (XDRA,NVIX,IIVX,NEVX,IIEX,YDRA,NVIY,IIVY,
15 + NEVY,IIEY)
16
18 #include <ncarg/ncargC.h>
19 void c_agstup (float *xdra, int nvix, int iivx, int nevx, \
21 int iiex, float *ydra, int nviy, int iivy, int nevy, \
22 int iiey)
23
25 The first five arguments of AGSTUP are meaningful only if at least one
26 of 'X/MINIMUM.' and 'X/MAXIMUM.' has the value "null 1" or "null 2",
27 specifying that Autograph is to determine for itself the minimum and/or
28 maximum X coordinate in the user's data. Similarly, the second five
29 arguments are meaningful only if at least one of 'Y/ MINIMUM.' and
30 'Y/MAXIMUM.' has the value "null 1" or "null 2".
31 XDRA (an input array of type REAL, dimensioned as implied by the
33 next four arguments) contains user X coordinates.
34 NVIX (an input expression of type INTEGER) is the number of
36 "vectors" of data from XDRA to be considered in computing
37 the minimum and/or maximum X values.
38 IIVX (an input expression of type INTEGER) is the index
40 increment between two "vectors" in XDRA. The 1st element of
41 the first vector is XDRA(1), the 1st element of the second
42 vector is XDRA(1+IIVX), the 1st element of the third vector
43 is XDRA(1+IIVX*2), etc.
44 NEVX (an input expression of type INTEGER) is the number of
46 elements of each vector in XDRA to be considered in
47 computing the minimum and/or maximum X values.
48 IIEX (an input expression of type INTEGER) is the index
50 increment between two consecutive elements of a vector in
51 XDRA. The second element of the 1st vector is XDRA
52 (1+IIEX), the third element of the 1st vector is
53 XDRA(1+IIEX*2), etc. If IIEX has the value 0, the contents
54 of XDRA are ignored completely; the minimum and maximum X
55 values are considered to be "1." and FLOAT(NEVX),
56 respectively.
57 YDRA, NVIY, IIVY, NEVY, and IIEY
59 are used similarly, but define the user Y coordinates.
60 Some examples:
62 X array Data to use XDRA NVIX IIVX NEVX HEX
65 ------- ----------- ---- ---- ---- ---- ---
66 X(100) all data X(1) 1 - 100 1
69 (X(I),I=1,99,2) X(1) 1 - 50 2
70 (X(I),I=51,99,2) X(51) 1 - 25 2
71 X(10,10) all data X(1,1) 10 10 10 1
72 X(1,1) 1 - 100 1
73 ((X(I,J),I=1,10),J=1,6) X(1,1) 6 10 10 1
74 X(1,1) 10 1 6 10
75 X(1,1) - 60 1
76 ((X(I,J),I=3,7),J=3,9) X(3,3) 7 10 5 1
77 X(3,3) 5 1 7 10
78 ((X(I,J),I=3,7,4),J=3,9,3) X(3,3) 3 30 2 4
79 none 1., 2., . . ., 62. - - - 62 0
80 Note: The character "-" is used above to indicate an argument which is
82 ignored and may be given a dummy value.
83 Normally, the X and Y coordinate data tendered to AGSTUP are the same
85 data which will later be used to draw curves. However, this need not
86 be the case. For example, one could call AGSTUP with a two-word XDRA
87 (setting NVIX=1, IIVX=1, NEVX=2, and IIEX=1) containing a desired
88 minimum and maximum to be used, disregarding the real data.
89 If 'INVERT.' is given the value "1." (in place of its default value
91 "0."), AGSTUP will behave as if its first five arguments had been
92 interchanged with its last five, so that X-coordinate values refer to
93 vertical distances, and Y-coordinate values to horizontal distances, on
94 the graph. This parameter affects AGCURV in a similar manner, thus
95 allowing one to plot "X as a function of Y".
96
98 The C-binding argument descriptions are the same as the FORTRAN
99 argument descriptions.
100
102 Use the ncargex command to see the following relevant examples: agex13,
103 cbex01.
104
106 To use AGSTUP or c_agstup, load the NCAR Graphics libraries ncarg,
107 ncarg_gks, and ncarg_c, preferably in that order. To get smoother
108 curves, drawn using spline interpolation, also load libdashsmth.o. Or,
109 you can use the ncargf77 command to compile your program and load the
110 above libraries, then, to get smoother curves, use the -dashsmth
111 option.
112
114 See the autograph man page for a description of all Autograph error
115 messages and/or informational messages.
116
118 Online: autograph, agback, agbnch, agchax, agchcu, agchil, agchnl,
119 agcurv, agdshn, aggetc, aggetf, aggeti, aggetp, aggetr, agpwrt, agrstr,
120 agsave, agsetc, agsetf, agseti, agsetp, agsetr, agutol, anotat, displa,
121 ezmxy, ezmy, ezxy, ezy
122 Hardcopy: NCAR Graphics Fundamentals, UNIX Version
124
126 Copyright (C) 1987-2007
127 University Corporation for Atmospheric Research
128 This documentation is free software; you can redistribute it and/or
130 modify it under the terms of the GNU General Public License as
131 published by the Free Software Foundation; either version 2 of the
132 License, or (at your option) any later version.
133 This software is distributed in the hope that it will be useful, but
135 WITHOUT ANY WARRANTY; without even the implied warranty of
136 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
137 General Public License for more details.
138 You should have received a copy of the GNU General Public License along
140 with this software; if not, write to the Free Software Foundation,
141 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
142UNIX March 1993 AGSTUP(3NCARG)