Skip to content

flash631/rutherford-epsim

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Rutherford-EPSim (Electric Pump System Simulator)

A software-only, open-source simulator of an electric-pump-fed LOX/RP-1 engine with a lightweight battery model and an MGU‑K style power-regeneration loop inspired by your Rutherford-engine modification concept. It is aimed at quick 0‑D trade studies, education, and design-space exploration.

Features (MVP)

  • 0‑D thrust/mass-flow model with throttle and simple atmosphere toggle (sea level vs. vacuum)
  • Electric pump power model (per-propellant hydraulic power + motor/controller efficiencies)
  • Battery energy & power limits with regen input (preburner/turbine → motor‑generator)
  • Power‑limited throttling (automatically scales throttle if battery can’t meet demand)
  • Simple RK4 integrator written from scratch (no SciPy dependency)
  • Plots for thrust, battery SOC, and power flows

Roadmap (stretch)

  • Config loader (YAML/JSON), CLI scenarios and batch sweeps
  • Optimizer hooks for sizing battery mass vs. burn time, regen fraction, and Pc
  • Basic ML surrogate (fit a small regressor to predict pump power and feasible throttle)
  • Streamlit dashboard for interactive sliders

Quick start

python -m rutherford_epsim.simulate --duration 120 --dt 0.05 --env vacuum --plot

This will save a PNG in the working directory and print summary statistics.

Model summary

  • Total mass flow: (\dot m = F/(I_{sp} g_0))
  • Split by mixture ratio (\mathrm{MR}=\frac{\dot m_{ox}}{\dot m_{f}})
  • Pump hydraulic power per leg: (P_{h,i}=\frac{\dot m_i}{\rho_i} \Delta P_i)
  • Electric draw: (P_{elec}=\sum_i \frac{P_{h,i}}{\eta_{pump,i}\eta_{motor}\eta_{controller}})
  • Regen approximation: (P_{regen}=k_{regen}, \dot m_f,LHV,\eta_{regen})
  • Battery: (\dot E_{batt}=-(P_{elec}-P_{regen}-P_{aux})) with power limit (P_{batt,max}) and energy limit

Note: These are deliberately simplified 0‑D relations to keep the simulator lightweight.

License

MIT

About

No description, website, or topics provided.

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages