rgfrosh (Real Gas FROzen SHock)

This project is a solver for the frozen shock equations¹ developed in Python at the University of Central Florida. The original RGFROSH was developed in FORTRAN at Stanford University by D. F. Davidson and R. K. Hanson using real gas subroutines for CHEMKIN²³.

rgfrosh is a package for calculating conditions behind incident and reflected shock in a shock tube. As its name suggests, rgfrosh was written primarily for solving the frozen shock equations for a real gas equation of state; however, the implementation also allows for the use of the ideal gas equation of state or even custom equations of state. Additionally, an implementation of the ideal shock equations is also available for comparison.

Documentation

The documentation site provides a detailed user guide and reference for the package.

Installation

rgfrosh can be installed using

pip install rgfrosh

which also installs required dependencies. Cantera or CoolProp are optional and must be installed separately if desired.

Contributing

For any bugs or feature requests, create an issue on the issue tracker.

After cloning the repository, the development environment can be set up with

pip install -r requirements.txt

Before creating a pull request, be sure to lint

black .

and run the automated tests

pytest

These checks will be performed automatically for all pull requests along with test coverage comparisons.

Cite

To cite rgfrosh click Cite this repositoryon the right side of the GitHub repository page to export the citation for the latest release of rgfrosh. It is also encouraged to cite the original paper¹ for the frozen shock equations that this work is a derived from.

Footnotes

1. Davidson, D.F. and Hanson, R.K. (1996), Real Gas Corrections in Shock Tube Studies at High Pressures. Isr. J. Chem., 36: 321-326. https://doi.org/10.1002/ijch.199600044 ↩ ↩²

2. P. Barry Butler, "Real Gas Equations of State for Chemkin" Sandia Report No. SAND88-3188 (1988). https://doi.org/10.2172/6224858 ↩

3. R. G. Schmitt, P. B. Butler, N. B. French "Chemkin real gas: a Fortran package for analaysis of thermodynamic properties and chemical kinetics in non-ideal systems," U. of Iowa Report UIME PPB 93-006 (1994). ↩