NAME
spins2netcdf - convert binary SPINS outputs into netCDF files.
SYNOPSIS
spins2netcdf [-hkmstv] [-fFIELD] [-iINDEX] [-n THREADS] [-o FILE]
DESCRIPTION
spins2netcdf converts the chosen fields and indices of SPINS binary data into netCDF files. If no optional arguments are given all binary files are converted. If the files are large, or there are many this might take a while and be unnecessary. With no arguments, spins2netcdf will create a netCDF file for each index of binary data in the current directory.
By default, spins2netcdf reorients the binary data from y-z-x format into z-y-x format which is preferred by ParaView and VisIt. This can be turned off with the -k flag, which also considerably speeds up the conversion process. However, ParaView and VisIt will incorrectly label the axes.
OPTIONS
-f, --input-fields arg
SPINS field names to convert. The name must be immediately after f (no space allowed), and must repeat the format for multiple field names (ie. -frho -fu -fv ...)
-h, --help
Print to screen the options available.
-i, --input-indices arg
SPINS indices of binary data to convert. Integer must be immediately after i (no space allowed), and must repeat the format for multiple indices (ie. -i5 -i10 -i15 ...)
-k, --keep-orient
Keep the orientation of the SPINS binary data (y-z-x). Without this flag, spins2netcdf will convert the orientation to z-y-x format which is preferred by ParaView and VisIt.
-m, --use-mmap-file
Use memory mapped file.
-n, --num-threads
Number of threads to use. The conversion doesn't parallelize very well, so don't go any larger than n=8.
-o, --output-file
NetCDF output file name. Default is output_#.nc where # is the SPINS index. All files will end in _#.nc.
-s, --silent
Do not print progress messages to screen.
-t, --keep-temporary-files
Keep temporary files (*.tmp) for debugging.
-v, --version
Print the version information to screen.
EXAMPLES
Convert all binary files for all fields and all indices:
spins2netcdf
Convert only the rho fields:
spins2netcdf -frho
Convert only the 10th and 20th index:
spins2netcdf -i10 -i20
Use 4 threads:
spins2netcdf -n 4
