sandialabs / hyram

GNU General Public License v3.0
40 stars 17 forks source link
scr-1703 snl-applications

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