Skip to content

rpoleski/MulensModel

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
Feb 20, 2023
Aug 18, 2023
Sep 15, 2023
Aug 17, 2023
Jul 25, 2023
Sep 15, 2023
Jul 13, 2023
Jul 11, 2022
Jan 26, 2023
Nov 24, 2022
May 4, 2023
Jan 24, 2022
Sep 15, 2023
Mar 4, 2022
Nov 15, 2022
Jan 19, 2022
Jul 4, 2022

Repository files navigation

MulensModel

MulensModel is package for modeling microlensing (or μ-lensing) events.

Detailed documentation: https://rpoleski.github.io/MulensModel/

Latest release: 2.18.0 and we're working on further developing the code.

MulensModel can generate a microlensing light curve for a given set of microlensing parameters, fit that light curve to some data, and return a chi2 value. That chi2 (and its gradient in some cases) can then be input into an arbitrary likelihood function to find the best-fit parameters.

If you want to learn more about microlensing, please visit Microlensing Source website.

Currently, MulensModel supports:

  • Lens Systems: point lens or binary lens. Shear and convergence allowed for both point and binary lenses.
  • Source Stars: single source or binary source.
  • Effects: finite source (1-parameter), parallax (satellite & annual), binary lens orbital motion, xallarap effect (new), different parametrizations of microlensing models.

Need more? Open an issue, start a discussion, or send us an e-mail.

MulensModel logo

Acknowledgements

Are you using MulensModel for scientific research? Please give us credit by citing the paper published in "Astronomy and Computing" and ASCL reference. For arXiv version please see link. You should also cite relevant papers for algorithms used. In a typical run that uses binary lenses these will be Bozza (2010) and Skowron & Gould (2012). HERE is a list of papers to cite for various algorithms used in MulensModel. We also thank other people who helped in MulensModel development - please see list in AUTHORS.md file.

Examples and tutorials

We have more than a dozen of examples - starting from very simple ones (like plotting a model) to very advanced (like fitting a binary lens model with finite source effect). Please see:

The full documentation of API is at https://rpoleski.github.io/MulensModel/.

How to install?

The easiest way is to run:

pip install MulensModel

which will download all files and also install all dependencies (using the PyPI website).

If the above method doesn't work or you would like to see other possibilities, then please see the install file.

Contributing

If you want to contribute to MulensModel, then please see this file.


astropy PyPI version shields.io GitHub stars MIT license Poleski & Yee 2019 astro-ph/1803.01003 EMAC PyPI - Downloads example workflow Coverage Status

file revised Sep 2023

About

Microlensing Modelling package

Resources

License

Citation

Stars

Watchers

Forks

Packages

No packages published