×How to Interpret this Dashboard
1. What is this Simulator?
This simulator provides a **conceptual visualization** of **2D incompressible fluid dynamics**. It numerically solves a simplified version of the Navier-Stokes equations, which are fundamental to describing how fluids like air and water move in a 2D plane. The goal is to help you build an intuition for complex fluid phenomena like turbulence, vortex dynamics, and energy dissipation.
CRITICAL NOTE FOR RESEARCHERS: This tool is for educational and conceptual purposes only. It uses a simplified numerical scheme and is **NOT** a high-fidelity Computational Fluid Dynamics (CFD) tool. It **cannot be used to formally prove or disprove mathematical conjectures** about the Navier-Stokes equations. That is a question of pure mathematics concerning the properties of the continuous equations, not numerical approximations.
2. The Physics & The Math
The Governing Equations
The core of the simulation is the Navier-Stokes momentum equation for an incompressible fluid in 2D:
$ \frac{\partial \mathbf{u}}{\partial t} + (\mathbf{u} \cdot \nabla)\mathbf{u} = -\nabla p + \nu \nabla^2 \mathbf{u} $
- $ \mathbf{u}(x,y,t) $ is the 2D fluid velocity vector $(u,v)$.
- $ (\mathbf{u} \cdot \nabla)\mathbf{u} $ (Advection): How the fluid carries itself. This non-linear term is the source of most of the complexity, including turbulence.
- $ -\nabla p $ (Pressure Gradient): How differences in pressure ($p$) create forces that push the fluid.
- $ \nu \nabla^2 \mathbf{u} $ (Viscous Diffusion): Represents fluid friction, where $\nu$ is the kinematic viscosity.
This is coupled with the incompressibility condition, which states that the flow is divergence-free:
$ \nabla \cdot \mathbf{u} = 0 $
Key 2D Concepts
- Vorticity ($\omega_z$): In 2D, vorticity is a scalar value representing the local "spin" of a fluid parcel, defined as $ \omega_z = \frac{\partial v}{\partial x} - \frac{\partial u}{\partial y} $. It is a crucial quantity in 2D flows.
- Enstrophy ($\mathcal{E}$): The integral of squared vorticity, $ \mathcal{E} = \frac{1}{2} \int \omega_z^2 dA $. In 2D turbulence, there is a cascade of enstrophy from large to small scales, where it is dissipated by viscosity.
- Inverse Energy Cascade: A unique feature of 2D turbulence where kinetic energy tends to move from small scales to larger scales, leading to the formation of large, coherent vortices. This is opposite to 3D turbulence.
3. How to Analyze the Plots & Data
The Kinetic Energy Spectrum
This log-log plot is a key tool for turbulence analysis. It shows how the fluid's kinetic energy $E$ is distributed across different length scales (wavenumber $k$; small $k$ = large scales, large $k$ = small scales). Look for:
- Inverse Energy Cascade Range: At low $k$, you might see a slope of $E(k) \propto k^{-5/3}$, indicating energy flowing to larger structures.
- Enstrophy Cascade Range: At high $k$, you might see a steeper slope of $E(k) \propto k^{-3}$, indicating enstrophy flowing to smaller, dissipative scales. The dashboard plots a $k^{-3}$ reference line.
Vector & Scalar Field Plots
This tab provides a powerful, interactive tool to inspect scalar fields like vorticity and divergence at a granular level. It features two synchronized views: a graphical canvas on the left and a numerical grid on the right.
- Interactive Hovering: Move your cursor over either the graphical canvas or the numerical grid. The corresponding cell in the other view will be highlighted, and the precise value at that point will be displayed live.
- Single-Point Detailed Analysis: Click on any cell in either the canvas or the grid. This will open a modal window showing a detailed mathematical breakdown for that specific point, including the calculated gradients used to compute the field value (e.g., $\partial v/\partial x$ and $\partial u/\partial y$ for vorticity).
- Multi-Pixel Analysis: For aggregate statistics over a custom region:
- Check the "Enable Multi-Pixel Analysis" box.
- Single-click on multiple cells in the grid to select them. Selected points will be marked with a dot.
- Once you have selected your points, double-click anywhere on the grid. A tooltip will appear showing the count, mean, standard deviation, min, and max of the values for your selected points.
4. Acquiring a Gemini API Key
To enable the AI-powered interpretation features, you need a Gemini API key from Google AI Studio.
- Visit https://aistudio.google.com/
- Sign in and click "Get API key" to create and copy your key.
- Paste it into the input box in the "Simulation Metrics" panel.
5. Acknowledgements
This simulator was built using a combination of powerful open-source technologies. We gratefully acknowledge the creators and maintainers of these projects:
- HTML5, CSS3, & JavaScript (ES6+): The fundamental technologies of the web.
- Tailwind CSS: For rapid UI development. (MIT License)
- Chart.js: For all data visualizations. (MIT License)
- MathJax: For beautiful LaTeX rendering. (Apache License 2.0)
- Google Gemini: The advanced LLM that powers the AI-driven interpretation features.