Create a Stream Network Observation relation — create_stream_network

Creates one time-specific Stream Network Observation row. Conditional requirements distinguish current producer output from qualified legacy evidence without inventing missing provenance.

create_stream_network_observation(
  stream_network_observation_id,
  stream_network_configuration_id,
  observation_year,
  observation_month = NA_integer_,
  observation_day = NA_integer_,
  evidence_class,
  coverage_status,
  source_terrain_id = NA_character_,
  source_terrain_label = NA_character_,
  source_terrain_fingerprint = NA_character_,
  derivation_method_id,
  method_version = NA_character_,
  threshold_value = NA_real_,
  threshold_unit = NA_character_,
  topology_tolerance,
  topology_tolerance_unit,
  native_horizontal_crs,
  native_vertical_datum = NA_character_,
  horizontal_unit,
  vertical_unit = NA_character_,
  cell_size = NA_real_,
  provenance_completeness,
  actor,
  created_at = Sys.time()
)

Arguments

stream_network_observation_id: Immutable observation UUID.
stream_network_configuration_id: Governing configuration UUID.
observation_year: Four-digit evidence year.
observation_month: Optional month.
observation_day: Optional day; requires a month.
evidence_class: Controlled evidence class.
coverage_status: Controlled coverage status.
source_terrain_id: Optional governed terrain UUID.
source_terrain_label: Optional review label.
source_terrain_fingerprint: Optional 64-character hexadecimal hash.
derivation_method_id: Stable scientific method identifier.
method_version: Method version; required for complete provenance.
threshold_value: Optional positive initiation threshold.
threshold_unit: Unit paired with `threshold_value`.
topology_tolerance: Positive topology tolerance.
topology_tolerance_unit: Horizontal unit for the tolerance.
native_horizontal_crs: Source horizontal CRS identifier.
native_vertical_datum: Optional vertical datum identifier.
horizontal_unit: Source horizontal unit.
vertical_unit: Unit paired with `native_vertical_datum`.
cell_size: Optional positive terrain cell size; required for direct terrain derivation.
provenance_completeness: Controlled provenance-completeness code.
actor: Stable actor or process identifier.
created_at: Creation date-time; converted to UTC.

Value

A one-row `stream_network_observation` tibble.