dran.calibration package

Subpackages

• dran.calibration.atmosphere package
  • Submodules
  • dran.calibration.atmosphere.atmos_frontend_dispatch module
    • dispatch_atmospheric_correction()
  • dran.calibration.atmosphere.atmos_models module
    • apply_atmospheric_penetration_2p5s()
    • apply_atmospheric_absorption_sb()
    • apply_atmospheric_penetration_1p3s()
    • apply_atmospheric_absorption_db()
  • dran.calibration.atmosphere.meteo_water_vapour module
    • add_water_vapour_fields()
  • Module contents
• dran.calibration.planets package
  • Subpackages
    • dran.calibration.planets.ephemeris package
      • Submodules
      • dran.calibration.planets.ephemeris.jpl_horizons_table module
      • dran.calibration.planets.ephemeris.resource_utils module
      • Module contents
  • Submodules
  • dran.calibration.planets.planet_geometry module
    • add_planet_angular_diameter()
    • add_jupiter_distance_au()
  • dran.calibration.planets.planet_jupiter_calibration module
    • apply_jupiter_atmospheric_calibration()
  • Module contents
• dran.calibration.predefs package
  • Module contents

Submodules

dran.calibration.calibrate module

dran.calibration.calibrate.calibrate_pointing_corrected_ta(hps_ta, hps_err, hpn_ta, hpn_err, on_ta, on_err, log, row)

Parameters:

• hps_ta (float)

• hps_err (float)

• hpn_ta (float)

• hpn_err (float)

• on_ta (float)

• on_err (float)

• log (Logger)

• row (Mapping[str, Any])

Return type:

PointingGainResult

dran.calibration.errors module

exception dran.calibration.errors.CalibrationError

Bases: Exception

Base exception for calibration failures.

exception dran.calibration.errors.MissingResourceError

Bases: CalibrationError

Raised when a required packaged resource is missing.

exception dran.calibration.errors.UnsupportedFrontendError

Bases: CalibrationError

Raised when a frontend/backend type is not supported.

exception dran.calibration.errors.EphemerisDateOutOfRangeError

Bases: CalibrationError

Raised when an ephemeris table does not cover the requested date.

exception dran.calibration.errors.InvalidObservationDateError

Bases: CalibrationError

Raised when an observation date string is invalid or cannot be parsed.

dran.calibration.pointing module

class dran.calibration.pointing.PointingGainResult(pc: float | None, ta_corr: float | None, ta_corr_err: float | None, reason: str)

Bases: object

Parameters:

• pc (float | None)

• ta_corr (float | None)

• ta_corr_err (float | None)

• reason (str)

pc: float | None

ta_corr: float | None

ta_corr_err: float | None

reason: str

dran.calibration.pointing.calc_pointing_correction(hps_ta, hps_err, hpn_ta, hpn_err, on_ta, on_err, data, missing_side)

Compute pointing correction factor and corrected antenna temperature with propagated uncertainty. Uses safe log transforms of scan peak temperatures to derive a pointing correction based on which beam side is missing, then applies the correction to on-source temperature and propagates errors via partial derivatives.

dran.calibration.pointing.calc_tcorr(Ta, pc, data)

Calculate the antenna temperature correction for high frequencies.

Parameters:

• temperature (Ta - the on scan antenna)

• correction (pc - the pointing)

• parameters (data - the dictionary containing all the drift scan)

Returns:

corrTa - the corrected antenna temperature

dran.calibration.pointing.pointing_gain_from_halfpower(hpn_ta, hpn_err, on_ta, on_err, hps_ta, hps_err, data, log, missing_side)

Compute multiplicative pointing gain factor pc and 1-sigma uncertainty pc_err.

missing_side:

None -> both half-power points available (south and north) “n” -> missing north half-power, use (HPS, ON) form in caller if needed “s” -> missing south half-power, use (ON, HPN) form in caller if needed

This function expects the two temperatures supplied belong to the two half-power points used in the same equation.

Parameters:

• hpn_ta (float)

• hpn_err (float)

• on_ta (float)

• on_err (float)

• hps_ta (float)

• hps_err (float)

• data (Dict)

• log (Logger)

• missing_side (str | None)

Return type:

PointingGainResult

dran.calibration.row_accessors module

dran.calibration.row_accessors.get_float(row, key, default=nan)

Read a float from a mapping. Returns default if the key is missing or invalid.

Parameters:

• row (Mapping[str, Any])

• key (str)

• default (float)

Return type:

float

Module contents