Event#

class uvex_transients.simulation.event.Event(event_id: int, schedule: SurveySchedule, transient: TransientBase, coord: SkyCoord, redshift: float, t_explosion: Time, seed: int, *, luminosity_distance: Quantity | None = None, ebv: float | None = None, transient_type: str | None = None)[source]#

One sampled transient event, tied to a real survey schedule.

Building an Event runs exactly one query against schedule (get_observations_of()) to find which scheduled observations actually covered this event’s position during [t_explosion, t_explosion + transient.duration_limit) – no photometry is done here. simulate_photometry() does the (comparatively expensive) per-observation, per-band synthetic photometry, on demand.

Parameters:

event_id (int) – See __init__().
schedule (SurveySchedule) – See __init__().
transient (TransientBase) – See __init__().
coord (SkyCoord) – See __init__().
redshift (float) – See __init__().
t_explosion (Time) – See __init__().
seed (int) – See __init__().
luminosity_distance (Quantity, optional) – See __init__().
ebv (float, optional) – See __init__().
transient_type (str, optional) – See __init__().

Methods

`flux`(t, mission[, band])	Theoretical (noiseless) observed flux density of this event's SED, at band's pivot wavelength.
`luminosity`(t)	Bolometric luminosity of this event's SED at time(s) t since explosion.
`mag`(t, mission[, band])	Theoretical (noiseless) apparent AB magnitude of this event's SED at time(s) t.
`sample_parameters`()	Return this event's physical SED parameters, deterministically regenerated from seed.
`simulate_photometry`(mission[, bands, n_sigma])	Evaluate this event's detectability at every observation in observations.

Attributes

`coord`	Sky position of the event.
`ebv`	Milky Way foreground E(B-V) at coord (0 if never supplied).
`event_id`	This event's unique id.
`luminosity_distance`	Luminosity distance to the event.
`n_observations`	Number of candidate observations (`len(observations)`).
`observations`	The schedule's `"observe"` rows that covered this event while active.
`redshift`	Cosmological redshift.
`seed`	This event's stored parameter seed.
`t_explosion`	Time of explosion.
`transient`	The transient type this event is a realization of.
`transient_type`	This event's transient-type name.