Table of Contents

Name

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

Synopsis

snaps2plot insnap-file [parametervalue] ...

Description

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.

Parameters

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.
s2boxcolor-range
S2PLOT style for the X, Y and Z axes. Default: BCDETMNOQ

See Also

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

http://astronomy.swin.edu.au/s2plot/

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.

Caveats

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.

Author

Peter Teuben

History


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


Table of Contents