NAME 3D contour map SUMMARY Name 3D contour map Type mapper Inputs field 2d any coordinates, scalar, float (REQUIRED) colormap (REQUIRED) field 2d any coordinates, scalar, float (OPTIONAL) colormap (OPTIONAL) Outputs geometry float float Parameters Name Type Default Min Max Levels computed boolean 1 Nice levels boolean 1 Levels integer 10 1 100 Level 0 float 0.0 unbounded Delta float 0.0 unbounded Boundary on/off boolean 1 Plane map tristate 0 2D Z coord control choice z normalized z normalized, z=field data Z scale float 0.0 unbounded Z offset float 0.0 unbounded contour offset 0.01 -0.1 0.1 Output surface tristate 0 Color contours boolean 1 Plane map boolean 0 Color plane contours boolean 1 Color plane boolean 1 Label height float 0.01 0 0.5 Labelled levels integer 0 0 100 DESCRIPTION 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). EXAMPLE generate colormap read field (read the bluntfin dataset) | | | orthogonal slicer | | | +------------+ | | 3D contour map | | |-----------+ | | | | 3D geom axes | | | +--------------+ | geometry viewer RELATED MODULES 3D geom axes AUTHOR Chris S. Nowinski Inst. of Applied Mathematics, Warsaw University - based on the work of Wes Bethel, Lawrence Berkeley Laboratory