create_surface_net

ptrace.create_surface_net(p0: float, p1: float, p2: float, p3: float, p4: float, p5: float) → int

Create surface restricted particle traces from a screen box pick.

The “ptrace: surface_restricted” command must be ON prior to this command.

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. The number of emitter points will be the product of num_in_x * num_in_y.

Args:

p0:

‘num_in_x’ number of equally spaced points in the x direction of the box pick

p1:

‘num_in_y’ number of equally spaced points in the y direction of the box pick

p2:

‘x1’ screen x coordinate of the first point on the diagonal of the box (0.0 to 1.0)

p3:

‘y1’ screen y coordinate of the first point on the diagonal of the box (0.0 to 1.0)

p4:

‘x2’ screen x coordinate of the second point on the diagonal of the box (0.0 to 1.0)

p5:

‘y2’ screen y coordinate of the second point on the diagonal of the box (0.0 to 1.0)

Examples:

ensight.part.select_begin(1,3,4)
#
# Setting some attributes before creation
# (surface_restricted must be on)
#
ensight.ptrace.begin()
ensight.ptrace.surface_restricted("ON")
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 35 traces from the box selection
#
ensight.ptrace.create_surface_net(5,7)

Returns:

zero on success, non-zero on error