*nodecreateatplanesintersection

Create nodes or points at locations of intersection between the input geometric entities and a plane or vector.

Syntax

*nodecreateatplanesintersection entity_type mark_id plane plane_use point_flag

Type

HyperMesh Tcl Modify

Description

This command creates nodes or points at locations of intersection between a selection of input geometries and a plane or vector.

If there is overlap (continuous intersection) between the entities, the result is undefined. For example, finding the intersection of a line that lies exactly on the specified plane is undefined and can return unexpected or varied results.

Inputs

entity_type
Type of input entities.
If plane_use is 0 (plane as input entity), then the only valid value is lines.
If plane_use is 1, 2 or 3 (vector as input entity), then valid values are lines, surfs, faces or solids.
mark_id
The ID of the mark of the first entity type. Valid values are 1 and 2.
plane
Input temporary plane ID (if plane_use is 0) created using *createplane or vector ID (plane_use is 1, 2 or 3) created using *createvector. This should always be set to 1.
plane_use
Parameter specifying whether input data specified by plane parameter is interpreted as a plane of vector. Valid values are:
0 – Input data specified by plane parameter is used as plane.
1 – Input data specified by plane parameter is used as undirected vector (straight line that passes through the base point specified by plane parameter in the direction of the normal specified by plane parameter).
2 – Input data specified by plane parameter is used as directed vector (ray that starts at base point specified by plane parameter and continues in the direction of normal specified by plane parameter).
3 – Input data specified by plane parameter is used as finite length vector (segment that starts at base point specified by plane parameter and ends at the end of normal vector specified by plane parameter).
point_flag
Parameter specifying whether nodes or points are created. Valid values are:
0 – Create nodes
1 – Create points

Examples

To create nodes at the intersections between the line with ID 12 and the plane z=2:

*createmark lines 1 12
*createplane 1 0.0 0.0 1.0 0.0 0.0 2.0
*nodecreateatplaneintersection lines 1 1 0 0

To create points at the intersection between surface 10 and a ray that starts at point (1, 2, 4) and propagates in the direction of y axis:

*createmark surfs 1 10
*createplane 1 0.0 1.0 0.0 1.0 2.0 4.0
*nodecreateatplaneintersection surfs 1 1 2 1

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:
if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

10.0