massed_drag_coefficient

ptrace.massed_drag_coefficient(p0: float) → int

Specify the name of the drag coefficient function table to be used in the drag force term of the massed-particle calculation.

The default setting is “none”. The “ptrace: massed_particles” command does not have to be ON in order to specify this command. This parameter is only used when the drag force term “ptrace: massed_drag” is toggled ON.

Also the three options “DragCoefPoly”, “DragCoefPower”, and “DragCoefTable1”, are EnSight User-Defined Math Functions. These math functions are typically located under $CEI_HOME/ensight92/src/math_functions, and are compiled as libraries by the user, and then dynamically liked via the _UDMF environment variable.

Args:

p0:

‘table_name’ none

p1:

‘table_name’ DragCoefTable1

p2:

‘table_name’ DragCoefPower

p3:

‘table_name’ DragCoefPoly

p4:

‘table_name’ any User-Defined Math Function

Examples:

#
# Create a massless point trace
#
ensight.part.select_all()
ensight.ptrace.select_default()
ensight.part.modify_begin()
ensight.ptrace.variable("velocity")
ensight.part.modify_end()
ensight.part.select_all()
ensight.ptrace.create_pt()
ensight.part.select_begin(2)
#
# Toggle on massed-particle drag force term
# Specify default drag coefficient function table
#
ensight.part.modify_begin()
ensight.ptrace.massed_drag("ON")
ensight.ptrace.massed_drag_coefficient("none")
ensight.part.modify_end()
#
# Change part to massed trace using current settings
#
ensight.part.modify_begin()
ensight.ptrace.massed_particles("ON")
ensight.part.modify_end()
#
# Change the drag coefficient function to use the power formulation
#
ensight.part.modify_begin()
ensight.ptrace.massed_drag_coefficient("DragCoefPower")
ensight.part.modify_end()

Returns:

zero on success, non-zero on error