R/survey_opportunities.R
survey_opportunity_summary.RdA read-only single-study assessment. Catalog entries remain distinct from acquisitions and accepted FG sources. No network requests, identity inference, geometry repair, data downloads, or Survey Event changes occur.
survey_opportunity_summary(
study_area,
survey_events,
catalog_records,
searches,
focus = study_area,
focus_label = "Study Area; supplied event inventory",
terrain_review = NULL
)One valid polygon sf row with study_area_id, study_area_name.
Data frame with event_id, label, collection_start, collection_end (Date columns), and date_label. Dates bound known precision; for a year-only observation use its whole-year interval, not a claimed day.
Polygon sf with catalog, record_id, snapshot_id, title, collection_start, collection_end (Date), date_label, status and metadata_url. Status is COMPLETE, PLANNED or UNKNOWN. Optional source_group and identity_evidence record supplied cross-listing identity, never inferred. Optional disposition is UNREVIEWED, REPRESENTED, REISSUE or DISMISSED; reviewed values require review_note, and REPRESENTED/REISSUE require event_id.
Data frame with catalog, snapshot_id, retrieved_at, outcome, scope_note. Outcome is COMPLETE, PARTIAL, FAILED or NOT_SEARCHED. Completeness describes this particular query, never the entire world's available surveys.
Optional valid polygon/line sf inside the Study Area. Temporal comparisons use the supplied event inventory for this explicitly chosen focus.
Description of the focus and event-inventory scope.
Optional output of terrain_reference_review(). Adds a separate evidence snapshot, never source/event identity or acceptance.
Structured assessment, source rows, map layers and search evidence, class fg_survey_opportunities. Row classifications are candidate triage, not scientific comparability or counts of independent acquisitions.