OpenDX - Documentation
Full Contents QuickStart Guide User's Guide User's Reference
Previous Page Next Page Table of Contents Partial Table of Contents Index Search

RubberSheet

Category

Realization

Function

Deforms a surface, using the data values of that surface.

Syntax


graph = RubberSheet(data, scale, min, max);

Inputs
Name Type Default Description
data scalar field none the field defining the surface to be deformed.
scale scalar input dependent displacement scaling
min scalar or field 0.0 offset to be applied to the surface data values
max scalar or field maximum data value value used for setting the maximum displacement

Outputs
Name Type Description
graph
scalar field the deformed field

Functional Details

This module takes a specified scalar surface or line field and displaces each point by an amount based on the data value at that point, as follows:

displacement = scale × (data - min)

(see parameter descriptions).

data

specifies the surface to be deformed.

scale

is the scale factor used in calculating the displacement.

If this parameter is not specified, the module provides a scale factor calculated as follows:

scale =  (0.1 * diagonal of data boundary box) ÷ (max - min)
If min is a field, the value used is the minimum data value of that field.

The resulting scale factor is attached to the output object as a "RubberSheet scale" attribute (which can be extracted with the Attribute module).

min

is the offset applied to the data values before they are scaled.

max

is used to determine a scale factor according to the formula shown above, if scale is not specified.

Notes:

  1. If the input data have no "normals" component (e.g., the output of Slab), the perpendicular to the first element is used as the displacement direction. In that case, for a positive scale factor and a positive data value, the surface is displaced in the direction given by the right-hand rule applied to the connections at the surface (i.e., with the thumb representing the direction of displacement and the fingers following the order of points in the connections).

  2. If the input does have a "normals" component, the displacement at the surface is determined by the dependencies of the data and of the normals:

  3. If the input data are 1- or 2-dimensional, an additional dimension is added in the resulting graph.

  4. If no colors are present, the module adds a default color.

  5. RubberSheet automatically adds shading to the output graph.

Components

Creates new "positions" and "connections" components. All other components, with the exception of "normals," are propagated to the output.

Example Visual Programs

AlternateVisualizations.net
RubberTube.net
ThunderGlyphSheet.net
UsingSwitchAndRoute.net
SIMPLE/Rubbersheet.net

See Also

 FaceNormals,  MapToPlane,  Normals,  Slab


Full Contents QuickStart Guide User's Guide User's Reference

[ OpenDX Home at IBM | OpenDX.org ]