GCNmegaphone

GCNmegaphone processes Gamma-ray Coordinates Network/Transient Astronomy Network (GCN/TAN) VOEvent notices using pygcn. It listens for Fermi (GBM), INTEGRAL (SPI-ACS), LIGO/Virgo detections, sends notificatons to Telegram and downloads GBM a SPI-ACS data.

Usage

Clone the repo, edit config.yaml, and run notice_filter.py in screen. It listens for VOEvents until killed with Control-C. One needs to provide Telegram bot token and chat_id to recieve alerts, see instruction to create your own bot.

Config description

log_dir:
    <path to store log and VOEvent dump, like "./logs" >
data_dir:
    <path to download data, like "./data" >
http_proxy:
    <e.g., "http://www-proxy:1234">

telegram_proxy:
    <Telegram socks5h proxy>
bot_token:
    <Telegram bot id>
chat_id:
    <chat/channel>

space-track: [login, passw]

Package content

File	Description
notice_filter.py	The main loop
get_fermi.py	Fermi (GBM) TTE data dowloading
gbm_tte.py	Converting GBM TTE data to ascii
gbm_map.py	Converting GBM healpix localization to ascii
get_integral.py	INTEGRAL SPI-ACS data dowloading
clock.py	Different date and time conversion functions
tle.py	Downloading TLE from space-track.org
telegram_api.py	Sending Telegram messages
path_utils.py	Simple path manipulation functions
contour.py	Healpix contours extraction functions
test/test_notice_filter.py	Tests for notice_filter.py
test/test_notice.py	Tests for notice class

Depends on

astropy
astroquery
pygcn
lxml
python-telegram-bot
PySocks
healpy
networkx

Useful links

VOEvents in GCN/TAN
Technical Details of GCN/TAN Notices

Acknowledgments

Nikita Sulimin - intial development of the project during his M.Sc. project.