Loads¶
Routines listed in this section apply loads.
GRAVITY¶
This routine sets up the gravitational acceleration.
GRAVITY (solfec, vector)
solfec – SOLFEC object for which the acceleration is set up
vector – (vx, vy, vz) tuple defining the gravity acceleration. Each entry is a number or a TIME_SERIES object defining the value of the acceleration component.
FORCE¶
This routine applies a point force to a body.
FORCE (body, kind, point, direction, value | data)
body – BODY object to which the force is applied
kind – either ‘SPATIAL’ or ‘CONVECTED’; the spatial direction remains fixed, while the convected one follows deformation
point – (x, y, z) tuple with the referential point where the force is applied
direction – (vx, vy, vz) tuple defining the direction of force
value – a number, a TIME_SERIES object or a callback routine defining the value of the applied force. In case of a callback routine, the following format is assumed:
force = value_callback (data, q, u, time, step)
where data is the optional user data passed to FORCE routine (if data is a tuple it will expand the list of parameters to the callback), q is the configuration of the body passed to the callback, u is the velocity of the body passed to the callback, time is the current time passed to the callback and step is the current time step passed to the callback. The callback returns a force tuple. For rigid body the force reads (spatial force, spatial torque, referential torque), while for other kinds of bodies this is a generalized force of the same dimension as the velocity u (power conjugate to it). See also: REGISTER_CALLBACK.
data – callback routine user data
TORQUE¶
This routine applies a torque to a rigid body.
TORQUE (body, kind, direction, value)
body – BODY object of kind ‘RIGID’ to which the torque is applied
kind – either ‘SPATIAL’ or ‘CONVECTED’; the spatial direction remains fixed, while the convected one follows deformation
direction – (vx, vy, vz) tuple defining the direction of torque
value – a number or a TIME_SERIES object defining the value of the applied torque
PRESSURE¶
This routine applies a constant surface pressure to MESH based bodies.
PRESSURE (body, surfid, value)
body – BODY object to which the pressure is applied (the shape has to be composed of a single MESH)
surfid – the integer surface identifier
value – a number or a TIME_SERIES object defining the value of the applied load