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

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages