Skip to content
Microlensing Modelling package
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
documents minor v2.0 notes Feb 20, 2019
examples minor Feb 14, 2019
LICENSE Update LICENSE Aug 27, 2016 remove unused photometry file Feb 14, 2019


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

Latest release: 1.9.4 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 can then be input into an arbitrary likelihood function to find the best fit parameters.

A few useful resources:

Documentation includes description of input and output of every function.

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

Currently, MulensModel supports:

  • Lens Systems: point lens or binary lens.
  • Source Stars: single source or binary source.
  • Effects: finite source (1-parameter), parallax (satellite & annual), binary lens orbital motion, different parametrizations of microlensing models.

Need more? Open an issue or send us an e-mail.

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 see link.

How to install?

Download the source code and run:

python install

MulensModel requires some standard packages plus astropy package. To make sure that you have everything that's needed, just run:

pip install -r requirements.txt

Alternatively, you can run makefiles: go to source/VBBL/ and run make, then go to source/AdaptiveContouring/ and do the same. Then and add the path MulensModel/source to your PYTHONPATH. If you have any problems, please contact the authors and we will try to help.

If you have problems with installing or running MulensModel on MacOS, please see notes here.


file revised Feb 2019

You can’t perform that action at this time.