convert_or_undo_photons_per_sec_to_radiance

irispy.utils.convert_or_undo_photons_per_sec_to_radiance(data_quantities, time_obs, response_version, obs_wavelength, detector_type, spectral_dispersion_per_pixel, solid_angle, *, undo=False)[source]

Converts data quantities from counts/s to radiance (or vice versa).

Parameters:

  • data_quantities (iterable of astropy.units.Quantity) – Quantities to be converted. Must have units of counts/s or radiance equivalent counts, e.g. erg / cm**2 / s / sr / Angstrom.

  • time_obs (an astropy.time.Time object, as a kwarg, valid for version > 2) – Observation times of the datapoints. Must be in the format of, e.g., time_obs parse_time(‘2013-09-03’, format=’utime’), which yields 1094169600.0 seconds in value. The argument time_obs is ignored for versions 1 and 2.

  • response_version (int) – Version number of effective area file to be used. Cannot be set simultaneously with response_file or pre_launch kwarg. Default=4.

  • obs_wavelength (astropy.units.Quantity) – Wavelength at each element along spectral axis of data quantities.

  • detector_type (str) – Detector type: ‘FUV’, ‘NUV’, or ‘SJI’.

  • spectral_dispersion_per_pixel (scalar astropy.units.Quantity) – spectral dispersion (wavelength width) of a pixel.

  • solid_angle (scalar astropy.units.Quantity) – Solid angle corresponding to a pixel.

  • undo (bool) – If False, converts counts/s to radiance. If True, converts radiance to counts/s. Default=False

Returns:

Data quantities converted to radiance or counts/s depending on value of undo kwarg.

Return type:

list of astropy.units.Quantity