Record an attributed account of terrain preparation — record_study_terrain

Saves explicitly supplied, ordered preparation steps linked to one terrain source-use account. This records an account, not an executable recipe or proof of execution. Nothing is fetched, parsed, transformed or inferred.

record_study_terrain_processing(
  dsn,
  output_file,
  processing_id,
  association_id,
  steps,
  basis,
  qualifications,
  analyst,
  evidence_id = NA_character_,
  report_file = NULL,
  report_purpose = "definition"
)

Arguments

dsn: Existing saved Study Area context containing source-use records.
output_file: New context .gpkg beside dsn; earlier snapshots are retained.
processing_id: Unique local account ID, append-only. Corrected accounts use a new ID and explain the correction in qualifications.
association_id: Exact source-use account ID. Its target fingerprint identifies the inventoried derivative; it does not fingerprint step inputs.
steps: Nonempty nonspatial data frame with exactly seven plain character columns: operation, input_description, output_description, parameters, software, software_version, and execution_time. Each operation is required; other cells may be NA for unknown. Row order is the analyst-declared order, not independently established execution order. Descriptions may name multiple inputs/outputs but do not resolve product identities or graph relationships. Parameters are literal text, never evaluated. execution_time retains known date precision as text; it is not the time this account is recorded.
basis: PROJECT_RECORD or OWNER_RECOLLECTION, never verified execution.
qualifications: Nonempty support, gaps, limitations and any correction rationale. Do not supply invented details to fill missing archive evidence.
analyst: Nonempty recorder attribution, not an approval signature.
evidence_id: Optional retained PROCESSING_RECORD ID belonging to the same source-use account. NA means no retained document is linked. Its current integrity is reported separately and does not authenticate this account.
report_file: Optional new HTML report path.
report_purpose: definition (default), terrain, or staging.

Value

List with context and report paths. Uses FLUVGEO_STUDY_CONTEXT_5; earlier schemas remain readable. Existing editors preserve the account. A report failure retains the saved context for reporting retry. This does not promote source use, change scientific assessment or establish comparability.