create_pt

ptrace.create_pt() → int

Create a particle trace from the current location of the cursor (a point).

The default attributes and/or any “ptrace:” attribute commands between “ptrace: begin” and “ptrace: end” commands are used for the trace creation. A parent part or parts (containing the flow field) must be selected prior to this command, and you need the cursor to be at the desired location.

Examples:

#
# Getting the cursor to the desired location
#
ensight.view_transf.cursor(-0.927830,1.474020,0.000000)
#
# Selecting the parent part(s)
#
ensight.part.select_begin(1,3,4)
#
# Setting some attributes before creation
# (others are the current defaults)
#
ensight.ptrace.begin()
ensight.ptrace.variable("VITESSE")
ensight.ptrace.type("streamline")
ensight.ptrace.component(1.0000e+00,1.0000e+00,1.0000e+00)
ensight.ptrace.representation("line")
ensight.ptrace.emit_at_current_time("ON")
ensight.ptrace.end()
#
# Creating trace from a point
#
ensight.ptrace.create_pt()

Returns:

zero on success, non-zero on error