Skip to main content
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 https://img.shields.io/badge/code%20style-black-000000.svg https://img.shields.io/badge/%20formatter-docformatter-fedcba.svg https://img.shields.io/badge/%20style-sphinx-0a507a.svg

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:

Metadata

Release files for space-dolphin 1.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for space-dolphin 1.5.0
File Size Uploaded
space_dolphin-1.5.0.tar.gz 68.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for space-dolphin 1.5.0
File Interpreter ABI Platform
space_dolphin-1.5.0-py3-none-any.whl Python 3 none any Details

Total release size: 138.9 kB

Release files / space_dolphin-1.5.0.tar.gz

Download URL space_dolphin-1.5.0.tar.gz
Size 68.0 kB
Tags Source
SHA-256 checksum
How to use checksums
7faad512665e93a25acf202720635e254bcecf8940c58e17ad3577174d1cb7d9
BLAKE2b-256 checksum
How to use checksums
babb45d2c450da08d6b6093bbe5e0410b1f0bd5fb073cfd997de18cc9e13570d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.16

Release files / space_dolphin-1.5.0-py3-none-any.whl

Download URL space_dolphin-1.5.0-py3-none-any.whl
Size 70.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
79cbc552d82bc3742f7ec07eb3e2d9d723e61dd90a9251268d6298a56fe5765d
BLAKE2b-256 checksum
How to use checksums
07a0cd0cd662765c442249482f5bcc85ef4166a7e05e9f5c1c4e23fb28a4a5a7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.16

Release history Release notifications | RSS feed

This release

1.5.0 This release

2 release files

1.4.0

2 release files

1.3.0

2 release files

1.2.1

2 release files

1.2.0

2 release files

1.1.3

2 release files

1.1.2

2 release files

1.1.1

2 release files

1.1.0

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page