massed_initial_velocity

ptrace.massed_initial_velocity(p0: float, p1: float, p2: float) → int

Specify the initial emitter velocity vector to be used on all the massed-particles.

The default vector value is <1,1,1>. The “ptrace: massed_particles” command does not have to be ON in order to specify this command. This parameter is figured in all terms of the massed-particle momentum balance equation. The values of this command take effect only if “ptrace: massed_initial_use_fluid” is toggled OFF.

Args:

p0:

‘vx’ the x-component of the initial velocity vector

p1:

‘vy’ the y-component of the initial velocity vector

p2:

‘vz’ the z-component of the initial velocity vector

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)
#
# Do not use the field velocity as the initial particle velocity
# Specify the initial velocity value for all the massed-particles
#
ensight.part.modify_begin()
ensight.ptrace.massed_initial_use_fluid("OFF")
ensight.ptrace.massed_initial_velocity(1.0000e+00,1.0000e+00,1.0000e+00)
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