WindNinja wind grids
Purpose
The Dogrib sample distributes WindNinja terrain-adjusted wind grids for Scenario 2c
(conservation of mass) and Scenario 2d (conservation of mass and momentum). ws4.fire.wind
reads the paired angle and velocity rasters, validates them, records their provenance, and
selects the nearest available direction grid for a weather step.
This module does not run WindNinja and does not treat the grids as observations.
Grid contract
A WindNinjaGrid holds:
the domain-average direction named by the source files;
a wind-direction grid in degrees clockwise from north;
a wind-speed grid in km/h;
the shared
ObservedGridgeometry;the method label and source label.
Angle and velocity rasters must share one geometry and shape. Values must be finite; angles
must be in [0, 360] and speeds non-negative. A pair with a missing companion is rejected
rather than filled from another direction.
Selection
nearest_wind_direction uses circular angular distance, so 350° and 10° are 20° apart.
wind_grid_at selects the nearest direction grid and returns its speed and direction at a
cell. The growth path can use those values as per-step wind inputs; it does not interpolate
between grids.
Provenance
The public Dogrib archive is available from the Prometheus sample distribution. The reviewed
copy was retrieved from the fgmfiles.spyd.com mirror. The conservation grids are under
conserv_mass/ and the momentum grids are under conserv_mass_moment/. Each pair is named
windninja_<direction>_<speed>_<resolution>m_ang.asc and ..._vel.asc.
The full grids are third-party validation data with no explicit licence file in the archive. They are used for non-commercial validation with attribution. Keep them out of the tracked tree unless the licence position is clarified; the unit tests use small synthetic pairs.
Limits
The loader does not run WindNinja or regenerate the grids.
The full Dogrib grids are not committed.
The growth integration and the fixed 2b/2c/2d matrix are P160.3.
The grids are model input, not observed wind evidence.