File size: 2,920 Bytes
6a9ab74
6987155
 
 
 
6a9ab74
6987155
6a9ab74
6987155
6a9ab74
 
6987155
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
---
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