This repository contains materials (notebooks & presentation) to explore the Fink broker alert data. As of November 2024, Fink has processed more than 180 millions alerts from the ZTF public alert stream. Among these, you will find extragalatic sources (supernovae, AGN, ...), galactic sources (many classes of transients incl. variables stars from our galaxy or gravitational microlensing events, ...) and moving objects from our Solar System (asteroids, comets, and made-man objects like space-debris!). Some sources are already confirmed, many are candidates!
The repository contains a number of notebooks focusing on the use of the Fink REST API for two different surveys: LSST and ZTF.
- LSST: The Vera C. Rubin Legacy Survey of Space and Time. Fink is one of the Fink Community Brokers processing LSST data from 2026.
- ZTF: Zwicky Transient Facility. Fink has been processing data from ZTF since November 2019.
You can try the notebooks using Google Colab (follow the link above). You can also clone the repo, and try it locally. Most notebooks will work with any Python verson higher than 3.5, except the one on ZTF microlensing which requires Python < 3.12 due to dependencies. We advise to work on a virtual environment:
python -m venv myenv
source myenv/bin/activate
pip install -r requirements.txt
# ... wait a bit
jupyter-notebook
# play with notebooks
We also provide a Singularity script to work in a contained environment (thanks @bregeon):
- Build with
singularity build --fakeroot fink.sif Singularity - Run with
singularity run fink.sif - Open the link in your browser (from the host)
How to contribute:
- Clone (or fork) this repo, and open a new branch.
- Create a new folder with a meaningful name (e.g.
supernovae,grb, ...) - Read and copy an existing notebook to get an idea of the structure of a tutorial.
- Once your notebook is finished, open a Pull Request such that we review the tutorial and merge it!