Release version 0.17.0

Author: AmberLee2427

.github/workflows/forward.yml

@@ -16,27 +16,27 @@ jobs:
           script: |
             const originalIssue = context.payload.issue;
             const body = originalIssue.body;
-            
+
             if (body.includes('Repost: Yes')) {
               // Forward to org repo
               const cleanBody = body.replace(/Repost:\s*(Yes|No)\s*\n?/gi, '').trim();
-              
+
               const newIssue = await github.rest.issues.create({
                 owner: 'rges-pit',
                 repo: 'microlens-submit',
                 title: originalIssue.title,
                 body: cleanBody + '\n\n---\n*Originally submitted via help form*',
                 labels: ['type:help', 'source:web-form']
               });
-              
+
               // Comment with forward link
               await github.rest.issues.createComment({
                 owner: context.repo.owner,
                 repo: context.repo.repo,
                 issue_number: originalIssue.number,
                 body: `✅ Forwarded to: ${newIssue.data.html_url}`
               });
-              
+
             } else if (body.includes('Repost: No')) {
               // Just add a comment explaining why it's being closed
               await github.rest.issues.createComment({
@@ -46,7 +46,7 @@ jobs:
                 body: '❌ Not forwarded as requested. Closing help form issue.'
               });
             }
-            
+
             // Close the original issue in both cases
             await github.rest.issues.update({
               owner: context.repo.owner,

CHANGELOG.md

@@ -5,6 +5,34 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.17.0] - 2026-02-04
+
+### Added
+- **Physical Parameters**: Added 24 physical parameters (Mtot, M1-M4, D_L, D_S, thetaE, piE components, mu_rel components, phi) to parameter spec
+- **Physical Parameter Validation**: Comprehensive validation including mass consistency checks, vector magnitude verification, distance constraints, and unit confusion warnings
+- **Uncertainty Metadata**: Added three new Solution fields:
+  - `uncertainty_method`: Method used to derive uncertainties (mcmc_posterior, fisher_matrix, bootstrap, propagation, inference, literature, other)
+  - `confidence_level`: Confidence level for uncertainties (default: 0.68 for 1-sigma)
+  - `physical_parameter_uncertainties`: Uncertainties for physical parameters (symmetric or asymmetric)
+- **CLI Options**: Added `--physical-param-uncertainty`, `--uncertainty-method`, and `--confidence-level` options to `add-solution` command
+- **Tests**: Added 3 new comprehensive BIC calculation tests verifying parameter counting
+- **Version Management**: Enhanced `bump_version.py` to update and validate `parameter_spec.yaml` (includes drift check)
+
+### Fixed
+- **BIC Calculation Bug**: Fixed critical bug where BIC calculation counted ALL parameters including metadata (t_ref, limb_darkening_coeffs) and physical parameters (Mtot, D_L, etc.) as "free parameters". Now correctly counts only fitted model parameters using new `count_model_parameters()` function. This affects relative probability calculations during export and solution comparison.
+
+### Changed
+- Physical parameters now validated with `validate_physical_parameters()` automatically when present
+- Solution metadata validation now includes uncertainty metadata checks
+- BIC calculation in `submission.py` and `validation.py` now uses `count_model_parameters()` instead of `len(s.parameters)`
+
+### Documentation
+- Added comprehensive examples of physical parameters and uncertainty metadata to tutorial and usage examples
+- Tutorial emphasizes uncertainties are **optional but strongly recommended** for evaluation readiness
+- Created `PHYSICAL_PARAMS_SUMMARY.md` with complete implementation guide
+
+## [Unreleased]
+
 ## [0.16.5] - 2026-02-04
 
 ### Fixed

CITATION.cff

@@ -1,9 +1,9 @@
 cff-version: 1.2.0
 message: "If you use microlens-submit, please cite it as below."
 title: "microlens-submit"
-version: "0.16.5"
+version: "0.17.0"
 authors:
   - family-names: Malpas
     given-names: Amber
 url: "https://github.com/AmberLee2427/microlens-submit"
-doi: "10.5281/zenodo.18246117"
+doi: "10.5281/zenodo.18488304"

README.md

@@ -160,15 +160,15 @@ import this file directly.
 
 Bibtex:
 ```
-@software{malpas_2025_18246117,
+@software{malpas_2025_18488304,
   author       = {Malpas, Amber},
   title        = {microlens-submit},
   month        = oct,
   year         = 2025,
   publisher    = {Zenodo},
   version      = {v0.16.3},
-  doi          = {10.5281/zenodo.18246117},
-  url          = {https://doi.org/10.5281/zenodo.18246117},
+  doi          = {10.5281/zenodo.18488304},
+  url          = {https://doi.org/10.5281/zenodo.18488304},
 }
 ```
 

RELEASE_NOTES.md

@@ -1,12 +1,31 @@
-# microlens-submit v0.16.5 Release Notes
+# microlens-submit v0.17.0 Release Notes
 
 **Release Date:** 2026-02-04
 
 ## Changelog
 
-## [0.16.5] - 2026-02-04
+## [0.17.0] - 2026-02-04
+
+### Added
+- **Physical Parameters**: Added 24 physical parameters (Mtot, M1-M4, D_L, D_S, thetaE, piE components, mu_rel components, phi) to parameter spec
+- **Physical Parameter Validation**: Comprehensive validation including mass consistency checks, vector magnitude verification, distance constraints, and unit confusion warnings
+- **Uncertainty Metadata**: Added three new Solution fields:
+  - `uncertainty_method`: Method used to derive uncertainties (mcmc_posterior, fisher_matrix, bootstrap, propagation, inference, literature, other)
+  - `confidence_level`: Confidence level for uncertainties (default: 0.68 for 1-sigma)
+  - `physical_parameter_uncertainties`: Uncertainties for physical parameters (symmetric or asymmetric)
+- **CLI Options**: Added `--physical-param-uncertainty`, `--uncertainty-method`, and `--confidence-level` options to `add-solution` command
+- **Tests**: Added 3 new comprehensive BIC calculation tests verifying parameter counting
+- **Version Management**: Enhanced `bump_version.py` to update and validate `parameter_spec.yaml` (includes drift check)
 
 ### Fixed
-- Dossier assets are now copied into the dossier output and linked with URL-safe relative paths,
-  improving image loading in Roman Research Nexus and similar environments.
-- Event data, plots, and posteriors now resolve reliably when paths include spaces or nested folders.
+- **BIC Calculation Bug**: Fixed critical bug where BIC calculation counted ALL parameters including metadata (t_ref, limb_darkening_coeffs) and physical parameters (Mtot, D_L, etc.) as "free parameters". Now correctly counts only fitted model parameters using new `count_model_parameters()` function. This affects relative probability calculations during export and solution comparison.
+
+### Changed
+- Physical parameters now validated with `validate_physical_parameters()` automatically when present
+- Solution metadata validation now includes uncertainty metadata checks
+- BIC calculation in `submission.py` and `validation.py` now uses `count_model_parameters()` instead of `len(s.parameters)`
+
+### Documentation
+- Added comprehensive examples of physical parameters and uncertainty metadata to tutorial and usage examples
+- Tutorial emphasizes uncertainties are **optional but strongly recommended** for evaluation readiness
+- Created `PHYSICAL_PARAMS_SUMMARY.md` with complete implementation guide

TODO

@@ -19,16 +19,17 @@
 - [x] auto populate hardware info
 - [x] ".001" gets interpreted as a string
 - [x] nexus init gives hardware warning and it doesn't need to
-- [ ] nexus dosiers (with submission in /teams/*) not displaying images (problem in AAS workshop notebooks)
+- [x] nexus dosiers (with submission in /teams/*) not displaying images (problem in AAS workshop notebooks)
 - [x] "Experienced' tier not "Advanced"
-- [ ] validate physical parameters (blocked)
+- [x] validate physical parameters
 - [x] "piEN (instead of piEN)" when piEN was missing
-- [ ] additional model types (blocked)
+- [x] additional model types
 - [x] git and submission in different locations (add git_dir)
 - [x] Windows build in workflow
 - [x] Release Workflow
 - [x] Wheel build CI
 - [x] Unhelpful error when band not supoplied but a flux value is
+- [ ] What the fuck do we do about uncertainties?
 
 
 ## Conda Forge

conda/recipe/meta.yaml

@@ -1,6 +1,6 @@
 {% set name = "microlens-submit" %}
 {% set filename_name = name | replace("-", "_") %}
-{% set version = "0.16.5" %}
+{% set version = "0.17.0" %}
 {% set python_min = "3.10" %}
 
 # NOTE: This recipe is the source of truth for conda-forge. Edit it here in