Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

Strong lens modeling package.

Project description Documentation Status Powered by Astropy Badge

lenstronomy is a multi-purpose package to model strong gravitational lenses. The software package is presented in Birrer & Amara 2018 and is based on Birrer et al 2015. lenstronomy finds application for time-delay cosmography and measuring the expansion rate of the universe, for quantifying lensing substructure to infer dark matter properties, morphological quantification of galaxies, quasar-host galaxy decomposition and much more. A (incomplete) list of publications making use of lenstronomy can be found at this link.

The development is coordinated on GitHub and contributions are welcome. The documentation of lenstronomy is available at and the package is distributed over PyPI. lenstronomy is an affiliated package of astropy.


$ pip install lenstronomy --user

Specific instructions for settings and installation requirements for special cases that can provide speed-ups, we refer to the documentation page.

Getting started

The starting guide jupyter notebook leads through the main modules and design features of lenstronomy. The modular design of lenstronomy allows the user to directly access a lot of tools and each module can also be used as stand-alone packages.

Affiliated packages

Multiple affiliated packages that make use of lenstronomy can be found here (not complete) and further packages are under development by the community.

Mailing list and Slack channel

You can join the lenstronomy mailing list by signing up on the google groups page.

The email list is meant to provide a communication platform between users and developers. You can ask questions, and suggest new features. New releases will be announced via this mailing list.

We also have a Slack channel for the community. Please send me an email such that I can add you to the channel.

If you encounter errors or problems with lenstronomy, please let us know!


Check out the contributing page and become an author of lenstronomy! A big shutout to the current list of contributors and developers!

Shapelet reconstruction demonstration movies

We provide some examples where a real galaxy has been lensed and then been reconstructed by a shapelet basis set.


The design concept of lenstronomy are reported in Birrer & Amara 2018. Please cite this paper when you use lenstronomy in a publication and link to Please also cite Birrer et al 2015 when you make use of the lenstronomy work-flow or the Shapelet source reconstruction. Please make sure to cite also the relevant work that was implemented in lenstronomy, as described in the release paper.

Project details

Download files

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

Files for lenstronomy, version 1.8.1
Filename, size File type Python version Upload date Hashes
Filename, size lenstronomy-1.8.1.tar.gz (3.0 MB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page