Table of Contents

3.5.11. CREATE-LOAD function

optional

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

optional

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

optional

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.

The 3 space variables (x, y and z) are associated with the 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).

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. 

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

Distributed load

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

See also

-

References

-