Split

Split (explode) objects into domains, faces, edges, or vertices.

Syntax

model.geom(<tag>).create(<ftag>,"Split");

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

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

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

Description

Use model.geom(<tag>).create(<ftag>,"Split") to split geometry objects.

Use model.geom(<tag>).feature(<ftag>).selection("input") to select the objects to split. The default selection is empty.

Table 3-96: Valid Property/Value Pairs

Property	Value	Default	Description
input	Selection		Objects to split.
keep	on | off	off	Keep input objects.
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.

•	A solid object is split into solids corresponding to its domains.

•	A surface object is split into surface objects corresponding to its faces.

•	A curve object is split into curve objects corresponding to its edges.

•	A point object is split into point objects corresponding to its vertices.

•

A general (mixed) object is split into solids (corresponding to the domains), surface objects (corresponding to faces not adjacent to a domain), curve objects (corresponding to edges not adjacent to a face or domain), and point objects (corresponding to vertices not adjacent to an edge, face, or domain).

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

Example

Split union of a solid circle and a solid rectangle.

Code for use with Java

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

GeomSequence g = model.geom().create("geom1",2);

g.create("r1","Rectangle");

g.create("c1","Circle");

g.create("u1","Union");

g.feature("u1").selection("input").set(new String[]{"r1","c1"});

g.create("spl1","Split");

g.feature("spl1").selection("input").set("u1");

g.run();

Code for use with MATLAB

model = ModelUtil.create('Model1');

g = model.geom.create('geom1',2);

g.create('r1','Rectangle');

g.create('c1','Circle');

g.create('u1','Union');

g.feature('u1').selection('input').set({'r1','c1'});

g.create('spl1','Split');

g.feature('spl1').selection('input').set('u1');

g.run;

See Also

 Compose, Union, Intersection, Difference, Delete