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

NAME

6       EZVEC - A front-end to VELVCT with a simpler interface. Like VELVCT, it
7       plots a a vector field in a single call.
8

SYNOPSIS

10       CALL EZVEC (U,V,M,N)
11

STATUS

13       EZVEC is obsolete, and is supported only to provide compatibility with
14       old NCAR Graphics codes. However, the compatibility mode parameter,
15       CPM, offers a number of options to help ease the the transition to the
16       new version of the utility. When writing new code you are encouraged
17       not to use this entry point, since it provides less capability than the
18       standard Vectors interface, and may eventually be phased out.
19

C-BINDING SYNOPSIS#

21       #include <ncarg/ncargC.h>
22
23       void c_ezvec (float *u, float *v, int m, int n)
24

DESCRIPTION

26       U           (REAL 2-dimensional array, dimensioned M x n: n >= N,
27                   input) By default, assumed to contain the first dimensional
28                   Cartesian components of the vector field. However, if PLR
29                   is non-zero, it is treated as containing the vector
30                   magnitudes.
31
32       V           (REAL 2-dimensional array, dimensioned M x n: n >= N,
33                   input) By default, assumed to contain the second
34                   dimensional Cartesian components of the vector field.
35                   However, if PLR is non-zero, it is treated as containing
36                   the vector angles.
37
38       M           (INTEGER, input) Actual size of the first dimension of
39                   arrays U and V
40
41       N           (INTEGER, input) Assumed size of the second dimension of
42                   arrays U and V.
43

C-BINDING DESCRIPTION

45       The C-binding argument descriptions are the same as the FORTRAN
46       argument descriptions with the following exceptions:
47
48       m           The actual size of the second dimension of arrays u and v.
49
50       n           The assumed size of first dimension of arrays u and v.
51

USAGE

53       U and V are 2-dimensional vector component arrays, whose actual first
54       dimensions must be equal to the value of M, and whose second dimensions
55       must equal or exceed the value of N.
56
57       Assuming the default value of the compatibility mode parameter, CPM,
58       Vectors always performs a SET call and draws a perimeter around the
59       plot when accessed through the EZVEC interface. Before the return from
60       EZVEC, another call to SET restores the previous coordinate system
61       mapping.
62
63       By modifying the value of CPM, you may take more control over the
64       utility than originally possible using this entry point. For instance,
65       you can override the default value of the SET parameter, or use the
66       Version 3.2 coordinate system mapping routines instead of the old FX,
67       FY, MXF, and MYF functions. Nevertheless, when creating new code, use
68       the VVINIT/VVECTR interface, since its capabilities are greater and
69       more likely to improve with time.
70

EXAMPLES

72       Use the ncargex command to see the following relevant example: tvelvc.
73

ACCESS

75       To use EZVEC, load the NCAR Graphics libraries ncarg, ncarg_gks, and
76       ncarg_c, preferably in that order.
77

SEE ALSO

79       Online: vectors, vectors_params, fx, velvct, vvectr, vvgetc, vvgeti,
80       vvgetr, vvinit, vvrset, vvsetc, vvseti, vvsetr, vvudmv, vvumxy,
81       ncarg_cbind.
82

84       Copyright (C) 1987-2009
85       University Corporation for Atmospheric Research
86
87       The use of this Software is governed by a License Agreement.
88
89
90
91UNIX                              April 1993                     EZVEC(3NCARG)
Impressum