BallSelection, BoxSelection, CylinderSelection

Create selections of geometric entities or objects that (partly) lie inside a ball/box/cylinder.

Syntax

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

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

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

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

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

Description

The following properties are available:

Property	Value	Default	Description
angletol	double	5	Angle tolerance for continuity evaluation
condition	intersects | inside | somevertex | allvertices	intersects	Condition for inclusion of an entity
entitydim	-1 | 0 | 1 | 2 | 3	space dimension	Dimension of entities to select. -1 means Object.
groupcontang	on | off	off	Continuous tangent mode
input	String[]	{}	Tags of input selections, only used when inputent is selections
inputent	all | selections	all	Select among all entities or entities defined by input property
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.

For BallSelection, you define the ball using the following properties (using the geometry sequence’s length unit):

Property	Value	Default	Description
posx	double	0	Center of ball, first coordinate
posy	double	0	Center of ball, second coordinate
posz	double	0	Center of ball, third coordinate
r	double	0	Radius of ball

For BoxSelection, you define the box using the following properties (using the geometry sequence’s length unit):

Property	Value	Default	Description
xmax	double	inf	Maximum x-coordinate of box
xmin	double	-inf	Minimum x-coordinate of box
ymax	double	inf	Maximum y-coordinate of box
ymin	double	-inf	Minimum y-coordinate of box
zmax	double	inf	Maximum z-coordinate of box
zmin	double	-inf	Minimum z-coordinate of box

For CylinderSelection, you define the cylinder using the following properties (using the geometry sequence’s length unit):

Property	Value	Default	Description
axis	double[]	{0,0,0}	Direction of cylinder axis. Vector has length 3 if axistype is cartesian and length 2 is axistype is spherical. Not used if axistype is x, y, or z.
axistype	x | y | z | cartesian | spherical	z	Type of axis or coordinate system used for axis. The value is synchronized with axis.
bottom	double	-inf	Coordinate of bottom face in local coordinate system
pos	double[]	{0,0,0}	Base point
r	double	0	Radius
top	double	inf	Coordinate of top face in local coordinate system

You select the input entities/objects to select among using the properties entitydim, inputent, and input. 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.

The output entities/objects are determined by the property condition:

•	intersects: All entities/objects that intersect the ball/box/cylinder are included.

•	inside: All entities/objects that are completely inside the ball/box/cylinder are included.

•	somevertex: All entities/objects that have at least one adjacent vertex inside the ball/box/cylinder are included.

•	allvertices: All entities/objects that have all adjacent vertices inside the ball/box/cylinder are included.

For intersects and inside, the rendering mesh is used for the calculation. You can set the resolution of the rendering mesh using

ModelUtil.setPreference("graphics.rendering.detail",<detail>);

where <detail> is coarse, normal, fine, or wireframe.

See Selections of Geometric Entities for general information about selections.

Example

In a 10-by-10 array of squares, delete the squares that lie in the box x>9.5, y>9.5.

Code for use with Java

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

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

g.create("sq1", "Square");

g.create("arr1", "Array");

g.feature("arr1").selection("input").set("sq1");

g.feature("arr1").set("fullsize", new int[]{10,10});

g.feature("arr1").set("displ", new double[]{2,2});

g.run("arr1");

g.create("boxsel1","BoxSelection");

g.feature("boxsel1").set("entitydim", -1);

g.feature("boxsel1").set("xmin", 9.5);

g.feature("boxsel1").set("ymin", 9.5);

g.create("del1", "Delete");

g.feature("del1").selection("input").init();

g.feature("del1").selection("input").named("boxsel1");

g.run("del1");

// g.objectNames().length = 75

Code for use with MATLAB

model = ModelUtil.create('Model');

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

g.create('sq1', 'Square');

g.create('arr1', 'Array');

g.feature('arr1').selection('input').set('sq1');

g.feature('arr1').set('fullsize', [10,10]);

g.feature('arr1').set('displ', [2,2]);

g.run('arr1');

g.create('boxsel1','BoxSelection');

g.feature('boxsel1').set('entitydim', -1);

g.feature('boxsel1').set('xmin', 9.5);

g.feature('boxsel1').set('ymin', 9.5);

g.create('del1', 'Delete');

g.feature('del1').selection('input').init;

g.feature('del1').selection('input').named('boxsel1');

g.run('del1');

% length(g.objectNames)= 75

See Also

AdjacentSelection, ExplicitSelection, UnionSelection, IntersectionSelection, DifferenceSelection, ComplementSelection