ExtragalacticTransient#

class uvex_transients.transients.base.ExtragalacticTransient(cosmology: Cosmology | None = None)[source]#

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

Parameters:

cosmology (Cosmology, optional) – The cosmology to use for this transient class. See __init__().

Methods

compute_all_sky_yield(duration)

Compute the expected intrinsic event count over the full sky.

compute_all_sky_yield_ci(duration)

Compute rate-only bounds on the expected all-sky intrinsic event count.

event_rate(z)

Compute the comoving event rate density at redshift(s) z, \(R(z;A)=A f(z)\).

rate_shape(z)

Compute the dimensionless redshift shape \(f(z)\) of the comoving event rate.

registry()

dict[str, type[TransientBase]]: A copy of every concrete subclass imported so far, keyed by class name.

sample_event_count(solid_angle[, duration, ...])

Sample the number of events in a given solid angle and duration.

sample_event_redshift(n_samples, *[, rng])

Draw n_samples redshifts from the rate-weighted redshift distribution.

sample_events_on_healpix_grid(nside, *, t_start)

Draw a Monte Carlo realization of events on a HEALPix grid, over a time window.

Attributes

DEFAULT_DURATION

The duration of this transient.

DEFAULT_MODEL

The SED model class associated with this transient type.

DEFAULT_Z_GRID_SIZE

DEFAULT_Z_LIM

RATE_CI

Multiplicative (lower, upper) 90% confidence factors on rate.

all_sky_rate

Expected all-sky event rate per observer year.

all_sky_rate_ci

Rate-only bounds on all_sky_rate.

cosmology

The cosmology used for luminosity-distance/volume calculations.

duration_limit

Upper bound on this transient's total duration.

effective_volume

\(\mathcal V\), the all-sky rate-weighted comoving volume.

integrated_rate

Expected event rate per observer time and solid angle.

integrated_rate_ci

Rate-only bounds on integrated_rate.

luminosity_distance_grid

\(D_L(z)\) at each point of redshift_grid.

rate

The fiducial rate normalization \(R_0\) (this class's \(A\)).

rate_ci

(R_L, R_U), the confidence bounds on rate.

redshift_grid

The cached redshift grid backing integrated_rate/sampling.

redshift_grid_size

Number of points in redshift_grid; reassigning invalidates the rate cache.

redshift_limit

Upper redshift bound of redshift_grid; reassigning invalidates the rate cache.

sed

This instance's SED -- flux, magnitude, and spectrum evaluation all live here.