R/terrain_development_report.R
terrain_development_summary.RdRead-only report data for R and future Shiny clients. Missing inputs remain explicit; no hierarchy, Survey Event, acceptance, or Level 1 readiness is inferred. Context tables are report inputs, not new FGDB persistence relations.
terrain_development_summary(
study_area = NULL,
streams = NULL,
reaches = NULL,
survey_events = NULL,
network = NULL,
dem = NULL,
terrain_notes = NA_character_,
analyst_notes = NA_character_,
survey_dems = NULL,
reconstruction = NULL,
folder_manifest = NULL,
legacy_staging = NULL,
analysis_reference = NULL,
terrain_sources = NULL,
terrain_evidence = NULL,
terrain_processing = NULL,
vertical_reference = NULL
)Optional one-row data frame with study_area_id and study_area_name, optionally polygon sf. A named Study Area can be described before its AOI is supplied; the AOI is never inferred from a DEM extent.
Optional data frame with stream_id, study_area_id, stream_name. These are selected Streams; defaults to network Configuration membership.
Optional data frame with reach_id, stream_id, reach_name. Optional sf geometry represents polygon AOIs, not flowlines.
Optional data frame with survey_event_id, reach_id, survey_year and optional survey_month/survey_day. This inventory does not verify file availability or network-to-event associations.
Optional Stream Network relation list or fluvgeo GeoPackage path.
Optional single-band projected terra SpatRaster. This first slice displays its extent/grid metadata, not an elevation preview or valid-cell mask.
Supplied terrain source, processing, units and limitations.
Supplied scope, segmentation rationale and next decisions.
Optional named list of single-band projected SpatRasters, keyed by supplied survey_event_id. Associations are caller assertions, not inferred from filenames or years. Grid metadata/rectangles do not prove valid-cell coverage, vertical references or scientific comparability.
Optional data frame with case_id, source_ref, proposed_structure, evidence, status, analyst and decision_notes. Status is PROPOSED, CONFIRMED, REJECTED or UNKNOWN. CONFIRMED/REJECTED require analyst and decision_notes. These are supplied forensic interpretations, never automatically promoted into hierarchy or FGDB acceptance. No UUIDs or parent context are required to record an unresolved archive case.
Optional terrain intake JSON manifest. Files are freshly inspected; its local intake labels never create report hierarchy. Schema-2 event links resolve against supplied Survey Events. Explicitly selected, unblocked GeoTIFFs supply event grid views; conflicting survey_dems inputs fail rather than choosing a precedence. Missing context/files remain findings. Associations do not prove provenance, coverage or acceptance.
Optional FileGDB staging Study Area directory, freshly inspected with inspect_legacy_staging(). Adds source-layer inventories and missing-structure prompts, not inferred hierarchy or conversion approval. This link is not persisted by the current Study Context binding.
Optional attributed saved project-choice table, as in write_study_context(). Kept separate from file declarations and assessment.
Optional saved source-use records accepted by write_study_context(). These attributed claims do not certify source lineage.
Optional retained attachment table, as in retain_study_terrain_evidence(). Paths are relative to the terrain manifest's folder. Fresh integrity results are returned separately as retained_evidence.
Optional ordered, attributed preparation accounts from record_study_terrain_processing(). These do not establish execution.
Optional structured vertical target specification, as in validate_study_vertical_reference(). No transformation is implied.
List of tables, map layers, fresh network validation and explicit gaps. Version 2 adds identity-based hierarchy, event_evidence, survey_dem_extents, reconstruction and a limited stage-specific assessment with requires_input flags for clients. Optional folder_manifest adds fresh selected-file inspection, not complete archive migration validation. review_actions groups pending assessment rows by code, stage, status, input flag and exact action; review_action_members retains their assessment-row references. This is a presentation queue. event_artifacts records supplied manifest associations, context resolution and selected grid-loading status, without acceptance. This is not a complete workflow or readiness verdict. Inputs and saved network history remain unchanged.