Quick start tutorial

The waveforms and energy curves for every simulation are stored within the hdf5-files "data.h5". While we propose to use python and the HDF5 data packages directly, another simple way of extracting the information from the data in the following.

To show the content of the h5 files use h5ls, e.g.

    h5ls -r data.h5  

One possible outcome of the command might be:

    /                        Group
    /energy                  Group
    /energy/EJ_r00650.txt    Dataset {4099, 6}
    /energy/EJ_r00700.txt    Dataset {4099, 6}
    /energy/EJ_r00750.txt    Dataset {4099, 6}
    /energy/EJ_r00800.txt    Dataset {4099, 6}
    /energy/EJ_r00850.txt    Dataset {4099, 6}
    /energy/EJ_r00900.txt    Dataset {4099, 6}
    /rh_22                   Group
    /rh_22/Rh_l2_m2_r00650.txt Dataset {4099, 9}
    /rh_22/Rh_l2_m2_r00700.txt Dataset {4099, 9}
    /rh_22/Rh_l2_m2_r00750.txt Dataset {4099, 9}
    /rh_22/Rh_l2_m2_r00800.txt Dataset {4099, 9}
    /rh_22/Rh_l2_m2_r00850.txt Dataset {4099, 9}
    /rh_22/Rh_l2_m2_r00900.txt Dataset {4099, 9}
    /rpsi4_22                Group
    /rpsi4_22/Rpsi4_l2_m2_r00650.txt Dataset {4099, 7}
    /rpsi4_22/Rpsi4_l2_m2_r00700.txt Dataset {4099, 7}
    /rpsi4_22/Rpsi4_l2_m2_r00750.txt Dataset {4099, 7}
    /rpsi4_22/Rpsi4_l2_m2_r00800.txt Dataset {4099, 7}
    /rpsi4_22/Rpsi4_l2_m2_r00850.txt Dataset {4099, 7}
    /rpsi4_22/Rpsi4_l2_m2_r00900.txt Dataset {4099, 7}
 

In case you want to dump the information into a regular file; we propose to use h5dump. As an example, let us consider we want to check the gravitational waveform at a radius of 800[Msun], i.e., /rh_22/Rh_l2_m2_r00800.txt . To output this dataset to an output file (out.dat), just use

  h5dump -d /rh_22/Rh_l2_m2_r00800.txt -y -w 0 -o out.dat data.h5  

For information about the formatting/output options, we refer to the h5dump manual, while here
-y supresses the print of the array indices
-w sets the numer of columns for the output
-o sets the output file

This command also prints to the screen the important information about the data contained in the h5 file, e.g., the dataset_columns, the extratction radius, and the total Mass M.

The file out.dat can now be read by any standard text editor and plotted e.g. with gnuplot or python.