User's Reference - MapToPlane

### 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

[ OpenDX Home at IBM | OpenDX.org ]