Skip to content

ninahernitschek/poi_broker_frontend

Repository files navigation

Point of Interest Community Broker

The Point of Interest Community Broker is a transient alert software (Rubin Observatory (LSST) Alert and Community Broker) that is currently tested with the ZTF alert stream. Incoming alerts will be processed, annotated, classified and forwarded.

For a general overview of LSST Community Broker, see https://www.lsst.org/scientists/alert-brokers

Motivation

Current and especially upcoming all-sky time-domain surveys, such as LSST, will deliver a vast amount of data each night, requiring for the developent of flexible, straightforward tools for the analysis, selection and forwarding of information regarding astrophysical transients and variable objects.

Our alert broker, called Point of Interest, is tailored towards the needs of astronomers looking for updated observations of variable stars in specific on-sky regions. Developed by a small team at Vanderbilt University, where I'm the main developer responsible for this project, this Point of Interest' alert broker should enable users to get updates on variable star observations from a straightforward, user-friendly web service. Data are processed in real time by big data/ machine learning algorithms and will be immediately available to the user community.

Point of Interest differs from other brokers in the focus on updates on variable stars, thus running a rather specific than the full analysis chain of streamed data. As a consequence, the broker is rather lightweight. Point of Interest users are encouraged to design their own on-sky regions they want receive updates for (such as for planned follow-up campaigns) or select from a list of on-sky regions which are particularly interesting for variable star observers, such as stellar streams, globular clusters and dwarf galaxies.

Usage

This repository contais the web frontend, including a small database for testing purposes.

After downloading the package, within the folder _web_frontend install all required packages:

pip3 install -r requirements.txt

start the web app from the terminal with

flask run

or flask --app app run --debug to start in debug mode (alternatively, export FLASK_DEBUG=1 in the terminal https://stackoverflow.com/questions/17309889/how-to-debug-a-flask-app) (optionally, install the flask-debugtoolbar https://www.askpython.com/python-modules/flask/flask-debug-mode)

In the web browser, enter http://127.0.0.1:5000/ In case the website isn't displayed: do a

cat app.log

in your terminal window to see the correct URL

Also, inspect the browser developer console (F12) to see if there are any JS errors, ie. a missmatching bokeh.min.js version.

About

ZTF Point Of Interest Broker Web Frontend

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •