Skip to content
Back to search

3dsat

MCP server + Svelte app for multiband satellite imagery draped on DEMs in interactive 3D, with analysis

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/rwspatial--3dsat/badge.svg)](/listings/rwspatial--3dsat)

HTML

<a href="/listings/rwspatial--3dsat"><img src="/api/listings/rwspatial--3dsat/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

uv sync
uv run sat3d-build --preset salinas --out data/salinas      # ~40 s, ~25 MB
xdg-open data/salinas/viewer.html                            # interactive 3D viewer
# or any AOI:
uv run sat3d-build --bbox -121.75 36.5 -121.5 36.7 --start 2024-07-01 --end 2024-08-31 --name myaoi --out data/myaoi

The stack is `LST`, `LST_UNCERTAINTY`, `LWIR1_EMIS`, `BLUE/GREEN/RED/REDEDGE1-3/NIR_SR`, `CLOUD_MASK`, `NDVI` and `DEM`. Each is a float32 COG in physical units on one 30 m UTM grid, with a `manifest.json` that records the source scene ids.

Sources: Landsat 8/9 C2 L2 (Planetary Computer), Sentinel-2 L2A and Copernicus GLO-30 (AWS open data / Earth Search). No credentials are needed.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 55 lines
  1. # 3dsat
  2. Tooling (and an MCP server, `sat3d`) for **multiband satellite imagery draped on elevation in interactive 3D, with analysis**. It builds an open-data analog of [Hydrosat](https://satdocs.hydrosat.com)'s thermal + VNIR products to develop against.
  3. ![LST draped on Copernicus DEM, Salinas Valley](docs/img/salinas-lst.png)
  4. See **[docs/STACK.md](docs/STACK.md)** for the Hydrosat product breakdown, the analog mapping, and stack options from laptop to large scale.
  5. ## Quick start
  6. ```bash
  7. uv sync
  8. uv run sat3d-build --preset salinas --out data/salinas # ~40 s, ~25 MB
  9. xdg-open data/salinas/viewer.html # interactive 3D viewer
  10. # or any AOI:
  11. uv run sat3d-build --bbox -121.75 36.5 -121.5 36.7 --start 2024-07-01 --end 2024-08-31 --name myaoi --out data/myaoi
  12. ```
  13. The stack is `LST`, `LST_UNCERTAINTY`, `LWIR1_EMIS`, `BLUE/GREEN/RED/REDEDGE1-3/NIR_SR`, `CLOUD_MASK`, `NDVI` and `DEM`. Each is a float32 COG in physical units on one 30 m UTM grid, with a `manifest.json` that records the source scene ids.
  14. Sources: Landsat 8/9 C2 L2 (Planetary Computer), Sentinel-2 L2A and Copernicus GLO-30 (AWS open data / Earth Search). No credentials are needed.
  15. ## Web app (Svelte)
  16. Interactive DEM drape for any stack in `data/`. It reads the COGs directly with geotiff.js over HTTP Range, so there's no export step.
  17. ```bash
  18. cd web && npm install && npm run dev # http://localhost:5173
  19. ```
  20. - Drape any layer (or S2 true colour) on the Copernicus DEM, with colour ramp, stretch, histogram and cloud masking
  21. - Vertical exaggeration, sun azimuth/altitude hillshade
  22. - **Band math**: expressions over layer names (`(NIR_SR - RED_SR)/(NIR_SR + RED_SR)`, `LST - 273.15`, presets incl. NDRE and LST anomaly)
  23. - **Threshold analysis**: pixels/area above or below a value, with mean LST / NDVI / elevation inside the mask
  24. - **Probe**: click the terrain to read every layer at that point
  25. - Coarse / medium / full mesh resolution; PNG export
  26. A second **Tech stack** tab (`/#stack`) shows a diagram of how the pieces connect and the scaling path.
  27. Set `SAT3D_DATA=/other/dir` to point it at stacks elsewhere.
  28. ![NDVI > 0.6 threshold on terrain](docs/img/svelte-ndvi-threshold.png)
  29. ## MCP server
  30. ```bash
  31. claude mcp add sat3d -- uv --directory /path/to/3dsat run sat3d
  32. ```
  33. | Tool | What it does |
  34. |---|---|
  35. | `build_analog_stack` | Build the Hydrosat-like stack for a bbox + date window |
  36. | `export_drape_viewer` | Write the 3D HTML viewer for a stack |
  37. | `raster_info` | Bands, dtypes, CRS, bounds, resolution, COG tiling/overviews (local path or GDAL URI) |
  38. | `band_stats` | Per-band min/max/mean/std/percentiles (optionally on an overview) |

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.