Site record

Pre-release. This site describes standard version 0.7.0-dev, which is in development and may change before version 1.0.0.

The record produced when an observer visits a site, or assesses it from the desk (ncgs:observationBasis): a state claim whose subject is the site’s state at that moment (claimont:hasSubject), made by the observer (claimont:isMadeBy), carrying observation-level evidence (ADR-0004). The fieldworker’s form is flat; this structure is what the shape requires of the export.

Kind of: StateClaim

Properties

Property Required Repeatable Value Message
capture channel yes no NCGS Capture Channels: Dedicated app, WhatsApp flow, Paper, transcribed A site record must state how it was captured.
device latitude yes no decimal A site record must carry its device latitude, separate from the site’s point: the capture device’s, or on a desk observation the site’s position as picked on a map.
device longitude yes no decimal A site record must carry its device longitude, separate from the site’s point: the capture device’s, or on a desk observation the site’s position as picked on a map.
has evidence yes yes Evidence item A site record must carry at least one evidence item.
has interview no yes Stakeholder interview
hasSubject yes no Site state A site record claims exactly one site state (ADR-0005).
observation basis no no NCGS Observation Bases: On site, At the desk, Remotely, by asking A site record says at most once how the site was observed: on site, at the desk or remotely. Without one it was observed on site.
observed at yes no dateTime A site record must carry exactly one observed-at timestamp.
observer yes no Agent A site record must name exactly one observer by IRI (ADR-0004).
observer role yes no NCGS Observer Roles: Fieldworker, Steward, Owner, Supervisor, Reviewer A site record must carry exactly one observer role.
produced by no no Site assessment activity
records site yes no Site A site record is about exactly one registered site, named by IRI; the site itself is validated by its own shape at registration (ADR-0022).

Also required of other records: Restatement

Property Required Repeatable Value Message
restatement reason no no string
restates no no any value A record restates at most one earlier record (ADR-0018).

Rules

  • A record names an observer enrolled in the role it claims, to the record’s site or to a project design the site is registered to: the role comes from the enrolment, never from the form (ADR-0004, ADR-0007).
  • A site record in a project ledger is about a registered site: its site has a site registration record, so an export for a case no registration created fails whatever pipeline produced it.
  • A record moves to another site only by a supervisor’s or an office analyst’s correction in one role, observed at one zoned time, to a registered site current when it moves, and with each thing its restatement group introduced before it withdrawn or replaced by the move or a correction before it (ADR-0027).
  • A restatement is a record of the same type as the record it restates (ADR-0018).
  • A restatement is about the same site as the record it restates, or follows in its restatement group, unless a supervisor’s or an office analyst’s correction moves it (ADR-0018, ADR-0027).
  • A restatement is observed after the record it restates: it is the later observation that governs (ADR-0018).
  • A restatement says why the fact is restated, in a sentence or more (ADR-0018).
  • A site registration never moves: its correction registers the site its original registered, and a site registered in error is replaced (ADR-0027).
  • A site record must carry at least one geotagged site photograph.
  • A site record’s state carries the mapped vegetation type at the site’s point, or records that the map has no unit there; the vegetation type operation writes both (ADR-0026).
  • Instance data must not use the standard’s namespace https://nova.org.za/ncgs/ (ADR-0002: instances are urn:uuid: IRIs).
  • The site a record is about must be the site its state is the state of.

Checked by

Site state

What is true of a site at one moment as observed: land cover, intactness, vegetation type. The subject of a site record, or the state a site registration records (ncgs:registeredState); never merged with the site.

Kind of: State

Properties

Property Required Repeatable Value Message
intactness no no NCGS Intactness: Intact, Degraded, Transformed A site state records at most one intactness value (intact, degraded or transformed).
isStateOf yes no Site A site state is the state of exactly one site.
land cover no no NCGS Land Cover: Built-up, Degraded or disturbed, Cropland, Managed grass or lawn, Indigenous grassland, Wetland, Riparian, Existing woodland, Bare soil A site state records at most one land cover from the NCGS land-cover scheme: set at registration and corrected at a visit, so a visit may leave it out (#130).
vegetation map no no string
vegetation type no no Concept A site state records at most one mapped vegetation type from the NCGS vegetation-types scheme.
vegetation type contested no no boolean
vegetation type unmapped no no boolean

Rules

  • A site state carries a mapped vegetation type or records that the map has none at its point, never both (ADR-0026).
  • Land cover and intactness are recorded together, or neither (#130).
  • The vegetation type must be a concept in the NCGS vegetation-types scheme.

Checked by

This page explains the standard and does not decide conformance: only the released corpus does. It describes ontology/ncgs-ontology.ttl, dataRequirements/project-ledger-shapes.ttl, dataRequirements/common-shapes.ttl, dataRequirements/site-record-shapes.ttl at standard version 0.7.0-dev.