IntersectPlane

Intersect an imported 3D mesh with a plane. The operation will partition geometric entities and intersect mesh entities to introduce planar intersections. Supported entities are unmeshed domains, boundaries, and edges. Meshed faces are created within the intersection edges if the edges form closed loops.

Syntax

model.component(<ctag>).mesh(<tag>).create(<ftag>,"IntersectPlane");

model.component(<ctag>).mesh(<tag>).feature(<ftag>).selection();

model.component(<ctag>).mesh(<tag>).feature(<ftag>).selection(property);

model.component(<ctag>).mesh(<tag>).feature(<ftag>).set(property,<value>);

model.component(<ctag>).mesh(<tag>).feature(<ftag>).getType(property);

Description

Use model.component(<ctag>).mesh(<tag>).create(<ftag>,"IntersectPlane") to partition geometric entities and mesh elements of an imported 3D mesh by specifying a plane.

The following properties are available:

Table 4-7: Available Properties
Property	Value	Default	Description
planetype	quick \| faceparallel \| edgeparalle \| normalvector \| vertices \| coordinates	quick	How the plane is specified
additionalplane	on \| off	off	Specify if to add additional parallel planes
planedistance	double[]		Sequence of numbers specifying desired offsets of additional planes. Both positive and negative values are allowed.
reversedistance	on \| off	off	Generate the additional planes in the opposite direction
createface	on \| off	on	Generate faces for closed loops in the intersection
toltype	auto \| relative \| absolute	auto	How snapping tolerance is specified.
abstol	double		Absolute point snapping tolerance, if toltype is absolute.
reltol	double	0.01	Relative point snapping tolerance, if toltype is relative.
cleanup	on \| off	on	Cleanup of resulting mesh by collapsing mesh edges within specified toltype tolerance.

Quick

This defines a plane parallel to one of the global coordinate planes.

Table 4-8: Valid Properties, Quick
Property	Value	Default	Description
quickplane	xy \| yz \| zx \| yx \| zy \| xz	xy	Specify which coordinate plane to use.
quickx	double	0	x-coordinate for plane (used when plane is yz or zy).
quicky	double	0	y-coordinate for plane (used when plane is xz or zx).
quickz	double	0	z-coordinate for plane (used when plane is xy or yx).
quickoffsettype	distance \| vertex	distance	Type of offset specification.
offsetvertex	Selection		Specify vertex when quickoffsettype is vertex.

Face Parallel

This specifies a plane that is parallel to a planar face in a mesh.

Table 4-9: Valid Properties, Face Parallel
Property	Value	Default	Description
face	Selection		Planar face selection.
offset	double	0	Specify offset in the normal direction of plane.
reverse	on \| off	off	Reverse normal direction of plane.
offsettype	distance \| vertex	distance	Type of offset specification.
offsetvertex	Selection		Specify vertex when offsettype is vertex.

Edge Parallel

This defines a plane that is parallel to a planar edge in a mesh.

Table 4-10: Valid Properties, Face Parallel
Property	Value	Default	Description
planaredge	Selection		Planar edge selection.
offset	double	0	Specify offset in the normal direction of plane.
reverse	on \| off	off	Reverse normal direction of plane.
offsettype	distance \| vertex	distance	Type of offset specification.
offsetvertex	Selection		Specify vertex when offsettype is vertex.

Normal Vector

This specifies a plane defined by a normal vector and a point on the plane.

Table 4-11: Valid Properties, Circle Perpendicular
Property	Value	Default	Description
normalvector	double[3]	{0,0,1}	Normal vector specification.
normalpoint	coord \| vertex	coord	Point on plane (defined using coordinates or as a geometry vertex).
normalcoord	double[3]	{0,0,1}	Coordinates of point, used when normalpoint is set to coord.
normalvertex	Selection		Vertex for point, used when normalpoint is set to vertex.

Vertices

This creates a plane parallel to a plane through three vertices v1, v2, and v3.

Table 4-12: Valid Properties, Vertices
Property	Value	Default	Description
vertex1	Selection		Specification of first vertex.
vertex2	Selection		Specification of second vertex.
vertex3	Selection		Specification of third vertex.
offset	double	0	Specify offset in the normal direction of plane.
reverse	on \| off	off	Reverse normal direction of plane.

Coordinates

This creates a plane through three points p1, p2, and p3.

Table 4-13: Valid Property, Coordinates
Property	Value	Default	Description
genpoints	double[3][3]	{{0,0,0},{1,0,0},{0,1,0}}	Specification of points.

genpoints[n][i] is the ith coordinate of the nth point.