Split
Split (explode) objects into domains, faces, edges, or vertices.
Syntax
model.component(<ctag>).geom(<tag>).create(<ftag>,"Split");
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);
Description
Use model.component(<ctag>).geom(<tag>).create(<ftag>,"Split") to split geometry objects.
Use model.component(<ctag>).geom(<tag>).feature(<ftag>).selection("input") to select the objects to split. The default selection is empty.
Table 3-105: Valid Property/Value Pairs for Split
Property
Value
Default
Description
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.
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");
model.component().create("comp1");
GeomSequence g = model.component("comp1").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');
model.component.create('comp1');
g = model.component('comp1').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