Reusable TOMToolkit app to support gravitational wave superevent and other nonlocalized event EM follow-up observations.
Project description
GW Superevent (or GRB, Neutrino) EM follow-up
This reusable TOM Toolkit app provides support for gravitational wave (GW) superevent and other non-localized event electromagnetic (EM) follow up observations.
Requirements
This TOM plugin requires the use of a postgresql 14+ database backend, since it leverages some postgres specific stuff for MOC volume map lookups.
Installation
-
Install the package into your TOM environment:
pip install tom-nonlocalizedevents
-
In your project
settings.py
, addtom_nonlocalizedevents
andwebpack_loader
to yourINSTALLED_APPS
setting:INSTALLED_APPS = [ 'webpack_loader', ... 'tom_nonlocalizedevents', ]
Also include the following Django-Webpack-Loader settings in your settings.py:
VUE_FRONTEND_DIR_TOM_NONLOCAL = os.path.join(STATIC_ROOT, 'tom_nonlocalizedevents/vue') WEBPACK_LOADER = { 'TOM_NONLOCALIZEDEVENTS': { 'CACHE': not DEBUG, 'BUNDLE_DIR_NAME': 'tom_nonlocalizedevents/vue/', # must end with slash 'STATS_FILE': os.path.join(VUE_FRONTEND_DIR_TOM_NONLOCAL, 'webpack-stats.json'), 'POLL_INTERVAL': 0.1, 'TIMEOUT': None, 'IGNORE': [r'.+\.hot-update.js', r'.+\.map'] } }
If
WEBPACK_LOADER
is already defined in your settings, then integrate these values in to it.Also add the following to your settings if they are not already there, setting whatever default values you need for your setup. These point to your deployed TOM toolkit instance, and to a hermes instance:
TOM_API_URL = os.getenv('TOM_API_URL', 'http://127.0.0.1:8000') HERMES_API_URL = os.getenv('HERMES_API_URL', 'http://hermes-dev.lco.gtn')
-
Include the tom_nonlocalizedevent URLconf in your project
urls.py
:urlpatterns = [ ... path('nonlocalizedevents/', include('tom_nonlocalizedevents.urls', namespace='nonlocalizedevents')), ]
-
Run
python manage.py migrate
to create the tom_nonlocalizedevents models. -
Set environment variables below to configure different connections:
Env variable | Description | Default |
---|---|---|
SA_DB_CONNECTION_URL |
Location of your django postgres database used for sqlalchemy | by default, this uses Django default DB for the project |
CREDIBLE_REGION_PROBABILITIES |
JSON List of Credible Region probabilities to automatically check each candidate target for | '[0.25, 0.5, 0.75, 0.9, 0.95]' |
-
In your TOM project, make sure to run
python manage.py collectstatic
after installing this app, to collect its Vue pages into yourstaticfiles
directory. -
If you want to automatically ingest GW events into your TOM, you should also install the
tom_alertstreams
app into your TOM and configure it to use the tom_nonlocalizedevents handler to ingest GW events:tom_nonlocalizedevents.alertstream_handlers.gw_event_handler.handle_message
. There is also a handler to handle retractions via thehandle_retraction
method in that package. These are currently written to work with LVC GW messages.
Development
When any changes are made to this library, the vue files will need to be build and bundled and committed into the repo so that they can be bundled and deployed with the django package. This means that after making any vue changes, you must run npm run build
within the tom_nonlocalizedevents_vue
directory once, which will install the built files into tom_nonlocalizedevents/static/
, and then those built files will need to be committed into the repo. This allows django projects using this library to get those files when running python manage.py collectstatic
.
Running the tests
In order to run the tests, run the following in your virtualenv:
python manage.py test
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for tom_nonlocalizedevents-0.6.0a3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 919d9ebf7662169624922eb0a9f202403301b3219ca9a20afc097cb4367d7f44 |
|
MD5 | 451410ae1ba0540a6579867dd77bae98 |
|
BLAKE2b-256 | f86bc8972635cc884529e3347432fa28a42f5a71506f92784318828b50d1ff13 |
Hashes for tom_nonlocalizedevents-0.6.0a3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f73ae182b4681cec19e71c5ec702f8577e1aef6ca592545702808dfb10ff5c82 |
|
MD5 | 7f7490f3d82e7bf146d158ea40b10f48 |
|
BLAKE2b-256 | e3d43b042645458195d6f20783ddde7920e71be19f644b61154f20b35ed78d7d |