Analysis Tools

Visualization Software

Athena++ can output formatted table, VTK and HDF5 data (see also Outputs).

The formatted table (.tab) format is intended for relatively small simulations, in particular 1D and 2D ones. This is just a simple text file which can be plotted by your favorite plotting software. If you have no idea, we recommend gnuplot as it is simple and free. Meaning of each column is described in the file header.

VTK and HDF5 are standard formats commonly used in numerical simulations. Because VTK is non-parallel IO, it is intended for relatively small 2D and 3D simulations. You can merge the VTK files using vis/vtk/join_vtk++.c, but currently this code works only for simulations without mesh refinement. For massively parallel simulations and/or simulations with mesh refinement, HDF5 is strongly recommended.

To visualize VTK or HDF5 files, there are some options publicly available, such as VisIt and ParaView. At this moment, yt probably does not work although it supports old Athena's VTK. For usage of these programs, please consult their documentations.

To read HDF5 data with VisIt or ParaView, load the corresponding .xdmf (eXtensible Data Model and Format) files which tell the software how to read the .athdf files. For now all the variables are stored as scalar. As this is inconvenient, we provide typical variable expression files for VisIt in the vis/vtk directory. You can load these files from Controls->Expressions.

Reading Data into Python

See Reading data into Python.

Reading .athdf Files

The format of .athdf files is HDF5, and can be read from your favorite programming language using the HDF5 library/package/etc. The data structure is pretty self-explanatory, and you can see it using HDFVIEW provided by the HDF Group.