uvex_transients.surveys.base.SurveySchedule.compute_control_time_curve#

SurveySchedule.compute_control_time_curve(timescales: Quantity, minimum_factor: float | None = None, maximum_factor: float | None = None, visibility_factor: float | None = None, start_time: Time | None = None, end_time: Time | None = None, nside: int | None = None, order: str | None = None) → Quantity[source]#

Compute survey area-time exposure over a sequence of transient timescales.

The curve-friendly counterpart to compute_control_time(): per-pixel visit times (the expensive, HEALPix-footprint-rasterizing part) are computed once and reused for every timescale, rather than redone inside the loop the way the original implementation of this curve did. Each timescale still re-scans every observed pixel to rebuild and re-merge its intervals, since the merged intervals themselves depend on the timescale.

Parameters:

  • timescales (Quantity) – Sequence of characteristic transient timescales.

  • minimum_factor (float, optional) – Bounds of the qualifying pair-separation window, relative to each timescale. Either may be None (the default) to use config["surveys.cadence.minimum_factor"]/ config["surveys.cadence.maximum_factor"].

  • maximum_factor (float, optional) – Bounds of the qualifying pair-separation window, relative to each timescale. Either may be None (the default) to use config["surveys.cadence.minimum_factor"]/ config["surveys.cadence.maximum_factor"].

  • visibility_factor (float, optional) – Duration over which the transient is assumed useful for temporal characterization, relative to each timescale, or None (the default) to use config["surveys.cadence.visibility_factor"].

  • start_time (Time, optional) – Optional survey interval over which to calculate control time.

  • end_time (Time, optional) – Optional survey interval over which to calculate control time.

  • nside (int, optional) – HEALPix resolution parameter, or None to use config["healpix.default_nside"].

  • order (str, optional) – HEALPix ordering scheme, either "nested" or "ring", or None to use config["healpix.default_order"].

Returns:

Area-time exposure for each input timescale.

Return type:

Quantity