Differences

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

--- user_manual:sesamx:functions_description:create_load [2022/01/22 12:15]
Ali Baba
+++ user_manual:sesamx:functions_description:create_load [2022/01/22 12:17]
Ali Baba [DISTRIBUTED branch]
@@ Line 1: / Line 1: @@
+{{description>Learn how to use the CREATE-LOAD function.}}
+====== 3.5.10. CREATE-LOAD function ======
+<label type="info">optional</label>
+===== Description =====
+This function is used to **define a load case on the model**. You can only define concentrated or distributed loads on the nodes.
+When you use multiple branches in the same ''CREATE-LOAD'' function, **the load definition works in an additive manner**. Each branch will add its contribution to the nodes on which it applies (as showcased in the example).
+==== Keywords ====
+^ Name   ^ Data Type   ^ Data number   ^ Optional   ^ Default value   ^ Physical quantity ^
+| **MODEL** | STRING| 1 | NO | | |
+| | Name of the model on which to create the load case. |||||
+| **NAME** | STRING| 1 | NO | | |
+| | Name of the load case |||||
+==== CONCENTRATED branch ====
+<label type="info">optional</label>
+This branch is used to add concentrated force and moment vectors on the model nodes. **The vectors components must be provided in the global basis**.
+**The force and moment vectors that you provide will be applied on each node of the selection**.
+=== Keywords ===
+^ Name   ^ Data Type   ^ Data number   ^ Optional   ^ Default value   ^ Physical quantity ^
+| **FORCE** | FLOAT| 3 | NO | | FORCE |
+| | Force vector components (global basis) to add on the nodes. |||||
+| **MOMENT** | FLOAT| 3 | NO | | MOMENT |
+| | Moment vector components (global basis) to add on the nodes. |||||
+| **ON-NODES-FROM** | STRING| 1 | NO | | |
+| | Name of the nodes selection on which the load is added. |||||
+==== DISTRIBUTED branch ====
+<label type="info">optional</label>
+This branch is used to distribute a force vector on the model nodes. **The total force vector must be provided, and this force will be distributed on the nodes. You can chose how to distribute the force while providing a weight function**. The weight function must be a function of the 3 space variables (x, y and z). And the function must be positive for all the nodes in the selection. SesamX will compute the resulting force vectors that applies on each node of the selection.
+**The vectors components must be provided in the global basis**.
+<callout type="info" icon="true">
+**The 3 space variables (x, y and z) are associated with the [[user_manual:sesamx:functions_description:create_units|LENGTH physical quantity]]**. For instance, let's suppose you are working with the SI unit system and the LENGTH unit is mm. For a point located at ($x = 100 \ mm$, $y = 0 \ mm$, $z = 0 \ mm$) SesamX will replace x in the formula with the value 100 (and not with 0.1).
+</callout>
+=== Keywords ===
+^ Name   ^ Data Type   ^ Data number   ^ Optional   ^ Default value   ^ Physical quantity ^
+| **KIND** | ENUM | 1| YES | NODE | |
+| | Type of distribution. Currently the only choice is: \\ **NODE** to distribute the force directly on the model nodes. |||||
+| **FORCE** | FLOAT| 3 | NO | | FORCE |
+| | Total force vector components (global basis) to distribute on the nodes. |||||
+| **WEIGHT-FUNCTION** | FORMULA| 1 | NO | | |
+| | The weight function formula (depending on the 3 space variables x, y and z) describing how to distribute the load. Each space variable is associated with the LENGTH physical quantity. |||||
+| **ON-NODES-FROM** | STRING| 1 | NO | | |
+| | Name of the nodes selection on which the load is added. |||||
+===== Examples =====
+==== Concentrated load ====
+This example showcases a load case definition relying on 2 ''CONCENTRATED'' branches.
+<code php>
+CREATE-LOAD
+  MODEL: MY_MODEL
+  NAME: LOAD_CASE
+  CONCENTRATED
+    FORCE: 10.,0.,0.
+    MOMENT: 0.,0.,0.
+    ON-NODES-FROM: HOLE_1
+  CONCENTRATED
+    FORCE: -2.,25.,0.
+    MOMENT: 0.,0.,10.
+    ON-NODES-FROM: HOLE_2
+</code>
+==== Distributed load ====
+<code php>
+CREATE-LOAD
+  MODEL: WHEEL_RIM
+  NAME: LOAD_CASE
+  DISTRIBUTED
+    FORCE: 0.,3000.,0.
+    KIND: NODE
+    WEIGHT-FUNCTION: "x^2 + *y^2  + 2*z^2"
+    ON-NODES-FROM: LOAD_SELE
+</code>
+----
+===== See also =====
+-
+===== References =====
+-