uvex_transients.transients.base#

Base classes for transient population models.

A TransientBase subclass is one type of transient to simulate in the survey. It is a thin container pairing a single SpectralModel (the full, self-contained \(L_\\nu(\\nu, t)\) model – flux, magnitude, band-averaged photometry, and rest-frame spectrum generation, including cosmological redshift/distance resolution, all live on the SED itself now; see that module) with the metadata needed to run and window a Monte Carlo survey simulation: a duration limit and, for ExtragalacticTransient, a cosmological volumetric event rate. Milky Way foreground reddening is likewise no longer a TransientBase concern – see DustExtinction – since it’s folded into a flux/magnitude call via the SED’s own log_attenuation keyword (ebv/dust_law for as_source_spectrum/simulate_photometry) rather than wrapped here.

ExtragalacticTransient adds cosmological volumetric-rate sampling: given a per-class comoving event-rate density (events / Mpc^3 / yr as a function of redshift), it can draw a Monte Carlo realization of events over a sky patch and time window, either as individual (RA, DEC, z, t_explosion, parameter_seed) tuples or, more compactly, as (healpix_id, time_id, z, seed) tuples against a shared discretization grid. It caches its redshift grid’s corresponding luminosity-distance values (luminosity_distance_grid) alongside the redshift grid itself (redshift_grid), so callers needing \(D_L(z)\) for a batch of events have it on hand without a second cosmology lookup.

Classes

ExtragalacticTransient([cosmology])

Extragalactic transient with a cosmological volumetric event rate; see the module docstring.

TransientBase([cosmology])

Abstract base class for transient types.