Partition

Partition 2D and 3D geometry objects using tool objects or a work plane.

Syntax

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

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

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

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

model.component(<ctag>).geom(<tag>).feature(<ftag>).setAttribute(attribute,<value>);

model.component(<ctag>).geom(<tag>).feature(<ftag>).getAttribute(attribute);

Description

The Partition Boolean operation partitions each input object using a set of tool objects or (in 3D only) a work plane. That is, within the input object new boundaries, edges, and vertices are created that come from the tools or the work plane.

The following properties are available:


Property	Value	Default	Description
absrepairtol	double	...geom(<tag>). absRepairTol()	Absolute repair tolerance.
contributeto	String	none	Tag of cumulative selection to contribute to.
input	Selection	empty	Objects to partition.
keepinput	on \| off	off	Keep input objects.
keeptool	on \| off	off	Keep tool objects.
partitionwith	objects \| workplane	objects	Partition with tool objects or a work plane.
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.
tool	Selection	empty	Tool objects.
workplane	String		Work plane to partition with.

For information about the selresult and contributeto properties, see Selections of Geometric Entities.

The following attributes are available:

Table 3-127: Valid attributes
Name	Value	Default	Description
construction	on \| off \| inherit	inherit	Designate the resulting objects as construction geometry. Use inherit to set the construction geometry attribute only if all input objects are construction geometry.

Compatibility

The keep property has been deprecated in version 5.3a. Instead, use the new properties keepinput and keeptool. If you set keep to on, both keepinput and keeptool. If you get the value of keep, it is on if keepinput and keeptool are on.

Example

Create an interior boundary in a cylinder by partitioning it with an oblique work plane:

Code for Use with Java

Model model = ModelUtil.create("Model");

model.component().create("comp1");

GeomSequence g = model.component("comp1").geom().create("geom1", 3);

g.create("cyl1", "Cylinder");

g.feature("cyl1").set("h", 10);

g.create("wp1", "WorkPlane");

g.feature("wp1").set("planetype", "general");

g.feature("wp1").setIndex("genpoints", 4, 0, 2);

g.feature("wp1").setIndex("genpoints", 5, 1, 2);