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-2009
127 University Corporation for Atmospheric Research
128 The use of this Software is governed by a License Agreement.
129UNIX March 1993 AGSTUP(3NCARG)