3.5.10. CREATE-LOAD function

This is an old revision of the document!

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).

Name	Data Type	Data number	Optional
MODEL	STRING	1	NO
	Name of the model on which to create the load case.
NAME	STRING	1	NO
	Name of the load case

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	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.

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.

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

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

-

3.5.10. CREATE-LOAD function

Description

Keywords

CONCENTRATED branch

Keywords

DISTRIBUTED branch

Keywords

Examples

Concentrated load

Distributed load

See also

References