field 2d any coordinates, scalar, float (REQUIRED)
colormap (REQUIRED)
field 2d any coordinates, scalar, float (OPTIONAL)
colormap (OPTIONAL)
This is a modification of the field to contour
module by Wes Bethel.
Enhancements include:
1. Generating contours as polylines and not disjoint lines
for faster rendering;
2. Generating whole range of contours by a single module;
3. Generating surfaces (these produced by field_to_mesh
do not fit into dimensions, sometime);
4. Optional plane and/or 3D maps;
5. Second field and colormap input to color surfaces.
The 3D contour map routine creates contour map
of a given 2D scalar float field together (optionally)
with a surface equivalent to the surface generated by
the field to mesh routine.
The contour thresholds can be specified manually by
Levels, Level_0 and Delta or equally spaced between
min_val and max_val. When Nice_levels is on, levels
are rounded to the good values (multiplicities of
1, 2 or 5 and a decimal scaling factor).
For 2-space fields the z coordinate can be taken from
field values either original or normalized (min_val
mapped to 0 and max_val to the value of the Scale
parameter. In this case, min_val and max_val/Scale are
output for use in the 3D geom axes modules. Optionally,
together with the 3D surface and contour map, a plane
contour map can be created at the z=Z_offset plane.
When the second field is present, surfaces (both 3D and
and plane) can be colored by that field value.
The algorithm used is a subset of the more familiar 3d
marching cubes algorithm.
INPUTS
Data Field (required; field 2D scalar float any-coordinates)
AVS Colormap (required)
The color of the lines produced by this module is determined
by doing a lookup into the input colortable. The user specifies
the mapping from the field scalar space into colorspace through
the use of the colormap.
Second Data Field (optional; field 2D scalar float
any-coordinates must have the same indexing scheme
as the primary data field)
AVS Colormap (optional)
The color of the surfaces produced by this module is determined
by doing a lookup into the input colortable. The user specifies
the mapping from the field scalar space into colorspace through
the use of the colormap.
PARAMETERS
Levels computed (boolean)
Specifies when threshold levels shall be equally spaced betveen
minimal and maximal field data values.
Nice levels (boolean)
When specified, threshold levels interval is normalized to the
nearest "nice" number (1, 2, or 5 multiplied by decimal scale
factor). This usually leads to slight modification of the
Levels parameter.
Levels (integer)
This is the number of the contour levels to be created.
Level0 (float) (only when Levels_computed is off)
This floating point value indicates the starting threshold
level to use in generating contour lines.
Delta (float) (only when Levels_computed is off)
This floating point value indicates the threshold
level spacing.
Boundary on/off (boolean)
When on, a white boundary line is drawn along the map.
Z Coordinate Control (choice)
Used to select whether to set the output Z coordinates to
original or normalized values in the input field.
Z scale (float) (when Z Control is set to "z normalized")
Defines vertical scale of the map (as in the field to mesh
module)
Z offset (float) (when plane map is generated)
Defines location of the plane map.
Contour offset (float) (when surfaces are generated)
Controls offset of contours with respect to the surfaces
for better composite object rendering.
Output surface (tristate)
0 - no surface is drawn;
1 - white (uncolored) surface is drawn;
2 - colored surface is drawn.
Color contours (boolean)
Sometimes just white (or black) contours on colored
surface can be best solution.
Plane map (for 2-space input field)
0 - no plane map is drawn;
1 - contours and plane is drawn.
Color plane contours (boolean)
Self-explaining.
Color plane (boolean)
Self-explaining.
OUTPUTS
AVS geometry.
float val0
When z coordinate is set as normalized field data, this is
the value mapped to 0 (this is min field data)
float delta
When z coordinate is set as normalized field data, this is
the data interval mapped to 1.
(these outputs can be useful for remapping of the z axis generated
by some "geom axes" module).