Rename assets to a common band schema.

Harmonising collections that name the same physical band differently (e.g. HLS Landsat B05 and HLS Sentinel-2 B8A are both the narrow NIR): supply a c(old = new) map and the asset column is rewritten to the shared names. Assets absent from the map are dropped by default, so the map doubles as the band selector. Include identity entries (Fmask = "Fmask") to keep a band under its own name.

Usage

stac_rename_assets(sources, mapping, drop_unmapped = TRUE)

Arguments

sources

A stac_sources() table.

mapping

Named character c(old = new): original asset -> common name.

drop_unmapped

Drop assets not named in mapping (default TRUE)? When FALSE, unmapped assets pass through unchanged.

Value

The table with a rewritten asset column.

Details

After renaming, stac_merge() concatenates the collections into one table. A band a collection lacks needs no placeholder: lazy_dataset() gives each band only the slices that carry it, and mask() pairs those slices with the QA band by name (a Landsat-only thermal band masks against the Landsat Fmask slices), so ragged bands reduce over exactly their own observations.

See also

Other stac helpers: lazy_stac_stack(), stac_drop_duplicates(), stac_filter_assets(), stac_filter_cloud(), stac_filter_coverage(), stac_filter_orbit(), stac_gti_index(), stac_merge(), stac_query(), stac_sign_mpc(), stac_sources(), stac_time_slices()