RustPEP documentation
Command-line runner
The propep command-line tool that shares RustPEP's calculation engine.
The RustPEP project includes propep, a command-line runner built on the same solver and data as the desktop application.
The 0.1.0 download packages contain the desktop application only. How the command-line runner will be distributed has not been finalized, so treat this page as a reference for the tool rather than something you can install today.
Finding an ingredient
Ingredients are referred to by their code number. find searches by name:
propep find "ammonium perchlorate"
137 AMMONIUM PERCHLORATE (AP) dHf -602 cal/g rho 1.949 g/cc Oxidizer
Running a recipe
Give each ingredient as code=grams:
propep run --pc 1000 137=68 845=20 63=12
| Option | Meaning | Default |
|---|---|---|
--db legacy|cea |
Product database | cea |
--pc <psi> |
Chamber pressure | 1000 |
--pe <psi> |
Exit pressure | 14.7 |
--ions |
Include ionized species | off |
--legacy-compat |
Legacy atomic weights and enthalpy basis | off |
--json |
Print the result as JSON instead of the text report | off |
--nozzle |
Also print the expansion-ratio table | off |
Sample output
The text report follows the layout of the original PEP program. This is the output for the command above, with the chamber and exhaust species tables left out:
CODE WEIGHT D-H DENS COMPOSITION
137 AMMONIUM PERCHLORATE (AP) 68.000 -602 0.07040 1CL 4H 1N 4O
845 R45 HTPB (UTC) 20.000 5 0.03360 981H 654C 6O
63 ALUMINUM (PURE CRYSTALINE) 12.000 0 0.09760 1AL
THE PROPELLANT DENSITY IS 0.05938 LB/CU-IN OR 1.6436 GM/CC
THE TOTAL PROPELLANT WEIGHT IS 100.0000 GRAMS
****************************CHAMBER RESULTS FOLLOW*****************************
T(K) T(F) P(ATM) P(PSI) ENTHALPY ENTROPY CP/CV GAS RT/V
2749 4488 68.02 1000.00 -40.84 241.97 1.2211 4.310 15.782
****************************EXHAUST RESULTS FOLLOW*****************************
T(K) T(F) P(ATM) P(PSI) ENTHALPY ENTROPY CP/CV GAS RT/V
1326 1927 1.00 14.70 -113.10 241.97 1.2583 4.296 0.233
**********PERFORMANCE: FROZEN ON FIRST LINE, SHIFTING ON SECOND LINE**********
IMPULSE IS EX T* P* C* ISP* OPT-EX D-ISP A*M EX-T
248.8 1.2204 2473 38.08 4987.5 8.43 408.8 0.15505 1283
250.8 1.2023 2506 38.41 5022.7 193.3 8.56 412.2 0.15615 1326
238 product species considered (cea database)
These are ideal thermochemical predictions for an example recipe, not measured results.