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
)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.
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.