calc_m5

rubin_sim.phot_utils.calc_m5(skysed, total_bandpass, hardware, phot_params, fwhm_eff=None)

Calculate the AB magnitude of a 5-sigma above sky background source.

The 5-sigma limiting magnitude (m5) for an observation is determined by a combination of the telescope and camera parameters (such as diameter of the mirrors and the readnoise) together with the sky background. This method (calc_m5) calculates the expected m5 value for an observation given a sky background Sed and hardware parameters.

@param [in] skysed is an instantiation of the Sed class representing sky emission, normalized so that skysed.calc_mag gives the sky brightness in magnitudes per square arcsecond.

@param [in] total_bandpass is an instantiation of the Bandpass class representing the total throughput of the telescope (instrumentation plus atmosphere)

@param [in] hardware is an instantiation of the Bandpass class representing the throughput due solely to instrumentation.

@param [in] phot_params is an instantiation of the PhotometricParameters class that carries details about the photometric response of the telescope.

@param [in] fwhm_eff in arcseconds

@param [out] returns the value of m5 for the given bandpass and sky SED