IBM Visualization Data Explorer User's Reference

MapToPlane

Category

Function

Maps a 3-dimensional field onto a plane.

Syntax


plane = MapToPlane(data, point, normal);

Inputs

Name Type Default Description
data field none data to be mapped
point vector center of object a point on the map plane
normal vector [0 0 1] normal to the map plane

Name	Type	Default	Description
`data`	field	none	data to be mapped
`point`	vector	center of object	a point on the map plane
`normal`	vector	[0 0 1]	normal to the map plane

Outputs

Name Type Description
plane field mapped plane

Name	Type	Description
`plane`	field	mapped plane

Functional Details

This module creates an arbitrary cutting plane through 3-dimensional space and interpolates data values onto it.

data
must be a field with 3-dimensional connections (i.e., cubes or tetrahedra).
point
is a vector value specifying a point on the cutting plane. If this parameter is not specified, Data Explorer uses the center of the bounding box of data.
normal
is a vector value specifying the normal to the map plane and is interpreted as the end point of a vector from the origin (not from point). The parameter defaults to [0 0 1].

Notes:

To create a plane parallel to one of the axes along a connections boundary (for regular data) it is more efficient to use the Slab module with zero thickness, because it performs no interpolation.
MapToPlane (unlike Slab) adds a "normals" component to the plane, so that the result is shaded. To eliminate the shading, remove the "normals" component with the Remove module or turn off the shading with the Shade module.
If the specified plane is precisely at the edge of the data, the output may or may not appear, depending on the direction of normal.

Components

Creates new "positions," "connections," and "normals" components. New "components" of all other input components are created (e.g., the "data" component) and contain values interpolated from the originals.

Example Visual Programs

AlternateVisualizations.net
ContoursAndCaption.net
ThunderGlyphSheet.net
SIMPLE/MapToPlane.net

[Data Explorer Home Page | Contact Data Explorer | Same document on Data Explorer Home Page ]

[IBM Home Page | Order | Search | Contact IBM | Legal ]

`data`	must be a field with 3-dimensional connections (i.e., cubes or tetrahedra).
`point`	is a vector value specifying a point on the cutting plane. If this parameter is not specified, Data Explorer uses the center of the bounding box of `data`.
`normal`	is a vector value specifying the normal to the map plane and is interpreted as the end point of a vector from the origin (not from `point`). The parameter defaults to [0 0 1].