Supplement: Going the Distance: Mapping Host Galaxies of LIGO and Virgo   Sources in Three Dimensions Using Local Cosmography and Targeted Follow-up
  This is a supplement to the Letter of Singer et al. (https://arxiv.org/abs/1603.07333), in which we demonstrated a rapid algorithm for obtaining joint 3D estimates of sky location and luminosity distance from observations of binary neutron star mergers with Advanced LIGO and Virgo. We argued that combining the reconstructed volumes with positions and redshifts of possible host galaxies can provide large-aperture but small field of view instruments with a manageable list of targets to search for optical or infrared emission. In this Supplement, we document the new HEALPix-based file format for 3D localizations of gravitational-wave transients. We include Python sample code to show the reader how to perform simple manipulations of the 3D sky maps and extract ranked lists of likely host galaxies. Finally, we include mathematical details of the rapid volume reconstruction algorithm. 
L. P. Singer, H.-Y. Chen, D. E. Holz, W. M. Farr, L. R. Price, V.   Raymond, S. B. Cenko, N. Gehrels, J. Cannizzo, M. M. Kas...
astro-ph.IM astro-ph.HE