Skip to main content

wrap lenstronomy for efficient simulation generation

Project description

Welcome to deeplenstronomy!

status status status status

deeplenstronomy is a tool for simulating large datasets for applying deep learning to strong gravitational lensing. It works by wrapping the functionalities of lenstronomy in a convenient yaml-style interface, allowing users to embrace the astronomer part of their brain rather than their programmer part when generating training datasets.

Installation

With conda (Recommended)

  • Step 0: Set up an environment. This can be done straightforwardly with a conda installation:
conda create -n deeplens python=3.7 jupyter scipy pandas numpy matplotlib astropy h5py PyYAML mpmath future
conda activate deeplens
  • Step 1: pip install lenstronomy
  • Step 2: pip install deeplenstronomy

With pip

  • Step 1: pip install deeplenstronomy

Getting Started and Example Notebooks

Start by reading the Getting Started Guide to familiarize yourself with the deeplenstronomy style.

After that, check out the example notebooks below:

Notebooks for deeplenstronomy Utilities

Notebooks for Applying deeplenstronomy to Machine Learning Analyses

Notebooks for Suggested Science Cases

API Documentation

deeplenstronomy is designed so that users only need to work with their personal configuration files and the dataset generatation and image visualization functions. However, if you would like to view the full API documentation, you can visit the docs page.

Citation

If you use deeplenstronomy in your work, please include the following citations:

@article{deeplenstronomy,
  doi = {10.21105/joss.02854},
  url = {https://doi.org/10.21105/joss.02854},
  year = {2021},
  publisher = {The Open Journal},
  volume = {6},
  number = {58},
  pages = {2854},
  author = {Robert Morgan and Brian Nord and Simon Birrer and Joshua Yao-Yu Lin and Jason Poh},
  title = {deeplenstronomy: A dataset simulation package for strong gravitational lensing},
  journal = {Journal of Open Source Software}
}

@article{lenstronomy,
    title     =   "lenstronomy: Multi-purpose gravitational lens modelling software package",
    journal   =   "Physics of the Dark Universe",
    volume    =   "22",
    pages     =   "189 - 201",
    year      =   "2018",
    issn      =   "2212-6864",
    doi       =   "10.1016/j.dark.2018.11.002",
    url       =   "http://www.sciencedirect.com/science/article/pii/S2212686418301869",
    author    =   "Simon Birrer and Adam Amara",
    keywords  =   "Gravitational lensing, Software, Image simulations"
}

Contact

If you have any questions or run into any errors with the beta release of deeplenstronomy, please don't hesitate to reach out:

Rob Morgan
robert [dot] morgan [at] wisc.edu

You can also message me on the DES, DELVE, LSSTC, deepskies, or lenstronomers Slack workspaces

Project details


Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

deeplenstronomy-0.0.2.3-py2.py3-none-any.whl (58.6 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file deeplenstronomy-0.0.2.3-py2.py3-none-any.whl.

File metadata

  • Download URL: deeplenstronomy-0.0.2.3-py2.py3-none-any.whl
  • Upload date:
  • Size: 58.6 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/2.0.0 pkginfo/1.4.2 requests/2.22.0 setuptools/40.2.0 requests-toolbelt/0.9.1 tqdm/4.26.0 CPython/3.7.1

File hashes

Hashes for deeplenstronomy-0.0.2.3-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 5d5f11ffff56562820a9d068934c8b44d16a877b97ec9b8b7be47dfdd45bf52c
MD5 26a4617f3381e0c55d2afe5f93ff24e1
BLAKE2b-256 c97c265fcdc66fd0f71a4adaf7844f9fa706ca2ef105b62083d84c7dc87a4d62

See more details on using hashes here.

Supported by

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