Spaces:
Running
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
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 | |