GFS wind vector advection & smoke dispersion mathematical model (smoke-dispersion.ts) #78

Closed
opened 2026-10-14 22:28:44 +00:00 by yuris · 1 comment
Owner

What to build

Implement the atmospheric dispersion model in src/lib/gis/smoke-dispersion.ts using Open-Meteo GFS U/V wind velocity vectors to project downwind 3D coordinate trajectories and particle decay rates from active fire centroids.

Technical specifications

  1. Target files:
    • src/lib/gis/smoke-dispersion.ts: Mathematical advection trajectory generator.
    • src/lib/gis/__tests__/smoke-dispersion.test.ts: Vitest unit tests.
  2. Output contract:
    • Generates array of 3D points [lng, lat, altitude_m] along the wind vector for each high-intensity fire cluster.

Acceptance criteria

  • Accurately projects particle path downwind based on U/V velocity components.
  • Decay function reduces opacity with distance from origin.
  • Unit tests verify vector mathematics under various wind angle scenarios.

Authoritative Specifications & Reference Documentation

  • Titik Gambut Architecture & Subsystem Contract: docs/ARCHITECTURE.md
  • BIG DEMNAS National Digital Elevation Model: Ina-Geoportal DEMNAS — 0.27 arc-second seamless national elevation mesh.
  • MapLibre GL JS Terrain 3D Spec: MapLibre 3D Terrain — Hardware-accelerated client elevation.
  • Open-Meteo GFS Global Forecast API: open-meteo.com/en/docs — Global 10m U/V wind velocity grids, relative humidity, and surface temperature.
  • NOAA GFS Models: NCEP GFS — Atmospheric advection modeling.
### What to build Implement the atmospheric dispersion model in `src/lib/gis/smoke-dispersion.ts` using Open-Meteo GFS U/V wind velocity vectors to project downwind 3D coordinate trajectories and particle decay rates from active fire centroids. ### Technical specifications 1. **Target files**: - `src/lib/gis/smoke-dispersion.ts`: Mathematical advection trajectory generator. - `src/lib/gis/__tests__/smoke-dispersion.test.ts`: Vitest unit tests. 2. **Output contract**: - Generates array of 3D points `[lng, lat, altitude_m]` along the wind vector for each high-intensity fire cluster. ### Acceptance criteria - [ ] Accurately projects particle path downwind based on U/V velocity components. - [ ] Decay function reduces opacity with distance from origin. - [ ] Unit tests verify vector mathematics under various wind angle scenarios. --- ### Authoritative Specifications & Reference Documentation - **Titik Gambut Architecture & Subsystem Contract**: [`docs/ARCHITECTURE.md`](https://git.nokopia.com/yuris/titik-gambut-next/src/branch/main/docs/ARCHITECTURE.md) - **BIG DEMNAS National Digital Elevation Model**: [Ina-Geoportal DEMNAS](https://tanahair.indonesia.go.id/demnas/) — 0.27 arc-second seamless national elevation mesh. - **MapLibre GL JS Terrain 3D Spec**: [MapLibre 3D Terrain](https://maplibre.org/maplibre-gl-js/docs/examples/3d-terrain/) — Hardware-accelerated client elevation. - **Open-Meteo GFS Global Forecast API**: [open-meteo.com/en/docs](https://open-meteo.com/en/docs) — Global 10m U/V wind velocity grids, relative humidity, and surface temperature. - **NOAA GFS Models**: [NCEP GFS](https://www.ncei.noaa.gov/products/weather-climate-models/global-forecast) — Atmospheric advection modeling.
yuris changed title from Issue 65: [Backend] GFS wind vector advection & smoke dispersion mathematical model (smoke-dispersion.ts) to [Backend] GFS wind vector advection & smoke dispersion mathematical model (smoke-dispersion.ts) 2026-10-14 22:31:23 +00:00
yuris changed title from [Backend] GFS wind vector advection & smoke dispersion mathematical model (smoke-dispersion.ts) to GFS wind vector advection & smoke dispersion mathematical model (smoke-dispersion.ts) 2026-10-14 22:38:29 +00:00
Author
Owner

This was generated by AI during triage.

Closed as completed in main (src/lib/gis/smoke-cone.ts implements GFS wind vector advection and geodesic smoke cones).

> *This was generated by AI during triage.* Closed as completed in main (src/lib/gis/smoke-cone.ts implements GFS wind vector advection and geodesic smoke cones).
yuris closed this issue 2026-10-15 01:26:15 +00:00
Sign in to join this conversation.
No labels
backend
frontend
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
yuris/titik-gambut-next#78
No description provided.