Datensätze ergänzen oder aktualisieren

In diesem Kapitel erfährst du, wie du die Daten zu deinen SDG-Indikatoren in OpenSDG ergänzt oder aktualisierst.

Grundlagen

Jeder Indikator in OpenSDG basiert auf einem Datensatz im CSV-Format. Diese Datei enthält die Messwerte zu einem bestimmten Ziel (SDG) und wird für die Darstellung der Diagramme und Tabellen verwendet.

Ein typischer Dateiname sieht so aus:

1-1-1.csv

Dabei steht 1-1-1 für den Indikator 1.1.1 aus der Agenda 2030.

Aufbau der CSV-Dateien

Die CSV-Dateien folgen einem bestimmten Aufbau. Jede Zeile enthält eine Kombination aus:

  • Jahr (z. B. 2022)
  • Kategorie(n) (z. B. Geschlecht, Altersgruppe)
  • Wert (z. B. 56.3)

Beispiel:

Year,Sex,Value
2020,Male,52.3
2020,Female,54.1
2021,Male,53.2
2021,Female,55.0

Die verwendeten Spaltenüberschriften (z. B. Sex, Age, Location) sind frei wählbar, sollten aber konsistent bleiben. Für die Visualisierung ist der Wert in der Spalte Value entscheidend.

Wo liegen die Dateien?

Die Dateien liegen im Repository deiner OpenSDG-Seite im Verzeichnis:

data/

Alternativ kann auch ein Unterordner wie data/de/ genutzt werden, um Sprachversionen zu trennen.

Neue Daten hinzufügen

  1. Öffne das data/-Verzeichnis.
  2. Lege eine neue Datei mit dem passenden Namen an (z. B. 3-1-2.csv).
  3. Füge die Werte in der korrekten Struktur ein.
  4. Speichere die Datei.
  5. Prüfe die Vorschau lokal mit mkdocs serve oder per Pull-Request über Gitlab Pages.

Bestehende Daten aktualisieren

  1. Öffne die bestehende Datei (z. B. 11-6-1.csv).
  2. Ergänze neue Zeilen oder aktualisiere bestehende Werte.
  3. Achte darauf, die Struktur nicht zu verändern.
  4. Speichere und prüfe die Datei wie oben beschrieben.

Hinweise zur Datenqualität

  • Fehlende Werte kannst du mit einem leeren Feld oder NA kennzeichnen.
  • Verwende einen Punkt als Dezimaltrennzeichen (nicht Komma).
  • Achte auf einheitliche Bezeichnungen in den Kategorien (z. B. Male, Female, nicht M, F).
  • Vermeide Sonderzeichen oder deutsche Umlaute in den Spaltennamen.

Weiterführende Infos

Die offizielle englische Dokumentation bietet eine ausführliche Beschreibung der Anforderungen an Datenformate:

OpenSDG: Data Format Documentation (Englisch)