Differences

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

--- doc:user:elements:boundaries:pressure_shear [2018/07/13 12:20] – [ContactTraction2DElement, ContactTraction3DElement] boemer
+++ doc:user:elements:boundaries:pressure_shear [2026/08/05 09:39] (current) – boman
@@ Line 1: / Line 1: @@
-====== Pressure and shear ======
+====== Pressure and shear  (Metafor > v3593) ======
+<note important>
+This Documentation refers to Metafor version >= 3593.
+for more informations on changes see [[https://gitlab.uliege.be/am-dept/MN2L/oo_meta/-/merge_requests/167|MR !167]] for technical informations).
-===== Materials=====
+for a Metafor version < 3593, please refers to this [[pressure_shear_pre3593|page]].
+</note>
-Since pressure/shear interactions are boundary conditions interactions (''LoadingInteraction''), no materials must be associated to the element.
+Pressure and shear boundary conditions can be applied using special finite elements defined on the boundary of the mesh. The geometry of these elements are lines in 2D corresponding to the boundary edges of the elements of the 2D mesh.
+In 3D, pressure elements are triangles or quads, depending of the shape of the facets of the elements of the mesh near the boundary.
+As any finite element, their definition requires an ''[[doc:user:elements:general:def_element_properties|ElementProperties]]'' object and an ''Interaction'' (''LoadingInteraction'') and a ''Material''.
+The ''[[doc:user:elements:general:def_element_properties|ElementProperties]]'' contains the type of element and integration parameters (number of integration points, stiffness computation method, ...).
+The ''PressureMaterial'' contains the values for the pressure and the shear, as well as functions defining the time / space evolution of these values.
+These elements should not be mixed with [[doc:user:conditions:dead_loads|dead loads]]. In most cases, pressure elements should be chosen over dead loads because:
+    * Pressure and shear are always defined in local axes, so the direction of the resulting force depends on the orientation of the boundary edge/face on which it is applied.
+    * Pressure is distributed properly over all edges/faces on which the ''LoadingInteraction'' is applied. Consequently, the total applied force does not depend on the mesh.
+{{ doc:user:pressure.gif |Pressure Elements}}
 ===== Element =====
-Therefore, the first step consist in defining an ''[[doc:user:elements:general:def_element_properties|ElementProperties]]'', as
+The first step consists in defining an ''[[doc:user:elements:general:def_element_properties|ElementProperties]]'', as
   prp = ElementProperties(typeEl)
-  prp.put(param1, value1)
+  prp.put(param, value)
-  prp.depend(param1, fct1, Lock1)) #optional
+where
+| ''typeEl'' | desired element (for example ''Pressure[2|3]DElement'' - see below)  |
+| ''param'' | name of the property associated to the element (e.g. ''NIP'') |
+| ''value'' | value of the corresponding property (e.g. the Number of Integration Points)  |
+  mat = materset.define(no, PressureMaterial)
+  mat.put(param, value)
+  mat.depend(param, fct, lock)) # optional
   ...
 where
-|''typeEl'' | desired element (for example ''Traction[2|3]DElement'')|
+| ''param'' | name of the property associated to the material (e.g. ''PRESSURE'') |
-|''param1''| name of the property associated to the element (for example ''PRESSURE'')|
+| ''value'' | value of the corresponding property (e.g. value for the pressure)  |
-|''value1''| value of the corresponding property |
-|''fct1''| function which characterizes the dependency of the property (optional: no fct if no dependency) |
-|''Lock1''| [[doc:user:general:locks|Lock]] which defines the dependency variable of the property (compulsory if there is a dependency) |
-==== Traction2DElement, Traction3DElement ====
+==== PressureMaterial ====
+Material for Pressure Elements
+=== Parameters ===
+^   Name                                          ^     Description       ^  Dependency ^
+| ''PRESSURE''  | Pressure on the entity on which the propriety is applied | time (TM)  \\ position (TX/TY/TZ)  |
+| ''SHEAR_KSI'' | Shear along $\xi$ (related to element) on the entity on which the propriety is applied | time (TM) \\ position (TX/TY/TZ)  |
+| ''SHEAR_ETA'' | Shear along $\eta$ (related to element) on the entity on which the propriety is applied \\ only usefull for ''Pressure3DElement'' | time (TM) \\ position (TX/TY/TZ)  |
+==== Pressure2DElement, Pressure3DElement ====
-Traction/shear element for a mesh made of quadrangles in 2D or hexaedra in 3D.
+Pressure/shear element for a mesh made of triangles/quadrangles in 2D or hexahedra in 3D.
 === Parameters ===
 ^   Name                                          ^     Description       ^  Dependency ^
 | ''STIFFMETHOD'' | Method used to compute the stiffness matrix\\ = ''STIFF_ANALYTIC'' : analytic matrix (default)\\ = ''STIFF_NUMERIC''  : numerical matrix  |  -  |
-| ''PRESSURE'' | Pressure on the entity on which the propriety is applied |  time  |
+| ''MATERIAL''    | Number of the ''PressureMaterial''  to consider  |
-| ''SHEAR_KSI'' / ''SHEAR_ETA''  | Shear along $\xi$ or $\eta$ on the entity on which the propriety is applied |  time  |
+| ''NIP''         | Number of integration points by direction (default : 2D 2 / 3D 2x2)    |  -  |
-| ''NPG''    | Number of integration points (default : 2)    |  -  |
-==== TriangleTraction3DElement ====
-Traction/shear element for a mesh made of tetrahedra
+==== TrianglePressure3DElement ====
+Pressure/shear element for a mesh made of tetrahedra
 === Parameters ===
 ^   Name                                          ^     Description       ^  Dependency ^
 | ''STIFFMETHOD'' | Method used to compute the stiffness matrix\\= ''STIFF_ANALYTIC'' : analytic matrix (default)\\ = ''STIFF_NUMERIC''  : numerical matrix \\ Not applicable, only the numerical one exists ! |  -  |
-| ''PRESSURE'' | Pressure on the entity on which the propriety is applied |  time  |
+| ''MATERIAL''    | Number of the ''PressureMaterial''  to consider  |
-| ''SHEAR_KSI'' / ''SHEAR_ETA''  | Shear along $\xi$ or $\eta$ on the entity on which the propriety is applied |  time  |
+| ''NIP''         | Total number of integration points (default : 1)    |  -  |
-| ''NPG''    | Number of integration points (default : 1)    |  -  |
-==== ContactTraction2DElement, ContactTraction3DElement ====
+==== ContactPressure2DElement, ContactPressure3DElement ====
-Derivations of Traction2DElement and Traction3DElement with the possibility to set the traction/shear force of a node to zero, when this node is in contact within a specified contact interaction.  To determine the contact status, the contact flag of the previous time step is used.
+Derivations of ''Pressure2DElement'' and ''Pressure3DElement'' with the possibility to set the pressure/shear force of a node to zero, when this node is in contact within a specified contact interaction.
+To determine the contact status, the contact flag of the previous time step is used.
 === Parameters ===
-The same than in Traction2DElement and Traction3DElement, with the following additional parameter:
+The same than in Traction2DElement and Traction3DElement, with the following additional parameters:
-^   Name                                          ^     Description       ^  Dependency ^
+^  Name  ^  Description  ^  Dependency  ^
-| ''NBR_CONTACT_INTERACTION'' | Number of the contact interaction, which is tested for the contact status |  -  |
+| ''NUM_CONTACT_INTERACTION''   | Number of the contact interaction, which is tested for the contact status |  -  |
+| ''TRACTION_AT_TRANSITION_ON'' | If ''True'' (default), the traction of a node belonging to an element at the transition from contact to no contact is not set equal to zero, although the node is in contact  |  -  |
+{{ :doc:user:elements:boundaries:tractionattransition.png?600 |}}
@@ Line 61: / Line 95: @@
 ===== Interaction =====
-The interaction is defined as:
+The interaction used for pressure/shear element is a ''LoadingInteraction''. It is defined as:
   load = LoadingInteraction(no)
@@ Line 72: / Line 106: @@
 where
-| ''no''       | number of the ''Interaction''  |
+| ''no''                      | number of the ''Interaction''  |
-| ''gObject1'', ''gObject2''  | meshed geometric entity where the boundary conditions are applied  |
+| ''gObject1'', ''gObject2''  | meshed geometric entity where the boundary conditions are applied (one part of the boundary of the mesh)  |
-| ''prp''      | [[doc:user:elements:general:def_element_properties|Properties]] of [[#Element|boundary condition elements]] to generate |
+| ''prp''                     | [[doc:user:elements:general:def_element_properties|Properties]] of [[#Element|boundary condition elements]] to be generated  |
-==== Remark ====
-Traction, pressure and shear is generated by "traction elements". Their definition requires a specific ''[[doc:user:general:glossaire#Interaction]]'' called ''LoadingInteraction'', to which is associated an [[doc:user:elements:general:def_element_properties|ElementProperties]]. These should not be mixed with [[doc:user:conditions:dead_loads|dead loads]]. In most cases, traction elements should be chosen over dead loads:
-    * traction (or pressure/shear) is always defined in local axes, so the direction of the force depends on the orientation of the edge/face on which it is applied.
-    * traction is divided properly over all edges/faces on which the ''Interaction'' is applied. Consequently, the resultant force does not depend on the mesh.
-{{ doc:user:pressure.gif |Elements de pression}}
-:!: Traction element is used backwards in 3D, so a positive value must be applied to generate a pressure. !!