MapToPlane

Category

Realization

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

Outputs

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:

1. 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.

2. 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.

3. 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

See Also

 AutoColor,  Map,  Remove,  RubberSheet,  Shade,  Slab