Eddy3D Visualizer

A web-based visualization tool for Eddy3D simulation results. Upload CSV data and explore 3D airflow and environmental patterns interactively.

Deployment	Link	Status
Main	viz.eddy3d.com
Dev	dev.viz.eddy3d.com

Features

• CSV Import — drag-and-drop or upload .csv result files
• Interactive 3D — orbit, pan, zoom; switch between perspective and top-down views
• Colormaps — Turbo, Jet, Viridis, Inferno, Magma with adjustable min/max range
• Display Controls — toggle buildings, edges, grid; adjust point size or use gapless mode
• Screenshot Export — batch-download views at configurable DPI (100–1200 px)
• Auto-Rotate — spin the model hands-free for presentations

Branching & Versioning

Branch	Purpose	Versioning	Deploy target
dev (default)	Active development	Pre-release — vX.Y.Z-dev.DATE.SHA	dev.viz.eddy3d.com
main	Stable releases	Release — vX.Y.Z	viz.eddy3d.com

Pushes to either branch automatically sync the other via GitHub Actions and create a GitHub Release (pre-release for dev, stable for main). The deployed app displays the current version in the sidebar.

Local development

Prerequisites

• Node.js >=20.19.0 or >=22.12.0 (Node 22 LTS recommended)

Setup

cd gui
npm install
npm run dev

Open the URL shown in the terminal (usually http://localhost:5173/).

Production build

cd gui
npm run build

Output is written to gui/dist.

Deployment details

• GitHub Pages deploys main via .github/workflows/deploy.yml.
• Netlify deploys dev using the dev context in netlify.toml.
• GitHub Actions handles versioning (.github/workflows/version.yml) and branch syncing (.github/workflows/sync-branches.yml).
• Version is injected at build time via VITE_APP_VERSION and VITE_APP_BRANCH environment variables.