uvex_transients.surveys.base.SurveySchedule.get_observed_healpix_ids#

SurveySchedule.get_observed_healpix_ids(start_time: Time, end_time: Time, nside: int | None = None, order: str | None = None) → ndarray[source]#

Return the HEALPix pixel indices covered by observations in a time interval.

Built directly from get_healpix_coverage_index()’s cached, whole-schedule CSR structure (rasterized once via m4opt.fov.footprint_healpix() and cached per (nside, order)) rather than re-rasterizing footprints for this time window – a per-pixel segmented reduction over the cached index, not a second geometric pass. Repeated calls with the same (nside, order) across different (even overlapping) time windows – as in a per-time-bin sampling loop – pay for the rasterization at most once.

Parameters:

  • start_time (Time) – Beginning of the query interval, inclusive.

  • end_time (Time) – End of the query interval, exclusive.

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

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

Returns:

Sorted, deduplicated HEALPix pixel indices covered by any observation in the interval; empty if there were none.

Return type:

numpy.ndarray