Inspect vertical-reference declarations in a local GeoTIFF

Source: R/inspect_terrain_vertical_reference.R

Compares the current GDAL reader view with an internal-only read that requests preservation of a compound CRS. A declaration can exist without being exposed by the ordinary reader. Neither observation establishes the reference actually used to produce the raster elevations or scientific acceptance.

inspect_terrain_vertical_reference(path)

Arguments

path

Path to an existing local, single-band native GeoTIFF.

Value

A list with schema, normalized path, SHA-256, software versions, default_reader and internal_compound observations, and crs_text_differs. Each observation contains status, WKT, optional PROJJSON, optional vertical CRS component, band unit, and the requested reader options. Status is VERTICAL_CRS_EXPOSED or VERTICAL_CRS_NOT_EXPOSED, never proof of absence. Text differences require review, not automatic conflict resolution.

Details

No statistics, raster processing, metadata assignment or file writes are requested. The file is hashed before and after inspection (two full byte reads). GDAL errors and unsupported inputs fail, rather than becoming unknown metadata. The internal read disables PAM sidecars; the ordinary read may use them. Options are scoped to each call. Existing intake manifests are unchanged. A three-dimensional geodetic CRS is retained but is not classified as a separate vertical CRS or automatically associated with raster band values.