Tracer

compute particle traces and streamlines

data_in0 vector field (data_in0) data_in1 additional field on same geometry (data_in1) Tracer data_out0 stream lines or points with mapped vector (data_out0) data_out1 stream lines or points with mapped field (data_out1) particle_id stream lines or points with mapped particle id (particle_id) step stream lines or points with step number (step) time stream lines or points with time (time) stepwidth stream lines or points with stepwidth (stepwidth) distance stream lines or points with accumulated distance (distance) stop_reason stream lines or points with reason for finishing trace (stop_reason) cell_index stream lines or points with cell index (cell_index) block_index stream lines or points with block index (block_index)

Parameters

name

description

type

verbose

verbose output

Int

taskType

task type (Streamlines, MovingPoints, Pathlines, Streaklines)

Int

startpoint1

1st initial point

Vector

startpoint2

2nd initial point

Vector

direction

direction for plane

Vector

no_startp

number of startpoints

Int

max_no_startp

maximum number of startpoints

Int

steps_max

maximum number of integrations per particle

Int

trace_len

maximum trace distance

Float

trace_time

maximum trace time

Float

tdirection

direction in which to trace (Both, Forward, Backward)

Int

startStyle

initial particle position configuration (Line, Plane, Cylinder)

Int

integration

integration method (Euler, RK32, ConstantVelocity)

Int

min_speed

minimum particle speed

Float

dt_step

duration of a timestep (for moving points or when data does not specify realtime

Float

h_init

fixed step size for euler integration

Float

h_min

minimum step size for rk32 integration

Float

h_max

maximum step size for rk32 integration

Float

err_tol_abs

absolute error tolerance for rk32 integration

Float

err_tol_rel

relative error tolerance for rk32 integration

Float

cell_relative

whether step length control should take into account cell size

Int

velocity_relative

whether step length control should take into account velocity

Int

use_celltree

use celltree for accelerated cell location

Int

num_active

number of particles to trace simultaneously on each node (0: no. of cores)

Int

particle_placement

where a particle’s data shall be collected (InitialRank, RankById, RankByTimestep, Rank0)

Int

cell_index_modulus

modulus for cell number output

Int

simplification_error

tolerable relative error for result simplification

Float