Skip to content

brady-ryan/dolphin

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,255 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

logo dolphin

https://readthedocs.org/projects/dolphin-docs/badge/?version=latest https://github.com/ajshajib/dolphin/actions/workflows/ci.yaml/badge.svg?branch=main Codecov License BSD 3-Clause Badge Shajib et al. 2025, ApJ, 992, 40 https://img.shields.io/badge/arXiv-2503.22657-b31b1b?logo=arxiv&logoColor=white Zenodo DOI 10.5281/zenodo.16587211 https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=brightyellow

Welcome to dolphin, an AI-powered automated pipeline for strong gravitational lens modeling!

dolphin leverages lenstronomy as its core modeling engine, providing an accessible and scalable framework for studying galaxy-scale lenses.

What is Dolphin?

Strong gravitational lens modeling traditionally requires significant manual effort. dolphin changes this by providing an AI-driven approach to forward modeling, enabling researchers to process large samples of strong lenses with ease. Whether you want a fully hands-off automated pipeline or a semi-automated workflow where you can fine-tune the AI-generated configurations, dolphin gives you the flexibility and power you need.

Features

  • 🤖 AI-Automated Modeling: Streamline forward modeling for large datasets of galaxy-scale lenses.
  • 🎛️ Flexible Workflows: Choose between fully automated runs or semi-automated modes with manual overrides.
  • 🌈 Multi-Band Support: Easily configure and model across multiple observing bands simultaneously.
  • 🌌 Versatile Sources: Built-in support for both galaxy–galaxy and galaxy–quasar lens systems.
  • 💻 HPC Ready: Seamlessly sync your setup between local machines and High-Performance Computing Clusters (HPCC).
  • Tested & Reliable: Comprehensively tested with Codecov.

Installation

PyPI - Version

Installing dolphin is simple. You can install the latest stable release via pip:

pip install space-dolphin

Alternatively, to install the latest development version directly from GitHub:

git clone https://github.com/ajshajib/dolphin.git
cd dolphin
pip install .

For instructions on setting up your workspace and running your first model, please check out our Quickstart guide.

Citation

If you use dolphin in your research, please cite the main dolphin paper:

Depending on the fitting recipe used, please additionally cite the following papers for the underlying modeling methodology:

About

Automated pipeline for lens modelling based on lenstronomy

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Jupyter Notebook 86.4%
  • Python 13.3%
  • Other 0.3%