Record evidenced vertical metadata for associated terrain — record_study_terrain

Fills previously unknown elevation-unit and/or vertical-reference assertions. Saves new manifest/context snapshots without editing rasters, their CRS, observed metadata, fingerprints or event associations. Assertions are not independent verification, unit conversion or scientific acceptance.

record_study_terrain_metadata(
  dsn,
  output_file,
  survey_event_id,
  vertical_unit = NULL,
  vertical_reference = NULL,
  evidence,
  analyst,
  manifest_file,
  report_file = NULL
)

Arguments

dsn: Existing saved Study Area context GeoPackage.
output_file: New context .gpkg beside dsn.
survey_event_id: Exact event UUID with a selected terrain file.
vertical_unit: Optional elevation-unit assertion. NULL or blank preserves the current value; never inferred from horizontal CRS or filename.
vertical_reference: Optional vertical datum/reference assertion. NULL or blank preserves the current value. At least one new field is required.
evidence: Nonempty source/basis for the supplied metadata.
analyst: Nonempty attribution, not an approval signature.
manifest_file: New JSON beside the existing manifest.
report_file: Optional new HTML report.

Value

List of context, report and manifest paths. Metadata belongs to the artifact and applies to every event sharing it. Existing known values cannot be replaced by this initial-entry tool. Partial knowledge remains explicit. Prior evidence is retained with appended attribution. Missing/changed or conflicted selected files are refused; unrelated findings remain visible. Outputs are not a single transaction: later failures retain already published manifest/context files for inspection. Never modify inputs concurrently.