Reopens the same saved context and renders an existing report view. Purpose is an explicit presentation choice, not a persisted project-origin flag, identity change or acceptance action. The staging view describes only saved context/interpretations; it does not inspect an unsaved legacy staging path.

study_context_report(
  dsn,
  output_file,
  purpose = "terrain",
  terrain_references = FALSE,
  analysis_reference = NULL
)

Arguments

dsn

Existing Study Area context GeoPackage.

output_file

New .html destination; existing files are refused.

purpose

One of terrain (the compatible combined Terrain Development view), definition (prospective Define Study Area), or staging (Staging Report).

terrain_references

Logical; opt in to the shared read-only reference review of explicitly selected saved event DEMs. Default FALSE preserves views.

analysis_reference

Optional attributed choices for this report only, as in read_study_context_summary(). Requires terrain_references = TRUE. NULL reuses saved choices; report-only values cannot override a saved record.

Value

Normalized report path invisibly. Requires the selected renderer's Pandoc and hard-link filesystem support. Source context and linked evidence are read-only; missing/changed pinned links retain the existing reader errors.