SPARTA WWW Site - SPARTA Documentation - SPARTA Commands

compute dt/grid command

compute dt/grid/kk command


compute ID dt/grid group-ID tfraction cfraction lambda temperature usq vsq wsq 


compute 1 grid all mymixture nrho temp usq vsq wsq
fix 1 ave/grid all 10 50 500 c_1[*]
compute lambda lambda/grid f_1[1] f_1[2] Ar
compute tstep dt/grid all 0.25 0.1 c_lambda f_1[2] f_1[3] f_1[4] f_1[5] 


Calculate a current timestep for each grid cell in a grid cell group, based on the properties of particles currently in the cell and the grid cell size. The per-grid cell timesteps can be output in a per-grid dump file for post analyses. Or they can be used as input to the fix dt/reset command to adjust the global timestep for a variable timestep simulation. See this section of the manual for more information on variable timestep simulations.

Only grid cells in the grid group specified by group-ID are included in the calculations. See the group grid command for info on how grid cells can be assigned to grid groups.

The tfraction and cfraction arguments are both values from 0.0 to 1.0 which are applied to the transit term and collision term in the example formula for a candidate cell timestep below.

In practice, multiple transit-based timestep candidates are constructed based on the cell dimensions in each coordinate direction and the associated average particle velocity components in addition to the maximum most probable speed. The selected cell timestep is the minumum of all candidate timesteps. The collision and transit fractions simply provide a user-defined safety margin for the collision time and transit time estimates. In (Bird2013), Bird recomnmends setting the collision fraction to 0.2, which is likely a good starting point for the selection of both of these fractions.

The remaining 5 arguments specify either computes which calculate various per grid cell quantities or fixes which time average those per grid cell quantities. The 5 quantities are per grid cell mean free path (lambda), temperature, and the xyz components of the velocity squared for particles in the grid cell. The compute lambda calculates a mean free path. The compute grid command can calculate the other 4 quantities. The compute thermal/grid command can also compute a per grid cell temperature.

This is done by specifying the lambda, temperature, usq, vsq, wsq arguments like this:

See the Example section above for an example of how these arguments can be specified.

IMPORTANT NOTE: If the IDs of one or more fix ave/grid commands is used for these 5 arguments, they only produce output on timesteps that are multiples of their Nfreq argument. Thus this compute can only be invoked on those timesteps.

Output info:

This compute calculates a per-grid vector.

This compute performs calculations for all flavors of child grid cells in the simulation, which includes unsplit, cut, split, and sub cells. See Section 6.8 of the manual for details of how SPARTA defines child, unsplit, split, and sub cells. Note that cells inside closed surfaces contain no particles. These could be unsplit or cut cells (if they have zero flow volume). Both of these kinds of cells will compute a zero result for the cell timestep. Likewise, split cells store no particles and will produce a zero result. This is because their sub-cells actually contain the particles that are geometrically inside the split cell. Additionally, any cell that is able to store particles but does not have any particles when this compute is invoked produces a zero result. Finally, a zero result is produced if any cell data to be used in the timestep calculation is sufficiently close to zero (including the maximum most probable speed, the velocity magnitude, and the mean free path).

The vector can be accessed by any command that uses per-grid values from a compute as input. See Section 4.4 for an overview of SPARTA output options.

Styles with a kk suffix are functionally the same as the corresponding style without the suffix. They have been optimized to run faster, depending on your available hardware, as discussed in the Accelerating SPARTA section of the manual. The accelerated styles take the same arguments and should produce the same results, except for different random number, round-off and precision issues.

These accelerated styles are part of the KOKKOS package. They are only enabled if SPARTA was built with that package. See the Making SPARTA section for more info.

You can specify the accelerated styles explicitly in your input script by including their suffix, or you can use the -suffix command-line switch when you invoke SPARTA, or you can use the suffix command in your input script.

See the Accelerating SPARTA section of the manual for more instructions on how to use the accelerated styles effectively.


As explained above, to use this compute with nrho or temp defined as input from a fix ave/grid command, this compute must only be invoked on timesteps that are multiples of the Nfreq argument used by the fix, since those are the steps when it produces output.

Related commands:

fix dt/reset, compute grid, compute thermal/grid, fix ave/grid

Default: none

(Bird2013) G. A. Bird, The DSMC method, CreateSpace Independent Publishing Platform, 2013.