id: https://bbsk.sk/models/kpi/key-performance-indicator/views/ricvfpfxtaxeyzf5c3b3es7ymc6unh3o
name: key-performance-indicator
title: One computed indicator
description: "One number for one window, with the provenance that makes it auditable (PF-54, PF-55). An indicator is computed by a pipeline from the rows of a raw space and lives in the project's indicator space, never beside the rows it was computed from.\nThe attribute set is fixed and the published schema closes the object, so `state` and `threshold` are absent by decision and not by omission: a threshold is the judgement of whoever reads the number, it changes without the number changing, and two departments may hold different ones. The state a view paints is what that view computes from the value and its own threshold.\nThe territory an indicator describes is the last segment of its `{localId}`, and therefore of its `name`: the entity carries no attribute for it, because a number labelled with a body and no territory is a number a viewer has to guess about."
license: https://joinedcontext.com/licenses/cc-by-4.0
prefixes:
  geojson: https://purl.org/geojson/vocab#
  jc: https://joinedcontext.com/models/
  linkml: https://w3id.org/linkml/
default_prefix: jc
default_range: string
imports:
  - linkml:types
classes:
  Any:
    class_uri: linkml:Any
    description: "Any value: an inlined object whose class this view does not show."
  KeyPerformanceIndicator:
    name: KeyPerformanceIndicator
    class_uri: https://uri.etsi.org/ngsi-ld/default-context/KeyPerformanceIndicator
    exact_mappings:
      - jc:KeyPerformanceIndicator
    slots:
      - location
      - name
      - title
      - currentValue
      - calculationPeriod
      - calculationFormula
      - derivedFrom
      - computedBy
      - updatedAt
    slot_usage:
      calculationFormula:
        name: calculationFormula
        slot_uri: jc:calculationFormula
        range: string
        required: true
        annotations:
          hidden: "true"
          label:
            tag: label
            value:
              sk: Výpočet
              cs: Výpočet
              fi: Laskentakaava
              en: Formula
              de: Berechnungsmethode
          ngsi_ld_kind: Property
        description: "How the value was computed, in words a reader can check the number against: the measure, the aggregation, the window and any divisor, such as `per km² of the district's own area`. English plain text: a table leaves it out, so a Slovak answer never shows English prose."
      calculationPeriod:
        name: calculationPeriod
        slot_uri: jc:calculationPeriod
        range: Any
        required: true
        inlined: true
        annotations:
          label:
            tag: label
            value:
              sk: Obdobie
              cs: Období
              fi: Jakso
              en: Period
              de: Berechnungszeitraum
          ngsi_ld_kind: Property
          summary: "true"
        description: "The window the value actually covers, as `{ start, end }` RFC 3339 instants. It is the window the pipeline used and not the one it was asked for, so the distance between `calculationPeriod.end` and `updatedAt` is how stale the source is."
        rank: 3
      currentValue:
        name: currentValue
        slot_uri: jc:currentValue
        range: Any
        required: true
        inlined: true
        annotations:
          label:
            tag: label
            value:
              sk: Hodnota
              cs: Hodnota
              fi: Arvo
              en: Value
              de: Wert
          ngsi_ld_kind: Property
          summary: "true"
          upstream_source: https://vocabulary.uncefact.org/UnitMeasureCode#
        description: "The number, with its unit on the Property as `unitCode`, a UN/CEFACT common code, and the instant it describes as `observedAt`. A window with no reading in it carries the string `not measured` instead of a number, and never a zero: a zero reads as a measurement."
        rank: 2
      name:
        name: name
        slot_uri: jc:name
        range: string
        required: true
        annotations:
          label:
            tag: label
            value:
              sk: Názov
              cs: Název
              fi: Nimi
              en: Name
              de: Name
          ngsi_ld_kind: Property
          summary: "true"
        description: "The indicator's own name, equal to the `{localId}` of its id, so the territory is legible without parsing the URN."
        rank: 1
      updatedAt:
        name: updatedAt
        slot_uri: jc:updatedAt
        range: datetime
        required: true
        annotations:
          label:
            tag: label
            value:
              sk: Aktualizované
              cs: Aktualizováno
              fi: Päivitetty
              en: Updated
              de: Zuletzt berechnet
          ngsi_ld_kind: Property
          summary: "true"
        description: "When the pipeline last ran, as an NGSI-LD DateTime. It is the run and not the window: an indicator whose source stopped moving keeps its window and gains a newer `updatedAt`, which is the visible fact that the source is static."
        rank: 4
    description: One number for one window, with the provenance that makes it auditable.
slots:
  calculationFormula:
    name: calculationFormula
    slot_uri: https://uri.etsi.org/ngsi-ld/default-context/calculationFormula
    exact_mappings:
      - jc:calculationFormula
    range: string
    required: true
    annotations:
      hidden: "true"
      ngsi_ld_kind: Property
    description: "How the value was computed, in words a reader can check the number against: the measure, the aggregation, the window and any divisor, such as `per km² of the district's own area`. English plain text: a table leaves it out, so a Slovak answer never shows English prose."
  calculationPeriod:
    name: calculationPeriod
    slot_uri: https://uri.etsi.org/ngsi-ld/default-context/calculationPeriod
    exact_mappings:
      - jc:calculationPeriod
    range: Any
    required: true
    inlined: true
    annotations:
      ngsi_ld_kind: Property
    description: "The window the value actually covers, as `{ start, end }` RFC 3339 instants. It is the window the pipeline used and not the one it was asked for, so the distance between `calculationPeriod.end` and `updatedAt` is how stale the source is."
  computedBy:
    name: computedBy
    slot_uri: https://uri.etsi.org/ngsi-ld/default-context/computedBy
    exact_mappings:
      - jc:computedBy
    range: string
    required: true
    annotations:
      label:
        tag: label
        value:
          sk: Vypočítané procesom
          cs: Vypočteno procesem
          en: Computed by
          de: Berechnet von
      ngsi_ld_kind: Property
    description: The Pipeline that computed it, as its URN.
  currentValue:
    name: currentValue
    slot_uri: https://uri.etsi.org/ngsi-ld/default-context/currentValue
    exact_mappings:
      - jc:currentValue
    range: Any
    required: true
    inlined: true
    annotations:
      ngsi_ld_kind: Property
      upstream_source: https://vocabulary.uncefact.org/UnitMeasureCode#
    description: "The number, with its unit on the Property as `unitCode`, a UN/CEFACT common code, and the instant it describes as `observedAt`. A window with no reading in it carries the string `not measured` instead of a number, and never a zero: a zero reads as a measurement."
  derivedFrom:
    name: derivedFrom
    slot_uri: https://uri.etsi.org/ngsi-ld/default-context/derivedFrom
    exact_mappings:
      - jc:derivedFrom
    range: string
    required: true
    annotations:
      label:
        tag: label
        value:
          sk: Zdroj údajov
          cs: Zdroj dat
          en: Derived from
          de: Abgeleitet von
      ngsi_ld_kind: Property
    description: "The Endpoint the sources were read through, as its URN. The endpoint and not the space: what an indicator could see is what that endpoint's policy let it see."
  location:
    name: location
    slot_uri: https://uri.etsi.org/ngsi-ld/location
    exact_mappings:
      - geojson:geometry
    range: string
    annotations:
      ngsi_ld_kind: GeoProperty
      upstream_source: ETSI NGSI-LD core context v1.8
    description: Where the entity is, as GeoJSON geometry.
  name:
    name: name
    slot_uri: https://uri.etsi.org/ngsi-ld/default-context/name
    exact_mappings:
      - jc:name
    range: string
    required: true
    annotations:
      ngsi_ld_kind: Property
    description: "The indicator's own name, equal to the `{localId}` of its id, so the territory is legible without parsing the URN."
  title:
    name: title
    slot_uri: http://purl.org/dc/terms/title
    exact_mappings:
      - jc:title
    range: string
    annotations:
      label:
        tag: label
        value:
          sk: Názov ukazovateľa
          cs: Název ukazatele
          en: Indicator title
          de: Indikatortitel
      ngsi_ld_kind: LanguageProperty
    description: "The indicator's human name, one text per language of the space, such as `{sk: Index starnutia, en: Ageing index}`: what a table labels the row with, because `name` is the slug. Optional: an indicator written before it, or by a writer that names none, has none."
  updatedAt:
    name: updatedAt
    slot_uri: https://uri.etsi.org/ngsi-ld/default-context/updatedAt
    exact_mappings:
      - jc:updatedAt
    range: datetime
    required: true
    annotations:
      ngsi_ld_kind: Property
    description: "When the pipeline last ran, as an NGSI-LD DateTime. It is the run and not the window: an indicator whose source stopped moving keeps its window and gains a newer `updatedAt`, which is the visible fact that the source is static."
