DustMap3D

class rubin_sim.maf.maps.DustMap3D(nside=64, map_file=None, interp=True, filtername='r', dist_pc=3000, d_mag=15.2, r_x=None)

Bases: BaseMap

The DustMap3D provides a map to hold 3d EBV data.

Adds the following keys to the slicePoints: ebv3d_dists - the distances from the 3d dust map at each slice_point (in pc) ebv3d_ebvs - the E(B-V) values corresponding to each distance at each slice_point ebv3d_ebv_at_<dist_pc> - the (single) ebv value at the nearest distance to dist_pc ebv3d_dist_at_<d_mag> - the (single) distance value corresponding to where extinction and distance modulus combine to create a m-Mo value of d_mag, for the filter specified in filtername (in pc). Note that <dist_pc> and <d_mag> will be formatted with a single decimal place.

The additional method ‘distance_at_mag’ can be called either with the distances and ebv values for the entire map or with the values from a single slice_point, in order to calculate the distance at which extinction and distance modulus combine to create a m-Mo value closest to ‘dmag’ in any filter. This is the same value as would be reported in ebv3d_dist_at_<d_mag>, but can be calculated on the fly, allowing variable filters and dmag values.

Parameters:

nside: `int`

Healpixel resolution (2^x).

map_filestr, opt

Path to dust map file.

interpbool, opt

Should returned values be interpolated (True) or just nearest neighbor (False). Default True, but is ignored if ‘pixels’ is provided.

filtername‘str’, opt

Name of the filter (to match the lsst filter names in rubin_sim.photUtils.DustValues) in which to calculate dust extinction magnitudes

dist_pcfloat, opt

Distance at which to precalculate the nearest ebv value

d_magfloat, opt

Calculate the maximum distance which matches this ‘d_mag’ d_mag == m-mO (dust extinction + distance modulus)

r_xdict {str: float}, opt

Per-filter dust extinction curve coefficients. Calculated by rubin_sim.photUtils.DustValues if “None”.

Methods Summary

distance_at_dmag(dmag, dists, ebvs[, filtername])
run(slice_points)	Given slice_points (dict containing metadata about each slice_point, including ra/dec),

Methods Documentation

distance_at_dmag(dmag, dists, ebvs, filtername=None)

run(slice_points)

Given slice_points (dict containing metadata about each slice_point, including ra/dec),

adds additional metadata at each slice_point and returns updated dict.