One of the main intents of the IRATE format is to unify the variety of formats currently used for simulations into a standard format that many tools can access efficiently. Hence, the IRATE package provides a number of conversion tools from various formats
The printhdf5 script prints out the format (e.g. The names of all the groups and datasets, and optionally artibutes) of the supplied HDF5 file. It can also be used to check whether or not an HDF5 file conforms to the IRATE format. Use it as printhdf5 [options] filename.
Options:
Check whether or not the given file conforms to the IRATE format.
Check whether or not the given file conforms to the strict IRATE format (this implies -c).
Print out attributes of a group.
If specified, gives the filename into which the output should be written.
The tipsy2irate script converts files in the tipsy binary format to IRATE. Use it as tipsy2irate [options] infile [outfile]. If outfile is not specified, it will be the same as infile with ‘.h5’ added.
Options:
add options
The gb2irate script converts files in the Gadget binary format to IRATE. Use it as gb2irate input-file [output-file] [options]. If outfile is not specified, it will be the same as infile with ‘-irate.hdf5’ added.
Options:
Specifies that the input file was produced with output format set to 2; i.e. that there are labels indicating what each block type is.
Interprets the output-file as a directory, and saves the resulting IRATE file in that directory with the default name.
Specifies that the input file is an initial conditions file, in which case gas densities and smoothing lengths are skipped.
Specifies that the gravitational potential is contained in the GADGET file, which is controlled via the Makefile of GADGET2. Has no effect if –type2 is enabled.
Specifies that the acceleration is contained in the GADGET file, which is controlled via the Makefile of GADGET2. No effect if –type2 is enabled.
Specifies that the rate of change of entropy of gas particles is included in the GADGET file, which is controlled via the Makefile of GADGET2. Has no effect if –type2 is enabled.
Specifies that the timestep of each particle is contained in the GADGET file, which is controlled via the Makefile of GADGET2. Has no effect if –type2 is enabled.
Tree (either gas, dark, or star) that the particles in the gas group of the GADGET file will be saved under.
Tree (either gas, dark, or star) that the particles in the halo group of the GADGET file will be saved under.
Tree (either gas, dark, or star) that the particles in the disk group of the GADGET file will be saved under.
Tree (either gas, dark, or star) that the particles in the bulge group of the GADGET file will be saved under.
Tree (either gas, dark, or star) that the particles in the star group of the GADGET file will be saved under.
Tree (either gas, dark, or star) that the particles in the boundary group of the GADGET file will be saved under.
Name of the group that the particles in the gas group of the GADGET file is given, under the specified tree.
Name of the group that the particles in the halo group of the GADGET file is given, under the specified tree.
Name of the group that the particles in the disk group of the GADGET file is given, under the specified tree.
Name of the group that the particles in the bulge group of the GADGET file is given, under the specified tree.
Name of the group that the particles in the star group of the GADGET file is given, under the specified tree.
Name of the group that the particles in the boundary group of the GADGET file is given, under the specified tree.
The gb2irate script converts files in the Gadget HDF5 format to IRATE. Use it as gh52irate input-file [output-file] [options]. If outfile is not specified, it will be the same as infile with ‘-irate.hdf5’ added.
Options:
Tree (either gas, dark, or star) that the particles in the gas group of the GADGET file will be saved under.
Tree (either gas, dark, or star) that the particles in the halo group of the GADGET file will be saved under.
Tree (either gas, dark, or star) that the particles in the disk group of the GADGET file will be saved under.
Tree (either gas, dark, or star) that the particles in the bulge group of the GADGET file will be saved under.
Tree (either gas, dark, or star) that the particles in the star group of the GADGET file will be saved under.
Tree (either gas, dark, or star) that the particles in the boundary group of the GADGET file will be saved under.
Name of the group that the particles in the gas group of the GADGET file is given, under the specified tree.
Name of the group that the particles in the halo group of the GADGET file is given, under the specified tree.
Name of the group that the particles in the disk group of the GADGET file is given, under the specified tree.
Name of the group that the particles in the bulge group of the GADGET file is given, under the specified tree.
Name of the group that the particles in the star group of the GADGET file is given, under the specified tree.
Name of the group that the particles in the boundary group of the GADGET file is given, under the specified tree.
The enbid2irate script adds the data from files produced by EnBiD in the GADGET format to existing IRATE files. Use it as enbid2irate enbid-file irate-file [output-file] [options]. If outfile is not specified, it defaults to irate-file with ‘-wenbid.hdf5’ added. enbid-file should be a binary file as produced by EnBiD, and irate-file should be an existing IRATE file. All data is saved under /Analysis
Options:
Tree (either gas, dark, or star) that the particles in the gas group of the GADGET file will be saved under.
Tree (either gas, dark, or star) that the particles in the halo group of the GADGET file will be saved under.
Tree (either gas, dark, or star) that the particles in the disk group of the GADGET file will be saved under.
Tree (either gas, dark, or star) that the particles in the bulge group of the GADGET file will be saved under.
Tree (either gas, dark, or star) that the particles in the star group of the GADGET file will be saved under.
Tree (either gas, dark, or star) that the particles in the boundary group of the GADGET file will be saved under.
Name of the group that the particles in the gas group of the GADGET file is given, under the specified tree.
Name of the group that the particles in the halo group of the GADGET file is given, under the specified tree.
Name of the group that the particles in the disk group of the GADGET file is given, under the specified tree.
Name of the group that the particles in the bulge group of the GADGET file is given, under the specified tree.
Name of the group that the particles in the star group of the GADGET file is given, under the specified tree.
Name of the group that the particles in the boundary group of the GADGET file is given, under the specified tree.
The gb2-enbid2irate script combines the gb2irate and enbid2irate scripts into one step. Use it as gb-enbid2irate gadget-file enbid-file [output-file] [options]. If outfile isn’t specified, it defaults to gadget-file with ‘-enbid-irate.hdf5’ added. Takes the same options as gb2irate.
The ahf2irate script converts files in the AHF ASCII format to IRATE. Use it as ahf2irate input-file-base [output-file] [options]. The input file base should be provided as *.AHF_; i.e. everything up to the “halos” or “particles” or “profiles” part of the filename. If output-file isn’t given, it defaults to the input file base with “irate.hdf5” added.
Options:
Include particle data from input-file-base + ‘particles’. If given, the data will be saved in a second HDF5 file that will be linked to the main IRATE catalog file.
Include radial profiles from input-file-base + ‘profiles’. Data will be saved under /Catalog/RadialProfiles/
Include both particles and profiles data; i.e. enables both –particles and –particles.
Enable if AHF was not compiled with -DGAS_PARTICLES or code will fail in trying to combine spatial datasets related to gas and star particles.
Specify an AHF parameter file to be saved as attributes to /CatalogHeader/AHF.
Overwrite the existing output file, if it exists.
Maximum size that particle data will be in memory before writing to a file, in GB. Note that this only has an effect if using HDF5 1.8; otherwise, all the particles will be read before anything is written.
Force the usage of HDF5 1.6 API, even if 1.8 is found. At present, the benefits that 1.8 provides aren’t working, so this is always enabled.
The ahfparticles2irate script reads an AHF _particles file, saves it to an HDF5 file, then links the resulting datasets to an existing IRATE catalog file. Use it as ahfparticles2irate particle-file irate-file [output-file] [options]. If output-file isn’t specified, it defaults to irate-file + ‘-particles.hdf5’.
Options:
Overwrite the existing output file, if it exists.
Maximum size that particle data will be in memory before writing to a file, in GB. Note that this only has an effect if using HDF5 1.8; otherwise, all the particles will be read before anything is written.
Force the usage of HDF5 1.6 API, even if 1.8 is found. At present, the benefits that 1.8 provides aren’t working, so this is always enabled.
The rockstar2irate script converts Rockstar halo catalogs to IRATE catalog files. Use it as rockstar2irate input-file [output-file] [format] [options]. If output-file isn’t specified, it defaults to input-file with ‘-irate.hdf5’ added.
Options:
Specifies that the input file is a Rockstar binary file.
Specifies that the input file is a Rockstar ASCII file.
Overwrite the existing IRATE catalog file, if one exists.
Run in quiet mode, with minimal output to the screen.