Set options for stream ribbons.
Synopsis:
ribbon
option=value [,option=value, ...]
Arguments:
option
A plot option for the ribbon plot. See table below.
value
A value associated with the matching
option
. See table below.
Option
|
Value
|
Value Meaning
|
Default Value
|
err
|
real number
>= 0.0
|
A scaled error value. An error of 0.01 means that variations on the order of 1/100 the size of the mesh are filtered out through line reduction. 0.0 indicates no filtering is done.
|
0.0
|
density
|
positive real number
|
The stream density. This is a scaled parameter. It relates to the "seed point density per unit area"; however, it is scaled such that a density of 1 results in approximately 200 streams. This is so the results are the same whether the mesh is defined in cm, mm, or any other scale.
|
1.0
|
legend
|
on, off
|
Whether or not a legend should be displayed with the plot.
|
on
|
maxsteps
|
positive integer
|
Number of integration steps taken per stream.
|
50
|
method
|
euler
rk2
rk4
eulera
rk2a
rk4a
|
Integration method for computing streams.
1st order Euler integration
2nd order Runge Kutta
4th order Runge Kutta
adaptive step 1st order
adaptive step 2nd order
adaptive step 4th order
|
rk2
|
numpoints
|
positive integer
|
The number of streamlines to generate for each seed point. Two streamlines will result in a ribbon, while more than two will result in a tube.
|
2
|
pop
|
pop
|
off
|
step
|
real number
>= 0.0
|
Integration step size. This parameter is scaled according to the size of the mesh compared to the magnitudes of the vectors to allow the step size to give similar quality results in a wide variety of meshes. If using an adaptive method, the specified step is used only as an initial value and will be adjusted according to the curvature of the flow at each point.
|
0.1
|
var
|
variable name
|
Name of the vector variable. The variable defines pseudocoloring as well. A 4d vector is interpreted as {x_component, y_component, z_component, colorvar}.
|
velocity
|
Description:
Ribbons are an extension of streams for 3D meshes. Ribbons are generated by meshing a surface between multiple streamlines which are seeded near each other. This depicts the flow through a 3D problem.
Examples:
ribbon numpoints=3, method="rk2a", maxsteps=40
See Also:
pop
,
stream