Differences

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

--- doc:user:geometry:user:operateurs [2013/07/01 12:45] – external edit 127.0.0.1
+++ doc:user:geometry:user:operateurs [2016/03/30 15:23] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-====== Opérateurs ======
+====== Geometry/Mesh Operators ======
 ===== Introduction =====
-Les opérateurs de transformation géométrique permettent de déplacer une géométrie maillée ou non pour la placer dans une autre position. La syntaxe est la suivante:
+These kinds of operators are used to move/deform a geometry and its associated mesh from one configuration to another. The generic syntax is as follow:
-  op = MachinOperator(arg1, arg2, ...)
+  op = XXXOperator(arg1, arg2, ...)
-  sideset(1).move(op)
+  target.move(op)
-On crée donc l'opérateur ''op'' qui prend un ou plusieurs arguments qui peuvent être des valeurs ou des objets de Metafor (voir le détail des différents opérateurs ci-dessous). On applique ensuite cet opérateur à l'objet que l'on désire déplacer (ici la face #1).
+where ''target'' is a geometrical entity (e.g. ''sideset(1)'', ''curveset(2)'')
+As can be seen, the operator ''op'' must first be created. It takes several arguments, which can be values of Metafor objects (see below for specific operators). Then, the operator is applied to the ''target'' object (e.g. Side #1 or Curve #2).
-===== Opérateur de translation =====
-Cet opérateur permet de déplacer selon un mouvement de translation une géométrie maillée ou non. Le déplacement est défini par un ''Vect3'':
+===== Translation Operator =====
-  op = TranslationOperator([Vect3] disp)
+This operator translates a geometry, meshed or not. The displacement is defined by a ''Vect3'':
-  sideset(1).move(op)
+  op = TranslationOperator(disp)
-===== Opérateur de rotation =====
+where
+| ''disp''   | ''Vect3'' | displacement vector |
-Cet opérateur permet de faire tourner une géométrie maillée ou non autour d'un axe. La rotation est définie par un angle (en radian) et un objet géométrique ''[[axes|Axe]]'':
+===== Rotation Operator =====
-  op = RotationOperator(axe, angle)
+This operator is used to rotate a geometry, meshed or not, along an axis. The rotation is defined by and angle (in radian) and an ''[[doc:user:geometry:user:axes|Axis]]'':
-  sideset(1).move(op)
+  op = RotationOperator(axis, angle)
-===== Opérateur d'alignement =====
+where
+| ''axis''   | ''[[doc:user:geometry:user:axes|Axis]]'' | rotation axis     |
+| ''angle''  | ''float''                                | angle (in radian) |
-Cet opérateur permet d'appliquer un mouvement de corps rigide (translation + rotation) une géométrie maillée ou non. Ce mouvement de corps rigide est défini par deux objets géométriques ''[[triedres|Trièdre]]'':
-  op = AlignmentOperator(triedreRef, triedreMesh)
+===== Alignment Operator =====
-  sideset(1).move(op)
-''triedreRef'' est le trièdre dans lequel on veut placer la ''Side'' 1 et ''triedreMesh'' est le trièdre modélisant un système d'axes local de la ''Side'' à déplacer
+This operator is used to apply a rigid body motion (translation + rotation), to a geometric entity, meshed or not. This rigid body mode is defined by two ''[[doc:user:geometry:user:triedres]]'':
+  op = AlignmentOperator(trihedronRef, trihedronMesh)
-===== Opérateur de symétrie centrale =====
+''trihedronRef'' is the trihedron to which the target must be moved, when ''trihedronMesh'' is a trihedron modelling a local frame of the side to be moved.
-Cet opérateur permet d'appliquer une symétrie centrale (couplée ou non à une translation) à une géométrie maillée ou non. Cette symétrie centrale est définie par un objet géométrique ''[[axes|Axe]]'' et l'amplitude ''ampl'':
+===== Point-Reflection Operator =====
+This operator is used to apply a point reflection (with or without a translation) to a geometric entity, meshed or not. This point reflection is defined by an ''[[axes|Axis]]'' and an amplitude ''ampl'':
   op = RadialOperator(axe, ampl)
-  op.setDisplacement([Vect3] disp)
+  op.setDisplacement(disp)
-  sideset(1).move(op)
-L'axe indique la direction de la symétrie centrale.
+where
+| ''axe''   | ''[[doc:user:geometry:user:axes|Axis]]'' | reflection axis which indicates the direction of the point reflection     |
+| ''ampl''  | ''float''                                | amplitude             |
+| ''disp''  | ''Vect3''                                | displacement vector   |
-===== Opérateur de symétrie orthogonale =====
+===== Reflection/Symmetry Operator =====
-Cet opérateur permet d'appliquer une symétrie orthogonale à une géométrie maillée ou non par rapport à un plan. Cette symétrie orthogonale est définie par un objet géométrique ''[[surfaces#plan|Plane]]'':
+This operator is used to apply a reflection symmetry to a geometric entity, meshed or not:
   op = OrthogonalSymmetryOperator(plane)
-  sideset(1).move(op)
+where
+| ''plane''   | ''[[surfaces#plan|Plane]]'' | reflection plane |
-===== Opérateur de mise à échelle =====
+===== Scaling Operator =====
-Cet opérateur permet d'appliquer une mise à échelle d'une géométrie maillée ou non. Cette mise à échelle est définie par le centre de l'homothétie (objet géométrique ''[[points|Point]]'') et l'amplitude de la mise à échelle ''fact'':
+This operator is used to apply a scaling to a geometric entity, meshed or not.
   op = ScalingOperator(pt0, fact)
-  sideset(1).move(op)
+where
+| ''pt0''   | ''Point'' | homothetic centre |
+| ''fact''   | ''float'' | scaling factor |