energy_dispersion

pyirf.irf.energy_dispersion(selected_events, true_energy_bins, fov_offset_bins, migration_bins)[source]

Calculate energy dispersion for the given DL2 event list. Energy dispersion is defined as the probability of finding an event at a given relative deviation (reco_energy / true_energy) for a given true energy.

Parameters:

selected_events: astropy.table.QTable: Table of the DL2 events. Required columns: reco_energy, true_energy, true_source_fov_offset.
true_energy_bins: astropy.units.Quantity[energy]: Bin edges in true energy
migration_bins: astropy.units.Quantity[energy]: Bin edges in relative deviation, recommended range: [0.2, 5]
fov_offset_bins: astropy.units.Quantity[angle]: Bin edges in the field of view offset. For Point-Like IRFs, only giving a single bin is appropriate.

Returns:

energy_dispersion: numpy.ndarray: Energy dispersion matrix with shape (n_true_energy_bins, n_migration_bins, n_fov_ofset_bins)