Skip to content

v3.38.0

Choose a tag to compare

View all tags
@cboettig cboettig released this 03 Nov 17:46
v3.38.0
57d6f51
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Raster time series

A raster layer published as one COG per date can now play through those dates (#421, #432). Give the asset a control with "bind": "frame" and a frames source. The source is either a STAC frame-list asset in the same collection or "list", which lists the folder that holds the layer's COG. The layer then gets a player in the overlay rail. It has play and pause, back and forward, a slider over the dates, and the date on screen. window, start/end and step choose which frames play, and frame_ms sets the speed.

"control": { "bind": "frame", "frames": "ssta-cog-frames", "window": "P90D", "step": 4 }

The map never goes blank between frames. The player keeps the next frames loading at zero opacity, and a new frame replaces the old one only once its tiles have been drawn. On a slow connection playback slows down to wait for each frame. preload (default 3) and max_wait_ms (default 8000) tune this.

The agent controls the player with a new set_time tool, which apps get only when they configure a time series. get_map_state reports each time series' current date and the dates available.

The full reference is the "Raster time series" section of docs/guide/configuration.md.

Raster bands and units

  • Band selection (#357). bidx picks the band of a multi-band COG. The band's STAC nodata and classification:classes are read from the chosen band.
  • Legend classes on rasters (#350). Config legend_classes replace a raster's STAC classes and also build its colormap, so a class left out renders transparent. A class whose value is the band's nodata is always left out.
  • Unscale. A band whose STAC raster:bands entry gives a scale or offset is now unscaled by TiTiler, so rescale and the legend are in real units. Set "unscale": false to keep the old behaviour.

Migration

For a raster whose STAC declares a scale other than 1 or an offset other than 0, rescale is now read in real units. An app with such a layer must change its rescale or set "unscale": false when it bumps its pin. All 60 raster collections in bosl-high-seas were checked, and none declares a scale or offset. Only that app's new Coral Reef Watch layers are affected, and they were configured for this release.

No other configuration changes are needed. Apps without a control on a raster are unaffected by the time series.

Other changes

  • The docs and README link the template at its new home, SchmidtDSE/glen-template (#425).

Full changelog: v3.37.0...v3.38.0

Assets 2
Loading