Repository navigation
HERA
HERA is a MATLAB based scientific ranking framework for paired benchmarking. It provides a hierarchical-compensatory logic that integrates effect-size statistics, and automated reporting capabilities.
For more information please refer to the Readme and Project Documentation.
What's New in v1.4.10?
⚙️ Enhancements
- Python 3.13+ Compatibility (Stable ABI) & Batch Ergonomics: Relaxed PyPI
python_requiresto>=3.9so Python 3.13+ users can install and runhera-matlabusing MATLAB Runtime's Stable ABI (abi3) while receiving Runtime's compatibilityUserWarning(Python 3.9–3.12 remain officially validated). Suppressed blocking interactive console pauses in batch mode and added bootstrap configuration fallbacks. - CSV Delimiter & Simulation Reporting Consistency: Standardized remaining convergence and output CSV tables to comma delimiters across
+HERA/+analysis/+convergence/and+HERA/+output/, refactoreddata/utils/simulation/reporting.pyand plotting helpers, updated benchmark summary reports/plots for consistency, and updated example outputs and header descriptions.
📚 Documentation & Usability
- Python Integration, Parameters & Docstrings: Updated Python Integration, Automated Build, and Configuration & Parameters guides, aligned
get_version.mand deployment helper comments, and removed the deprecatedpolyfill.ioscript from MkDocs configuration.
🐛 Bug Fixes
- PyPI Package Initialization (
hera_matlab.initialize()): Fixed.github/scripts/prepare_pypi.pycalling the non-existent_pir.get_matlab_instance()method (replaced with_pir.initialize_package()and removed unreachable code afterreturn), restoring standalone PyPI usage without local MATLAB fallbacks. run_rankingPython Return Marshaling: Added recursive cell-array sanitization indeploy/wrappers/run_ranking.mso 2D cell tables insideresults.swap_detailsconvert cleanly to nested1 x Ncells instead of raisingValueError: cell arrays returned from MATLAB must be 1-by-N or M-by-1duringhera.run_ranking(config, nargout=1).- Numerical Precision, Workflow Paths & Build Automation: Added
1e-12floating-point tolerance to zero checks inrelative_difference.mandcalculate_thresholds.m, correctedREPO_ROOTanddeploy/output/matlabdiscovery indata/utils/run_workflow.py, madeeval_rank_stability.pysymlink-safe, fixedbuild_hera_python()invocation in.github/workflows/build_release.yml, and madedeploy/build_HERA_matlab.marchitecture checks dynamic viacomputer('arch').
Recent Major Features (from v1.4.0)
✨ Convergence Analysis Enhancements:
- New Scenario: Added a "Sensitivity" scenario with small effect sizes.
- JSON Configuration: All scenarios are fully customizable through a JSON configuration file.
(For a full history of previous features and changes, see the Changelog)
🖥️ Platform Support
- MATLAB Toolbox & Python Package: Windows, macOS (Intel & Apple Silicon), Linux. Execution instructions: MATLAB Toolbox (Overview) | Python Package
- Standalone Runtime Application: macOS (Apple Silicon ONLY). Execution instructions: Standalone App
📦 Compatibility
- MATLAB: Compatible with R2020a and newer.
- Python: Compatible with Python 3.9 through 3.12 (officially supported; Python 3.13+ supported via Stable ABI with a runtime compatibility warning) and MATLAB Runtime R2025b (25.2).
Full Changelog: v1.4.9...v1.4.10