Specifies parameters for the output of path line segment endpoints.


AcuTrace Command


TRACE_OUTPUT {parameters}


This command has no qualifier.


active (boolean) [=off]
Flag specifying if trace output is active.
output_frequency (integer) [=1]
Segment frequency at which to output the endpoints.
flow_state_data or flow_state (boolean) [=off]
Flag specifying whether to include the flow state in the output.
flow_gradient_data or flow_gradient (boolean) [=off]
Flag specifying whether to include gradients of the flow state in the output.


Particle traces are computed by AcuTrace as a series of segments. Trace output records the endpoints of all the segments. The endpoints for all particles are recorded. The parameter output_frequency specifies how often to record the endpoints. For example,
   active            = on
   output_frequency  = 5

specifies that every fifth segment endpoint is recorded.

The active, flow_state_data, and flow_gradient_data parameters control what information is recorded. No trace output is recorded unless active = on. By default, all particle outputs and no flow outputs are recorded when trace output is active.

Particle values are the state of the particle, that is, its position, time, particle velocity, and so on. The flow outputs are found by interpolating the AcuSolve flow field to the current position and time of the particle.

Particle outputs always include

  • Seed ID
  • Coordinates
  • Time
  • Particle velocity
  • Element ID
  • Element set ID
  • Marker
  • Particle velocity magnitude
  • Trace length

They also include

  • Particle mass
  • Particle density
  • Particle radius

if the parameter particle equals finite_mass model in the EQUATION command,

  • Component values

if the parameter number_particle_components in the EQUATION command is non-zero,

  • User equation values

if one or more user equations are specified in the user_equations parameter of the EQUATION command.

  • Turbulence random seed

if the parameter turbulent_trace equals on in the TRACE_PARAMETERS command and

  • Stretch vector
  • Stretch magnitude
  • Log stretch magnitude
  • Stretch rate magnitude

if the parameter stretch does not equal none in the EQUATION command.

Flow state values always include

  • Flow velocity
  • Flow pressure
  • Flow velocity magnitude
  • Flow strain rate magnitude

They also include

  • Flow temperature
  • Flow species
  • Flow eddy viscosity

if these are available in the AcuSolve database.

Flow gradient values currently include only

  • Gradient of flow velocity

Note that for the massless particle motion equation, the particle and the flow velocity fields are identical except possibly for particle positions in elements next to a wall.