Hybrid-handler CHANGELOG

All notable changes to this project will be documented in this changelog. This project does not strictly adhere to Semantic Versioning, but it uses versioning inspired by it. In particular, not all backward incompatible changes lead to a bump in the major version number, but all of these are mentioned and emphasized here. Given a version number X.Y.Z,

• X is incremented for major changes in particular relevant new functionality,
• Y is incremented for minor changes or new minor functionality, and
• Z is mainly used for bug fixes.

Symbols

Every entry in this file is prepended with a symbol that is meant to draw attention about the type of change. Click on a symbol above for more information about it.

This symbol indicates new features.

This symbol indicates changes in existing functionality.

This symbol indicates fixes of wrong behavior.

This symbol indicates removed features.

This symbol indicates breaking changes, i.e. not backward-compatible changes.

This symbol indicates deprecated features, which are likely to be removed in later versions.

This symbol indicates changes that deserve particular attention by the user.

Hybrid-handler-2.2

    Release date: 2026-05-19     Compare changes to previous version

Changes:

  The name of the framework is changed from SMASH-vHLLE-hybrid to Hybrid-handler. Since the handler is a tool to facilitate running hybrid simulations and the underlying stage modules can be varied, this generic name is more precise. Nevertheless, the SMASH-vHLLE-hybrid approach is still part of this framework.

  Added Add_corona_from_IC_and_Hydro configuration key in the Afterburner module, which merges the files containing corona particles from IC and Hydro into the particle lists sampled in Sampler.

  Added new valid config key hydro_coordinate_system for SMASH sampler 3.3 to handle hydrodynamic simulations in Cartesian coordinates properly, additional to the runs in tau-eta frame.

  Added new valid config keys compute_spin_vector, and create_vorticity_vector_output for SMASH sampler 3.3 to enable spin vector calculation all sampled particles.

  The Input_file configuration key in the Hydro and Afterburner modules can now be used to modify the expected file names from the appropriate IC and Sampler sub-folders, when a string without a / character is given.

  The parameters extracted by the Bayesian analysis in Phys. Rev. C 112, 014910 are now set as default for the base configs. The old parameters for the hydro evolution were kept in configs/predef_configs/vhlle_hydro_EPJA_58-11-230, and the other parameters are adjusted by each handler configuration file in *** predef_configs***.

  Added configuration files for a dynamic fluidization run in configs/predef_configs/dynamic_fluidization. This requires the specific branch merge-review in vHLLE.

SMASH-vHLLE-hybrid-2.1.3

    Release date: 2025-06-05     Compare changes to previous version

  Fix Hybrid-handler crash due to accessing an unbound variable when trying to run both the Sampler and the Afterburner stages using the FIST sampler.

SMASH-vHLLE-hybrid-2.1.2

    Release date: 2025-05-16     Compare changes to previous version

  The previous hot-fix introduced a subtle bug, making the Hybrid-handler ignore a user-customized base configuration file for the IC stage. This is fixed now.

SMASH-vHLLE-hybrid-2.1.1

    Release date: 2025-05-15     Compare changes to previous version

  Make the handler select the correct default base configuration file for the IC stage depending on the SMASH version. This was needed because SMASH-3.2 changed some configuration keys about initial conditions setup.

  Fix how spectators are added from the IC output into the Afterburner input file. This now works for all SMASH versions. The spectators from the target were not properly considered beforehand. Additionally, the adding of spectators is currently only allowed if only one IC event was run.

  Renamed the copied/linked afterburner inputfile containing the sampled particles (and possibly spectators) from sampled_particles_list.oscar to :material_file: sampled_particles.oscar. Note that this is not a breaking change because this file is created into the Afterburner folder at the beginning of such a stage.

SMASH-vHLLE-hybrid-2.1

    Release date: 2025-03-31     Compare changes to previous version

  Make the handler select the correct default base configuration file for the Sampler stage depending on the SMASH hadron sampler version. This was needed because SMASH-hadron-sampler-3.2 refactored the user interface.

  Support for a new sampler module: FIST sampler is now usable additionally to the SMASH hadron sampler.

  The project logo was changed to a fancier, more fantasy version.

SMASH-vHLLE-hybrid-2.0

  Release date: 2024-04-12     Compare changes to previous version

  The project approach has totally changed and it switched from a CMake based framework to a Bash based framework. A detailed documentation web-page has been built to guide both users and developers.

SMASH-vHLLE-hybrid-1.0

  Release date: 2020-11-18     First public version of the SMASH-vHLLE-hybrid