为PanSTARRS和atlasligovirgo(PSAT)小组提供的CLtools帮助调查LIGOVIRGO可能的天空位置发现了引力波
breaker的Python项目详细描述
PanSTARRS&atlasligo-VIRGO(PSAT)小组的python包和命令行工具,以帮助调查LIGO-VIRGO可能的天空位置,发现引力波。在
命令行用法
*The CL tools for breaker* :Author: David Young :Date Created: October 29, 2015 Usage: breaker init breaker update [-naP][-s <pathToSettingsFile>] breaker skymap <gwid> <pathToLVMap> [-c <centerDeg>] breaker plot [-a](timeline|history|sources)[-w <gwid>][-t <telescope>][-p <projection>][-s <pathToSettingsFile>] breaker plot comparison <gwid> <pathToMapDirectory> [-s <pathToSettingsFile>] breaker faker <ps1ExpId> [-s <pathToSettingsFile>] breaker stats <gwid> [<telescope>][-s <pathToSettingsFile>] breaker listen <far> (<mjdStart> <mjdEnd> | <inLastNMins>)[-s <pathToSettingsFile>] breaker listen -d [<far> <sec>][-s <pathToSettingsFile>] breaker contour <gwid> <ra> <dec> COMMANDS -------- init setup the breaker settings file for the first time update update the PS1 footprint table in breaker database and associate with GW-IDs. Optionally download overlapping NED source and also add to the database skymap generate an all sky FITS & PDF image map given the path to the LV likeihood map (Meractor and Mollweide projections respectively) plot enter plotting mode timeline plot from the epoch of the wave detection forward in timehistory plot from now back in time over the last days, weeks and months comparison produce a multi-panel plot to compare wave maps stats generate some coverage stats for a given wave survey campaign sources overplot map with NED sources found within the wave campaign footprint faker generate a catalogue of simulated transient sources in PS1 exposure ID footprint listen connect to grace DB and download maps found within the given time range contour determine within which likelihood contour a given transient location lies (nearest 10%) ARGUMENTS --------- ra right ascendsion (sexegesimal or decimal degrees) dec declination (sexegesimal or decimal degrees) far false alarm rate limit in Hz. Default *1e-5* (~=1 per day) -w <gwid> the gravitational wave ID (graceDB or human-readable GW forms allowed) pathToSettingsFile path to the yaml settings file -c <centerDeg> the central longitude line (deg) pathToMapDirectory path to a directory containing localisation maps ps1ExpId a panstarrs exposure ID mjdStart start of an MJD range mjdEnd end of the MJD range inLastNMins in the last N number of minutes pathToLVMap path to the LV likelihood map sec time in seconds -t <telescope> select an individual telescope (default is all telescopes)[ps1|atlas] -p <projection> skymap projection. Default *mercator*. [mercator|gnomonic|mollweide] FLAGS ----- -h, --help show this help message -s, --settings the settings file -n, --updateNed update the NED database steam -d, --daemon listen in daemon mode -a, --all plot all timeline plot (including the CPU intensive -21-0 days and all transients/footprints plots) -P, --no-pointings do not update pointings
文件
breaker的文档由Read the Docs(最后一个是stable version和latest version)托管。在
安装
安装断路器最简单的方法是通过水蟒。有关安装Python的说明。在
一旦你安装了一个新的水蟒环境,然后激活它:
^{pr2}$现在在安装断路器之前先安装healpy(healpy的pip安装看起来很不稳定):
conda install -c conda-forge healpy
最后安装断路器:
pip install breaker
安装开发版本
或者您可以克隆github repo并从本地版本的代码进行安装:
git clone git@github.com:thespacedoctor/breaker.git
cd breaker
python setup.py install
要升级到breaker的最新版本,请使用以下命令:
pip install breaker --upgrade
故障排除
如果您在安装过程中遇到问题,可以尝试以下几种方法:
Astropy和Clang。在macos上,在安装astropy之前,您可能需要将C编译器设置为clang。因此,在安装断路器之前,请尝试:
setenv CC clang
或者,对于bash:
exportCC=clang
然后再次尝试安装断路器。在
healpy。如果在安装healpy时遇到问题,请尝试安装latest version from github。下载并提取tarball。在
Untar,设置您的MACOSX_DEPLOYMENT_TARGET环境变量并安装:
tar -xvf healpy-1.9.0.tar.gz cd healpy-1.9.0 setenv MACOSX_DEPLOYMENT_TARGET 10.11 python setup.py install
开发
如果您想修改代码,请在开发模式下安装。 这意味着您可以从克隆的回购中修改代码:
git clone git@github.com:thespacedoctor/breaker.git
cd breaker
python setup.py develop
Pull requests 欢迎光临!在
问题
请报告任何问题 here。在
许可证
版权所有(c)2018 David Young
在此免费授予任何获得 本软件和相关文档文件的副本 “软件”),无限制地经营软件,包括 但不限于使用、复制、修改、合并、发布的权利, 分发、转授权和/或出售软件副本,以及 允许向其提供软件的人员这样做,但须遵守 以下条件:
应包括上述版权声明和本许可声明 在软件的所有副本或重要部分。在
本软件按“原样”提供,不提供任何形式的保修 或暗示,包括但不限于 适销性、特定用途的适用性和非侵权性。 在任何情况下,作者或版权持有人对任何 索赔、损害赔偿或其他责任,无论是在合同诉讼中, 侵权行为,侵权行为,侵权行为 软件或软件的使用或其他交易。在
- 项目
标签: