cut


Synopsis

The cut module cuts a portion of a field on one side of the cutting plane.

Input Ports

in_field

Mesh [+ Node_Data] [+Cell_Data]

in_plane

cutting plane (2D uniform Mesh)

ui_parent

user interface parent object

 

Parameters

map components

UIoptionBoxLabel

maps selected node data components onto resulting mesh

map cell data

UIoptionBoxLabel

maps selected cell data components onto resulting mesh

Above

UItoggle

select side of the plane to cut off

plane distance

UIslider

moves cutting plane parallel to itself

 

Output Ports

out_fld

Mesh [+ Node_Data] [+Cell_Data]

out_obj

output renderable object

 

Description

cut allows you to divide a field into two pieces and output one of the pieces. You position an arbitrarily-oriented cutting plane within the field and then select which side of the cutting plane you wish to output. New data is generated every time the cutting plane moves.

Note: The cut module does not generate vertex normals by default.

Input Ports

in_field

The input must be a field with any type of 2D or 3D mesh and any type. It may optionally have node and/or cell data components.

in_plane

The cutting plane. This is generated by the plane object found in Geometries.FPlane. The plane object has its own Plane Transformation panel that controls plane rotation, translation, and scale, as well as controls to specify its size when it is connected to the default user interface object in the application in which the macro is instanced.

FPlane

Plane

ui_parent

A port for connecting to a user interface object that contains the macro's widgets. By default, it is connected to the default user interface object in the application in which the macro is instanced. (This default connection is not drawn.)

Parameters

map components

UIoptionBox. A selection to pick which components of in_field's node data (if present) to send to the output field. You can pick more than one or none. The default is the first (0th) component. If node data labels are present, they are displayed.

map cell data

UIoptionBox. A selection to pick which components of in_field's cell data (if present) to send to the output field. You can pick more than one or none. The default is the first (0th) component. If cell data labels are present, they are displayed.

Above

UItoggle. Selects whether the part of the mesh above (1) or below (0) the cutting plane is removed. Above is in the positive Z direction of the cutting plane.

plane distance

UIslider. A float slider that moves the plane through the field perpendicular to the plane. Though the Plane Transformation panel has X, Y, and Z transformation controls, it is usually easier to use plane's controls to orient and size the plane, but use this plane distance control to move the plane. cut generates output whenever the slice plane moves. The default distance is 0.0 and the range is the extents of the field.

Output Ports

out_fld

The output field contains a new mesh object that is the subset of the original mesh. It has the same type as the input mesh. It may have node and/or cell data containing the selected components. Its extents are set to retain the position of the cut section of the field in space.

out_obj

This is a renderable version of the output field.

Example

Libraries.Examples.Vizualization.Cut
examples/cut.v

File

v/modules.v