Spaces:
Running
Download README.md from AK51/Vortex_Ring_Collusion: direct link, hf CLI and curl.
- Browser
- Download file 2.92 kB
-
https://huggingface.co/spaces/AK51/Vortex_Ring_Collusion/resolve/main/README.md
- Command line
-
hf download hf://spaces/AK51/Vortex_Ring_Collusion/README.md
-
curl -L -o README.md https://huggingface.co/spaces/AK51/Vortex_Ring_Collusion/resolve/main/README.md
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 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 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:
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)
- 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
Created by Andy Kong