BallSelection, BoxSelection, CylinderSelection, DiskSelection
Create selections of geometric entities that (partly) lie inside a ball, box, cylinder, or disk.
Syntax
model.component(<ctag>).mesh(<tag>).create(<ftag>,"BallSelection");
model.component(<ctag>).mesh(<tag>).create(<ftag>,"BoxSelection");
model.component(<ctag>).mesh(<tag>).create(<ftag>,"CylinderSelection");
model.component(<ctag>).mesh(<tag>).create(<ftag>,"DiskSelection");
model.component(<ctag>).mesh(<tag>).set(property,<value>);
model.component(<ctag>).mesh(<tag>).getType(property);
Description
The following general properties are available:
Table 4-16: Available General properties.
Name
Value
Default
Description
entitydim
3 | 2 | 1 | 0
space dimension
Dimension of entities to select.
inputent
all | selections
all
Select among all entities or entities defined by the input property.
input
String[]
{}
Tags of input selections. Used when inputent is selections.
condition
intersects | inside | somevertex | allvertices
intersects
Condition for inclusion of an entity.
groupcontang
on | off
off
Continuous tangent mode.
angletol
double
15
Angle tolerance for continuity evaluation (value is converted if radians is used).
selshow
on | off
on
Show selection in physics, materials, and so on. For mesh parts, this option shows selection in instances of the part.
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.
customcolor
RGB-triplet
Next available theme color
The color to use. Active when color is set to custom.
For BallSelection, you define the ball using the following properties:
Table 4-17: Additional properties for BallSelection.
Name
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 (nonnegative)
0
Radius of ball.
For BoxSelection, you define the box using the following properties:
Table 4-18: Additional properties for BoxSelection.
Name
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 in 3D.
zmin
double
-inf
Minimum z-coordinate of box in 3D.
For CylinderSelection, you define the cylinder using the following properties:
Table 4-19: Additional properties for CylinderSelection.
Name
Value
Default
Description
angle1
double
0
Start angle
angle2
double
360 or 2*pi
End angle (default is a full cylinder)
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 (nonnegative)
0
Outer radius.
rin
double (nonnegative)
0
Inner radius.
top
double
inf
Coordinate of top face in local coordinate system.
ax3
double[]
{0,0,1}
Direction of cylinder axis. Used when axistype is set to cartesian.
ax2
double[]
{0,0}
Direction of cylinder axis. Used when axistype is set to spherical.
For DiskSelection, you define the disk using the following properties:
Table 4-20: Additional properties for DiskSelection.
Name
Value
Default
Description
angle1
double
0
Start angle
angle2
double
360
End angle (default is a full disk)
posx
double
0
Center of disk, first coordinate.
posy
double
0
Center of disk, second coordinate.
r
double (nonnegative)
0
Outer radius.
rin
double (nonnegative)
0
Inner radius.
You select the input entities 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 that intersect the ball/box/cylinder/disk are included.
•
inside: All entities that are completely inside the ball/box/cylinder/disk are included.
•
somevertex: All entities that have at least one adjacent vertex inside the ball/box/cylinder/disk are included.
•
allvertices: All entities that have all adjacent vertices inside the ball/box/cylinder/disk are included.
See Also
UnionSelection, IntersectionSelection, DifferenceSelection, ComplementSelection, AdjacentSelection, ExplicitSelection