Differences

This shows you the differences between two versions of the page.

--- doc:user:geometry:user:selections [2018/01/30 16:23] – [Adding nodes (simple)] papeleux
+++ doc:user:geometry:user:selections [2018/01/30 18:44] – papeleux
@@ Line 25: / Line 25: @@
   groupset(number).addMeshPointsInBox(xmin, xmax, ymin, ymax, zmin, zmax)
   groupset(number).addMeshPointsFromObject(target, selector)
-  groupset(number).addInnerMeshPointsFromObject(target, selector) (does not add nodes on boundary of target)
+  groupset(number).addInnerMeshPointsFromObject(target, selector)
 where
@@ Line 36: / Line 36: @@
 | ''selector'' | selection operator which reduces the number of MeshPoints in the group |
+nb : addInnerMeshPointsFromObject does not add nodes on boundary of ''target'' if ''target'' is a real geometrical object (meaning : not a group)
 ===== Sorting the selected nodes =====
@@ Line 57: / Line 58: @@
 ===== Advanced features (Selectors) =====
-Adding nodes from the geometric object ''target'':
+Adding nodes from the geometric object ''target'' (target can be a group):
   groupset(number).addMeshPointsFromObject(target, selector)
@@ Line 63: / Line 64: @@
 where ''selector'' is an object of the ''Selector'' type. Here are some of its derived classes:
-    * ''BoxSelector'' (selection within a bow),
+=== BoxSelector===
-    * ''RangeSelector'' (selection in a given area),
-    * ''DistSelector'' (spherical selection),
+Selection within a box :
-    * ''SectorSphericalSelector'' (selection in a spherical sector),
-    * ''AnnealedSelector'' (selection of a ring along the ''x'', ''y'' or ''z'' direction),
+  BoxSelector(xMin, xMax, yMin, yMax, zMin, zMax)
-    * ''SectorAnnealedSelector'' (selection of a part or a ring, defined by two angles, along the ''x'', ''y'' or ''z'' direction),
-    * ''InverseSelector'' (inverse the selection criterion passed in argument).
+where
+| ''xMin'' | minimal X value |
+| ''xMax'' | maximal X value |
+| ''yMin'' | minimal Y value |
+| ''yMax'' | maximal Y value |
+| ''zMin'' | minimal Z value |
+| ''zMax'' | maximal Z value |
+=== RangeSelector ===
+Selection in a given area :
+  RangeSelector(lock, vMin, vMax)
+where
+| ''lock'' | direction of the selector : ''TX'', ''TY'' or ''TZ'' |
+| ''vMin'' | minimal value in lock direction |
+| ''vMax'' | maximal value in lock direction |
+=== DistSelector ===
+Spherical selection :
+  DistSelector (Cx, Cy, Cz, R)
+where
+| ''Cx, Cy, Cz'' | center of the sphere |
+| ''R'' | radius of the sphere |
+=== SectorSphericalSelector ===
+Selection in a spherical sector :
+  SectorSphericalSelector (Cx, Cy, Cz, rMin, rMax, thetaMin, thetaMax, phiMin, phiMax)
+where
+| ''Cx, Cy, Cz'' | center of the spherical sector |
+| ''rMin''- ''rMax'' | minimal - maximal radius of the spherical sector |
+| ''thetaMin''-''thetaMax'' | minimal-maximal azimuth angle (from $0.0$ to $2 \pi$) |
+| ''phiMin''-''phiMax'' | minimal-maximal elevation angle (from $-\frac{\pi}{2}$ to $\frac{\pi}{2}$) |
+__Note__ : angles are computed with respect to the structural frame translated toward the center or the sphere.
+=== AnnealedSelector ===
+Selection selection of a ring along the ''x'', ''y'' or ''z'' direction :
+  AnnealedSelector(lock, x, y, z, rMin, rMax, hMin, hMax)
+where
+| ''lock''  | direction of the axe of the ring (''TX'', ''TY'' or ''TZ'') |
+| ''x,y,z'' | center of the ring |
+| ''rMin,rMax'' | minimal - maximal radius of the ring |
+| ''hMin,hMax'' | minimal - maximal height of the ring |
+gets all nodes situated from the two cylinders of axis ''lock'', of radii ''rMin'' and ''rMax'', and of height between ''hMin'' and ''hMax''.
+=== SectorAnnealedSelector ===
+Selection of a part or a ring, defined by two angles, along the ''x'', ''y'' or ''z'' direction :
+  SectorAnnealedSelector(lock, x, y, z, rMin, rMax, thetaMin, thetaMax, hMin, hMax)
+where
+| ''lock''  | direction of the axe of the ring (''TX'', ''TY'' or ''TZ'') |
+| ''x,y,z'' | center of the ring |
+| ''rMin, rMax'' | minimal - maximal radius of the ring sector |
+| ''thetaMin, thetaMax'' | minimal - maximal angle of the sector (from $-\pi$ to $\pi$) |
+| ''hMin, hMax'' | minimal - maximal height of the ring sector |
+=== TorrusSelector ===
+Selection of nodes inside a torus :
+  TorrusSelector(axe, Cx, Cy, Cz, rMin, rMax)
+where
+| ''axe'' | [[doc:user:geometry:user:axes|Axe]] of the torus  |
+| ''Cx, Cy, Cz'' | center of the torrus |
+| ''rMin'' | minimal Radius (to be explained) |
+| ''rMax'' | maximal Radius (to be explained) |
+=== EllipseSelector ===
+Selection within an ellipse :
+  EllipseSelector (lock, Cx, Cy, CZ, a, b)
+where
+| ''lock'' | direction of axe perpendicular to the plane of the ellipse : ''TX'', ''TY'' or ''TZ'' |
+| ''Cx, Cy, Cz'' | center of the ellipse |
+| ''a'' | small radius |
+| ''b'' | big radius |
+=== PlaneSelector ===
+Selection on one side of a plane :
+  PlaneSelector (plane, dir)
+where
+| ''plane'' | [[doc:user:geometry:user:surfaces#plane|Plane]] surface object |
+| ''dir'' | boolean (True / False) defining the side of the plane (depending to the normal) |
+=== InverseSelector ===
+Revert the effect of a selector  :
+  InverseSelector (selector)
+where
+| ''selector'' | selector whose effect will be inverted |
+=== BoundarySelector ===
+Select nodes that are on the surface of a meshed object (3D Models only)  :
+  BoundarySelector ()
+=== Boundary2DSelector ===
+Select nodes that are on the surface of a meshed object (2D Models only)  :
+  Boundary2DSelector ()
 __Examples:__