Two interactive 3D visualizations are designed to contrast key principles in fluid dynamics, offering distinct operational modes to highlight the difference between flow circulation and local spin. The simulation demonstrates that a complex appearance of rotation does not always equate to fluid vorticity: the Rigid-Body Rotation is fundamentally rotational ( $\omega \neq 0$ ), possessing constant, uniform vorticity, whereas the Irrotational Vortex is defined by zero vorticity ( $\omega=0$ ), where particles orbit but do not spin internally. Functionally, the tool offers modes that contrast volume conservation, such as Divergence-Free (swirling, constant volume) versus Divergent (spreading, volume increasing), all while enabling analytical evaluation through Real-Time Momentum Tracking of $x, y$, and $z$ components. User control is streamlined via a Toggle Mode Button and Reset Simulation Button, complemented by Dynamic Descriptions that instantly explain the physics of the current flow state.

🎬

https://youtu.be/FZF0GBMBwMY


This fluid model (two demos) illustrates the fascinating distinction between local kinematics and global dynamics: while the first demo reveals a state of "Rigid-Body Rotation"-where every fluid parcel spins with an identical, constant vertical vorticity-the second demo demonstrates how spatial orientation dictates "Orbital Momentum." Because the cubic volume is positioned off-center relative to the rotation axis, its angular momentum is not merely a reflection of internal spin ( $L_3$ ), but also a result of the massive lever arms that create "tilting" components ( $L_1, L_2$ ) as the fluid translates upward. Together, these demos prove that even a uniform, divergence-free flow can exhibit complex, asymmetric global properties simply based on where in space the observation "cube" is placed.

🎬The Helical-Orbital Synthesis

https://youtu.be/ufHGktRCghA


🪜State Diagram: Kinematic Transitions: From Local Vorticity to Global Angular Momentum

The state diagram illustrates the progression from theoretical fluid kinematic problems to interactive visualizations, moving from local fluid properties (vorticity) to global geometric behaviors (angular momentum).

stateDiagram-v2
    [*] -->Demo_1: Initial Visualisation
    note right of Demo_1
        Visualize particle movement 
        & real-time momentum
    end note

    Demo_1 --> Example_1: Local Rotation Analysis
    state Example_1 {
        Vorticity_Math: ω = ∇ × v
        Result: Constant Vertical Spin
    }

    Example_1 --> Demo_2_3: Comparative Dynamics
    note right of Demo_2_3
        Contrast Rotational (Rigid-Body) 
        vs. Irrotational motion
    end note

    Demo_2_3 --> Example_2: Global Geometric Analysis
    state Example_2 {
        Angular_Momentum: L = r × (ρv)
        Result: Tilted Vector ($$L_1, L_2, L_3$$)
    }

    Example_2 --> Demo_4: Lever Arm Visualisation
    note right of Demo_4
        Show why $$\ L_3\ $$ is dominant 
        and why 'tilt' occurs off-center
    end note

    Demo_4 --> Reference_Sheet: Synthesis
    note right of Reference_Sheet
        Comparison of Local (ω) 
        vs. Global (L) behavior
    end note

    Reference_Sheet --> [*]

⚖️Quadrant 1: Momentum in Cubic Domains (P26 Demos)

---
config:
  quadrantChart:
    chartWidth: 800
    chartHeight: 700
  themeVariables:
    quadrant1Fill: "#541c5e"
    quadrant2Fill: "#541c5e"
    quadrant3Fill: "#541c5e"
    quadrant4Fill: "#541c5e"
    quadrantInternalBorderStrokeFill: "#000"
    quadrantExternalBorderStrokeFill: "#192a24"
---
quadrantChart
    title Momentum in Cubic Domains (P26 Demos)
    x-axis "Structural Principles" --> "Kinetic Actions"
    y-axis "Foundational/Static" --> "Complex/Systemic"
    quadrant-1 "Complex Dynamic Simulations"
    quadrant-2 "Targeted Kinetic Demos"
    quadrant-3 "Foundational Geometric Rules"
    quadrant-4 "Relational Geometry"

    "Rhombus Diagonals (P5 Demos)": [0.15, 0.20]
    "Cube Diagonal Constancy (P6 Demos)": [0.35, 0.15]
    "Skew Line Distance (P8 Demos)": [0.45, 0.45]
    "Precessing Vectors (P10 Demos)": [0.65, 0.35]
    "Helical Motion (P9 Demos)": [0.70, 0.40]
    "Conservative Work (P21 Demos)": [0.85, 0.75]
    "Rigid Body Kinematics (P20 Demos)": [0.90, 0.85]
    "Momentum in Cubic Domains (P26 Demos)":::col: [0.75, 0.95]

classDef col color: #7f2e8d, radius : 20, stroke-color: #d091db, stroke-width: 10px