Model-surface Item for a (DuckDB-backed) dataset

Describes the dataset's per-taxon surfaces as a static GeoParquet asset plus the live DuckDB-SQL TiTiler endpoint (as a web-map link + an alternate asset), parameterized by {mdl_seq}. If the dataset has more than one prediction interval, a datacube temporal/season dimension enumerates them.

Usage

stac_model_cell_item(
  ds,
  cfg,
  time_periods = NULL,
  mdl_key_ex = NA_character_,
  id_field = c("mdl_key", "mdl_seq"),
  cog_ex = NA_character_,
  has_native_asset = FALSE
)

Arguments

ds

one-row data.frame from dataset

cfg

config from stac_cfg()

time_periods

character vector of distinct model.time_period for the dataset

mdl_key_ex

a representative mdl_key of the dataset, baked into the example tile links

id_field

"mdl_key" (v8 onward) or "mdl_seq" — a LEGACY release (v1–v7b, usa05 grid). A legacy release publishes no dist_merged/ Parquet and is not served by the SQL tile factory: its surfaces are one content-addressed COG per model, registered in tables/model_asset.parquet, so that registry is the Item's data asset and the example tile links go through titiler's stock /cog.

cog_ex

for a legacy release, the cog_url of a representative model (example links); NA omits the links rather than inventing one.

has_native_asset

TRUE when the release publishes tables/native_asset.parquet (the pointer table of per-model COG / PMTiles files in the content-addressed store); a raster or vector dataset then gets one native_asset asset linking it. FALSE (default) emits no per-model file asset rather than a dead link. stac_build() sets it from the release's tables.

Value

STAC Item as a list