Skip to main content

Automated pipeline for lens modeling based on lenstronomy

Project description

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:

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

space_dolphin-1.3.0.tar.gz (44.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

space_dolphin-1.3.0-py3-none-any.whl (44.6 kB view details)

Uploaded Python 3

File details

Details for the file space_dolphin-1.3.0.tar.gz.

File metadata

  • Download URL: space_dolphin-1.3.0.tar.gz
  • Upload date:
  • Size: 44.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for space_dolphin-1.3.0.tar.gz
Algorithm Hash digest
SHA256 346803f7ceab13815c613911fb4a47f43fb13cbcc039daae4569a9c4e0e2120d
MD5 be98368857ab140722fa4c44445c65eb
BLAKE2b-256 8e4968f5f070ce22bfe7c74564ff795c631148063236caec2fea8c4a42465a6d

See more details on using hashes here.

File details

Details for the file space_dolphin-1.3.0-py3-none-any.whl.

File metadata

  • Download URL: space_dolphin-1.3.0-py3-none-any.whl
  • Upload date:
  • Size: 44.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for space_dolphin-1.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 670aca40cb0ed0853e22381f19a996dae7ef20b3aa3f56ea2ae8425dd284b411
MD5 1ccb0ab3728833b15268271555e63c18
BLAKE2b-256 29e253b283cd4c113d195124efc924451107d3cadd825a0fd6feb62663a40b19

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page