ExposureCatalog#

class uvex_transients.simulation.exposure_catalog.ExposureCatalog(table: QTable, nside: int, order: str, time_bins: Time)[source]#

Per-(transient type, time bin) effective exposure, tagged by type and time bin.

Produced by compute_effective_exposure().

Methods

column(name)

Return a table column as a plain array, rather than an astropy.table.Column/Quantity view.

from_disk(path[, table_format])

Read an exposure catalog back from disk, as written by to_disk().

get_expected_events_between(t_start, t_end)

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

get_exposure_between(t_start, t_end[, ...])

Effective exposure accrued within [t_start, t_end), grouped by transient type.

rebin(time_bins)

Rebin this catalog onto an arbitrary new time binning.

to_disk(path[, table_format, overwrite])

Write this catalog's table to disk as ECSV, with its provenance in the header.

Attributes

coverage_fraction

Each transient type's time- and sky-averaged coverage fraction.

duration

Each row's bin width.

effective_exposure

Each row's effective exposure (solid_angle * duration).

expected_events

Each row's expected event count (effective_exposure * integrated_rate).

n_pixels_visited

Each row's number of visited HEALPix pixels.

solid_angle

Each row's visited footprint solid angle.

t_end

Each row's bin end time.

t_start

Each row's bin start time.

time_bin

Each row's time-bin index.

total_duration

The full window time_bins spans (last edge minus first).

total_effective_exposure

Sum effective_exposure across every time bin, grouped by transient type.

total_expected_events

Sum expected_events across every time bin, grouped by transient type.

transient_type

Each row's transient-type name.

table

One row per (transient type, time bin).

nside

HEALPix resolution the visited footprint was queried at.

order

HEALPix pixel ordering scheme ("nested" or "ring").

time_bins

The n + 1 bin edges exposure was tabulated within.