MORIA

About MORIA

There are Lord of the Rings references throughout this website and pipeline. The author of this pipeline (me) is a big fan and apologizes for the references.

MORIA is an automated procedure to reduce high-resolution HST images of microlensing targets, build empirical point-spread function models from the data, and perform simultaneous multi-star PSF fitting to blended sources, lenses, and neighbor stars.

A paper on the use of MORIA with KMT-2019-BLG-0253 is available here and is titled: You Shall Not Pass (Without Modeling): High-Resolution Analysis of KMT-2019-BLG-0253 using MORIA

Join the Fellowship

Clone the repository, install the package, and copy the demo notebooks to your working directory.

Clone and Install By:

git clone https://github.com/10ay/MORIA.git
cd MORIA
pip install -e .

Copy notebooks to your analysis directory:

cp -r demo/notebooks/* /path/to/your/project/
cp -r data/* /path/to/your/project/

Along with you, here are the other eight members of the Fellowship

matplotlib
pandas
pathlib
astropy
numpy
Plotly
Fortran Compiler
Jupyter

Nine companions. So be it. You shall be the fellowship of the ring.

Speak, Friend, And `cd`

The recommended way to run MORIA is to copy everything in demo/notebook to the same repository level at which you want to perform the data analysis. If you follow the installation instructions above, you should alreay be ready to run the pipeline. Follow the demo notebooks in this order.

Output Stacks

Prepare and stack HST images. Build a starlist from the images.

Open PDF 00.output_stacks.ipynb

CMD Diagram

Make a CMD diagram + identify stars with colors and magnitudes similar to the target.

Open PDF 01.cmd_diagram.ipynb

Create a PSF

Construct a PSF model using stars selected to have colors and magnitudes similar to those of the target star.

Open PDF 02.creating_psf.ipynb

Fit PSFs

Fit one-, two-, and three-star models. Run the last cell of this notebook to meet a silly, old friend.

Open PDF 03.fitting_psfs.ipynb

Calibrate

Match to OGLE-III magnitudes to derive the photometry. Emerge into calibrated light.

Open PDF 04.calibrations.ipynb

Keck (optional)

Handles coordinate tranformation between HST and Keck. Since this is an optional notebook, the Balrog is rumored to be hidden here.

View on GitHub opt.keck_calib.ipynb

The Mines

MORIA expects a project directory with numbered data folders. The necessary scripts required to run the pipeline live in the data/ folder. Your working directory should include these folders.

Folder	Notebook
`00.DATA`	`00.output_stacks.ipynb`
`01.XYM`	`00.output_stacks.ipynb`
`02.CMD`	`01.cmd_diagram.ipynb`
`03.LOC_TRANS`	`02.creating_psf.ipynb`
`04.EXTRACT_PSF`	`02.creating_psf.ipynb`
`05.KECK_TRANS`	`opt.keck_calib.ipynb`
`06.FIT`	`03.fitting_psfs.ipynb`
`07.CALIBRATION`	`04.calibrations.ipynb`