CropLat3D

DESCRIPTION

This module takes a 1D curvilinear lattice (i.e. a list of points in 3D space) and two locations in 3D space and uses them as the lower (X Min, Y Min, Z Min) and upper (X Max, Y Max, Z Max) corners of a cuboid to crop the 3D lattice. It outputs the cropped lattice, and a cuboid for the cropped region.

The coordinates of the rectangle can be entered either via the widgets on the control panel, or as pick data (see below). Attempting to set X Min greater than X Max will result in X Min being set to X Max, and vice versa (similarly for Y and Z). In addition, inputted values which are outside the range of the coordinates of the input lattice will be clamped to this range.

INPUTS

Port: Lattice
Type: Lattice
Constraints: 1-D
Constraints: curvilinear
Constraints: 3-cD
The data lattice. It can have any primitive type, and contain any number of data variables. The cropping cuboid is set to the extent of the coordinates of the lattice whenever a new lattice is passed to the module.

Port: Pick
Type: Pick
Optional: This port is optional.
Input locations. The left mouse button is used to update one location and the middle button is used for the other. The module calculates the smaller of the two X locations and uses that for the minimum X coordinate of the cuboid, while the other X location is used for the maximum X coordinate. It deals with the Y and Z locations in a similar way.

WIDGETS

Port: Apply
Type: Button
Applies the currently selected region and uses it to crop the input lattice. No output lattice is produced until this button is pressed.

Port: X Min
Type: Text
The minimum X coordinate of the region, measured in the same units as the coordinates of the input lattice.

Port: Y Min
Type: Text
The minimum Y coordinate of the region, measured in the same units as the coordinates of the input lattice.

Port: Z Min
Type: Text
The minimum Z coordinate of the region, measured in the same units as the coordinates of the input lattice.

Port: X Max
Type: Text
The maximum X coordinate of the region, measured in the same units as the coordinates of the input lattice.

Port: Y Max
Type: Text
The maximim Y coordinate of the region, measured in the same units as the coordinates of the input lattice.

Port: Z Max
Type: Text
The maximum Z coordinate of the region, measured in the same units as the coordinates of the input lattice.

OUTPUTS

Port: Box
Type: Geometry
Geometry of the region.

Port: Cropped Lattice
Type: Lattice
Constraints: 1-D
Constraints: float
Constraints: curvilinear
Constraints: 3-cD
The output lattice.

KNOWN PROBLEMS

It is possible to select a region which contains no points from the input lattice. A warning appears when this is so.

SEE ALSO

CropLat2D, LimLat.
[Documentation Home]
© The Numerical Algorithms Group Ltd, Oxford UK. 2000