Open. See. Explore. — GFD Data Visualization, Reimagined.

A next-generation desktop app for visualizing geophysical fluid dynamics (GFD) data. Drop a NetCDF file, get an instant 3D globe with smart variable inference — no config needed.

Built as a modern replacement for GrADS / Panoply / ncview.

• 3-Stage Variable Inference — CF standard_name → name heuristics → data statistics
• Visualization Suggestion — Auto-recommends view, colormap, and overlays based on variable analysis
• Trajectory Pair Detection — Auto-finds 1D lon/lat variable pairs for trajectory overlay
• Wind Pair Detection — Auto-detects u/v wind component pairs
• Units-Aware — Auto-converts radians to degrees for trajectory data

• Time Animation — Play/pause with adjustable speed, frame-step buttons
• Level Selection — Floating vertical level slider for 3D data
• Colormap Range — Slice / Global / Manual scaling + symmetric (0-centered) mode
• Point Info — Hover on Map to see lat/lon/value; click Globe/Map to select profile point
• Interactive Profile — Click Globe/Map → split view with vertical/time/T-Lev profile
• Multi-File — Open multiple NetCDF files, switch between them
• Drag & Drop — Drop NetCDF files to open instantly
• PNG/GIF Export — Publication-quality export with axes, colorbar, title; GIF animation export
• Code Generation — Bidirectional Python (xarray + cartopy + matplotlib) code panel
• Rhai Scripting — Programmable automation via Rhai script engine
• Spectral Filter — Wavenumber truncation filter (ispack-rs integration)
• Temporal Filter — Time-domain lowpass filter for smoothing time series (FFT-based)
• Context Menu — Right-click Globe/Map for Profile here / Export PNG / Center here
• Collapsible Panels — [/] keys to toggle Data Browser / Inspector
• Session Persistence — Auto-save/restore app state across sessions

• LLM Copilot — Chat sidebar with Claude API (Explain / Explore quick actions, markdown rendering)
• Command Palette — Cmd+K fuzzy search for views, colormaps, projections, overlays, exports
• Recipe Save/Load — Save visualization settings as .py recipes, load & apply
• MCP Server — Machine-readable control interface for external tool integration
• i18n — English / Japanese UI switching

Sequential: Viridis, Plasma, Inferno, Cividis, YlGnBu, Turbo Diverging: RdBu_r, Coolwarm, BrBG, PiYG

• Rust toolchain (stable)
• HDF5 1.10

# macOS
brew install hdf5@1.10

# Set HDF5 path (already configured in .cargo/config.toml for Homebrew default)

git clone https://github.com/daktu32/geoscope.git
cd geoscope

# Download sample data (requires GitHub CLI)
./samples/download.sh

cargo run --release -- samples/rossby_haurwitz.nc

Or launch without arguments and use the + button in the Data Browser to open files.

Full-resolution sample NetCDF files are available from GitHub Releases:

See samples/README.md for download instructions.

src/
├── main.rs                 # Entry point (D&D, 1280x800)
├── app.rs                  # App state, eframe integration, SidePanel layout
├── data/
│   ├── mod.rs              # DataStore, NetCDF I/O, field/profile/trajectory loading
│   ├── inference.rs        # 3-stage variable inference + visualization suggestion
│   ├── spectral_filter.rs  # Wavenumber filter (ispack-rs, spectral truncation)
│   ├── temporal_filter.rs  # Temporal FFT spectrum + lowpass filter (ispack-rs RealFftPlan)
│   └── trajectory_loader.rs # External trajectory loading (JSON/CSV)
├── renderer/
│   ├── common.rs           # Shared types, view_proj matrix, colormap LUT
│   ├── globe.rs            # 3D globe (wgpu, UV sphere, WGSL shader)
│   ├── map.rs              # 2D map (wgpu, Equirect/Mollweide/Polar)
│   ├── hovmoller.rs        # Hovmoller diagram (egui)
│   ├── cross_section.rs    # Vertical cross-section (egui)
│   ├── spectrum.rs         # E(n)/E(m)/E(ω) energy spectrum (egui)
│   ├── profile.rs          # 1D profile / time series (egui)
│   ├── contour.rs          # Contour lines — Marching Squares (egui)
│   ├── streamline.rs       # Streamlines — RK4 integration (egui)
│   ├── trajectory.rs       # Trajectory overlay (egui)
│   ├── vector_overlay.rs   # Wind arrows (egui)
│   ├── bitmap_font.rs      # 5x7 bitmap font (publication export)
│   └── export.rs           # PNG/GIF export (image + gif crate)
├── copilot/
│   ├── mod.rs              # LLM Copilot hub
│   ├── llm_client.rs       # Claude API client (ureq, background thread)
│   └── context.rs          # GFD domain knowledge + view context generation
├── codegen/
│   ├── mod.rs              # Code generation hub
│   ├── python.rs           # Python (xarray+cartopy+matplotlib) generator
│   ├── parser.rs           # Python → GUI reverse parser (bidirectional sync)
│   ├── rhai_engine.rs      # Rhai script engine (GeoScope API)
│   └── cmd_palette.rs      # Command palette (fuzzy match + action execution)
├── mcp/
│   └── mod.rs              # MCP server (JSON-RPC, tool control interface)
├── i18n.rs                 # Internationalization (EN/JA, t("key") lookup)
└── ui/mod.rs               # UI panels (DataBrowser, Viewport, Inspector, CodePanel, Copilot)

GeoScope is part of the dcmodel ecosystem — numerical models and libraries for GFD developed by the GFD Dennou Club.

ispack-rs  →  spmodel-rs  →  GeoScope
(spectral      (spectral      (visualization)
 transforms)    models)        ← you are here

Primary use case: visualizing output from ispack-rs / spmodel-rs shallow water and atmospheric models. Any CF-compliant NetCDF file is supported.

• docs/PRD.md — Product Requirements Document
• PROGRESS.md — Development progress log

MIT License. See LICENSE for details.

• GFD Dennou Club — the research community behind dcmodel
• ISPACK by K. Ishioka — the spectral transform library that started it all