Converting particle files to LCAVision format: EnzoToParticles

The file EnzoToParticles is a tool written by John Shalf to convert particle data from the enzo output format to a format that LCAVision can handle. It is available in binary form in the same directory as the LCAVision executable, and also at /lcascr2/jshalf/Stars on nexus for LCA users. The correct usage is:

EnzoToStars <options> outputfilename.hierarchy

Where the options are:

-info :
Provides a description of the data available in the AMR file. In particular, this is how you can determine the names of the data objects that appear in the data files as well as the depth and number of grids in the hierarchy.

-star :
extracts the star particles into a single HDF file.

-dm :
extracts dark matter particles into a single HDF file.

-gas :
extracts gas field densities as gas particles. Every data point in each 3D grid is replaced with a particle possessing the same attributes as the field quantity at that point. Where grids overlap, particles are only created for the deepest nested grid.

-jad :
This option converts the field data into the FlexIO AMR format which can be read by LCAVision. This takes the one-file-per grid output of Enzo and puts it all into a single file with all of the metadata necessary to reconstruct the hierarchy.

-field :
This option determines which field or particle quantities to extract. It should be followed by a comma separated list of field names (which can be determined using the -info option described above. The default for particle extractions is to extract all available fields. The default for -jad is to only extract the field named Density because the field quantities require so much disk space. The keyword All can be used to tell it to extract all available data fields.
So, if enzo's output is in the format RedshiftOutput0100.* , where the * is hierarchy, grid, stars, etc. then to get a file of star particles for LCAVision you type

EnzoToParticles -star RedshiftOutput0100.hierarchy

And the output file will be in the format of outputfilename.all.star.hdf, in this case RedshiftOutput0100.all.star.hdf, which is readable by LCAVision.