Gravelamps: Gravitational Wave Lensing Mass Profile Model Selection

We present the package Gravelamps which is designed to analyse lensed gravitational wave signals in order to constrain the mass density profile of the lensing object. Gravelamps does this via parameter estimation using the framework of bilby, which enables estimation of both the lens and the source parameters. The package can be used to study both microlensing and macrolensing cases -- where the lensing mass distribution is described by a point mass and extended mass density profile respectively -- and allows the user to easily and freely switch between the full wave optics and approximate geometric optics description. The performance of Gravelamps is demonstrated via simulated analysis of both mircolensing and macrolensing events, illustrating its capability for both parameter estimation and model selection in the wave optics and hybrid environments. To further demonstrate the utility of the package, the real gravitational-wave event GW170809 was analysed using Gravelamps; this event was found to yield no strong evidence supporting the lensing hypothesis, consistent with previously published results.