Site location 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 of one observation of a site’s point after registration: the site, the point (wgs84:lat, wgs84:long), its accuracy in metres, its source (field GPS, office map placement, verified on site), the observer in a role, when it was observed, and the reason it was recorded. Never changed; a later correction is a new record, never a second registration.

Properties

Property Required Repeatable Value Message
has evidence no yes Evidence item
lat yes no decimal A site location record has exactly one WGS84 latitude.
location accuracy in metres yes no decimal A site location record states the point’s accuracy once, in metres above zero.
location reason no no string
location source yes no NCGS Location Sources: Field GPS, Office map placement, Verified on site A site location record carries exactly one source from the location-source scheme.
long yes no decimal A site location record has exactly one WGS84 longitude.
observation basis no no NCGS Observation Bases: On site, At the desk, Remotely, by asking A site location record says at most once how the point was observed (#130).
observed at yes no dateTime A site location record has exactly one observed time, from which its point holds.
observer yes no Agent A site location record names exactly one observer by IRI, never a literal (ADR-0004, ADR-0007).
observer role yes no NCGS Observer Roles: Fieldworker, Supervisor, Office analyst A site’s point is recorded by a fieldworker, a supervisor or an office analyst.
records site yes no Site A site location record is about exactly one site.

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 field GPS fix or a point verified on site is observed on site: its basis, when given, is the field (#130).
  • A point placed on an office map is observed at the desk, and says so (ncgs:observationBasis ncgs-cs:basis-desk) (#130).
  • A site location record after the site’s first carries a reason: why the point was recorded again.
  • An office analyst never observes on site: the basis is at the desk or remote, and the source is never a field GPS fix or a point verified on site (#130).
  • Every site location record leads to a point assignment, unless a later correction restates it (ADR-0025). This one has none: its site has no registration, or the site point operation has not run (ADR-0021).

Site point assignment

One result of the site point operation: the point a site took from its registration or from a site location record (prov:wasDerivedFrom), and the time from which it holds, the record’s observed time. The one derived from the registration holds no stated time: it is in force until the site’s first location record. The point in force at a time is that of the latest assignment holding from then or earlier, else the registration’s.

Properties

Property Required Repeatable Value Message
assigns point to yes no Site
lat yes no decimal
location accuracy in metres no no decimal
long yes no decimal
point in force from no no dateTime
wasDerivedFrom yes no IRI A site point assignment derives from exactly one record: the site’s registration or a site location record.

Rules

  • A point assignment from a site location record is about the record’s site, takes its point and holds from its observed time, or a correction’s from the original’s (ADR-0025); one from a site registration is about the registered site and states no time; it derives from nothing else (ADR-0021).
  • A site has at most one current point: no two of its point assignments hold from the same time, it has at most one from a registration, and no record has two (ADR-0021).

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-location-shapes.ttl at standard version 0.7.0-dev.