uvex_transients.dust#

Milky Way foreground dust extinction.

This module provides access to the PlanckGNILC E(B-V) map (dust_map) and a reddening law (get_dust_law, Gordon+2023’s G23 by default – see config["physics.default_dust_law"]), combined by a single vectorized entry point (log_attenuation) into a natural-log attenuation array ready to add directly into a ~uvex_transients.models.core.base.SpectralModel flux calculation (its log_attenuation keyword argument). attenuation_callable gives the same thing as a callable; ~uvex_transients.models.core.base.SpectralModel.as_source_spectrum/ ~uvex_transients.models.core.base.SpectralModel.simulate_photometry call it internally whenever their own ebv keyword is given, so ordinary callers of this package never touch this module, a callable, or functools.partial at all.

Attributes

Reddening

An explicit E(B-V) value/array (float/dimensionless Quantity/numpy.ndarray), or a DustMapLike to query at a given ~astropy.coordinates.SkyCoord -- see resolve_ebv.

Functions

attenuation_callable(Ebv[, dust_law])

Bind log_attenuation to a fixed E(B-V)/dust law, as a plain nu -> ln(transmission) callable.

dust_map()

Return the Planck GNILC E(B-V) sky map, downloading and caching it on first use.

get_dust_law([dust_law])

Return the (cached, instantiated) reddening law to use.

log_attenuation(nu, Ebv[, dust_law])

Natural log of the Milky Way foreground attenuation, \(\ln(10^{-0.4\,A(\nu)})\), at nu.

resolve_ebv(reddening[, coord])

Resolve a Reddening value into a plain E(B-V) array.

Classes

DustMapLike(*args, **kwargs)

Structural type for anything queryable for E(B-V) at a sky position, like PlanckGNILCQuery.