microlens-submit 0.12.1__py3-none-any.whl

microlens_submit-0.12.1.dist-info/METADATA

@@ -0,0 +1,159 @@
+Metadata-Version: 2.4
+Name: microlens-submit
+Version: 0.12.1
+Summary: A stateful submission toolkit for the Microlensing Data Challenge.
+Author-email: Amber Malpas <malpas.1@osu.edu>
+License: MIT
+Project-URL: Homepage, https://github.com/AmberLee2427/microlens-submit
+Project-URL: Repository, https://github.com/AmberLee2427/microlens-submit
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer[all]>=0.9.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: rich>=13.0
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: markdown>=3.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: pre-commit; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: isort; extra == "dev"
+Requires-Dist: sphinx; extra == "dev"
+Requires-Dist: sphinx_rtd_theme; extra == "dev"
+Dynamic: license-file
+
+<p align="center">
+  <a href="https://github.com/AmberLee2427/microlens-submit">
+    <img src="./microlens_submit/assets/rges-pit_logo.png" alt="logo" width="300"/>
+  </a>
+</p>
+
+<h1 align="center">microlens-submit</h1>
+
+*A stateful submission toolkit for the RGES-PIT Microlensing Data Challenge.*
+
+[![PyPI - v0.12.1](https://img.shields.io/pypi/v/microlens-submit.svg)](https://pypi.org/project/microlens-submit/)
+[![CI](https://github.com/AmberLee2427/microlens-submit/actions/workflows/ci.yml/badge.svg)](https://github.com/AmberLee2427/microlens-submit/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+<br>
+
+`microlens-submit` provides a robust, version-controlled workflow for managing, validating, and packaging your challenge submission over a long period. It supports both a programmatic Python API and a full-featured Command Line Interface (CLI) for language-agnostic use.
+
+Full documentation is hosted on [Read the Docs](https://microlens-submit.readthedocs.io/en/latest/). A comprehensive tutorial notebook is available at `docs/Submission_Tool_Tutorial.ipynb`. Challenge participants who prefer not to use this tool can consult [SUBMISSION_MANUAL.md](SUBMISSION_MANUAL.md) for the manual submission format.
+
+## Key Features
+
+* **Persistent Projects:** Treat your submission as a local project that you can load, edit, and save over weeks or months.
+* **Python API & CLI:** Use the tool directly in your Python analysis scripts or via the command line.
+* **Solution Management:** Easily add, update, and deactivate degenerate solutions for any event without losing your work history.
+* **Active Solution Control:** Quickly list just the active solutions or mark
+  all solutions inactive in one call.
+* **Automatic Validation:** Aggressive data validation powered by Pydantic ensures your submission is always compliant with the challenge rules.
+* **Parameter Validation:** Centralized validation logic checks parameter completeness, types, and physical consistency based on model type and higher-order effects.
+* **Rich Documentation:** Notes field supports Markdown formatting for creating detailed, structured documentation and submission dossiers.
+* **Environment Capture:** Automatically records your Python dependencies for each specific model fit, ensuring reproducibility.
+* **Optional Posterior Storage:** Record the path to posterior samples for any solution.
+* **Simple Export:** Packages all your active solutions into a clean, standardized `.zip` archive for final submission.
+
+## Installation
+
+This package is pre-release. It is currently available on TestPyPI:
+
+```bash
+pip install -i https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple microlens-submit==0.12.0-dev
+```
+
+The package will be available on PyPI:
+
+```bash
+pip install microlens-submit
+```
+
+### Quickstart Using the Command Line Interface (CLI)
+
+The CLI is the recommended way to interact with your submission project.
+
+You can pass ``--no-color`` to any command if your terminal does not support ANSI colors.
+
+1. Initialize your project: `microlens-submit init --team-name "Planet Pounders" --tier "advanced"`
+2. Add a new solution to an event:
+   ```bash
+   microlens-submit add-solution ogle-2025-blg-0042 1S2L \
+       --param t0=555.5 \
+       --param u0=0.1 \
+       --param tE=25.0 \
+       --notes "This is a great fit!"
+   ```
+   Model types must be one of `1S1L`, `1S2L`, `2S1L`, `2S2L`, `1S3L`, `2S3L`, or `other`.
+   This will create a new solution and print its unique `solution_id`.
+   You can run the same command with `--dry-run` first to verify the
+   parsed input without saving anything.
+3. Deactivate a solution that didn't work out: `microlens-submit deactivate <solution_id>`
+4. List all solutions for an event: `microlens-submit list-solutions ogle-2025-blg-0042`
+5. Validate solutions and check for issues: `microlens-submit validate-solution <solution_id>`
+6. Export your final submission: `microlens-submit export final_submission.zip`
+
+**Note:** When you add a solution, it's automatically validated and any warnings are displayed. Use `--dry-run` to check validation without saving.
+
+### Using the Python API
+
+For those who want to integrate the tool directly into their Python analysis pipeline.
+
+```python
+import microlens_submit
+
+# Load or create the project
+sub = microlens_submit.load(project_path="./my_challenge_submission")
+sub.team_name = "Planet Pounders"
+sub.tier = "advanced"
+
+# Get an event and add a solution
+evt = sub.get_event("ogle-2025-blg-0042")
+params = {"t0": 555.5, "u0": 0.1, "tE": 25.0}
+sol = evt.add_solution(model_type="1S2L", parameters=params)
+
+# Record compute info for this specific run
+sol.set_compute_info(cpu_hours=15.5)
+sol.notes = "This fit was generated from our Python script."
+
+# Save progress to disk
+sub.save()
+
+# When ready, export the final package
+sub.export("final_submission.zip")
+```
+
+## Development
+
+The full development plan can be found in agents.md. Contributions are welcome!
+
+To build and test this project, the development environment needs the following Python libraries. You can provide these to Codex or set up a `requirements-dev.txt` file.
+
+### Core Dependencies:
+* **`typer[all]`**: For building the powerful command-line interface. The `[all]` extra ensures shell completion support is included.
+* **`pydantic`**: For aggressive data validation and settings management.
+
+### Testing Dependencies:
+* **`pytest`**: The standard framework for testing Python code.
+* **`pytest-cov`**: To measure test coverage.
+
+### Packaging & Distribution Dependencies:
+* **`build`**: For building the package from the `pyproject.toml` file.
+* **`twine`**: For uploading the final package to PyPI.
+
+## Citation
+
+If you use **microlens-submit** in your research, please cite the project using
+the metadata provided in the `CITATION.cff` file. Most reference managers can
+import this file directly.
+

microlens_submit-0.12.1.dist-info/RECORD

@@ -0,0 +1,13 @@
+microlens_submit/__init__.py,sha256=hBD9NA-AbajbMaVGS8_5xNvvWsLGBON0bXIK3kDK-jA,5869
+microlens_submit/api.py,sha256=p_EqHPBA7kkOMa1GzPj1_fTy4J63uyzkI41l1O3_IlA,53885
+microlens_submit/cli.py,sha256=SpO3d8v2_SswFNZFDkNQ4K0Oj-EXkDYmR5309123D6o,78718
+microlens_submit/dossier.py,sha256=tvWSh0JaSrPK5O7c_xULDkKNxCxBnUfaUgm9dFMUsrA,65415
+microlens_submit/validate_parameters.py,sha256=GNma6rIl_VompJ7eyGJnT3nQ0v_PFJW1pZVBqVj5UTA,30767
+microlens_submit/assets/github-desktop_logo.png,sha256=pb4rallKrYQPHt6eC0TmJe_UyyMtf1IrP8_OWK19nH8,479821
+microlens_submit/assets/rges-pit_logo.png,sha256=45AJypXCymvt3lMeK7MHt1SBhwPpnKCMj6S000Cejtc,537645
+microlens_submit-0.12.1.dist-info/licenses/LICENSE,sha256=cy1qkVR-kGxD6FXVsparmU2vHJXYeoyAAHv6SgT67sw,1069
+microlens_submit-0.12.1.dist-info/METADATA,sha256=qoO8paDd7MhdTpuJNbPI09i8Ij20RUlee27me7if5Uc,7177
+microlens_submit-0.12.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+microlens_submit-0.12.1.dist-info/entry_points.txt,sha256=kA85yhxYrpQnUvVZCRS2giz52gaf1ZOfZFjY4RHIZ2s,62
+microlens_submit-0.12.1.dist-info/top_level.txt,sha256=uJ9_bADYRySlhEpP-8vTm90ZLV2SrKEzutAaRx8WF0k,17
+microlens_submit-0.12.1.dist-info/RECORD,,

microlens_submit-0.12.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

microlens_submit-0.12.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+microlens-submit = microlens_submit.cli:app

microlens_submit-0.12.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Amber Malpas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

microlens_submit-0.12.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+microlens_submit