LIGGGHTS(R)-PUBLIC WWW Site - LIGGGHTS(R)-PUBLIC Documentation - LIGGGHTS(R)-PUBLIC Commands

fix property/atom/tracer/stream command

Syntax:

fix id group property/atom/tracer/stream mark_step s n_tracer n insert_stream ins-ID every e

ID, group-ID are documented in fix command
property/atom/tracer/stream = style name of this fix command
mark_step = obligatory keyword
s = step when atoms are marked (or started to be marked, depending on marker_style)
n_tracer = obligatory keyword
n = number of tracer atoms to be marked
insert_stream = obligatory keyword
ins-ID = ID of a fix insert/stream
every = obligatory keyword
```
e = 'once' or integer > 0  
```

Examples:

fix tracer all property/atom/tracer/stream mark_step 10000  insert_stream ins  n_tracer 20  every 10000

Description:

Fix property/atom/tracer/stream marks a given number of particles (as defined by keyword n_tracer) which are generated by a fix insert/stream command (as defined by keyword ins-ID. The first n_tracer particles which pass the insertion face after time-step mark_step are being marked as tracers. In case of every = once, this procedure is performed once, otherwise the procedure is repeated for the first n_tracer particles which pass the insertion face after step mark_step + every.

Note that even for option once, particles are the marking procedure can extend over multiple packets of insertion by a fix insert/stream in case that the number of particles inserted in a packet is smaller than the number of particles to tag (as defined by keyword n_tracer).

An arbitrary number of fix property/atom/tracer/stream commands can be used for a given fix insert/stream.

It is useful to combine this command with a compute nparticles/tracer/region command to compute residence time distributions.

IMPORTANT NOTE: Due to some parallel operation which needed to tag the particles, you need an atom map to be allocated, see the atom_modify command for details.

Restart, fix_modify, output, run start/stop, minimize info:

Information about this fix is written to binary restart files .

This fix computes a per-atom vector (the marker) which can be accessed by various output commands. . This fix also computes a global scalar indicating how many particles were marked since the last time the global scalar was computed. This scalar can also be accessed by various output commands. .

Restrictions:

Currently, this feature does not support multi-sphere particles.

Related commands:

compute nparticles/tracer/region

Default: none