AK51's picture
Upload 2 files
6987155 verified
|
Raw History Blame Contribute Delete
2.92 kB
---
title: Rocket Propellant Vortex-Ring Mixing
emoji: 🚀
colorFrom: blue
colorTo: red
sdk: static
app_file: index.html
pinned: false
license: mit
---
# Rocket Propellant Vortex-Ring Mixing
An interactive 3D visualisation of the head-on collision of two vortex rings,
framed as the mixing of two rocket-propellant streams. Built with
[Three.js](https://threejs.org/) and rendered entirely in the browser with a
GPU particle cloud.
Two coaxial rings — one per propellant — are fired toward each other. As they
meet they interpenetrate, the dye intermixes, and the merged structure blooms
outward into a larger, lobed ring, reproducing the qualitative behaviour of the
classic Lim & Nickels (1992) experiment and the
[Basilisk two_rings.c](https://basilisk.fr/sandbox/Antoonvh/two_rings.c)
reference simulation.
## Running it
This is a static web app — no build step. Open `index.html` in any browser with
WebGL support, or serve the folder:
```bash
python -m http.server 8000
# then open http://localhost:8000
```
On Hugging Face Spaces it runs as a **Static** Space: the `index.html` at the
repository root is served directly.
## Controls
- **Drag** to orbit, **scroll** to zoom.
- **↺ Restart**, **⏸ Pause**, camera presets, **⚙ Parameters**, **ⓘ About**.
### Parameters
Properties of a propellant jet are set **independently per stream** (Left /
Right); properties of the shared domain or numerics are **system-wide**.
| Per-stream (L / R) | System-wide |
|---|---|
| Propellant (colour, density, viscosity) | Reynolds number (Re) |
| Jet strength (circulation Γ) | Viscosity (dye diffusion) |
| Ring radius R | Dye particle count |
| Launch distance | Particle size |
| Vertical offset | Playback speed (dt) |
| Core thickness ε | |
| Instability lobes (wavenumber) | |
Seven real propellants are available (LOX, LH₂, CH₄, RP-1, N₂O₄, UDMH, LN₂),
each with authentic density and viscosity that drive stream momentum and dye
diffusion. A denser propellant carries more momentum and pushes the collision
point toward the lighter stream.
## Method
Each ring is a loop of discrete vortex elements. Both the dye particles and the
vortex elements move in the summed Biot–Savart velocity field of every element,
so self-propulsion, collision and radial expansion all emerge from the physics
rather than being scripted. This is a lightweight qualitative model, **not** a
full Navier–Stokes combustion solver — there is no heat release or chemistry.
## References
- [Basilisk — Collision of two vortex rings (Antoon van Hooft)](https://basilisk.fr/sandbox/Antoonvh/two_rings.c)
- [dgreenheck / threejs-particle-fluids](https://github.com/dgreenheck/threejs-particle-fluids)
- Lim, T.T. & Nickels, T.B. (1992). Instability and reconnection in the head-on collision of two vortex rings. *Nature*, 357, 225–227.
- [Three.js](https://threejs.org/)
---
Created by Andy Kong