Skip to content

chromo 0.9.0

Choose a tag to compare

@jncots jncots released this 29 Jul 07:51
· 11 commits to main since this release

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 chromo

Development 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

πŸ“ 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