Provided by: splash_2.10.1-1_amd64 bug

NAME

       splash -- A visualisation tool for SPH data (c)2004-2020 Daniel Price and contributors

SYNOPSIS

       splash file1 file2 file3...

DESCRIPTION

       SPLASH:  A  visualisation  tool  for  SPH  data (c)2004-2020 Daniel Price and contributors
       v2.10.1 [24th June 2020]

       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) time,np,ncols
              do i=1,np

       write(1) dat(1:ncols),itype
              enddo

       to stream
              : convert SPH data to streamed binary format dumpfile.binarystream:

              t,np,ncols,np*(dat(1:ncols),itype) [4,4,4,np*(ncols*4,4)] bytes

              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,xmin,xmax,ymin,ymax,zmin,zmax [ 4x4,7x8 bytes ]
              write(unit) (((rho(i,j,k),i=1,nx),j=1,ny),k=1,nz)  [ 8  bytes  each  ]  write(unit)
              (((vx(i,j,k),  i=1,nx),j=1,ny),k=1,nz)   [ 8 bytes each ] write(unit) (((vy(i,j,k),
              i=1,nx),j=1,ny),k=1,nz)       [      8      bytes      each      ]      write(unit)
              (((...(i,j,k),i=1,nx),j=1,ny),k=1,nz)  [ 8 bytes each ]

       to gridstream
              : grid data in byte-stream binary format (e.g. for python):

              nx,ny,nz,ncolumns,time,xmin,xmax,ymin,ymax,zmin,zmax,rho [ 4,4,4,4,8*7,8*nx*ny*nz ]

       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.10.1 [24th June 2020]

       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) time,np,ncols
              do i=1,np

       write(1) dat(1:ncols),itype
              enddo

       to stream
              : convert SPH data to streamed binary format dumpfile.binarystream:

              t,np,ncols,np*(dat(1:ncols),itype) [4,4,4,np*(ncols*4,4)] bytes

              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,xmin,xmax,ymin,ymax,zmin,zmax [ 4x4,7x8 bytes ]
              write(unit)  (((rho(i,j,k),i=1,nx),j=1,ny),k=1,nz)   [  8  bytes each ] write(unit)
              (((vx(i,j,k), i=1,nx),j=1,ny),k=1,nz)  [ 8 bytes each ]  write(unit)  (((vy(i,j,k),
              i=1,nx),j=1,ny),k=1,nz)       [      8      bytes      each      ]      write(unit)
              (((...(i,j,k),i=1,nx),j=1,ny),k=1,nz)  [ 8 bytes each ]

       to gridstream
              : grid data in byte-stream binary format (e.g. for python):

              nx,ny,nz,ncolumns,time,xmin,xmax,ymin,ymax,zmin,zmax,rho [ 4,4,4,4,8*7,8*nx*ny*nz ]

       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'

SEE ALSO

       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.

SPLASH: A visualisation tool for SPH data (cJune420200 Daniel Price and contributors   SPLASH:(1)