Commands list
×MENU
EXPAND ALL
SORT A-Z
- Input handling
- Solution control and techniques
- Output
-
Mesh commands
- ACTIVATE_ELEMENTS
- ADD_MASS
- CHANGE_PART_ID
- COMPONENT_BOLT
- COMPONENT_BOX
- COMPONENT_BOX_IRREGULAR
- COMPONENT_CYLINDER
- COMPONENT_PIPE
- COMPONENT_REBAR
- COMPONENT_SPHERE
- CONNECTOR_DAMPER
- MERGE_DUPLICATED_NODES
- REDISTRIBUTE_MESH_CARTESIAN
- REFINE
- SMOOTH_MESH
- SUBDIVIDE_PART_THICKNESS
- TRANSFORM_MESH_CARTESIAN
- TRANSFORM_MESH_CYLINDRICAL
- TRIM
- TRIM_HOLE
- WELD
- Nodes and connectivity
-
Material properties
- EOS_GRUNEISEN
- MAT_BB
- MAT_BERGSTROM_BOYCE
- MAT_CABLE
- MAT_CERAMIC
- MAT_CONCRETE_2017
- MAT_CONCRETE_2018
- MAT_CONCRETE_2021
- MAT_CREEP
- MAT_ELASTIC
- MAT_FABRIC
- MAT_FLUID
- MAT_FOAM
- MAT_FORMING
- MAT_FORMING_R
- MAT_GRANULAR_CAP
- MAT_HJC_CONCRETE
- MAT_HOEK_BROWN
- MAT_HSS
- MAT_JC
- MAT_JC_FIELD
- MAT_JH_CERAMIC
- MAT_LEE_TARVER
- MAT_LIBRARY
- MAT_METAL
- MAT_MMC
- MAT_MMC_OST
- MAT_MOONEY_RIVLIN
- MAT_OBJECT
- MAT_POWDER_BURN
- MAT_REBAR
- MAT_RIGID
- MAT_USER_X
- MAT_VISCOUS_FOAM
- MAT_VISCO_PLASTIC
- MAT_YEOH
- MAT_ZA
- PROP_DAMAGE_BRITTLE
- PROP_DAMAGE_CL
- PROP_DAMAGE_CL_0_45_90
- PROP_DAMAGE_CL_ANISOTROPIC
- PROP_DAMAGE_CL_REGULARIZE
- PROP_DAMAGE_HC
- PROP_DAMAGE_IMP
- PROP_DAMAGE_IMP_ISO
- PROP_DAMAGE_JC
- PROP_DAMAGE_JC_REGULARIZE
- PROP_DAMAGE_STRAIN
- PROP_THERMAL
-
Initial conditions
- INITIAL_CONTACT
- INITIAL_DAMAGE_RANDOM
- INITIAL_DAMAGE_SURFACE_RANDOM
- INITIAL_MATERIAL_DIRECTION
- INITIAL_MATERIAL_DIRECTION_PATH
- INITIAL_MATERIAL_DIRECTION_VECTOR
- INITIAL_MATERIAL_DIRECTION_WRAP
- INITIAL_PLASTIC_STRAIN_FUNCTION
- INITIAL_STATE
- INITIAL_STATE_HAZ
- INITIAL_STATE_WELDSIM
- INITIAL_STRESS_FUNCTION
- INITIAL_TEMPERATURE
- INITIAL_THICKNESS
- INITIAL_VELOCITY
- REMAP
- Boundary conditions
- Loads
- Contact and tied interfaces
- Rigid bodies
- Connectors
- Parameters and functions
- Geometries
- Sets
- Coordinate system
- Particle
- γSPH
Third-party add-ons
Python scripting
IMPETUS module
This module was introduced in Engine v6.0.846 and cannot be used with earlier versions.
The impetus module is a built-in module which allows one to extract more data from the simulation, such as curve, table and path data.
Module Contents
-
variable = impetus.
curve
(
curve_id , abscissa)
-
Returns the ordinate value of abscissa in the defined curve_id.
See the command *CURVE for more information.
-
variable = impetus.
table
(
table_id , row , col)
-
Returns the table value of row and col in table table_id.
See the command *TABLE for more information.
-
variable = impetus.
path
(
path_id , pos , relative)
-
Returns the coordinate of pos in path_id. The return variable is a 3-component long list
(x = variable[0], y = variable[1], z = variable[2]). Variable relative defines if the pos
value is relative (1) or absolute (0). If relative is set to 1, then pos will correspond
to the relative position between 0 and 1 in the path. If the pos value exceeds the upper limit of the path,
the return value will be extrapolated.
See the command *PATH for more information.
Example
Python script: script.py
# Import the impetus module
import impetus
# Curve example
def curve_example(curve_id, abscissa):
value = impetus.curve(int(curve_id), abscissa)
print("Value:", value, flush=True)
# The printed value should be "5"
# Table example
def table_example(table_id, row, col):
value = impetus.table(int(table_id), int(row), int(col))
print("Value:", value, flush=True)
# The printed value should be "4.7"
# Path example (using relative position)
def path_example(path_id, pos):
coordinate = impetus.path(int(path_id), pos, 1)
print("x:", coordinate[0], flush=True)
print("y:", coordinate[1], flush=True)
print("z:", coordinate[2], flush=True)
# The printed value should be:
# "x = 0.1622625066423805"
# "y = 0.1377374933576195"
# "z = -0.011312533211902509"
# Adding the python file to our input file
*SCRIPT_PYTHON
script.py
# Calling python function curve_example()
*FUNCTION
1000
script.curve_example(1, 5.0e-7)
# Calling python function table_example()
*FUNCTION
1001
script.table_example(100, 3, 1)
# Calling python function path_example()
*FUNCTION
1002
script.path_example(1234, 0.3)
*CURVE
1
0, 0
1.0e-6, 10.0
1.0, 10.0
*TABLE
100, 3
0.0, 0.0, 0.0
1.2, 3.4, 5.5
4.7, 2.2, 6.2
8.0, 1.1, 9.2
*PATH
1234
0.0, 0.0, 0.0
0.1, 0.2, 0.3
0.2, 0.1, -0.2
0.0, 1.0, -0.2
-0.1, 1.0, 0.3