TCL Command BOOLEAN

Syntax

BOOLEAN arg1 arg2 arg3 arg4 arg5 arg6 arg7 arg8 arg9 arg10 arg11 arg12

Description

A Boolean operation is applied to the component geometry. If necessary, an external component (BODY) is accessed in order to combine both geometries.

Arguments

Minimum number: 3

arg1

Value	unit	Meaning
UNION	KEYWORD	Union with an external component (2nd operand)
SUBTRACT	KEYWORD	Subtraction of an external component (2nd operand) or removal of a partial body by using a defined plane (2nd operand)
DISTINCT	KEYWORD	A body is added to the container. No union function is performed, thus saving computing time.

arg2 (arg1 = UNION)

Value	unit	Meaning
BODY	KEYWORD	The external component (2nd operand) follows as the next argument.

arg3 (arg2 = BODY)

Value	unit	Meaning
bname	TEXT	Name of the external component (2nd operand)

arg2 (arg1 = SUBTRACT)

Value	unit	Meaning
BODY	KEYWORD	The external component (2nd operand) follows as the next argument.
HPLANE	KEYWORD	A plane, given as a Hesse normal form, intersects the solid and the part on the positive side of the plane (positive normal direction) is removed.
PPLANE	KEYWORD	A plane, given by 3 global points, intersects the solid and the part on the positive side of the plane (positive normal direction) is removed.
DPLANE	KEYWORD	A plane, given by 3 connection points, intersects the solid and the part on the positive side of the plane (positive normal direction) is removed.

arg3 (arg2 = BODY)

Value	unit	Meaning
bname	TEXT	Name of the external component (2nd operand). The geometry of the 2nd operand is subtracted.

arg3 - arg6 (arg2 = HPLANE)

Value	unit	Meaning
nx	DOUBLE	X-component of the plane’s normal vector
ny	DOUBLE	Y-component of the plane’s normal vector
nz	DOUBLE	Z-component of the plane’s normal vector
d	LSTRUCTD	Space between the plane and the global origin

arg3 - arg11 (arg2 = PPLANE)

Value	unit	Meaning
ox	LSTRUCTD	Global X-component of a point O of the plane
oy	LSTRUCTD	Global Y-component of a point O of the plane
oz	LSTRUCTD	Global Z-component of a point O of the plane
p1x	LSTRUCTD	Global X-component of a point P1 on the plane, 1st vector of the plane: P1 - O
p1y	LSTRUCTD	Global Y-component of a point P1 on the plane, 1st vector of the plane: P1 - O
p1z	LSTRUCTD	Global Z-component of a point P1 on the plane, 1st vector of the plane: P1 - O
p2x	LSTRUCTD	Global X-component of a point P2 on the plane, 2nd vector of the plane: P2 - O
p2y	LSTRUCTD	Global Y-component of a point P2 on the plane, 2nd vector of the plane: P2 - O
p2z	LSTRUCTD	Global Z-component of a point P2 on the plane, 2nd vector of the plane: P2 - O

arg3 - arg5 (arg2 = DPLANE)

Value	unit	Meaning
dpname1	TEXT	Name of connection point P1, 1st point of the plane
dpname2	TEXT	Name of connection point P2, 2nd point of the plane, 2nd vector of the plane: P2 - P1
dpname3	TEXT	Name of connection point P3, 3rd point of the plane, 2nd vector of the plane: P3 - P1

arg? (The argument below can be attached depending on the operation selected).

Value	unit	Meaning
TEMPLATE	KEYWORD	The Boolean operation is determined by the referenced template and is inherited.
FEMDEPTH	KEYWORD	Specification of the model depth to which the body is assigned. The next argument is an integer.

arg-i (argi-1 = FEMDEPTH)

Value	unit	Meaning
idepth	INT	The body is taken into account in the FE model if its model depth is less than or equal to the global FE model depth. At a model depth of 0, the body is not taken into account.

Scopes

BODY/BOOLEANS

Examples

BOOLEAN UNION BODY "Body2"

The component geometry is merged with the geometry from "Body2" here.

BOOLEAN SUBTRACT HPLANE 0.00000 0.00000 1.00000 20.00000

The component geometry is cut with the horizontal plane at height 20. The part above 20 was removed.

BOOLEAN SUBTRACT DPLANE "P1-0" "P2-0" "Body2:P2-0"

The component geometry is cut through the points "P1-0", "P2-0", with "Body2:P2-0". In this case, the 3rd connection point is in another component. The plane is defined via the vectors v1 = "P2-0" - "P1-0" and v2 = "Body2:P2-0" - "P1-0" . The normal of the plane is formed by the product n = v1 x v2.

BODY "Prism1+2" CONTAINER BEGIN

DOCKING BEGIN

POINTS BEGIN

POINTS END

TRANSFORMATION BEGIN

INIT ORTHOXZ DOCKAT ""

TRANSFORMATION END

DOCKING END

BOOLEANS BEGIN

BOOLEAN DISTINCT BODY "Prism 1"

BOOLEAN DISTINCT BODY "Prism 2"

BOOLEANS END

BODY END

The component "Prism1+2" consists of the 2 individual bodies "Prism 1" and "Prism 2".