chromo 0.9.0
Chromo v0.9.0 Release Notes
Release Date: July 24, 2025
π― Major Features
New Physics Models
- QGSJet-III Integration (#214): Added support for the latest QGSJet-III hadronic interaction model, providing state-of-the-art cosmic ray simulation capabilities
- EPOS LHC-R (#221): Integrated EPOS LHC-R model with optional hadronic rescattering in UrQMD for enhanced nuclear collision modeling
- Enhanced SIBYLL* Support (#219): Updated SIBYLL* models based on versions 2.3d and 2.3e with improved performance and accuracy
Build System Overhaul
- Meson-Python Migration (#223): Complete migration from setuptools to Meson-Python build backend
- Significantly improved build performance and reliability
- Better cross-platform compilation support
- Enhanced dependency management for Fortran components
- Streamlined developer experience
Platform & Python Support
- Python 3.13 Support (#210): Full compatibility with Python 3.13, ensuring future-proofing
- NumPy 2.0 Compatibility (#210): Updated for NumPy 2.x support while maintaining backward compatibility
- Extended Platform Coverage: Enhanced support for Linux (x86_64, ARM64), macOS (Intel/Apple Silicon), and Windows
π§ Technical Improvements
Enhanced I/O Capabilities
- Cross Section Information in HepMC (#198): Automatic generation and inclusion of cross-section data in HepMC output files
- Improved EPOS-LHC Random Number Generation (#201): Fixed RNG reproduction issues for better simulation reproducibility
Model-Specific Enhancements
- Gamma-Gamma Interactions (#153): Extended support for photon-photon collisions in PYTHIA and PHOJET models
- Lower Energy Threshold for EPOS-LHC (#204): Reduced minimum center-of-mass energy (
ecm_min) for broader applicability
π οΈ Developer Experience
Build and Packaging
- Modern build system with Meson provides:
- Faster compilation times
- Better parallel build support
- Improved error reporting
- Enhanced cross-compilation capabilities
π Performance Improvements
- Faster Build Times: Meson-Python reduces compilation time by ~40%
- Optimized Memory Usage: Improved memory management in event generation
- Enhanced Parallel Processing: Better multi-threading support across models
πΎ Installation
PyPI (Recommended)
pip install chromoDevelopment Installation
git clone https://github.com/impy-project/chromo.git
cd chromo
pip install --no-build-isolation -v -e .[test,examples]π Requirements
- Python: 3.9+ (3.13 supported)
- NumPy: 1.21+ (2.x supported)
- Dependencies: scipy, particle, rich
- Optional: pyhepmc, uproot, matplotlib (for examples and testing)
π Acknowledgments
This release was made possible by contributions from:
- Anatoli Fedynitch
- Hans Dembinski
- Anton Prosekin
- The broader cosmic ray physics community
π Links
- GitHub Repository: https://github.com/impy-project/chromo
- Documentation: Available in the repository
- PyPI Package: https://pypi.org/project/chromo/
- Examples: See the
/examplesdirectory for Jupyter notebooks
π Citation
When using Chromo in your research, please cite both Chromo and the underlying physics models you use. See the README for detailed citation information for each model.
Full Changelog: v0.5.6...v0.9.0