Skip to content

Commit 7a2149c

Browse files
Add CHANGELOG.md for v0.4.0 release
1 parent 9e04abc commit 7a2149c

1 file changed

Lines changed: 97 additions & 0 deletions

File tree

CHANGELOG.md

Lines changed: 97 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
1+
# Changelog
2+
3+
All notable changes to the SPINE Production System will be documented in this file.
4+
5+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6+
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7+
8+
## [0.4.0] - 2026-02-10
9+
10+
**Post-reformatting baseline release** - Major architectural overhaul of the configuration system and codebase structure. This release marks a stable reference point before planned architectural evolution.
11+
12+
### ⚠️ Breaking Changes
13+
- **Requires SPINE v0.9.0 or later**
14+
- Configuration directory structure completely reorganized
15+
- Include paths in existing configurations need updating
16+
17+
### What's Changed
18+
19+
- **Complete Configuration System Restructure:**
20+
- Introduced modular organization with separation of concerns
21+
- Mode-agnostic model configurations now in `config/common/model/`
22+
- Mode-specific configs (base/io/post) organized under `config/{infer,train}/{detector}/`
23+
- Implemented intelligent fallback resolution: detector-specific → common defaults
24+
- New standardized naming conventions with date-stamped configuration files
25+
26+
- **Submitter Codebase Modularization:**
27+
- Refactored monolithic submission script into maintainable modules
28+
- Separated concerns: configuration management, file handling, SLURM client
29+
- Improved code structure for extensibility and testing
30+
31+
- **Enhanced Job Submission Features:**
32+
- Local directory mode: jobs write to `--local-dir` by default (use `--central-dir` for production)
33+
- Better dependency handling for multi-array job requirements
34+
- Improved chunking logic with sequential execution guarantees
35+
- Smart job array generation (skips arrays for single-task jobs)
36+
37+
- **Extended Detector Support:**
38+
- Added DUNE 10kt-1x2x6 inference configurations
39+
- Improved NERSC cluster integration
40+
41+
### Migration Guide
42+
43+
For users with custom v0.3.x configurations, see detailed migration instructions in `config/common/README.md` and `config/infer/README.md`. Key steps:
44+
45+
1. Reorganize model configs → `config/common/model/`
46+
2. Move detector-specific inference configs → `config/infer/{detector}/`
47+
3. Update include paths in composite configurations
48+
4. Update SPINE dependency to v0.9.0+
49+
50+
Full Changelog: [v0.3.1...v0.4.0](https://github.com/DeepLearnPhysics/spine-prod/compare/v0.3.1...v0.4.0)
51+
52+
---
53+
54+
## [0.3.1] - 2025-12-19
55+
Fixed issue with `shower_start_merge` blocks in ICARUS configurations.
56+
57+
See [GitHub release](https://github.com/DeepLearnPhysics/spine-prod/releases/tag/v0.3.1) for details.
58+
59+
## [0.3.0] - 2025-12-17
60+
Updated all configurations to reflect SPINE v0.8.0 geometry handling changes. Created new `geo` blocks, renamed `ndlar` to `nd-lar`, restructured detector naming conventions.
61+
62+
See [GitHub release](https://github.com/DeepLearnPhysics/spine-prod/releases/tag/v0.3.0) for details.
63+
64+
## [0.2.5] - 2025-12-12
65+
Last release before geometry handling overhaul. Added lithification configurations, latest ICARUS production configs (250625), new ND-LAr configurations, and single 2x2 module support.
66+
67+
See [GitHub release](https://github.com/DeepLearnPhysics/spine-prod/releases/tag/v0.2.5) for details.
68+
69+
## [0.2.4] - 2025-09-04
70+
Updated SBND configurations: interaction clustering anchored to tracks, backtracking fixes, containment module updates, MCS resolution modeling improvements.
71+
72+
See [GitHub release](https://github.com/DeepLearnPhysics/spine-prod/releases/tag/v0.2.4) for details.
73+
74+
## [0.2.3] - 2025-08-18
75+
Updated SBND configurations: containment checks, cathode crosser handling, flash matching improvements.
76+
77+
See [GitHub release](https://github.com/DeepLearnPhysics/spine-prod/releases/tag/v0.2.3) for details.
78+
79+
## [0.2.2] - 2025-07-30
80+
Bug fixes, shower quality attributes, SBND calibration updates, CRT info integration, cathode crosser post-processor.
81+
82+
See [GitHub release](https://github.com/DeepLearnPhysics/spine-prod/releases/tag/v0.2.2) for details.
83+
84+
## [0.2.1] - 2025-03-31
85+
Additional configurations for ICARUS and SBND. Compatible with SPINE v0.2.0 through v0.3.X.
86+
87+
See [GitHub release](https://github.com/DeepLearnPhysics/spine-prod/releases/tag/v0.2.1) for details.
88+
89+
## [0.2.0] - 2025-01-17
90+
All configurations work with SPINE v0.2.X. Flash matching configurations incompatible with SPINE v0.1.3 and below.
91+
92+
See [GitHub release](https://github.com/DeepLearnPhysics/spine-prod/releases/tag/v0.2.0) for details.
93+
94+
## [0.1.0] - 2024-11-25
95+
First reference release. All configurations work with SPINE v0.1.X. Flash matching configurations incompatible with SPINE v0.2.0 and above.
96+
97+
See [GitHub release](https://github.com/DeepLearnPhysics/spine-prod/releases/tag/v0.1.0) for details.

0 commit comments

Comments
 (0)