二元可观测性与说明性探索（bowie）
bowie的Python项目详细描述
######################################################### bowie：二元可观测性与说明性探索 #########################################################
<…图片：：logo/bowie_logo.png ：高度：300px ：宽度：300像素 比例：50% ：alt:替换文本 ：对齐：居中bowie是一个用于对来自引力波的二元信号进行图形分析的工具。它采用网格化的数据集，并以定制的排列方式生成不同类型的图，以详细分析引力波灵敏度曲线和/或二元信号。详细介绍该工具及其使用示例的论文可在arxiv:1807.02511（用lisa评估黑洞可探测性）中找到。代码有三个主要部分：网格数据生成器（snr_calculator.generate_contour_data.py）、绘图工具（bowie.make_plot.py）和通用波形生成器（snr_calculator.utils.pyphenomd.py）。波形产生器为二元黑洞的吸气、合并和减速创造了典型的波形。Phenomd来自Husa et al 2016（arxiv:1508.07250）和Khan et al 2016（arxiv:1508.07253）。网格化数据集是使用用于信噪比（snr）分析的phenomd生成器创建的。使用网格化数据集，可使用绘图包创建绘图的自定义配置。
可供选择的三个地块是瀑布、比率和地平线。瀑布图是一个填充等高线图，类似于lisa任务建议（arxiv:1702.00786）中的图3。比率图显示了两种不同的二进制和灵敏度配置之间的snr比率。它们还包括损失/增益轮廓，显示了两种配置在它们可以检测和不能检测的源方面的不同。水平图显示给定信噪比值下多个配置的线轮廓。有关详细信息，请参阅原始纸张和笔记本示例。
注意：本简介的其余部分详细介绍了绘图模块的安装。它非常适用于不同的引力波源或具有类似信噪比特性的其他测量。snr_calculator包列为bowie（表示绘图模块）的要求。此软件包随Bowie安装一起安装，但是，它与绘图模块分开提供。为此，它有自己的自述文件和文档此处.
入门
这些说明将为您提供一份在本地计算机上运行的项目副本，以供使用和测试。
可通过PIP和Github获得：https://github.com/mikekatz04/bowie
先决条件
软件安装/使用只需要一些python中的特定库。如果使用pip安装，如果没有这些库，则应自动安装所有这些库（这包括必需的snr_calculator）。所有python库都包含在anaconda中。如果不在anaconda环境中运行python，则需要以下库和模块才能运行所有功能：numpy、scipy、collections、sys、json、多处理、datetime、time、astropy、h5py和matplotlib。所有的都可以用pip安装。例如，在您选择的python环境中：
<> >代码>p安装h5py为了正确地使用cTypes创建波形，您将需要Complex、GSL和MathC库。要安装GSL，请参阅https://www.gnu.org/software/gsl/" rel="nofollow">https://www.gnu.org/software/gsl/或通过Anaconda安装。
gwsnrcalc也是必需的。这将使用pip install或setup.py自动安装。
安装
安装有两种方式：
- 使用pip
pip安装bowie
这将把所有必需的包下载到您当前的环境中。它不会下载用于测试和示例使用的笔记本。
- 在命令行上克隆git repo，或者从github下载它。这适用于所有模块，例如Jupyter笔记本和附加文件。
a）导航到您选择的目录。
b）在命令行上克隆git repo。
``git clone https://github.com/mikekatz04/BOWIE.git``
c）运行setup.py将模块添加到您的环境中并编译C代码。
``python ./setup.py install``
测试并运行示例
要测试代码，请运行测试笔记本。
Jupyter笔记本快速测试示例.ipynb
贡献
请阅读contribution.md了解有关我们的行为准则以及向我们提交请求的过程的详细信息。
版本控制
当前版本是2.0.0。
我们使用semver进行版本控制。
作者
- michael katz-
mikekatz04
请将任何错误或请求发送给作者。
许可证
此项目是在GNU许可下授权的-有关详细信息，请参见license.md\file。
致谢
- 感谢迈克尔·普雷尔、塞巴斯蒂安·汗、弗兰克·欧姆、奥菲克·比恩霍尔茨、莱昂内尔·伦敦，感谢他在Lalsuite中为Phenomed编写了最初的C代码。
欢迎加入QQ群-->： 979659372
