Household survey 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 owner’s answers to the household benefit survey (NCGS-M010) at a household stand, taken on a monitoring visit at T2 or later that observed a living tree there: per fruit tree whether it bore fruit in the recent season, and for the household whether fruit was shared or sold, the months with fruit and the number of people the trees benefit. Counts and yes-or-no answers only; the respondent is the owner as an agent identifier and a role, never a name (ADR-0007). A living tree is confirmed by the visit’s observation, never by the answer.

Properties

Property Required Repeatable Value Message
fruit shared yes no boolean A household survey says whether fruit from the programme’s trees was shared in the recent season.
fruit sold yes no boolean A household survey says whether fruit from the programme’s trees was sold in the recent season.
has fruiting answer no yes Fruiting answer Each fruit tree asked about is an answer naming the tree and whether it bore fruit.
months with fruit yes no integer A household survey records the months in the past year with fruit from the programme’s trees, from 0 to 12.
observed at yes no dateTime
observer yes no Agent A household survey names exactly one interviewer by IRI, never a literal (ADR-0004, ADR-0007).
observer role yes no NCGS Observer Roles: Fieldworker, Supervisor A household survey is taken by a fieldworker or a supervisor; an owner does not survey their own household.
people benefiting yes no integer A household survey records how many people in the household benefit from the trees, as one count, never a list of people (ADR-0007).
records site yes no Site A household survey is at exactly one site.
respondent yes no Agent role A household survey names exactly one respondent, as an agent IRI and a role, never a name (ADR-0007).
surveyed on visit yes no Monitoring visit record A household survey is taken on exactly one monitoring visit.

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 household survey answers for each tree at most once.
  • A household survey is taken on a monitoring visit at the same site.
  • A household survey is taken on a visit that declares T2 or a later horizon: before T2 a tree has not had a season to bear fruit.
  • A household survey is taken on its visit’s day, at or after the visit began: a survey dated before the visit or on another day is not that visit’s.
  • A household survey is taken only at a household stand.
  • A household survey is taken only on a visit that observed at least one living tree at the stand: the visit confirms the tree, the answer does not.
  • A monitoring visit carries at most one household survey.
  • Every tree a fruiting answer names was observed alive on the survey’s visit.
  • Instance data must not use the standard’s namespace https://nova.org.za/ncgs/ (ADR-0002: instances are urn:uuid: IRIs).
  • The respondent of a household survey is enrolled as the owner of the surveyed stand: an owner of another stand cannot answer for this one (ADR-0007).
  • The respondent of a household survey is the owner of the stand, in the owner role.
  • 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).

Checked by

Fruiting answer

One fruit tree in a household survey record: the tree individual, which the visit observed alive, and whether it bore fruit in the recent season.

Properties

Property Required Repeatable Value Message
answered tree yes no Tree individual A fruiting answer is about exactly one tree individual.
bore fruit in the recent season yes no boolean A fruiting answer says whether the tree bore fruit in the recent season.

Rules

  • Instance data must not use the standard’s namespace https://nova.org.za/ncgs/ (ADR-0002: instances are urn:uuid: IRIs).

Checked by

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