plucky (3) ezvec.3NCARG.gz

Provided by: libncarg-dev_6.6.2.dfsg.1-10build2_amd64 bug

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


SYNOPSIS
       CALL EZVEC (U,V,M,N)


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


C-BINDING SYNOPSIS#
       #include <ncarg/ncargC.h>

       void c_ezvec (float *u, float *v, int m, int n)


DESCRIPTION
       U           (REAL 2-dimensional array, dimensioned M x n: n >= N, input) By default, assumed to contain
                   the first dimensional Cartesian components of the vector field. However, if PLR is non-zero,
                   it is treated as containing the vector magnitudes.

       V           (REAL 2-dimensional array, dimensioned M x n: n >= N, input) By default, assumed to contain
                   the second dimensional Cartesian components of the vector field.  However, if PLR is non-
                   zero, it is treated as containing the vector angles.

       M           (INTEGER, input) Actual size of the first dimension of arrays U and V

       N           (INTEGER, input) Assumed size of the second dimension of arrays U and V.


C-BINDING DESCRIPTION
       The C-binding argument descriptions are the same as the FORTRAN argument descriptions with the following
       exceptions:

       m           The actual size of the second dimension of arrays u and v.

       n           The assumed size of first dimension of arrays u and v.


USAGE
       U and V are 2-dimensional vector component arrays, whose actual first dimensions must be equal to the
       value of M, and whose second dimensions must equal or exceed the value of N.

       Assuming the default value of the compatibility mode parameter, CPM, Vectors always performs a SET call
       and draws a perimeter around the plot when accessed through the EZVEC interface. Before the return from
       EZVEC, another call to SET restores the previous coordinate system mapping.

       By modifying the value of CPM, you may take more control over the utility than originally possible using
       this entry point. For instance, you can override the default value of the SET parameter, or use the
       Version 3.2 coordinate system mapping routines instead of the old FX, FY, MXF, and MYF functions.
       Nevertheless, when creating new code, use the VVINIT/VVECTR interface, since its capabilities are greater
       and more likely to improve with time.


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


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


SEE ALSO
       Online: vectors, vectors_params, fx, velvct, vvectr, vvgetc, vvgeti, vvgetr, vvinit, vvrset, vvsetc,
       vvseti, vvsetr, vvudmv, vvumxy, ncarg_cbind.


       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research

       The use of this Software is governed by a License Agreement.