重力波形与信噪比
gwsnrcalc的Python项目详细描述
gwsnrcalc是为使用匹配滤波snr方法快速计算单个引力波源的信噪比而设计的包。它最初设计用于支持BOWIE使用lisa评估黑洞可探测性。它提供了一个快速的信噪比计算器,二元黑洞的频域振幅波形,以及二元黑洞的信噪比网格发生器。
主要的信噪比函数是gwsnrcalc.gw_snr_calculator.snr。它能够跨处理器并行执行计算,以加快计算速度。
波形发生器(gwsnrcalc.utils.waveforms)创建圆形或偏心波形。
圆形波形是由双星黑洞吸气、合并和减速的物候振幅波形产生的。Phenomd来自Husa et al 2016(arXiv:1508.07250)和Khan et al 2016(arXiv:1508.07253)。返回的电流波形以特征应变为单位。
偏心波形是根据彼得斯演化产生的,只适用于吸气相。
snr网格生成器:gwsnrcalc.generate_contour_data使用gwsnrcalc.gw_snr_calculator.snr为等高线图创建snr网格(类似于bowie中使用的网格)。
通过pip和github提供:https://github.com/mikekatz04/BOWIE/
开始
这些说明将为您提供项目的副本,并在本地计算机上运行,以供使用和测试。
先决条件
软件安装/使用只需要一些python中的特定库。所有的图书馆都包括在水蟒身上。如果不在anaconda环境中运行python,则需要以下库和模块才能运行所有功能:numpy、scipy、collections、sys、json、多处理、datetime、time、astropy和h5py。所有的都可以用pip安装。例如,在您选择的python环境中:
pip install astropy
为了正确地使用cTypes创建波形,您将需要Complex、GSL和MathC库。要安装gsl,请参阅https://www.gnu.org/software/gsl/或通过anaconda安装。
安装
安装有两种方式:
- 使用pip
^{tt7}$
This will download the all necessary packages to your current environment. It will not download the notebooks for testing and example usage.
- 在命令行上克隆git repo,或者从github下载它。这适用于所有模块,例如jupyter笔记本和其他文件。这个方法包括bowie。要下载pip不附带的特定文件(例如jupyter笔记本和示例),只需从github下载这些文件。
- navigate to the directory of your choice.
- clone the git repo on the command line.
^{tt8}$
- 运行setup.py将模块添加到您的环境中并编译C代码。
^{tt9}$
测试并运行示例
要测试代码,请运行指南笔记本。
jupyter notebook pyphenomd_guide.ipynb
贡献
请阅读CONTRIBUTING.md了解有关我们的行为准则以及向我们提交请求的过程的详细信息。
许可证
此项目是在gnu许可下授权的-有关详细信息,请参见LICENSE.md文件。
致谢
- 感谢迈克尔·普雷尔、塞巴斯蒂安·汗、弗兰克·欧姆、奥菲克·比恩霍尔茨、莱昂内尔·伦敦,感谢他在莱尔苏特内部为Phenomd编写了原始C代码。