An interactive aerodynamics simulator for airfoils, 3-D wings, propellers and blunt bodies. Change any setting and watch the streamlines, pressures and forces update. Drag a probe along a streamline from the free stream up to the wing and see exactly how the speed, pressure, Mach number, temperature and density change on the way.
No installation needed. The browser version has the 2D airfoil, 3D wing and propeller tabs with the draggable probe, and runs the same Python physics inside your browser. For the blunt-body tab, the UIUC airfoil database and the fastest performance, install the desktop app.
| Tab | What you get |
|---|---|
| 2D Airfoil | Streamlines, Cp / speed / Mach contours, lift CL, drag CD (friction, separation and wave parts), moment Cm, lift and drag forces, critical Mach number, boundary-layer transition and separation, stall, full polars |
| 3D Wing | Vortex-lattice wing with taper, sweep, dihedral and twist. Tip-vortex streamlines, span loading compared with elliptic, induced drag, span efficiency, induced angle, wing stall, and the 2-D section at any span station with the 3-D effects included |
| Propeller | Blade-element momentum theory: thrust, torque, power, efficiency, CT / CP, tip Mach, figure of merit, loading along the blade, performance maps, slipstream streamlines and the flow around any blade section |
| Blunt Bodies | Cylinder (also spinning, for the Magnus effect), sphere, ellipses, square, diamond, plate, D-sections and triangles. Drag vs Reynolds number (drag crisis), vortex-shedding frequency, separation point and critical Mach number |
Other features:
- Incompressible and compressible flow. Choose Prandtl-Glauert, Kármán-Tsien or Laitone corrections. Supersonic airfoils use Busemann second-order theory and show the Mach waves. Above the critical Mach number a wave-drag estimate is added.
- Draggable probe on any streamline, with a live plot of the whole streamline (speed, Mach, Cp, pressure, temperature, density).
- Airfoil library with about 1,000 built-in airfoils: every common NACA 4-digit, 4-digit-modified and 5-digit section (including reflexed ones), Joukowski, Kármán-Trefftz, supersonic biconvex and double wedge, flat and cambered plates. You can also type any NACA code, import .dat files (Selig or Lednicer format), or download the UIUC database of about 1,650 airfoils with one click.
- Atmosphere model (ISA up to 80 km), speed in m/s, km/h, knots, mph or Mach.
![]() |
![]() |
![]() |
![]() |
Each model works in the regimes below. The Flow model setting (Auto, Incompressible, Compressible) picks the regime automatically from the Mach number, or you can force incompressible flow to compare.
Mach-number regimes
| Model | Incompressible M < 0.3 |
Subsonic compressible 0.3 ≤ M < Mcr |
Transonic Mcr ≤ M < 1 |
Supersonic M > 1 |
|---|---|---|---|---|
| 2D airfoil | ✅ Panel method | ✅ Prandtl-Glauert, Kármán-Tsien or Laitone | ✅ Busemann 2nd-order theory with Mach waves (best for thin, sharp-nosed sections; evaluated at M = 1.08 for 1.0–1.08) | |
| 3D wing | ✅ Vortex lattice | ✅ Prandtl-Glauert / Göthert rule | ❌ Not supported | |
| Propeller | ✅ Blade-element momentum theory | ✅ Section lift corrected for each blade element's Mach number | ❌ Not supported (supersonic tips are shown in the blade-section view only) | |
| Blunt bodies (2D) | ✅ Panel method + measured drag | ✅ Pressure-field corrections + measured drag rise | ||
| Sphere (3D) | ✅ Exact potential flow + Morrison drag correlation | ✅ Pressure-field corrections + measured drag rise |
✅ supported
Physical effects
| Effect | 2D airfoil | 3D wing | Propeller | Blunt bodies |
|---|---|---|---|---|
| Inviscid pressure field and streamlines | ✅ 2D | ✅ 3D lattice + 2D section view | ✅ Slipstream (actuator disk) + blade-section view | ✅ 2D, or axisymmetric for the sphere |
| Viscous drag (boundary layer) | ✅ Thwaites / Head | ✅ Strip-wise from the 2D polar | ✅ From the 2D polar | ✅ Measured CD(Re) |
| Laminar-turbulent transition | ✅ Free, forced, fully laminar or fully turbulent | ✅ From the section polar | ✅ From the section polar | ✅ Drag crisis near Re ≈ 3×10⁵ |
| Separation and stall | ✅ Kirchhoff trailing-edge stall | ✅ Wing stall, spanwise location | ✅ Blade stall, post-stall polar | ✅ Separation angle (Thwaites) |
| 3D effects | — | ✅ Induced drag, downwash, tip vortices, sweep, taper, twist, dihedral | ✅ Tip and hub losses (Prandtl) | ✅ Sphere vs cylinder |
| Rotation | — | — | ✅ RPM, advance ratio, swirl | ✅ Spinning cylinder (Magnus effect) |
Just want to try it? Open the browser version. Nothing to install. The first visit downloads about 15 MB and takes 10–20 seconds to start.
You need Python 3.10 or newer (3.12, 3.13 and 3.14 are fine). Everything else is installed for you. Installation takes about 5 minutes and roughly 600 MB of disk space (mostly the Qt GUI library).
Windows
- Go to https://www.python.org/downloads/windows/.
- Under the newest Python 3.13 or 3.14 release, click "Windows installer (64-bit)". (Choose "ARM64" only if your PC has an ARM processor, such as a Snapdragon laptop.)
- Run the installer. On the first screen, tick "Add python.exe to PATH", then click Install Now.
- At the end, click "Disable path length limit" if it is offered.
- Open a new terminal (Start menu → type
cmd→ Command Prompt) and check the installation:It should print something likepython --versionPython 3.14.x.
macOS
- Go to https://www.python.org/downloads/macos/ and download the macOS 64-bit universal2 installer.
- Open the
.pkgfile and follow the steps. - Open Terminal and check the installation:
python3 --version
(Homebrew users can run brew install python instead.)
Linux (Ubuntu / Debian)
sudo apt update
sudo apt install python3 python3-venv python3-pip git libxcb-cursor0 libxkbcommon-x11-0 libegl1The last three packages are needed by the Qt window system. Fedora: sudo dnf install python3 xcb-util-cursor.
Option A: Download a ZIP (no Git needed). On the GitHub page, click the green Code button → Download ZIP, then unzip it somewhere easy to find, such as your Documents folder.
Option B: Clone with Git.
git clone https://github.com/oreo7382/wind-tunnel-sim.git
cd wind-tunnel-sim| System | What to do |
|---|---|
| Windows | Open the scripts folder and double-click install_windows.bat |
| macOS / Linux | In a terminal inside the project folder, run bash scripts/install_mac_linux.sh |
The installer creates a private Python environment in a .venv folder inside the project, so it does
not change anything else on your computer, and then installs numpy, matplotlib and PySide6.
| System | What to do |
|---|---|
| Windows | Double-click scripts/run_windows.bat |
| macOS / Linux | bash scripts/run_mac_linux.sh |
The first start can take a few seconds while the libraries load.
Create a "Virtual Wind Tunnel" icon that you can double-click to open the simulator directly:
| System | What to do | What you get |
|---|---|---|
| Windows | Double-click scripts/create_shortcut_windows.bat |
A desktop shortcut and a Start menu entry (right-click it to Pin to taskbar) |
| macOS | bash scripts/create_shortcut_mac_linux.sh |
Virtual Wind Tunnel.app on the desktop and in your Applications folder |
| Linux | bash scripts/create_shortcut_mac_linux.sh |
A desktop launcher and an entry in your applications menu. If the desktop shows a text file, right-click it and choose Allow Launching. |
The icon points to this project folder, so create it again if you move the folder. Add --no-menu
to create only the desktop icon.
Manual installation (if you prefer typing the commands yourself)
From inside the project folder:
Windows (Command Prompt or PowerShell)
python -m venv .venv
.venv\Scripts\python -m pip install --upgrade pip
.venv\Scripts\python -m pip install -e .
.venv\Scripts\windtunnel
macOS / Linux
python3 -m venv .venv
.venv/bin/python -m pip install --upgrade pip
.venv/bin/python -m pip install -e .
.venv/bin/windtunnelYou can also install straight from GitHub without downloading anything first:
pip install git+https://github.com/oreo7382/wind-tunnel-sim.git
windtunnelDownload the new ZIP (or run git pull), then run the install script again.
Delete the project folder, plus the desktop icon and menu entry if you made them. The only other thing
the simulator creates is a small .windtunnel-sim folder in your home directory (imported airfoils and
the optional UIUC database). Delete that too if you like.
- Pick a tab at the top: 2D Airfoil, 3D Wing, Propeller or Blunt Bodies.
- Change settings on the left: angle of attack, speed (in m/s, km/h, knots, mph or Mach), altitude, size, physics model and so on. Results update automatically.
- Drag the red probe in the flow picture. It slides along the streamlines, so you can follow a particle of air from far upstream to the airfoil surface. The probe readout and the "Along the selected streamline" plot show the local speed, V/V∞, Mach number, Cp, static and total pressure, temperature and density. Click anywhere to jump the probe to the nearest streamline.
- Untick "Probe follows streamlines" to place the probe anywhere. When you let go, a new streamline is traced through that point.
- Use the magnifier / hand tools above the picture to zoom and pan. Click the tool again to return to probe mode. The house icon resets the view.
- Change the background to show pressure coefficient, speed or local Mach number contours, and tick "Colour by speed" to colour the streamlines themselves.
- Click the airfoil name to open the library: search, preview, type a NACA code, import a
.datfile, or download the UIUC database. - File → Save flow picture exports the current plot as PNG, SVG or PDF.
- Increase the angle of attack on a NACA 2412 until the separation marker moves forward and the wing stalls.
- Set the speed to Mach 0.75 and compare the dashed (incompressible) and solid (compressible) Cp curves. Watch the probe report "locally SUPERSONIC" over the upper surface.
- Switch to a Biconvex or Double wedge airfoil at Mach 2 and look at the shock and expansion waves.
- In 3D Wing, set taper to 1.0 and then 0.4 and compare the span loading with the elliptic curve. Add sweep and watch where the wing stalls first.
- In Propeller, set the speed to 0 (static thrust) and then increase it. Compute the performance map to find the best efficiency.
- Spin the cylinder (spin ratio 1–2) to see the Magnus effect move the stagnation points.
- Raise the cylinder Reynolds number past 3×10⁵ to see the drag crisis.
The simulator uses fast engineering methods taught in aerodynamics courses. They don't solve the full Navier-Stokes equations (no CFD), so every result appears instantly. Below are the governing equations and corrections, with the Python file that implements each one. docs/THEORY.md gives the full derivations, assumptions and validation.
Atmosphere and free stream (atmosphere.py)
International Standard Atmosphere (layered lapse rates), ideal gas, and Sutherland's viscosity law:
Inviscid flow: potential theory and the panel method (panel.py)
Incompressible, irrotational flow satisfies Laplace's equation. The Hess-Smith panel method represents the body with source panels plus a uniform vortex sheet, enforces zero normal velocity on every panel, and applies the Kutta condition (equal tangential speeds at the trailing edge):
Boundary layer and viscous drag (boundary_layer.py)
All methods march the von Kármán momentum-integral equation along the surface:
-
Laminar (Thwaites):
$\theta^2 = \dfrac{0.45,\nu}{u_e^6}\displaystyle\int_0^x u_e^5,dx$ , with$\lambda = \dfrac{\theta^2}{\nu}\dfrac{du_e}{dx}$ . Laminar separation occurs when λ < −0.09. -
Transition (Michel):
$Re_\theta > 1.174\left(1 + \dfrac{22400}{Re_x}\right)Re_x^{0.46}$ , or a trip strip / laminar separation. -
Turbulent (Head's entrainment method + Ludwieg-Tillmann):
$\dfrac{d}{dx}(u_e\theta H_1) = 0.0306,u_e,(H_1 - 3)^{-0.6169}$ and$C_f = 0.246\cdot10^{-0.678H},Re_\theta^{-0.268}$ . Separation is taken as H ≥ 2.0. -
Profile drag (Squire-Young):
$c_d = 2,\theta_{TE}\left(\dfrac{u_{e,TE}}{V_\infty}\right)^{(H_{TE}+5)/2}$ , summed over both surfaces. -
Stall (Kirchhoff / Beddoes-Leishman):
$c_l = c_{l,\text{inviscid}}\left(\dfrac{1+\sqrt f}{2}\right)^2$ , where f is the separation point x/c, plus a small empirical boundary-layer "decambering" factor (≤ 7 %) (airfoil2d.py).
Compressibility corrections (compressibility.py)
The incompressible pressure coefficient
The critical Mach number is where the minimum corrected Cp reaches the sonic value:
The probe's local state follows from isentropic relations with the free-stream total conditions
(incompressible mode: ρ and T constant, and
-
Transonic wave drag (Lock's 4th-power law):
$c_{d,w} = 20,(M_\infty - M_{cr})^4$ , capped at 0.1. Supersonic pockets are limited to local M ≤ 1.6. -
Compressible skin friction: reduced by
$(1 + 0.144M^2)^{-0.65}$ .
Supersonic airfoils (flowfield.py)
Busemann's second-order thin-airfoil theory. δ is the local flow deflection, and disturbances travel along Mach lines at angle μ:
3D wings: vortex-lattice method (wing3d.py)
Horseshoe vortices (Biot-Savart law) satisfy the flow-tangency condition at each panel's ¾-chord control point. Compressibility uses the Göthert rule (geometry stretched by 1/β in x). Induced drag is computed in the Trefftz plane far behind the wing:
Each strip's lift is then iterated onto its 2D viscous polar at the effective angle
Propellers: blade-element momentum theory (propeller.py)
Blade-element forces are balanced against momentum theory in each annulus, including Prandtl's tip and hub loss factor F. W is the relative speed at the blade and φ the inflow angle:
Blunt bodies (bluntbody.py)
Potential flow gives the pressure field, for example
The models are validated against exact solutions and published wind-tunnel data (see tests/).
Typical accuracy is a few percent for lift and moment in attached flow, 10–20 % for drag, and roughly
±15 % for maximum lift. Transonic shocks, deep stall and separated wakes are only estimated, and the app
warns you when you are in those regimes. This is a learning tool, not certified design software.
| Problem | Fix |
|---|---|
python is not recognized / Microsoft Store opens (Windows) |
Reinstall Python and tick "Add python.exe to PATH". Or go to Settings → Apps → Advanced app settings → App execution aliases and turn off the two "python" aliases. |
ModuleNotFoundError: No module named 'pip._vendor...' or very long path errors (Windows) |
Run the Python installer again → Modify → enable "Disable path length limit", or move the project to a shorter folder such as C:\wind-tunnel-sim. |
No matching distribution found for PySide6 |
Your Python is too new or too old for the Qt library. Install Python 3.12 or 3.13. |
Linux: Could not load the Qt platform plugin "xcb" |
sudo apt install libxcb-cursor0 libxkbcommon-x11-0 libegl1 |
| macOS: "cannot be opened because the developer cannot be verified" | Run the scripts from Terminal with bash scripts/... rather than double-clicking them. |
error: externally-managed-environment |
Use the install script, or create the virtual environment as in the manual instructions. Don't install into the system Python. |
| The window is very slow | Reduce the number of streamlines or panels, or turn off "Show tip-vortex streamlines" on the 3D tab. |
| UIUC download fails | Check your internet connection. You can also download coord_seligFmt.zip from https://m-selig.ae.illinois.edu/ads/coord_database.html manually and use Import .dat file. |
pip install -e ".[test]"
pytest # physics validation, web bridge, shortcut maker and an off-screen GUI smoke testBuild and preview the browser version locally:
python web/build_site.py # assembles _site/
python -m http.server 8000 --directory _site # then open http://localhost:8000src/windtunnel/
physics/ all aerodynamics (no GUI code; usable from scripts and notebooks)
atmosphere.py ISA atmosphere, free-stream state
geometry.py airfoil storage, splines, repanelling
naca.py, shapes.py, library.py airfoil families, blunt bodies, library and .dat import
panel.py Hess-Smith panel method
boundary_layer.py Thwaites + Michel + Head + Squire-Young
compressibility.py, flowfield.py corrections, local state, streamline tracing
airfoil2d.py complete 2-D analysis (all regimes)
wing3d.py vortex-lattice wing
propeller.py blade-element momentum theory + actuator-disk slipstream
bluntbody.py blunt-body models
gui/ PySide6 + matplotlib user interface
shortcut.py desktop shortcut / app-menu entry for Windows, macOS and Linux
assets/ app icon
web/ browser version: HTML/JS interface; py/bridge.py runs the physics in Pyodide
(Python compiled to WebAssembly) inside a web worker
tests/ pytest suite
scripts/ one-click install / run scripts
The physics package can be used without the GUI:
from windtunnel.physics import naca, airfoil2d as a2
from windtunnel.physics.atmosphere import isa, Freestream
section = a2.Section(naca.from_code("2412"))
result = a2.analyze(section, Freestream(isa(1000), 60.0), a2.Settings(alpha_deg=5, chord=1.2))
print(result.cl, result.cd, result.lift_per_span)Every push to main also rebuilds the browser version and publishes it to GitHub Pages
(.github/workflows/pages.yml).
GitHub Actions installs the project on Windows, macOS and Linux with several Python versions and runs the tests, and also runs the one-click install scripts, on every push.
Created by oreo7382. Released under the MIT License.
The UIUC Airfoil Coordinates Database is maintained by Michael Selig's group at the University of Illinois. It is not bundled with this project. The app downloads it to your computer only when you ask it to.




