The Microlenser's Guide to the Galaxy

Welcome, intrepid explorers of the cosmic tapestry! You are about to embark on a delightful journey through the realm of microlensing. This guide has been meticulously crafted to furnish the eager minds of budding scientists with the skills necessary to navigate the wonders of the Roman microlensing project.

Overview

Table of Contents

• Introduction
• Installation
• Usage
• Contributing
• License
• Contact

Introduction

Picture this: a galaxy brimming with mysteries and hoards of juicy Roman data waiting to unravel them. But this picture is missing something: a doe-eyed microlenser, whose fortitude and cleverness are up to the task of its unraveling—someone like you.

The goal of this project is to create an all-encompassing collection of Jupyter notebooks—your trusty companions for engaging exercises related to microlensing. Through these notebooks, the insights and experiences of microlensing elders can light your path as you embark on your journey of discovery and exploration through scientific research.

This guide follows a choose-your-own-adventure style. You control the specializations and knowledge you wish to become equipped with. That way, whether you are the min-maxing kind or more the type to vibe it out, this course is designed specifically for you.

These resources are made to be as freely available as HST time is not, beckoning anyone with a curious spirit to delve into the fascinating world of microlensing and contribute to its exciting development.

Installation

To embark on your microlensing adventure, simply follow these straightforward steps:

1. Clone the repository:
   bash git clone https://github.com/AmberLee2427/TheMicrolensersGuideToTheGalaxy.git

2. Create a dedicated environment with the required dependencies: bash sudo apt-get install python3-venv python3 -m venv <env-name> source <env-name>/bin/activate pip install -r requirements.txt for pip users on macOS or Linux,

   or

   bash conda env create --file=environment.yml conda activate TheGuide for Anaconda users. This notebook course currently runs on Python version 3.11.

   Alternatively, without using environments (not recommended), you can install the required dependencies as follows:
   bash pip install -r requirements.txt for pip users,

   or

   bash conda install --file requirements.txt for Anaconda users. Installs using the requirements file are untested

And voilà! You’re ready to launch into the universe of data and discovery.

If however, this installation process leaves you as maniacally depressed as the android, Marvin, save yourself some heartache and refer to the expertise of your institutions designated tech expert. If you continue to experience failures to launch, contact the project author.

Some of the more specialised notebooks in this guide have further install requirements that we recommend you tackle on an as-needed basis.

Usage

Open the Jupyter notebooks nestled within the Notebooks directory, where each document brims with exercises and illuminating examples. Follow the instructions inside your Introduction.ipynb (GitHub link) notebook and prepare to explore the captivating concepts of microlensing with all the enthusiasm of a seasoned hitchhiker.

Contributing

Your contributions are the hydrogen that makes this project shine brighter! If you wish to become an Author and enhance these resources—whether through bug fixes, clever improvements, or new exercises—please don’t hesitate to contact the project author at malpas.1@osu.edu. Every bit of input is appreciated.

Authors

• Amber Malpas
• Katarzyna Kruszynska
• Alison Crisp
• Samson Johnson
• B. Scott Gaudi (TBD)
• Michael Albrow (TBD)

License

This project is released under the MIT License. Fear not, for the original material within these resources, including code snippets, is free for use—like the best snacks on an interstellar flight. However, do keep in mind that any copyrighted material within the notebooks is bound by the restrictions of its original copyright holders.

Contact

Should questions or inquiries cross your mind or terminal, feel free to reach out to the project author, who is as approachable as a friendly as wait staff at the restaurant at the end of the Universe:

• Name: Amber Malpas
• Email: malpas.1@osu.edu
• GitHub: AmberLee2427

So raise you thumb, grab your towel, and prepare for an enlightening expedition into the universe of microlensing!