Recent Releases of bihc

bihc - BIHC v0.1.0

BIHC v0.1.0

First official release! πŸŽ‰

πŸš€ Features

  • ⚑ Beam-Induced Heating Computation

    • Compute the power loss from impedance spectra and beam characteristics.
    • Use the built-in CERN accelerator parameters: LHC, SPS, SPS-SFTPRO (new!) & PS
    • Accept impedance input from ASCII files, NumPy arrays & XWakes (former PyWIT) models (new!)
    • Power loss calculations using both analytical and numerical spectra:
      • Create analytical spectra from Gaussian, binomial, parabolic, q-Gaussian or Cosine squared.
      • Supports bunch-by-bunch profiles and bunch length variation (new!)
  • πŸ› οΈ Filling Schemes

    • Built-in templates for LHC, SPS (standard, 8b4e), and SFTPRO (new!).
    • Option to define custom or case-specific schemes, including Timber-based retrieval for SWAN/NXCALS use.
    • Supports LPC format for historic CERN beam configurations.
    • Support for bunch-by-bunch intensity from FBCT measurements using datascout acc-py package
  • πŸ“ˆ Visualization & Examples

    • Rich plotting utilities for:
    • Power loss maps - New example combining CST - IDDEFIX and BIHC by @Jishnnn
    • Bunch profiles and spectrum comparisons
    • Statistical analysis of power loss: rigid shift of impedance spectrum or mode by mode analysis.
    • Jupyter notebooks included for:
    • SPS/LHC power loss studies for different devices
    • Comparison of analytical vs numerical spectrum generation for different bunch shapes.
    • Timber-based fill reconstruction and analysis
    • Fully documented usage examples available in /examples.

πŸ“š Documentation

  • πŸ“– Physics guide included
    • Explains power loss computations, spectrum generation, and impedance usage.
  • πŸ› οΈ Installation instructions for SWAN, Miniforge, and local environments.
  • πŸ§ͺ Example notebooks for CERN beams: SPS, LHC, SFTPRO.
  • 🧡 Integration with neffint, iddefix, and wakis.

πŸ› Bugfixes and Enhancements since v0.0.X

  • Fixed impedance length mismatch edge cases.
  • Minor bug fixes for label formatting and plot compatibility.
  • Improved support for running in SWAN and LXPLUS environments.

πŸ” CI/CD and Build

  • Added setup.py, _version.py, and release metadata.
  • Defined first official version tag v0.1.0 with packaging support.
  • Compatible with ReadTheDocs and standard Python packaging.
  • Examples structured for reproducibility and testing.

πŸ‘₯ Contributors


🧊 BIHC is part of the ImpedanCEI ecosystem β€” a growing suite of open tools for impedance evaluation and beam-coupling studies.

- Python
Published by elenafuengar 10 months ago