Table of Contents
snapgridsmooth - grid a snapshot into a 3D image cube with adaptive
smoothing
snapgridsmooth in=snapshot out=image [parameter=value]
snapgridsmooth grids three arbitrary bodytrans expressions
(default: x, y and z) of a snapshot into a datacube with adaptive smoothing
based on a bodytrans variable. Unlike snapgrid(1NEMO)
, which handles 2D
projections and certain types of line-of-sight processing, this program simply
accumulates the emission in each cell, and optional smoothing, normalization
and periodicity.
The following parameters can be given in any
order if the keyword is also passed with it:
- in=in-file
- input file, must
be in snapshot(5NEMO)
format. Multiple snapshots can be stacked uses the
times= keyword: see stack= below. [no default].
- out=out-file
- output file,
will be in image(5NEMO)
format. Depending on the use of times=, stack= and
evar= (see below) one more multiple cubes can be output. [no default].
- times=t1:t2,t3,..
- Selection of the times of snapshots to be selected for gridding. For stack=t
all snapshots will be co-added into one image, however selecting stack=f
or selecting multiple evar's one can request multiple output images. [Default:
all].
- xrange=xb:xe
- Range in xvar to bin. Note that all particles outside
this grid will be discarded, even if periodic=t (see below). [default:
-2:2].
- yrange=xb:xe
- Range in yvar to bin [default: -2:2].
- zrange=xb:xe
- Range
in zvar to bin [default: -2:2].
- xvar=x-expression
- The value of x-expression
is gridded along the X axis. [default: x].
- yvar=y-expression
- The value of
y-expression is gridded along the Y axis. [default: y].
- zvar=z-expression
- The
value of z-expression is gridded along the Z axis [default: -vz].
- evar=emissivity
- Variable to denote emissivity (density if you wish) per particle. You can
select more than 1 expression, in which case different images will be written
out (only in stack=f mode) [default: m].
- svar=smoothing
- Variable to denote
gaussian smoothing
- nx=x-pixels
- Number of pixels along the X axis of the
cube [default: 64].
- ny=y-pixels
- Number of pixels along the Y axis of the
cube [default: 64].
- nz=z-pixels
- Number of pixels along the Z axis of the
cube [default: 64].
- stack=t|f
- Should all snapshots from the input file be
stacked, or write one image per selected (see times=) time? [default: f].
- periodic=t|f
- If set true, smoothing results will be applied on a periodic
grid. Particles that fell outside the x,y,z grid, however, are discarded
and never smoothed/aliased into the visible grid. [Default: f]
- normalize=t|f
- If smoothing is applied (see svar=), should the smoothing be normalized
as to conserve mass (evar=)? [Default: t]
The following example
...
This program was cloned from snapgrid(1NEMO)
, and the keywords stack=
and multiple values for evar= have not been tested out.
Units are maintained
in the same way as in snapshots, they don't have a specific name, but carry
their normal meaning 'length', 'velocity' and 'mass'. Since snapgridsmooth calculates
space densities, its units are formally 'mass' per cubic 'length'
snapgrid(1NEMO)
,
tsf(1NEMO)
, snapshot(5NEMO)
, image(5NEMO)
Peter Teuben
src/nbody/image snapgridsmooth.c
1-nov-06 V0.1: Created PJT/ES
6-nov-06 V0.3: added normalize= and fixes for that PJT
Table of Contents