{"id":19746416,"url":"https://github.com/astrolabsoftware/fink-tutorials","last_synced_at":"2025-10-06T12:04:35.777Z","repository":{"id":40234774,"uuid":"348653673","full_name":"astrolabsoftware/fink-tutorials","owner":"astrolabsoftware","description":"Tutorials and notebooks using Fink API","archived":false,"fork":false,"pushed_at":"2024-04-08T20:35:22.000Z","size":632998,"stargazers_count":5,"open_issues_count":7,"forks_count":4,"subscribers_count":7,"default_branch":"main","last_synced_at":"2024-05-07T18:22:33.432Z","etag":null,"topics":["api","fink","tutorial"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/astrolabsoftware.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2021-03-17T09:38:47.000Z","updated_at":"2024-05-07T18:22:33.433Z","dependencies_parsed_at":"2023-10-11T11:11:42.882Z","dependency_job_id":"3a0ecb36-68c3-463b-a896-658b658b6399","html_url":"https://github.com/astrolabsoftware/fink-tutorials","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/astrolabsoftware%2Ffink-tutorials","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/astrolabsoftware%2Ffink-tutorials/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/astrolabsoftware%2Ffink-tutorials/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/astrolabsoftware%2Ffink-tutorials/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/astrolabsoftware","download_url":"https://codeload.github.com/astrolabsoftware/fink-tutorials/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224202818,"owners_count":17272807,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","fink","tutorial"],"created_at":"2024-11-12T02:14:30.265Z","updated_at":"2025-10-06T12:04:30.755Z","avatar_url":"https://github.com/astrolabsoftware.png","language":"Jupyter Notebook","readme":"# Fink broker tutorials\n\n[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/astrolabsoftware/fink-notebook-template/blob/main)\n\nThis repository contains materials (notebooks \u0026 presentation) to explore the [Fink broker](https://fink-broker.org) 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!\n\n## Materials\n\nThe repository contains a number of notebooks focusing on the use of the Fink REST API. We shortly present different science cases:\n\n- Extragalactic science: AGN \u0026 supernovae ([see notebook](extragalactic/extragalactic.ipynb))\n- Galactic science: variable stars \u0026 microlensing ([see notebook](galactic/galactic.ipynb))\n- Solar system science: asteroids, comets \u0026 space debris ([see notebook](sso/sso.ipynb))\n- Solar system science: phase curves ([see notebook](sso/fink_sso_imcce.ipynb))\n- Multi-messenger astronomy: searching for kilonovae ([see notebook](MMA/MMA.ipynb))\n- Multi-messenger astronomy: correlating with gravitational waves sky maps ([see notebook](MMA/gravitational_waves.ipynb))\n- Broker interfaces: presentation on the livestream service, the Science Portal and its API, and the Fink TOM module ([see the presentation](interfaces/README.md))\n\nThese sciences are not exhaustive and we welcome new collaborations to expand them! In addition, there are notebooks focusing on other specific aspects:\n\n- How to tune the output rate of a Fink filter? Example for the Early SN Ia candidate filter ([see notebook](extragalactic/tuning_snia_output_rate.ipynb))\n\nYou 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 [microlensing](galactic/galactic.ipynb) which requires Python \u003c 3.12 due to dependencies. We advise to work on a virtual environment:\n\n```\npython -m venv myenv\nsource myenv/bin/activate\n\npip install -r requirements.txt\n# ... wait a bit\n\njupyter-notebook\n# play with notebooks\n```\n\nWe also provide a Singularity script to work in a contained environment (thanks @bregeon):\n\n- Build with `singularity build --fakeroot fink.sif Singularity`\n- Run with `singularity run fink.sif`\n- Open the link in your browser (from the host)\n\n\n## How to contribute\n\nHow to contribute:\n\n- Clone (or fork) this repo, and open a new branch.\n- Create a new folder with a meaningful name (e.g. `supernovae`, `grb`, ...)\n- Read and copy an existing notebook to get an idea of the structure of a tutorial.\n- Once your notebook is finished, open a Pull Request such that we review the tutorial and merge it!\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fastrolabsoftware%2Ffink-tutorials","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fastrolabsoftware%2Ffink-tutorials","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fastrolabsoftware%2Ffink-tutorials/lists"}