--- 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