Table of Contents
snapplot3 - display an N-body snapshot file in a 3-panel XY-YZ-XZ display
snapplot3 insnap-file [parametervalue] ...
snapplot3 plots
a sequence of frames from a N-body snapshot file on a yapp(5NEMO)
display
device, and plots 3 panels per page in the special cube-foldout XY-ZY-XZ:
the lower left box contains the XY view, to its right the ZY view, and
to the top the XZ view. It is possible to make the XY box a different size,
at the cost (or benefit) of the other ZY and XZ views.
This program is derived
from snapplot(1NEMO)
and therefore shares many of its keywords.
The
following parameters are recognized; they may be given in any order.
- insnap-file
- Input data is read from snap-file, which must be in snapshot format.
- timestime-range
- Only plot frames with time values within time-range, which is of the form,
eg, "1.0:1.5,2.5,3.0". The default is "all".
- xvarx-expression
- The value of x-expression
is plotted along the X axis. x-expression is a real-valued C language expression
over the real values x, y, z, vx, vy, vz, phi, t, and the integer value
i. The default is x.
- xlabelx-axis-label
- Label for the X axis. The default is
the expression given for xvar.
- xrangex-axis-range
- Range of values for the
X axis, specified either as a single number (in which case the lower bound
is zero) or a pair of numbers separated by a colon. The default range is
-2.0:2.0.
- yvary-expression
- See above. The default is y.
- ylabely-axis-label
- yrangey-axis-range
- zvarz-expression
- See above. The default is z.
- zlabelz-axis-label
- zrangez-axis-range
- visibexpression
- Determines the visibility of particles. expression is a
integer expression in the above variables; only points with non-zero values
are plotted. Particles are plotted in order of their visib, e.g. visib=1 are
plotted before visib=2, thus this keyword can be used to re-arrange the
plotting order on screen (useful if colors are used). The default is 1.
- psizeexpression
- Determines the point type and size. expression is a real expression in the
above variables; zero means plot a point, positive (negative) means plot
a circle (cross) with size controled by absolute value. The default is 0.
- colorexpression
- Determines the point color. expression is a real expression
in the above variables; values between 0 and 1 produce a sequence of saturated
colors starting with red, running through the spectrum, and wrapping back
to red. The default is 0.
- crangecolor-range
- Range of colors that should be
mapped. Below and above these ranges the yapp(3NEMO)
plotting layer may
determine the visibility of the points. The default range is 0:1.
Although
the default is 3 equal size panels, for a detailed look at disk galaxies
the following example gives more resolution in the Z direction, but a larger
view of the XY plane:
% mkexpdisk out=disk1 nbody=10000
% gyrfalcON in=disk1 out=disk1.out tstop=1 step=0.1 (takes 8" on a
1.6GHz class pentium4)
% snapplot3 disk1.out xbox=1:16 ybox=1:16 zbox=16.5:19.5 zrange=-0.2:0.2 nzticks=3
glnemo2(1NEMO)
, snaps2plot(1NEMO)
, snapplot(1NEMO)
, bodytrans(1NEMO)
,
snapshot(5NEMO)
.
Peter Teuben
2-nov-05 V0.1 - initial version written PJT
Table of Contents