← Catalogue
World Models · legacy example

Official Statistics & Indicators

This meta-model describes official statistics: indicators and the series that measure them, observations with vintages and revisions, the censuses and surveys that collect the raw material, the methodologies that make figures comparable, and the releases that publish them under embargo discipline. It is its own model because statistical production has semantics no generic dataset model carries: reference periods, provisional versus final status, revision policy, methodology binding and release calendars.

AI YAMLAGENTS.mdSource
IDworld.n10-official-statistics-and-indicators
Version history0.2.0-legacy
CategoryReference example
IndustryCross-industry
Domainknowledge-information
Tagsofficial, statistics, indicators
Data structure

Bundles and layers

Bundle

collection

Gathering and grounding the numbers

Layers

censusAndSurvey`: collection operations, instruments, coverage · `methodologyAndClassification`: methods, classifications, revision policy

Bundle

series

The measured world over time

Layers

indicatorDefinition`: indicators, units, formulas · `observationAndVintage`: time series, observations, vintages

Bundle

dissemination

Publishing under discipline

Layers

releaseCalendar`: scheduled releases and embargoes · `revisionAndCorrection`: revisions, corrections, discontinuations

Findings

Catalogue-native findings must describe the information grouped by each layer. This legacy version does not declare them separately.

Questions & artifacts

Questions, artifact requirements and serial naming rules are required by Vercy vNext; they remain unassigned in this reference version.

Service layers

How this specification operates

Dimension & namespace

  • COMPOSE `world.dataset` (N3): every release is catalogued as a dataset with distributions, while statistical semantics remain here.
  • REFERENCE `world.reportStatement` (N2): reported figures from organizations are inputs to series production.
  • REFERENCE `world.timeCalendar` (N11): reference periods, frequencies and release calendars.
  • REFERENCE `world.documentRecord` (N1): methodology documents are governed records.
  • REFERENCE `world.place` (P1): the geographies that key series and collections.
  • imports: sdmx (ALIGN): data structure definitions, codelists and dataflows.
  • imports: ddi (ALIGN): study and instrument documentation for collection operations.
  • imports: gsbpm (ALIGN): the production process phases behind this model's events.

Canon, patches & standards

  • COMPOSE `world.dataset` (N3): every release is catalogued as a dataset with distributions, while statistical semantics remain here.
  • REFERENCE `world.reportStatement` (N2): reported figures from organizations are inputs to series production.
  • REFERENCE `world.timeCalendar` (N11): reference periods, frequencies and release calendars.
  • REFERENCE `world.documentRecord` (N1): methodology documents are governed records.
  • REFERENCE `world.place` (P1): the geographies that key series and collections.
  • imports: sdmx (ALIGN): data structure definitions, codelists and dataflows.
  • imports: ddi (ALIGN): study and instrument documentation for collection operations.
  • imports: gsbpm (ALIGN): the production process phases behind this model's events.

Artifact formats & serial data

Format-independent core. Concrete artifact formats and naming prefixes are not declared in this legacy version.

Policies & accepted processes

  • `openDisseminationContract`: standard public terms for released aggregate statistics.
  • `microdataAccessContract`: controlled research access to underlying microdata under confidentiality obligations.
  • `preReleaseAccessContract`: strictly limited embargoed access before publication.

Read / add / edit / delete

CRUD procedures and interface bindings are not declared in this legacy version.

Ownership, roles & access

The neutral owner archetype is the statistics steward, the statistics office class bound as S5 in this catalogue, which owns series, releases and methodology while respondents retain ownership of their source data. Access is always granted through the catalogue's S1/S2 ownership and access models, with microdata and pre-release access audited via S4.

Existing assembly

Objects, relationships, events and projections

Objects

  • `indicator`: a defined measurable phenomenon; key attributes: indicatorId, definition, unitRef, computationFormula.
  • `statisticalSeries`: a keyed time series measuring an indicator; key attributes: seriesKey, frequency, geographyRef, startPeriod.
  • `observation`: one value for one period in a series; key attributes: period, value, statusFlag, vintage.
  • `collectionOperation`: a census or survey producing source data; key attributes: operationType, referencePeriod, coverage, responseRate.
  • `methodology`: the documented method behind series; key attributes: methodologyDocRef, classificationRefs, revisionPolicy.
  • `statisticalRelease`: a scheduled publication act; key attributes: releasedAt, embargoUntil, edition.
  • `revision`: a recorded change to a published observation; key attributes: previousValue, newValue, reason, revisedAt.

Relationships

  • `indicator` -> measuredBy -> `statisticalSeries` (1:N): one indicator, many geographies and breakdowns.
  • `statisticalSeries` -> contains -> `observation` (1:N): the series body over periods.
  • `statisticalSeries` -> sourcedFrom -> `collectionOperation` (N:N): where the numbers come from.
  • `statisticalSeries` -> documentedBy -> `methodology` (N:1): the method that makes the series comparable.
  • `statisticalRelease` -> publishes -> `statisticalSeries` (N:N): which series each release updates.
  • `revision` -> revises -> `observation` (N:1): the audit trail of published numbers.
  • `indicator` -> derivedFrom -> `indicator` (N:N): composite indices built from component indicators.

Events

  • `collectionConducted`: a census or survey completed its field phase.
  • `seriesEstablished`: a new statistical series was defined and keyed.
  • `releasePublished`: a scheduled release made observations public.
  • `embargoLifted`: pre-release access restrictions ended at the scheduled moment.
  • `observationRevised`: a published value was revised with reason.
  • `methodologyChanged`: the documented method behind series changed, breaking or bridging comparability.
  • `seriesDiscontinued`: a series stopped being produced.

Projections

  • `headlineDashboard`: latest observations of headline indicators; omits vintages and methodology detail.
  • `sdmxDataflowExport`: machine-readable series and observations with structure references; omits narrative context.
  • `researcherMicrodataView`: anonymized unit-level data under contract; omits direct identifiers and pre-release values.