ExplicitSelection

Create explicit selections of geometric entities or objects.

Syntax

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

model.geom(<tag>).feature().selection("selection");

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

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

Description

The following properties are available:

Property	Value	Default	Description
angletol	double	5	Angle tolerance for continuity evaluation.
groupcontang	on | off	off	Continuous tangent mode.
selection	Selection	empty	Selection of entities or objects.
selkeep	on | off	on	Keep the selection within the geometry sequence.
selshow	on | off	on	Show selection in physics, materials, and so on; in part instances; or in 3D from a plane geometry.
contributeto	String	none	Tag of cumulative selection to contribute to.

Use the selection methods described in the section “Geometry Object Selection Methods” under model.geom() to specify the selection model.geom(<tag>).feature().selection("selection").

For a boundary or edge selection in 2D or 3D, you can force the selection to select whole groups of entities by setting the property groupcontang to on. Each group consists of adjacent entities that meet at an angle less than angletol.

See Selections of Geometric Entities for general information about selections.

Compatibility

The following alias can also be used:

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

Example

The sequence below creates a block and a cylinder and creates a selection of face 4 of the block. This corresponds to faces 9 and 13 in the finalized geometry.

Code for use with Java

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

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

g.create("blk1", "Block");

g.run("blk1");

g.create("sel1","ExplicitSelection");

g.feature("sel1").selection("selection").init(2);

g.feature("sel1").selection("selection").set("blk1", new int[]{4});

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

g.run();

int[] faces = model.selection("geom1_sel1").entities(2);

// faces = 9, 13

Code for use with MATLAB

model = ModelUtil.create('Model');

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

g.create('blk1', 'Block');

g.run('blk1');

g.create('sel1','ExplicitSelection');

g.feature('sel1').selection('selection').init(2);

g.feature('sel1').selection('selection').set('blk1', 4);

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

g.run;

faces = model.selection('geom1_sel1').entities(2);

% faces = 9, 13

See Also

AdjacentSelection, BallSelection, BoxSelection, CylinderSelection, UnionSelection, IntersectionSelection, DifferenceSelection, ComplementSelection