uvex_transients.simulation.exposure_catalog.ExposureCatalog.get_expected_events_between#

ExposureCatalog.get_expected_events_between(t_start: Time, t_end: Time, transient_type: str | None = None) → float | dict[str, float][source]#

Compute the expected event count within [t_start, t_end), grouped by transient type.

Uses the same bin-overlap weighting as get_exposure_between (see _bin_overlap_weights); valid because expected_events is effective_exposure scaled by a per-type constant (integrated_rate), so the two scale identically.

Parameters:

  • t_start (Time) – The query window.

  • t_end (Time) – The query window.

  • transient_type (str, optional) – If given, return only that type’s expected count (a scalar float) rather than a dict of every type present.

Returns:

Expected number of events between the two times.

Return type:

float or dict[str, float]