NAME¶

STATUS¶

SYNOPSIS¶

C-BINDING SYNOPSIS¶

void c_strmln (float *u, float *v, float *work, int imax, int iptsx, int jptsy, int nset, int *ier)

DESCRIPTION¶

U

(REAL 2-dimensional array, dimensioned IMAX x n: n >= JPTSY, 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 >= JPTSY, 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*IPTSX*JPTSY, 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 value of the first dimension of arrays U and V.

IPTSX

(INTEGER, input): Number of contiguous elements along the first dimensional axis containing data to be processed in each of the arrays, U and V.

JPTSY

(INTEGER, input): Number of contiguous elements along the second dimensional axis containing data to be processed in each of the arrays, U and V.

NSET

(INTEGER, input) Flag that controls how and when the SET call is invoked. If NSET is 0, STRMLN makes a SET call to establish a standard viewport and window boundaries coincident with the array coordinate boundaries. PERIM is called to draw a border. If NSET is greater than zero, STRMLN does not call SET or PERIM. If NSET is less than zero, STRMLN calls SET to establish window boundaries coincident with the array grid coordinate boundaries but does not modify the viewport or call PERIM. Unlike the STINIT/STREAM interface, when STRMLN does a SET call, it always restores the original coordinate system state before returning.

IER

(INTEGER, output) If no error involving the ICYC common block variable (or, depending on the compatibility mode, the CYK internal parameter) is detected IER contains the value 0 on exit from STRMLN. If, when STRMLN is invoked, ICYC (or CYK) is erroneously set to indicate that the data is cyclic, STRMLN still processes the data using non-cyclic interpolation formulas, but returns the value of -1 in IER.

C-BINDING DESCRIPTION¶

imax

The second dimension of u and v in the calling program

iptsx

Number of contiguous elements along the second dimensional axis containing data to be processed in each of the arrays, u and v.

jptsy

Number of contiguous elements along the first dimensional axis containing data to be processed in each of the arrays, u and v.

USAGE¶

• Should FX and FY rather than the Version 3.2 mapping routines perform the mapping to user coordinates?
• Should the value of the input argument, NSET, override the current value of the SET parameter?
• Should the values contained in the common blocks STR02 and STR03 override the current values of corresponding Streamlines' internal parameters?

Given the default value of CPM, all these questions are answered in the affirmative, and a call to STRMLN gives a reasonably faithful emulation of the older version's behavior.

However, even in this case, it is possible to use the parameter setting routines to control the behavior of features that have no counterpart in the older version of STRMLN, as long as the feature is accessible without calling the new interface. For instance, you could control the streamline linewidth by setting the LWD parameter, but on the other hand you could not draw streamlines masked to an area map because doing so requires direct invocation of STREAM with the proper input arguments. The following two tables show how the STRMLN input arguments and STR02/STR03 common block members map into internal parameters currently supported by Streamlines:

See the streamlines_params man page for a description of the internal parameters.

EXAMPLES¶

ACCESS¶

SEE ALSO¶

COPYRIGHT¶