A visualisation tool for sph data (c)2004-2014 daniel price
splash \,file1 file2 file3\/...
SPLASH: A visualisation tool for SPH data (c)2004-2014 Daniel Price v2.5.0 [22nd Aug. 2014]
Usage with flags: splash [-p fileprefix] [-d defaultsfile] [-l limitsfile] [-ev] [-lowmem] [-o format] [-x col] [-y col] [-render col] [-cont col] file1 file2 ...
Command line options:
-p fileprefix
: change prefix to ALL settings files read/written by splash
-d defaultsfile
: change name of defaults file read/written by splash
-l limitsfile
: change name of limits file read/written by splash
-e, -ev
: use default options best suited to ascii evolution files (ie. energy vs time)
-lm, -lowmem
: use low memory mode [applies only to sphNG data read at present]
-o pixformat
: dump pixel map in specified format (use just -o for list of formats)
Command line plotting mode:
-x column
: specify x plot on command line (ie. do not prompt for x)
-y column
: specify y plot on command line (ie. do not prompt for y)
-r[ender] column
: specify rendered quantity on command line (ie. no render prompt) (will take columns 1 and 2 as x and y if -x and/or -y not specified)
-vec[tor] column
: specify vector plot quantity on command line (ie. no vector prompt) -c[ontour] column : specify contoured quantity on command line (ie. no contour prompt)
-dev device
: specify plotting device on command line (ie. do not prompt)
convert mode ("splash to X dumpfiles"): splash to ascii : convert SPH data to ascii file dumpfile.ascii
to binary
: convert SPH data to simple unformatted binary dumpfile.binary
write(1) time,npart,ncolumns
do i=1,npart
write(1) dat(1:ncolumns),itype
enddo
to phantom : convert SPH data to binary dump file for PHANTOM to gadget : convert SPH data to default GADGET snapshot file format
Grid conversion mode ("splash to X dumpfiles"):
splash to grid
: interpolate basic SPH data (density, plus velocity if present in data)
to 2D or 3D grid, write grid data to file (using default output=ascii)
to gridascii
: as above, grid data written in ascii format
to gridascii2
: grid data written in ascii format, all in one file
to gridbinary
: as above, grid data in simple unformatted binary format:
write(unit) nx,ny,nz,ncolumns,time
[ 4 bytes each ]
write(unit) (((rho(i,j,k),i=1,nx),j=1,ny),k=1,nz)
[ 4 bytes each ]
write(unit) (((vx(i,j,k), i=1,nx),j=1,ny),k=1,nz)
[ 4 bytes each ]
write(unit) (((vy(i,j,k), i=1,nx),j=1,ny),k=1,nz)
[ 4 bytes each ]
write(unit) (((...(i,j,k),i=1,nx),j=1,ny),k=1,nz)
[ 4 bytes each ]
allto grid
: as above, interpolating *all* columns to the grid (and output file)
allto gridascii
: as above, with ascii output
allto gridbinary
: as above, with binary output
Analysis mode ("splash calc X dumpfiles") on a sequence of dump files:
splash calc energies
: calculate KE,PE,total energy vs time
output to file called 'energy.out'
calc massaboverho : mass above a series of density thresholds vs time
output to file called 'massaboverho.out'
calc max
: maximum of each column vs. time
output to file called 'maxvals.out'
calc min
: minimum of each column vs. time
output to file called 'minvals.out'
calc diff
: (max - min) of each column vs. time
output to file called 'diffvals.out'
calc amp
: 0.5*(max - min) of each column vs. time
output to file called 'ampvals.out'
calc mean
: mean of each column vs. time
output to file called 'meanvals.out'
calc rms
: (mass weighted) root mean square of each column vs. time
output to file called 'rmsvals.out'
the above options all produce a small ascii file with one row per input file. the following option produces a file equivalent in size to one input file (in ascii format):
calc timeaverage
: time average of *all* entries for every particle
output to file called 'time_average.out'
calc ratio
: ratio of *all* entries in each file compared to first
output to file called 'ratio.out'
Basic splash usage is explained in the userguide,
located in the directory splash/docs/splash.pdf
v2.5.0 [22nd Aug. 2014]
Usage: splash file1 file2 file3...
Usage with flags: splash [-p fileprefix] [-d defaultsfile] [-l limitsfile] [-ev] [-lowmem] [-o format] [-x col] [-y col] [-render col] [-cont col] file1 file2 ...
Command line options:
-p fileprefix
: change prefix to ALL settings files read/written by splash
-d defaultsfile
: change name of defaults file read/written by splash
-l limitsfile
: change name of limits file read/written by splash
-e, -ev
: use default options best suited to ascii evolution files (ie. energy vs time)
-lm, -lowmem
: use low memory mode [applies only to sphNG data read at present]
-o pixformat
: dump pixel map in specified format (use just -o for list of formats)
Command line plotting mode:
-x column
: specify x plot on command line (ie. do not prompt for x)
-y column
: specify y plot on command line (ie. do not prompt for y)
-r[ender] column
: specify rendered quantity on command line (ie. no render prompt) (will take columns 1 and 2 as x and y if -x and/or -y not specified)
-vec[tor] column
: specify vector plot quantity on command line (ie. no vector prompt) -c[ontour] column : specify contoured quantity on command line (ie. no contour prompt)
-dev device
: specify plotting device on command line (ie. do not prompt)
convert mode ("splash to X dumpfiles"): splash to ascii : convert SPH data to ascii file dumpfile.ascii
to binary
: convert SPH data to simple unformatted binary dumpfile.binary
write(1) time,npart,ncolumns
do i=1,npart
write(1) dat(1:ncolumns),itype
enddo
to phantom : convert SPH data to binary dump file for PHANTOM to gadget : convert SPH data to default GADGET snapshot file format
Grid conversion mode ("splash to X dumpfiles"):
splash to grid
: interpolate basic SPH data (density, plus velocity if present in data)
to 2D or 3D grid, write grid data to file (using default output=ascii)
to gridascii
: as above, grid data written in ascii format
to gridascii2
: grid data written in ascii format, all in one file
to gridbinary
: as above, grid data in simple unformatted binary format:
write(unit) nx,ny,nz,ncolumns,time
[ 4 bytes each ]
write(unit) (((rho(i,j,k),i=1,nx),j=1,ny),k=1,nz)
[ 4 bytes each ]
write(unit) (((vx(i,j,k), i=1,nx),j=1,ny),k=1,nz)
[ 4 bytes each ]
write(unit) (((vy(i,j,k), i=1,nx),j=1,ny),k=1,nz)
[ 4 bytes each ]
write(unit) (((...(i,j,k),i=1,nx),j=1,ny),k=1,nz)
[ 4 bytes each ]
allto grid
: as above, interpolating *all* columns to the grid (and output file)
allto gridascii
: as above, with ascii output
allto gridbinary
: as above, with binary output
Analysis mode ("splash calc X dumpfiles") on a sequence of dump files:
splash calc energies
: calculate KE,PE,total energy vs time
output to file called 'energy.out'
calc massaboverho : mass above a series of density thresholds vs time
output to file called 'massaboverho.out'
calc max
: maximum of each column vs. time
output to file called 'maxvals.out'
calc min
: minimum of each column vs. time
output to file called 'minvals.out'
calc diff
: (max - min) of each column vs. time
output to file called 'diffvals.out'
calc amp
: 0.5*(max - min) of each column vs. time
output to file called 'ampvals.out'
calc mean
: mean of each column vs. time
output to file called 'meanvals.out'
calc rms
: (mass weighted) root mean square of each column vs. time
output to file called 'rmsvals.out'
the above options all produce a small ascii file with one row per input file. the following option produces a file equivalent in size to one input file (in ascii format):
calc timeaverage
: time average of *all* entries for every particle
output to file called 'time_average.out'
calc ratio
: ratio of *all* entries in each file compared to first
output to file called 'ratio.out'
unknown command line argument '--version'
The full documentation for SPLASH: is maintained as a Texinfo manual. If the info and SPLASH: programs are properly installed at your site, the command
info SPLASH:
should give you access to the complete manual.