Rename a saved Stream or Reach — rename_study

Changes only the display name in a new revision, retaining geometry, identities, relationships, source evidence and earlier revisions. No stationing or automatic numbering is performed. Unchanged names are not a new revision.

rename_study_feature(dsn, output_file, level, feature_id, name,
  report_purpose = "definition")

Arguments

dsn: Existing study context GeoPackage.
output_file: New GeoPackage beside dsn. Never overwritten.
level: stream or reach.
feature_id: Exact saved identity.
name: Nonempty replacement name, unique within its parent ignoring case.
report_purpose: definition, terrain or staging.

Value

Revision context and report paths.