How team-tsa/gribs works
GRIBS is a JSON-configured transient solid-rocket internal-ballistics simulator. Users provide motor and thermochemistry inputs, select a backend, and run the simulation to obtain time-history results and reports. Its domain workflow covers propellant properties, thermochemistry, grain regression, chamber/nozzle behavior, and post-burnout blowdown; reporting includes plots and provenance. The runtime is implemented in one Python file. README statements support the documented capabilities and workflow; source excerpts are partial, so finer call relationships are not asserted.
Main entry points: GRIBS_v0.4.3-alpha.py Unsteady chamber · gribs_config.json JSON configuration
Components 21
Inputs and setup
- JSON configuration
gribs_config.json - Config validation
GRIBS_v0.4.3-alpha.py - Mixture density
GRIBS_v0.4.3-alpha.py
Thermochemistry
- Backend selection
GRIBS_v0.4.3-alpha.py - CEA Python backend
GRIBS_v0.4.3-alpha.py - Legacy CEA backend
GRIBS_v0.4.3-alpha.py - NASA CEA package
- fcea2 executable
- Chamber properties
GRIBS_v0.4.3-alpha.py - Thermo cache
GRIBS_v0.4.3-alpha.py
Ballistics simulation
- Numerical self-tests
GRIBS_v0.4.3-alpha.py - Grain regression
GRIBS_v0.4.3-alpha.py - Burn-rate model
GRIBS_v0.4.3-alpha.py - Unsteady chamber
GRIBS_v0.4.3-alpha.py - Nozzle flow
GRIBS_v0.4.3-alpha.py - Erosive and throat erosion
GRIBS_v0.4.3-alpha.py - Post-burnout blowdown
GRIBS_v0.4.3-alpha.py
Results and diagnostics
- CEA performance diagnostics
GRIBS_v0.4.3-alpha.py - Plots and data outputs
GRIBS_v0.4.3-alpha.py - Run provenance
GRIBS_v0.4.3-alpha.py
Other components
- Motor analyst
Connections 25
- Motor analyst → JSON configuration: edits
README.md - Motor analyst → Config validation: validates
README.md - JSON configuration → Config validation: validates
README.md - Motor analyst → Backend selection: selects backend
README.md - JSON configuration → Backend selection: configures
README.md - Backend selection → CEA Python backend: selects
README.md - Backend selection → Legacy CEA backend: selects
README.md - CEA Python backend → NASA CEA package: uses API
README.md - Legacy CEA backend → fcea2 executable: runs
README.md - CEA Python backend → Chamber properties: calculates properties
GRIBS_v0.4.3-alpha.py - Legacy CEA backend → Chamber properties: provides properties
GRIBS_v0.4.3-alpha.py - Chamber properties → Thermo cache: caches table
GRIBS_v0.4.3-alpha.py - Config validation → Mixture density: validates inputs
GRIBS_v0.4.3-alpha.py - Mixture density → Unsteady chamber: sets propellant density
GRIBS_v0.4.3-alpha.py - Motor analyst → Numerical self-tests: runs checks
README.md - Motor analyst → Unsteady chamber: runs simulation
README.md - Unsteady chamber → Grain regression: models grain
README.md - Unsteady chamber → Burn-rate model: models burning
README.md - Unsteady chamber → Nozzle flow: models flow
README.md - Unsteady chamber → Erosive and throat erosion: includes erosion
README.md - Unsteady chamber → Post-burnout blowdown: models blowdown
README.md - Motor analyst → CEA performance diagnostics: enables diagnostics
README.md - Unsteady chamber → CEA performance diagnostics: compares performance
README.md - Unsteady chamber → Plots and data outputs: produces results
README.md - Unsteady chamber → Run provenance: records provenance
README.md