v1.0.0 — AAS Workshop Release

This is the AAS Workshop version of the Roman Microlensing Data Challenge 2026 notebook set. It packages the finalized workshop materials (Sessions A–D) along with participant-facing documentation, Colab-friendly notebooks where applicable, and the automation needed to keep the website and Roman Research Nexus exports in sync.

Highlights

• Workshop-ready notebook set under AAS Workshop/ with session-level README context and consistent A–D labeling.
• Colab support for notebooks that can run in a remote runtime (with “Nexus-only” guidance where Colab is not applicable).
• Canonical → derived build pipeline driven by notebooks_manifest.yml and scripts:
  • Website-ready pages generated into bin/
  • Nexus-ready notebook artifacts generated into RRN/build/
• Updated Nexus integration path: exports target the dedicated rges-pit/nexus-notebooks repository (artifact-only) instead of a PR to roman_notebooks.
• Manual notebook execution workflow (workflow dispatch) to rebuild and execute Nexus-ready artifacts with optional tag-based skipping for expensive cells.

Repository Contents

The contents of this repository feed multiple destinations:

• AAS Workshop syllabus (AAS Workshop/) – canonical notebooks and documentation for the AAS RMDC26 workshop sessions (A–D).
• Extras (Extras/) – additional canonical notebooks and helper material for data-challenge participants.
• Website-ready pages (bin/) – Markdown fragments transformed into rges-pit.github.io pages via page_transformer.py.
• Roman Research Nexus derivatives (RRN/) – Nexus-specific builds of the canonical notebooks that satisfy STScI contributing guidance.

Derived content is generated from the canonical directories via transformers in scripts/ using the notebooks_manifest.yml manifest. When contributing, please do not edit generated artifacts directly in RRN/ or bin/.

Environment

Global environment specs: env.yml (conda) and requirements.txt (pip).

Notes for maintainers

• The website sync continues to open a PR for review (branch-based PR against the upstream site repo).
• The Nexus export is treated as export-only artifacts, force-updating the target repo’s main branch.

What's Changed

• Citations by @AmberLee2427 in #29
• info page minimum content by @AmberLee2427 in #30
• Fix links and title in data challenge workflow by @AmberLee2427 in #34
• Update binary lens caustic class for MuLensModel 3.4.0 by @Copilot in #35
• Add missing dependencies for AAS workshop notebooks by @Copilot in #36
• Fix header file parsing in Single Lens notebooks by constraining column read by @Copilot in #37
• Update publish workflow and TODO list for improved repository management by @AmberLee2427 in #38
• Fix URLs in data_challenge_pipeline.md for correct navigation and dow… by @AmberLee2427 in #39
• workflow dramas by @AmberLee2427 in #40
• workflow again by @AmberLee2427 in #41
• Refactor PR creation process to use GraphQL for better repository ID … by @AmberLee2427 in #42
• wrong api fields by @AmberLee2427 in #43
• fix boolean f-up by @AmberLee2427 in #44
• Refactor PR creation process to use REST API for improved repo clarity by @AmberLee2427 in #45
• debugging workflow by @AmberLee2427 in #46
• trying a new branch name by @AmberLee2427 in #47
• Meet vyas dev/main by @AmberLee2427 in #49
• Code Review and Bug Fixes by @Meet-Vyas-Dev in #48
• Meet vyas dev/main by @AmberLee2427 in #50
• last minute data path fixes by @AmberLee2427 in #51
• mulensmodel api error fix by @AmberLee2427 in #52
• final notebook tidy up by @AmberLee2427 in #53
• proof reading edits by @AmberLee2427 in #54
• Bare nexus repo as submodule by @AmberLee2427 in #55
• Add CI workflow for Nexus artefacts by @AmberLee2427 in #56

New Contributors

• @Copilot made their first contribution in #35
• @Meet-Vyas-Dev made their first contribution in #48

Full Changelog: v0.1.0...v1.0.0

Pre-Review Release v0.1.0

This repository provides a set of Jupyter notebooks that support the Roman Microlensing Data Challenge 2026, a competition organized by the Roman Galactic Exoplanet Survey – Project Infrastructure Team (RGES-PIT). The goal of the challenge is to familiarize researchers with the data volume and characteristics expected from the Roman Galactic Bulge Time Domain Survey, advance existing data analysis and computing practices, and encourage new talent to the field of microlensing.

If you are a data challenge participant, your primary resources live in the AAS Workshop/ and Extras/ directories. Each directory ships with README.md context plus Colab buttons where a remote runtime is supported.

Repository Contents

The contents of this repository feed multiple destinations:

• AAS Workshop syllabus (AAS Workshop/) – canonical notebooks and documentation for the AAS 247 RMDC26 workshop sessions (A–D).
• Extras (Extras/) – additional canonical notebooks and helper material for data-challenge participants.
• Website-ready pages (bin/) – Markdown fragments that are transformed into rges-pit.github.io pages via scripts/page_transformer.py.
• Roman Research Nexus derivatives (RRN/) – Nexus-specific builds of the canonical notebooks that satisfy the STScI contributing guidelines.

Derived content is generated from the canonical directories via transformers in scripts/ using the notebooks_manifest.yml manifest. Contributions should not be made directly to RRN/build/ or bin/ because those directories are regenerated artifacts. See RRN/README.md and the documentation within bin/ for details.

Notebook Content

The notebooks (and related environment files) included in this repo are:

• Extras/Microlensing_Tools.ipynb – a tutorial notebook that lists open-source microlensing codes, provides Roman-specific walkthroughs, and explains how to install dependencies. It uses simulated light curves from the 2018 WFIRST Data Challenge to demonstrate basic fitting and analysis steps. The notebook is intended to be embedded on the RGES-PIT website and mirrored on the Nexus.

  

• AAS Workshop/Session A: Nexus/Nexus_Workflow.ipynb – a data-challenge-specific walkthrough covering data access, Nexus tooling, and submission validation with microlens-submit. This notebook is designed for the Roman Research Nexus kernel and is not intended to run on Colab.

• AAS Workshop/Session B: Single Lens & Pipelines/Single_Lens_Pipeline.ipynb – a bulk single-lens fitting tutorial, refreshed for the AAS workshop.

  

• AAS Workshop/Session C: Binary Lens/Fitting_Binary_Lenses.ipynb – a binary-lens modeling notebook that demonstrates multiple fitting strategies and exercise blocks.

  

• Extras/Gould_Loeb_Planetary_Event.ipynb – a binary lens light-curve interpretation notebook based on Chapter 4 of the REU2025 minicourse.

  

• requirements.txt and env.yml – universal Python requirements for all notebooks.

  # pip
  pip install -r requirements.txt
  
  # conda
  conda env create -f env.yml
  conda activate rges-pit-dc

• Additional notebooks or scripts contributed by the community are extremely welcome. Examples include custom light-curve fitting routines, demonstrations of particular codes, or workflows that cover additional data types (astrometric time series, image cut-outs, etc.) anticipated for RMDC26 and future Roman data.

What's Changed

• Readme by @AmberLee2427 in #1
• added Chapter 5 rip off by @AmberLee2427 in #4
• Added binary lens materials for the AAS Workshop by @ArjunMurlidhar in #5
• Parallelization added for mcmc and grid search by @ArjunMurlidhar in #6
• Refactor for RRN build and website content sync by @AmberLee2427 in #7
• cosmetic changes to the readme files and matching regex adjustments by @AmberLee2427 in #8
• woops, accidentally removed three notebooks by @AmberLee2427 in #9
• Add GitHub Actions workflow to build artifacts and create website and RRN draft PRs by @AmberLee2427 in #10 - #26

New Contributors

• @AmberLee2427 made their first contribution in #1
• @ArjunMurlidhar made their first contribution in #5
• @KatieVandorou made their first contributions in direct pushes to the repo

Full Changelog: https://github.com/rges-pit/data-challenge-notebooks/commits/v0.0.1