massed_fluid_density

ptrace.massed_fluid_density(p0: float) → int

Specify the density of the corresponding fluid field where the massed-particles are traced.

The default setting for this parameter is the constant value of “1.0”, with the Fluid Density variable name set to “none”. This indicates that no variable name is used; rather the constant density is used in the calculations instead. The “ptrace: massed_particles” command does not have to be ON in order to specify this command. This parameter is figured only when the drag and gravity force terms of the massed-particle momentum balance equation are used.

Args:

p0:

‘density’ the fluid density constant value of the corresponding fluid field

p1:

‘density’ the fluid density constant value of the corresponding fluid field

p2:

‘density’ the fluid density variable name of the corresponding fluid field - defaults to “none” when constant value used

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)
#
# Specify density scalar field variable name of the fluid.
#
ensight.part.modify_begin()
ensight.ptrace.massed_fluid_density("density")
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()

Returns:

zero on success, non-zero on error