Delete

Delete vertices, edges, faces, domains, or geometric objects.

Syntax

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

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>,"Delete") to delete geometric entities.

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

Table 3-44: Valid Property/Value Pairs

Property	Value	Default	Description
input	Selection		Vertices, edges, faces, domains, or objects to delete.
compat	4.2a | 4.3	4.3	Algorithm version.
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.geom(<tag>).create(<ftag>,"del") creates a Delete feature.

In 3D, the default value for edge and point was all in version 3.5a. Now the default is empty (corresponds to none in 3.5a). The value all for subdomain, face, edge, and point is no longer available. The property out is no longer available.

Example

Delete face 5 from a surface block:

Code for use with Java

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

GeomSequence g =model.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');

g = model.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