splash -- A visualisation tool for SPH data (c)2004-2017 Daniel
Price
splash file1 file2 file3...
SPLASH: A visualisation tool for SPH data (c)2004-2017 Daniel
Price v2.8.0 [6th April 2018]
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 for line plotting (.ev files)
- -360
- : set default options suited to 360 video
- -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)">write(1)">write(1)
time,npart,ncolumns
- do i=1,npart
- write(1)~2">write(1)~2">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 delta
- : 0.5*(max - min)/mean of each column vs. time
- output to file called 'deltavals.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'
- calc tracks
- : track particle data vs time for selected* particle,
- output to file called 'tracks.out'
- ( * select "xy limits relative to particle" in l)imits
menu", or
- press "t" in interactive mode, and save settings to
splash.defaults )
- 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.8.0 [6th April 2018]
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 for line plotting (.ev files)
- -360
- : set default options suited to 360 video
- -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)~3">write(1)~3">write(1)
time,npart,ncolumns
- do i=1,npart
- write(1)~4">write(1)~4">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 delta
- : 0.5*(max - min)/mean of each column vs. time
- output to file called 'deltavals.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'
- calc tracks
- : track particle data vs time for selected* particle,
- output to file called 'tracks.out'
- ( * select "xy limits relative to particle" in l)imits
menu", or
- press "t" in interactive mode, and save settings to
splash.defaults )
- 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.