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, grid metadata, and the requested reader options. Grid size is columns/rows; spacing and affine coefficients retain source CRS units. Missing grid declarations remain empty or NULL. 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 once; size and modification metadata are checked for changes during inspection. 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.