Provided by: libncarg-dev_6.6.2.dfsg.1-10build2_amd64 
NAME
Streamlines_params - This document briefly describes all Streamlines internal parameters.
DESCRIPTION
Parameter descriptions follow, in alphabetical order. Each description begins with a line giving the
three-character mnemonic name of the parameter, the phrase for which the mnemonic stands, and the
intrinsic type of the parameter.
AGD - Arrow Placement Grid Increment - Integer
This parameter allows you a degree of control over directional arrowhead spacing in the field flow
plot. Streamlines allows a maximum of one directional arrowhead for each grid box, where a grid
box is the space between adjacent integer grid coordinates in the grid coordinate system along
both dimensions. However, Streamlines actually places an arrowhead only if both lower grid
indices, modulo the value of AGD, are equal to 0. If AGD is set to 2, for instance, Streamlines
places an arrowhead on the first streamline to enter each grid box with even-numbered lower grid
indices.
If the transformation pipeline is everywhere linear from grid coordinate space to NDC space, then
the spacing of the arrowheads should be more or less uniform over the field flow plot. However, if
there is a non-linearity anywhere in the pipeline, the arrowheads will probably be more crowded in
some areas than in others. The default value of AGD is 2.
AMD - Arrow Head Minimum Distance - Real
AMD allows you to specify, as a fraction of the viewport width, a minimum distance between
adjacent directional arrowheads along a single streamline. If the data grid is transformed in such
a way that adjacent grid cells become very close in NDC space, as for instance in many map
projections near the poles, you can use this parameter to help reduce the otherwise cluttered
appearance of these regions of the plot. Note that currently, whenever AMD has a positive value,
the first arrowhead that would otherwise be drawn for each streamline is always eliminated. If AMD
is less than or equal to 0.0, then no arrowheads are eliminated. The default value of AMD is 0.0.
ARL - Arrow Head Length - Real
ARL defines the length of each of the two lines used to create the directional arrow head. If the
parameter GBS is set to 0, ARL has units "fraction of viewport width"; if GBS is set to 1, ARL has
the units "fraction of grid box width". The default value of ARL is 0.012 when GBS has the value
0 and 0.33 when GBS has the value 1. Setting GBS causes ARL to be reset to its appropriate default
value.
CDS - Critical Displacement Multiplier - Real
CDS specifies the minimum amount the streamline must grow as a multiple of the basic differential
step size each time the stream progress is checked in order for the streamline not to be
terminated. The nominal differential step size is specified by DFM in NDC space, and the progress
is checked each CKP iterations. Points of convergence or divergence typically cause stream growth
to diminish and the streamline eventually to be terminated. The default value of CDS is 2.0,
meaning that any time a streamline does not increase in length a minimum of 2.0*DFM in NDC over
the previous check, it is discontinued and a new streamline is begun if possible.
CKP - Check Progress Iteration Count - Integer
The parameter CKP specifies the number of iterations through the streamline building loop between
each check of the streamline growth. If the distance between current position of the streamline
and the position saved at the time of the previous check is less than a minimum amount, defined as
the value of CDS times the value of DFM in NDC space, then the current streamline is terminated
and a new one begun if possible. The default value of CKP is 35.
CKX - Check Crossover Iteration Count - Integer
CKX specifies the number of iterations through the streamline building loop between checks for
streamline crossover, that is, one streamline growing closer than a certain distance (as specified
by the parameter SSP) to previously created streamline. A negative value of CKX causes Streamlines
to check for crossover only when a new grid box is entered. At each crossover check, the current
streamline position is compared with a sampling of previous streamline positions retained in an
internal circular list. This list is currently fixed to a length of 750. Since up to this number
of comparisons are performed at each crossover check, the frequency with which these checks are
performed can have a noticeable impact on performance. By default, CKX has the value -99, causing
Streamlines to check for crossover only on entrance to a new grid box.
CYK - Cyclical Data Flag - Integer
Use this parameter to specify that the data in the vector field arrays is cyclical: that is, it
repeats with a period of M-1 (M, the input parameter to STINIT) along the first dimensional axis.
If the flag is set on, Streamlines checks to see if the field data meet certain criteria. If they
do, an internal cyclical flag is set, causing the normalized vector interpolation routines to
consider data from the opposite ends of the dataset when interpolating near the first dimensional
dataset boundaries. If the criteria are not met, Streamlines sets an error flag, retrievable by
the user through the parameter ERR. Processing, however, continues without interruption, except
that Streamlines now interpolates (as it would ordinarily) near the first dimensional end points
without consideration of data at the opposite end. The data must pass the following test in order
to be deemed cyclical: for each subscript value along the second dimensional axis, the first
element and the last element along the first dimensional axis must be identical. A value of 0 for
CYK means that the data is to be considered non-cyclical; any other value means that Streamlines
should test for the cyclical condition. You must initialize Streamlines with a call to STINIT
after modifying this parameter. The default value of CYK is 0.
CPM - Compatibility Mode - Integer
Controls the degree of compatibility between versions of the Streamlines utility prior to NCAR
Graphics 3.2 and the current version. You can independently control three behaviors using the nine
settings provided:
• use of STRMLN input parameters;
• use of variables contained in the common blocks STR02 and STR03;
• use of the old coordinate mapping routines, FX and FY.
Note, however, that when using the Version 3.2 entry points STINIT and STREAM, only the third
behavior option has any meaning.
When CPM is set to 0, its default value, the Streamlines utility´s behavior varies depending on
whether you access it through one of the pre-Version 3.2 entry points (STRMLN and EZSTRM), or
through the STINIT/STREAM interface. Otherwise, positive values result in invocation of the older
coordinate mapping routines (FX and FY). Negative values cause the Version 3.2 mapping routines to
be used instead. When using the pre-Version 3.2 interface only, odd values of CPM cause the data
values in the common blocks, STR02 and STR03, to override corresponding values initialized in the
Version 3.2 STDATA block data subroutine, or set by the user calling STSETx routines. Values of
CPM with absolute value less than or equal to two cause the NSET argument to STRMLN to take
precedence over the SET parameter.
Here is a table of the nine settings of CPM and their effect on the operation of the Streamlines
utility:
Value Use FX and FY Use STR02,STR03 Use NSET
----- ------------- --------------- --------
-4 no no no
-3 no yes no
-2 no no yes
-1 no yes yes
0 old - yes;new - no (*) yes yes
1 yes yes yes
2 yes no yes
3 yes yes no
4 yes no no
(*) Old means EZSTRM or STRMLN entry point; new, STINIT/STREAM. Only the first column is
applicable to the behavior of the STINIT/STREAM interface. See the strmln man page for more
detailed emulation information.
DFM - Streamline Differential Magnitude
DFM specifies the length of the differential magnitude step size used by Streamlines. If the
parameter GBS is set to 0 DFM has units "fraction of viewport width"; if GBS is set to 1, DFM has
the units "fraction of grid box width". When the Version 3.2 mapping routines are used, DFM
directly affects processing time and the resulting plot precision. In general, smaller values of
DFM cause Streamlines to take more, smaller steps in the construction of a streamline, resulting,
within the limits of the processor´s floating point resolution, in longer execution times and a
more precise plot. Process memory requirements are not affected. If the compatibility mode
parameter is set such that the older mapping routines, FX and FY, are invoked instead, DFM no
longer has any effect on the plot, since in this case the step size is determined by the setting
of the parameter VNL as a fraction of the grid box width. The default value of DFM is 0.02 when
GBS has the value 0 and 0.33 when GBS has the value 1. Setting GBS causes DFM to be reset to its
appropriate default value.
GBS - Grid-Based Spacing - Real
The parameter GBS controls the interpretation of several parameters that play a critical role in
the appearance of the streamline plot. These parameters are DFM, SSP, and ARL. When GBS has the
value 0, the values of these parameters are treated as having units of "fraction of viewport
width". If GBS has the value 1, the values are treated as having the units of "fraction of grid
box width". Whenever you set GBS, the three affected parameters are reset to default values
appropriate to the units; therefore you must set GBS prior to setting any non-default values for
DFM, SSP, or ARL. You may find that using the grid-based spacing method causes Streamlines to
adapt more gracefully to variations in the density of the data grid. Currently, the default value
of GBS is 0; however, in the next release this may change.
LWD - Streamline Linewidth - Real
LWD controls the linewidth used to draw the streamlines. Note that since the linewidth in NCAR
Graphics is always calculated relative to a unit linewidth that is dependent on the output device,
you may need to adjust the linewidth value depending on the output conditions to obtain a pleasing
plot. LWD affects the linewidth of the directional arrowheads as well as the streamlines
themselves. The arrowhead length also increases somewhat when the linewidth is greater than the
default. However, the arrowhead length parameter still affects the length. The default is 1.0,
specifying a device-dependent minimum linewidth.
MAP - Map Transformation Code - Integer
MAP defines the mapping transformation between the data and user coordinate space. For more
information on coordinate mapping transformations see the stuixy, stumxy, and stumta man pages, as
well as the description of the transformation type parameter, TRT. Three MAP parameter codes are
reserved for pre-defined transformations, as follows:
Value Mapping transformation
0 (default) Identity transformation between data and user coordinates: array indices of U and V
are linearly related to user coordinates. Note however that a non-linear
transformation is still possible from user to NDC coordinates.
1 Ezmap transformation: first dimension indices of U and V are linearly related to
longitude; second dimension indices are linearly related to latitude.
2 Polar to rectangular transformation: first dimension indices of U and V are
linearly related to the radius; second dimension indices are linearly related to
the angle in degrees.
If MAP has any other value, Streamlines invokes the user-modifiable subroutines, STUMXY, STUIXY,
and STUMTA to perform the mapping. The default version of these routines simply performs an
identity mapping. Note that, while the Streamlines utility does not actually prohibit the
practice, you are advised not to use negative integers for user-defined mappings, since other
utilities in the NCAR Graphics toolkit attach a special meaning to negative mapping codes.
For all the predefined mappings, the linear relationship between the grid array indices and the
data coordinate system is established using the four parameters, XC1, XCM, YC1, and YCN. The X
parameters define a mapping for the first and last indices of the first dimension of the data
arrays, and the Y parameters do the same for the second dimension. If MAP is set to a value of
one, you need to be careful to ensure that the SET parameter is given a value of zero, since the
Ezmap routines require a specific user coordinate space for each projection type, and internally
call the SET routine to define the user to NDC mapping. Otherwise, you may choose whether or not
to issue a SET call prior to calling STINIT, modifying the value of SET as required. See the
description of the parameter, TRT, and the man pages, stumxy, stuixy, and stumta for more
information.
MSK - Mask To Area Map Flag - Integer
Use this parameter to control masking of streamlines to an existing area map created by routines
in the Areas utility. When MSK is greater than 0, masking is enabled and an area map must be set
up before calling STREAM. The area map array and, in addition, the name of a user-definable masked
drawing routine, must be passed as input parameters to STREAM. There are two states for the MSK
parameter, as follows:
Value Effect
<= 0 (default) No streamline masking.
>0 The subroutine ARDRLN is called internally to decompose the streamlines into
segments contained entirely within a single area group. ARDRLN calls the user-
definable masked drawing subroutine.
See the man page, stumsl, for further information on the user-definable masked drawing subroutine.
PLR - Polar Input Mode - Integer
When PLR is greater than zero, the vector component arrays are considered to contain the field
data in polar coordinate form: the U array is treated as containing the vector magnitude and the V
array as containing the vector angle. Be careful not to confuse the PLR parameter with the MAP
parameter polar coordinate mode. The MAP parameter relates to the location of the vector, not its
value. Here is a table of values for PLR:
Value Meaning
0 (default) U and V arrays contain data in cartesian component form.
1 U array contains vector magnitudes; V array contains vector angles in degrees.
2 U array contain vector magnitudes; V array contains vector angles in radians.
You must initialize Streamlines with a call to STINIT after modifying this parameter.
SET - SET Call Flag - Integer
Give SET the value 0 to inhibit the SET call STINIT performs by default. Arguments 5-8 of a SET
call made by the user must be consistent with the ranges of the user coordinates expected by
Streamlines. This is determined by the mapping from grid to data coordinates as specified by the
values of the parameters XC1, XCM, YC1, YCN, and also by the mapping from data to user coordinates
established by the MAP parameter. You must initialize Streamlines with a call to STINIT after
modifying this parameter. The default value of SET is 1.
SGD - Stream Starting Grid Increment - Integer
This parameter gives you a degree of control over the number and density of streamlines in the
field flow plot. The Streamlines utility never begins a streamline in any grid box that has
previously had a streamline pass through it, where a grid box is defined as the space between
adjacent integer grid coordinates in the grid coordinate system along both dimensions. By setting
SGD to a value greater than 1, you can reduce the number of grid boxes initially eligible for
starting a streamline. A grid box is considered initially eligible for starting a streamline only
if both the lesser indices that establish the grid box, modulo the value of SGD, equal 0. If SGD
is set to 2, for instance, every grid box with even-numbered lower grid indices would be initially
eligible for starting a streamline. As the streamlines grow and pass through grid boxes that were
initially eligible, these boxes too are marked ineligible, further reducing the boxes where a
stream can be started.
If the transformation pipeline is everywhere linear from grid coordinate space to NDC space, then
this scheme for starting streamlines usually produces a more or less uniform spacing of the
streamlines over the field flow plot. However, if there are non-linear transforms anywhere in the
pipeline, the streamlines will probably be more crowded in some areas than in others. Future
enhancements to the Streamlines utility are expected to address this issue, and also perhaps to
provide options for intentional non-uniform spacing based on flow intensity. The default value of
SGD is 2.
SSP - Streamline Spacing Value - Real
The streamline spacing parameter establishes the minimum distance a streamline in progress is
allowed to approach existing streamlines before being terminated. If the parameter GBS is set to
0, SSP has units "fraction of viewport width"; if GBS is set to 1, SSP has the units "fraction of
grid box width". In general, within either system of units, larger values of SSP increase the
distance between streamlines, and have a tendency to create more, but shorter stream lines. The
spacing is only checked at intervals, so streamlines sometimes approach closer than the specified
distance. The checking frequency is adjustable using the streamline crossover checking parameter,
CKX. The streamline starting grid increment parameter, SGD, also affects the overall streamline
density. The default value of SSP is 0.015 when GBS has the value 0 and 0.5 when GBS has the value
1. Setting GBS causes SSP to be reset to its appropriate default value.
SST - Streamline Statistics Output Flag - Integer
If SST is set to one, STREAM writes a summary of its operations to the default logical output
unit, including the number of streamlines plotted and the total differential step count. Here is a
sample of the output:
STREAM Statistics
Streamlines plotted: 119
Total differential step count: 2903
The differential step count actually counts the number of iterations through the main streamline
construction loop, and can be used to help gauge the trade-offs between the increased processing
time required for smaller differential step sizes and the resulting differences in plot quality.
SVF - Special Value Flag - Integer
The special value flag controls special value processing for the U and V vector component data
arrays. Special values may appear in either the U or V array or in both of them. When any of the
four points surrounding the current streamline end contain a special value, the streamline is
terminated, and a new one started, if possible. Streamlines allows special value processing to be
turned on or off, as follows:
Value Effect
0 (default) Neither the U nor the V array is examined for special values
non 0 Whenever the streamline under construction enters a new grid box, the U and V array
values at each corner of the box are examined for special values. The interpolation
method parameter, TRP, is overridden, causing Streamlines to use bi-linear
interpolation only.
The U and V special values are defined by setting parameters USV and VSV. Streamlines only uses
bi-linear interpolation when special value processing is in effect, because the Bessel
interpolation method quadruples the requirement for good data points (from 4 to 16) surrounding
the current stream end point. You must initialize Streamlines with a call to STINIT after
modifying this parameter.
TRP - Interpolation Method - Integer
Use TRP to control which of two interpolation methods Streamlines should use in determining the
normalized flow components for each point in the streamline. The choices are as follows:
Value Interpolation Method
0 (default) Use the 16-point Bessel interpolation method where possible; otherwise, near the
data set boundaries use 12, 9 or 4 point interpolation methods, depending on the
situation.
non 0 Use 4-point bi-linear interpolation at all points.
Note that Streamlines forces use of the 4-point bi-linear interpolation method if the SVF
parameter is set to turn on special value processing.
TRT - Transformation Type - Integer
The transformation type parameter, TRT, qualifies the mapping transformation specified by the MAP
parameters, as follows:
Value Effect
-1 Direction, magnitude, and location are all transformed. This option is not
currently supported by any of the pre-defined coordinate system mappings.
0 Only location is transformed
1 (default) Direction and location are transformed
This parameter allows you to distinguish between a system that provides a mapping of location only
into an essentially cartesian space, and one in which the space itself mapped. To understand the
difference, using polar coordinates as an example, imagine a set of wind speed monitoring units
located on a radial grid around some central point such as an airport control tower. Each unit´s
position is defined in terms of its distance from the tower and its angular direction from due
east. However, the data collected by each monitoring unit is represented as conventional eastward
and northward wind components. Assuming the towers´s location is at a moderate latitude, and the
monitoring units are reasonably ´local´, this is an example of mapping a radially defined location
into a nearly cartesian space (i.e. if the northward components were all set to 0.0, the
streamlines defined by the eastward components would all be parallel straight lines. One would
set MAP to two (for the polar transformation) and TRT to zero to model this data on a plot
generated by the Streamlines utility.
On the other hand, picture a set of wind data, again given as eastward and northward wind
components, but this time the center of the polar map is actually one of the earth´s poles. In
this case, the eastward components do not point in a single direction; instead they outline a
series of concentric circles around the pole. This is a space mapping transformation: one would
again set MAP to two, but TRT would be set to one to transform both direction and location.
Changing the setting of this parameter affects the end results only when a non-uniform non-linear
mapping occurs at some point in the transformation pipeline. For this discussion a uniform linear
transformation is defined as one which satisfies the following equations:
x_out = x_offset + scale_constant * x_in
y_out = y_offset + scale_constant * y_in
If scale_constant is not the same for both equations then the mapping is non-uniform.
This option is currently implemented only for the pre-defined MAP parameter codes, 0 and 2, the
identity mapping and the polar coordinate mapping. However, it operates on a different stage of
the transformation pipeline in each case. The polar mapping is non-linear from data to user
coordinates. The identity mapping, even though necessarily linear over the data to user space
mapping, can have a non-uniform mapping from user to NDC space, depending on the values given to
the input parameters of the SET call. This will be the case whenever the LL input parameter
specifies a logarithmic scaling or the viewport and the user coordinate boundaries do not have the
same aspect ratio. Thus for a MAP value of 2, TRT affects the mapping between data and user space,
whereas for MAP set to 0, TRT influences the mapping between user and NDC space.
USV - U Array Special Value - Real
USV is the U vector component array special value. It is a value outside the range of the normal
data used to indicate that there is no valid data for this grid location. When the special value
flag parameter, SVF, is non-zero, each time a streamline enters a new cell Streamlines will check
for this special value in the U array at each of the four corners of the grid box. Anytime the
special value is discovered, the current streamline is terminated and a new one started if
possible. The default value given to USV is 1.0 * 10**12.
VNL - Vector Normalization Value - Real
The parameter, VNL, determines the value Streamlines uses to normalize the vector flow field,
before beginning the streamline construction loop. When Streamlines is used with the pre-Version
3.2 mapping routines, FX and FY, the value of VNL determines the step size in the grid coordinate
system used to construct the streamlines, as a fraction of the grid box size. When using FX and
FY, smaller values of VNL result in smaller steps, more processing time and, within the limits of
the processor´s floating point accuracy, a higher precision plot. However, if the mapping has non-
linearities, the grid size does not remain constant over the transformation and the step size can
vary greatly, resulting in discontinuities in certain areas of the plot.
Streamline´s new mapping routines define the streamline differential magnitude in NDC space,
ensuring a constant step size over the whole plot, notwithstanding any non-linearity in the
transformation. When using the new mapping routines, the parameter DFM controls the step size in
NDC space, and VNL is not adjustable by the user. (See the discussion of the compatibility mode
parameter, CPM, for a discussion of how to switch between the old and new mapping routines.) The
default value of VNL is 0.33.
VPB - Viewport Bottom - Real
The parameter VPB has an effect only when SET is non-zero, specifying that Streamlines should do
the call to SET. It defines a minimum boundary value for the bottom edge of the viewport in NDC
space, and is constrained to a value between 0.0 and 1.0. It must be less than the value of the
Viewport Top parameter, VPT. The actual value of the viewport bottom edge used in the plot may be
greater than the value of VPB, depending on the setting of the Viewport Shape parameter, VPS. You
must initialize Streamlines with a call to STINIT after modifying this parameter. The default
value of VPB is 0.05.
VPL - Viewport Left - Real
The parameter VPL has an effect only when SET is non-zero, specifying that Streamlines should do
the call to SET. It defines a minimum boundary value for the left edge of the viewport in NDC
space, and is constrained to a value between 0.0 and 1.0. It must be less than the value of the
Viewport Right parameter, VPR. The actual value of the viewport left edge used in the plot may be
greater than the value of VPL, depending on the setting of the Viewport Shape parameter, VPS. You
must initialize Streamlines with a call to STINIT after modifying this parameter. The default
value of VPL is 0.05.
VPR - Viewport Right - Real
The parameter VPR has an effect only when SET is non-zero, specifying that Streamlines should do
the call to SET. It defines a maximum boundary value for the right edge of the viewport in NDC
space, and is constrained to a value between 0.0 and 1.0. It must be greater than the value of the
Viewport Left parameter, VPL. The actual value of the viewport right edge used in the plot may be
less than the value of VPR, depending on the setting of the Viewport Shape parameter, VPS. You
must initialize Streamlines with a call to STINIT after modifying this parameter. The default
value of VPR is 0.95.
VPS - Viewport Shape - Real
The parameter VPS has an effect only when SET is non-zero, specifying that Streamlines should do
the call to SET; it defines the desired viewport shape, as follows:
Value Effect
<0.0 The absolute value of VPS specifies the shape to use for the viewport, as the ratio
of the viewport width to its height,
0.0 The viewport completely fills the area defined by the boundaries specifiers, VPL,
VPR, VPB, VPT
>0.0,<1.0 (0.25,default)
Use R = (XCM-XC1)/(YCN-YC1) as the viewport shape if MIN(R, 1.0/R) is greater than
VPS. Otherwise determine the shape as when VPS is equal to 0.0.
>= 1.0 Use R = (XCM-XC1)/(YCN-YC1) as the viewport shape if MAX(R, 1.0/R) is less than
VPS. Otherwise make the viewport a square.
The viewport, whatever its final shape, is centered in, and made as large as possible in, the area
specified by the parameters VPB, VPL, VPR, and VPT. You must initialize Streamlines with a call to
STINIT after modifying this parameter.
VPT - Viewport Top - Real
The parameter VPT has an effect only when SET is non-zero, specifying that Streamlines should do
the call to SET. It defines a maximum boundary value for the top edge of the viewport in NDC
space, and is constrained to a value between 0.0 and 1.0. It must be greater than the value of the
Viewport Bottom parameter, VPB. The actual value of the viewport top edge used in the plot may be
less than the value of VPT, depending on the setting of the Viewport Shape parameter, VPS. You
must initialize Streamlines with a call to STINIT after modifying this parameter. The default
value of VPT is 0.95.
VSV - V Array Special Value - Real
VSV is the V vector component array special value. It is a value outside the range of the normal
data used to indicate that there is no valid data for this grid location. When the special value
flag parameter, SVF, is non-zero, each time a streamline enters a new cell Streamlines will check
for this special value in the V array at each of the four corners of the grid box. Anytime the
special value is discovered, the current streamline is terminated and a new one started if
possible. You must initialize Streamlines with a call to STINIT after modifying this parameter.
The default value given to VSV is 1.0 * 10**12.
WDB - Window Bottom - Real
When STINIT does the call to SET, the parameter WDB is used to determine argument number 7, the
user Y coordinate at the bottom of the window. If WDB is not equal to WDT, WDB is used. If WDB is
equal to WDT, but YC1 is not equal to YCN, then YC1 is used. Otherwise, the value 1.0 is used.
You must initialize Streamlines with a call to STINIT after modifying this parameter. The default
value of WDB is 0.0.
WDL - Window Left - Real
When STINIT the call to SET, the parameter WDL is used to determine argument number 5, the user X
coordinate at the left edge of the window. If WDL is not equal to WDR, WDL is used. If WDL is
equal to WDR, but XC1 is not equal to XCM, then XC1 is used. Otherwise, the value 1.0 is used. You
must initialize Streamlines with a call to STINIT after modifying this parameter. The default
value of WDL is 0.0.
WDR - Window Right - Real
When STINIT does the call to SET, the parameter WDR is used to determine argument number 6, the
user X coordinate at the right edge of the window. If WDR is not equal to WDL, WDR is used. If WDR
is equal to WDL, but XCM is not equal to XC1, then XCM is used. Otherwise, the value of the
STINIT input parameter, M, converted to a real, is used. You must initialize Streamlines with a
call to STINIT after modifying this parameter. The default value of WDR is 0.0.
WDT - Window Top - Real
When STINIT does the call to SET, the parameter WDB is used to determine argument number 8, the
user Y coordinate at the top of the window. If WDT is not equal to WDB, WDT is used. If WDT is
equal to WDB, but YCN is not equal to YC1 then YCN is used. Otherwise, the value of the STINIT
input parameter, N, converted to a real, is used. You must initialize Streamlines with a call to
STINIT after modifying this parameter. The default value of WDT is 0.0.
XC1 - X Coordinate at Index 1 - Real
The parameter XC1 specifies the X coordinate value that corresponds to a value of 1 for the first
subscript of the U and V, vector field component arrays. Together with XCM, YC1, and YCN it
establishes the mapping from grid coordinate space to data coordinate space. If XC1 is equal to
XCM, 1.0 will be used. You must initialize Streamlines with a call to STINIT after modifying this
parameter. The default value of XC1 is 0.0.
XCM - X Coordinate at Index M - Real
The parameter XCM specifies the X coordinate value that corresponds to the value of the STINIT
input parameter, M, for the first subscript of the U and V vector component arrays. Together with
XC1, YC1, and YCN it establishes the mapping from grid coordinate space to data coordinate space.
If XC1 is equal to XCM, the value of M, converted to a real, will be used. You must initialize
Streamlines with a call to STINIT after modifying this parameter. The default value of XCM is 0.0
YC1 - Y Coordinate at Index 1 - Real
The parameter YC1 specifies the Y coordinate value that corresponds to a value of 1 for the first
subscript of the U, V, vector component arrays as well as for the P scalar data array, if used.
Together with YCN, XC1, and XCM it establishes the mapping from grid coordinate space to data
coordinate space. If YC1 is equal to YCN, 1.0 will be used. You must initialize Streamlines with
a call to STINIT after modifying this parameter. The default value of YC1 is 0.0
YCN - Y Coordinate at Index N - Real
The parameter YCN specifies the Y coordinate value that corresponds to the value of the STINIT
input parameter, N, for the second subscript of the U and V vector component arrays as well as the
P scalar data array, if used. Together with YC1, XC1, and XCM it establishes the mapping from
grid coordinate space to data coordinate space. If YC1 is equal to YCN, the value of N, converted
to a real, will be used. You must initialize Streamlines with a call to STINIT after modifying
this parameter. The default value of YCN is 0.0
ZFC - Zero Field Text Block Color - Integer
If ZFC is greater or equal to zero, it specifies the GKS color index to use to color the Zero
Field text block. Otherwise the Zero Field text block is colored using the current GKS text color
index. The default value of ZFC is -1.
ZFP - Zero Field Text Block Positioning Mode - Integer
The ZFP parameter allows you to justify, using any of the 9 standard justification modes, the Zero
Field text block unit with respect to the position established by the parameters, ZFX and ZFY The
position modes are supported as follows:
Mode Justification
-4 The lower left corner of the text block is positioned at ZFX, ZFY.
-3 The center of the bottom edge is positioned at ZFX, ZFY.
-2 The lower right corner is positioned at ZFX, ZFY.
-1 The center of the left edge is positioned at ZFX, ZFY.
0 (default) The text block is centered along both axes at ZFX, ZFY.
1 The center of the right edge is positioned at ZFX, ZFY.
2 The top left corner is positioned at ZFX, ZFY.
3 The center of the top edge is positioned at ZFX, ZFY.
4 The top right corner is positioned at ZFX, ZFY.
ZFS - Zero Field Text Block Character Size - Real
ZFS specifies the size of the characters used in the Zero Field graphics text block as a fraction
of the viewport width. The default value is 0.033.
ZFT - Zero Field Text String - Character* 36
Use ZFT to modify the text of the Zero Field text block. The Zero Field text block may appear
whenever the U and V vector component arrays contain data such that all the grid points otherwise
eligible for plotting contain zero magnitude vectors. Currently the string length is limited to 36
characters. Set ZFT to a single space (´ ´) to prevent the text from being displayed. The default
value for the text is ´Zero Field´.
ZFX - Zero Field Text Block X Coordinate - Real
ZFX establishes the X coordinate of the Zero Field graphics text block as a fraction of the
viewport width. Values less than 0.0 or greater than 1.0 are permissible and respectively
represent regions to the left or right of the viewport. The actual position of the block relative
to ZFX depends on the value assigned to the Zero Field Positioning Mode parameter, ZFP. The
default value is 0.5.
ZFY - Zero Field Text Block Y Coordinate - Real
ZFY establishes the Y coordinate of the minimum vector graphics text block as a fraction of the
viewport height. Values less than 0.0 or greater than 1.0 are permissible and respectively
represent regions below and above the viewport. The actual position of the block relative to ZFY
depends on the value assigned to the Zero Field Positioning Mode parameter, ZFP. The default value
is 0.5.
SEE ALSO
Online: stgetc, stgeti, stgetr, stinit, stream, streamlines, strset, stsetc, stseti, stsetr, stuixy,
stumsl, stumta, stumxy, ncarg_cbind.
Hardcopy: NCAR Graphics Fundamentals, UNIX Version
COPYRIGHT
Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.
UNIX March 1995 Streamlines_params(3NCARG)