Command manual

Impetus Engine module

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

# Import the impetus engine 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"