Delete
Delete vertices, edges, faces, domains, or geometric objects.
Syntax
model.component(<ctag>).geom(<tag>).create(<ftag>,"Delete");
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>,"Delete") to delete geometric entities.
Use model.component(<ctag>).geom(<tag>).feature(<ftag>).selection("input") to select the entities to delete. The default selection is empty.
Table 3-48: Valid Property/Value Pairs
Property
Value
Default
Description
input
Selection
 
Vertices, edges, faces, domains, or objects to delete.
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.
compat
4.2a | 4.3
4.3
Algorithm version.
customcolor
RGB-triplet
Next available theme color
The color to use. Active when color is set to custom.
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.
Deleting a domain, face, or edge automatically deletes all lower-dimensional adjacent entities, except those needed to bound surviving entities.
In 2D and 3D, vertices that are adjacent to an edge cannot be deleted.
In 3D, an edge can be deleted if it has no adjacent faces, or if it is interior to a face.
For information about the selresult and contributeto properties, see Selections of Geometric Entities.
Compatibility
In version 4.3, the algorithm was changed slightly. The main difference is that the old algorithm preserved the object type for solid, surface, and curve objects. To get the old behavior, set compat to 4.2a.
model.component(<ctag>).geom(<tag>).create(<ftag>,"del") creates a Delete feature.
Example
Delete face 5 from a surface block:
Code for Use with Java
Model model = ModelUtil.create("Model1");
model.component().create("comp1");
GeomSequence g =model.component("comp1").geom().create("geom1",3);
g.create("blk1","Block");
g.feature("blk1").set("type", "surface");
g.run("blk1");
g.create("del1","Delete");
g.feature("del1").selection("input").set("blk1",5);
g.run();
Code for Use with MATLAB
model = ModelUtil.create('Model1');
model.component.create('comp1');
g = model.component('comp1').geom.create('geom1',3);
g.create('blk1','Block');
g.feature('blk1').set('type', 'surface');
g.run('blk1');
g.create('del1','Delete');
g.feature('del1').selection('input').set('blk1',5);
g.run;
See Also
 Compose, Union, Intersection, Difference