Compose, Union, Intersection, Difference

You are viewing the documentation for an older COMSOL version. The latest version is available here.

model.component(<ctag>).geom(<tag>).create(<ftag>,"Compose");

model.component(<ctag>).geom(<tag>).create(<ftag>,"Union");

model.component(<ctag>).geom(<tag>).create(<ftag>,"Intersection");

model.component(<ctag>).geom(<tag>).create(<ftag>,"Difference");

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

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

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

Use model.component(<ctag>).geom(<tag>).create(<ftag>,operationName) to combine geometric objects in different ways.

Use model.component(<ctag>).geom(<tag>).feature(<ftag>).selection(property) to select the objects to combine. The default selection is empty.

Table 3-35: Valid Properties for the Compose and Boolean Operations
Property	Value	Default	Description
absrepairtol	double	...geom(<tag>). absRepairTol()	Absolute repair tolerance.
color	none \| custom \| integer between 1 and the number of colors in the current theme	none	The color of the selection, either given as an integer indicating a color in the color theme, or as a custom color in the customcolor property. Coloring is only available when selresult in active.
customcolor	RGB-triplet	Next available theme color	The color to use. Active when color is set to custom.
formula	String		Set formula (only for Compose feature).
input	Selection		Objects to compose.
input2	Selection		Objects to subtract (only for Difference feature).
intbnd	on \| off	on	Keep interior boundaries.
keep	on \| off	off	Keep input objects.
repairtol	double	...geom(<tag>). repairTol()	Relative repair tolerance, relative to size of union of inputs.
repairtoltype	auto \| relative \| absolute	...geom(<tag>). repairTolType()	Repair tolerance type: automatic, relative, or absolute.
selresult	on \| off	off	Create selections of all resulting objects.
selresultshow	all \| obj \| dom \| bnd \| edg \| pnt \| off	dom	Show selections, if selresult is on, in physics, materials, and so on; in part instances; or in 3D from a plane geometry. obj is not available in a component’s geometry. dom, bnd, and edg are not available in all features.
contributeto	String	none	Tag of cumulative selection to contribute to.

Table 3-35: Valid Properties for the Compose and Boolean Operations

...geom(<tag>).
absRepairTol()

Absolute repair tolerance.

color

none | custom | integer between 1 and the number of colors in the current theme

none

The color of the selection, either given as an integer indicating a color in the color theme, or as a custom color in the customcolor property. Coloring is only available when selresult in active.

customcolor

RGB-triplet

Next available theme color

The color to use. Active when color is set to custom.

formula

String

Set formula (only for Compose feature).

Objects to subtract (only for Difference feature).

intbnd

on | off

Keep interior boundaries.

on | off

...geom(<tag>).
repairTol()

Relative repair tolerance, relative to size of union of inputs.

repairtoltype

auto | relative | absolute

...geom(<tag>).
repairTolType()

Repair tolerance type: automatic, relative, or absolute.

selresult

on | off

off

Create selections of all resulting objects.

selresultshow

all | obj | dom | bnd | edg | pnt | off

dom

Show selections, if selresult is on, in physics, materials, and so on; in part instances; or in 3D from a plane geometry. obj is not available in a component’s geometry. dom, bnd, and edg are not available in all features.

contributeto

String

none

Tag of cumulative selection to contribute to.

•

For Compose, the input objects are combined using the set formula in the property formula. The operators +, *, and - correspond to the set operations union, intersection, and difference, respectively. The precedence of the operators + and - are the same. * has higher precedence.

•

For Intersection, the objects in input are intersected.

•

For Difference, the objects in input2 are subtracted from the union of the objects in input to form a set difference.

Table 3-36: Valid Property/Value Pairs
Property	Value	Default	Description
edge	all \| none	none	Delete isolated edges on a face (3D). Delete interior edges and edges not adjacent to a domain (2D; alias for indbnd).
face	all \| none	none	Delete interior faces (3D; alias for intbnd).
point	all \| none	none	Delete isolated vertices (points) on a face (3D) or in a domain (2D).

Table 3-36: Valid Property/Value Pairs

all | none

Delete isolated edges on a face (3D). Delete interior edges and edges not adjacent to a domain (2D; alias for indbnd).

face

all | none

none

Delete interior faces (3D; alias for intbnd).

point

all | none

none

Delete isolated vertices (points) on a face (3D) or in a domain (2D).