Hydrogen Plus Other Alternative Fuels Risk Assessment Models (HyRAM+)

The Hydrogen Plus Other Alternative Fuels Risk Assessment Models (HyRAM+) toolkit integrates deterministic and probabilistic models for quantifying accident scenarios, predicting physical effects, and characterizing the impact on people from hydrogen and other alternative fuels.

Additional descriptions and documentation, as well as a Windows installer, can be found at https://hyram.sandia.gov/.

Copyright and License

The copyright language is available in the COPYRIGHT.txt file. The license, as well as terms and conditions, are available in the COPYING.txt file.

Contributing

The application comprises a frontend GUI written in C# and a backend module written in Python. Anyone who wants to contribute to the development of the open-source HyRAM+ project should refer to the details in the CONTRIBUTING document.

Documentation

The HyRAM+ Technical Reference Manual contains descriptions of the models and calculations used within HyRAM+. It also contains references to the original works that these models and calculations are based on.

The HyRAM 2.0 User Guide contains details and examples on how to use the HyRAM+ software through the graphical user interface (GUI), with example calculations updated with changes to the interface and improved calculation options. This document more references how to use the software interface, rather than specifics on the models and calculations themselves. While there have been many changes to the current HyRAM+ version of the code, many of the examples are still applicable even though the User Guide is based on the previous version; a new version of the User Guide will be published in the future.

Repository Layout

The HyRAM+ repository includes both the C# frontend GUI and the backend Python module. Source code is organized in directories in the git repository in the following directory structure:

├───src
|   ├───gui
|   ├───cs_api
|   └───hyram
|       ├───phys
|       ├───qra
|       └───utilities
└───tests
    ├───cs_api
    └───hyram
        ├───phys
        ├───qra
        └───validation

• src - Project source code, including C# GUI and python modules
• src/gui - Front-end C# interface providing convenient access to HyRAM+ tools
• src/cs_api - Python functions providing C# access to HyRAM+ python code via the python.NET library
• src/hyram - Python package of HyRAM+ tools including physics, quantitative risk assessment, and miscellaneous utilities
  • Additional information on the usage and development of the HyRAM+ Python module can be found in the README of that directory
• tests - Tests of the project source code to verify calculations and functionality
• tests/cs_api - Tests for the Python functions providing C# access to HyRAM+ Python package via the python.NET library
• tests/hyram - Tests for the HyRAM+ Python package including physics, risk assessment, and physics validation