Table of Contents


snaps2plot - display an N-body snapshot file in a s2plot display


snaps2plot insnap-file [parametervalue] ...


snaps2plot plots a sequence of frames from a N-body snapshot file on a s2plot display device,

This program is derived from snapplot3(1NEMO) and therefore shares many of its keywords.


The following parameters are recognized; they may be given in any order.
Input data is read from snap-file, which must be in snapshot format.
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".
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.
Label for the X axis. The default is the expression given for xvar.
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.
See above. The default is y.
See above. The default is z.
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.
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.
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.
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.
S2PLOT style for the X, Y and Z axes. Default: BCDETMNOQ

See Also

snapplot3(1NEMO) , snapplot(1NEMO) , bodytrans(1NEMO) , snapshot(5NEMO) , s2splot(5NEMO)

Environment Variables

s2plot needs a number of environment variables during install, and optionally during running. The most common ones are S2PATH and S2ARCH for building, and S2PLOT_DEV for selecting the default plotting device. If you don’t use s2plot for yapp, more than likely the $YAPP will be conflicting with a valid name for S2PLOT_DEV. use yapp=/? to get a valid list of s2plot device names, possibly yapp=/S2MONO.


Version 0.1 was a quick hack on valentines evening. It only plots the selected snapshot, it cannot yet page to the next one. Colors not implemented. Layers (visib=) are using s2plot’s symbols (1,2,...). No tickmark implementation either.


Peter Teuben


14-feb-2011    V0.1 - initial version written      PJT

Table of Contents