NAME

       EZSTRM - A front-end to STRMLN with a simpler interface.  Like STRMLN, it plots a streamline
       representation of field flow data in a single call.

STATUS

       EZSTRM 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 Streamlines interface, and may eventually be phased out.

SYNOPSIS

       CALL EZSTRM (U,V,WORK,IMAX,JMAX)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_ezstrm (float *u, float *v, float *work,
                      int imax, int jmax)

DESCRIPTION

       U           (REAL  2-dimensional  array,  dimensioned  IMAX x n: n >= JMAX, 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  IMAX x n: n >= JMAX, 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.

       WORK        (REAL  array, dimensioned n: n>= 2*IMAX*JMAX working space): User provided work array used to
                   store the normalized vector component values, and also  to  keep  track  of  the  grid  boxes
                   eligible for starting a streamline or placement of a directional arrow.

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

       JMAX        (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:

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

       jmax        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  IMAX, and whose second dimensions must equal or exceed the value of JMAX. The WORK array must,
       at minimum, be of length 2*IMAX*JMAX.

       Assuming the default value of the compatibility mode parameter, CPM, Streamlines always  performs  a  SET
       call  and draws a perimeter around the plot when accessed through the EZSTRM interface. Before the return
       from EZSTRM, 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 and FY functions. Nevertheless, when
       creating new code, use the STINIT/STREAM interface, since its capabilities are greater and more likely to
       improve with time.

ACCESS

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

SEE ALSO

       Online: fx, stgetc, stgeti, stgetr, stinit,  stream,  streamlines,  streamlines_params,  strset,  stsetc,
       stseti, stsetr, stuixy, stumsl, stumta, stumxy, ncarg_cbind.

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.

UNIX                                               April 1993                                     EZSTRM(3NCARG)