ncl_agcurv(3)

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

NAME

6       AGCURV - Draws a curve in a manner specified by the current values of
7       the control parameters - the primary parameters with default values or
8       with values supplied by the user, and the secondary parameters with
9       values computed by AGSTUP.
10

SYNOPSIS

12       CALL AGCURV (XVEC,IIEX,YVEC,IIEY,NEXY,KDSH)
13

C-BINDING SYNOPSIS

15       #include <ncarg/ncargC.h>
16
17       void c_agcurv (float *xvec, int iiex, float *yvec,
18       int iiey, int nexy, int kdsh)
19

DESCRIPTION

21       XVEC        (a singly-subscripted input array of type REAL), when IIEX
22                   is non-zero, contains NEXY X-coordinate data - curve point
23                   1 has X coordinate XVEC(1), curve point 2 has X coordinate
24                   XVEC(1+IIEX), curve point 3 has X coordinate
25                   XVEC(1+IIEX*2), etc. When IIEX is zero, the array XVEC is
26                   ignored - curve point 1 has X coordinate "1.", curve point
27                   2 has X coordinate "2.", etc.
28
29                   If the value of any X coordinate matches the current value
30                   of 'NULL/1.' (default - "1.E36"), the corresponding point
31                   is considered to be missing - curve segments on either side
32                   of that point are not drawn.
33
34       IIEX        (an input expression of type INTEGER), if non-zero, is the
35                   index increment between one X coordinate in XVEC and the
36                   next. If IIEX is zero, the array XVEC is ignored, as
37                   described above.
38
39       YVEC        (a singly-subscripted input array of type REAL) is just
40                   like XVEC, but provides Y coordinate data.
41
42       IIEY        (an input expression of type INTEGER) is just like IIEX,
43                   but describes the use (or non-use) of YVEC.
44
45       NEXY        (an input expression of type INTEGER) is the number of
46                   curve points - the number of X/Y coordinate pairs to be
47                   used.
48
49                   Note: If 'INVERT.' is given the value "1." (in place of its
50                   default value "0."), AGCURV will behave as if the arguments
51                   XVEC and IIEX had been interchanged with the arguments YVEC
52                   and IIEY, so that X-coordinate values refer to vertical
53                   distances, and Y-coordinate values to horizontal distances,
54                   on the graph. This parameter affects AGSTUP in a similar
55                   manner, thus allowing one to plot "X as a function of Y".
56
57       KDSH        (an input expression of type INTEGER) specifies the dashed-
58                   line pattern to be used in drawing the curve. (Since the
59                   routines DASHD, FRSTD, VECTD, and LASTD, in the package
60                   Dashline, are used to draw the curve, it may have its own
61                   particular dashed-line pattern.)  If KDSH is zero, the user
62                   is assumed to have done his own call to DASHD; AGCURV will
63                   do no such call.
64
65                   ·   If KDSH is zero, the user is assumed to have done his
66                       own call to DASHD; AGCURV will do no such call.
67
68                   ·   If KDSH is non-zero and negative, the function
69                       MOD(-KDSH-1,26)+1 determines which of 26 "alphabetic"
70                       patterns is to be used; each of these generates a solid
71                       line interrupted by one of the letters of the alphabet.
72                       The value 1 implies that an "A" will be used, the value
73                       2 that a "B" will be used, . . . the value 27 that an
74                       "A" will be used again, etc.
75
76                   ·   If KDSH is non-zero and positive, the function
77                       MOD(KDSH-1,n)+1 determines which of n "user" patterns
78                       is to be used; these n patterns are defined by the
79                       parameters in the group named 'DASH.' - the default
80                       values specify one solid-line pattern.
81
82                   Note: The routines EZY and EZXY, which draw one curve per
83                   call, always call AGCURV with KDSH = 1. The routines EZMY
84                   and EZMXY, which draw one or more curves per call, call
85                   AGCURV with KDSH = ISIGN(p,q), where p is the number of the
86                   curve being drawn (p is between 1 and MANY, inclusive) and
87                   q is the current integral value of 'DASH/SELECTOR.'.
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 example: agex13.
95

ACCESS

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

MESSAGES

105       See the autograph man page for a description of all Autograph error
106       messages and/or informational messages.
107

COPYRIGHT

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