Zum Inhalt springen
DE

Wissenschaftsdatensatz erstellen

Das Wissenschaftspanel liest eine einzige Datei: einen Wissenschaftsdatensatz (comap.science-dataset/v1), der in den Einstellungen des Raums gespeichert ist. Er enthält vorberechnete Summen pro Zone, die das Panel im Browser für die Zonen zusammenzählt, die jemand gerade wählt. Niemand schreibt ihn von Hand: Ein Offline-Builder erzeugt ihn aus den Quelldaten, zusammen mit einem QA-Beleg, der das Ergebnis prüft.

Um die eigenen Rasterebenen des Raums an einem gewählten Punkt als Diagramm zu zeigen, schreiben Sie stattdessen eine Science-Konfiguration: siehe Wissenschaftspanel konfigurieren.

Einen Raum einzurichten braucht vier Schritte:

  1. Erstellen Sie die Datensatzdatei und prüfen Sie ihren QA-Beleg.
  2. Laden Sie die Polygone der Zoneneinteilungen als Kartenebenen in den Raum hoch.
  3. Laden Sie die Datei unter Raumeinstellungen → Wissenschaftspanel und verknüpfen Sie jede Zoneneinteilung mit ihrer Ebene.
  4. Prüfen Sie das Panel im Raum.
Eingabe Was es ist Im öffentlichen Raum
Baumartenkarte Ein GeoTIFF mit einem Wahrscheinlichkeitsband pro Baumart, im Schweizer Koordinatensystem (EPSG:2056) 30-m-Zellen, 11 Bänder: Fichte, Tanne, Föhre, Lärche, Arve, Buche, Ahorn, Esche, Eiche, Kastanie, Andere
Abgestorbene Bäume Ein GeoPackage mit den erkannten abgestorbenen Bäumen pro Befliegungsjahr, jeder mit seiner Fläche im Feld Area 2017 bis 2024 — dieselben Dateien wie die Mortality-Ebenen des Raums
Zoneneinteilungen Polygon-Shapefiles, jedes mit einem Schlüsselfeld und optional einer übergeordneten Zoneneinteilung zum Aufklappen Kantone (KANTONSNUM), Bezirke (UUID, innerhalb der Kantone), Wald-Ökoregionen (Code)
QA-Referenzen Dienen nur der Prüfung des Ergebnisses Das 10-m-Totholzraster, die veröffentlichten Anteile abgestorbener Bäume und die Abdeckungsebene der Befliegungen

Eine Build-Konfiguration nennt all dies und ergänzt, was das Panel anzeigt: die Datensatz-ID und ihren Titel in jeder Sprache, die Bezeichnungen und Gruppen der Baumarten, die Befliegungsjahre mit ihrer erwarteten Zeilenzahl sowie für jede Zoneneinteilung die Felder für Schlüssel, Name, Code und übergeordnete Zone. Die Konfiguration des öffentlichen Raums ist python-geo-service/science/configs/public-room-v1.json im App-Repository.

Der Builder liegt unter python-geo-service/science/ im App-Repository. Führen Sie ihn im Geo-Service-Image aus, mit schreibgeschützt eingebundenen Eingaben:

Terminal window
docker run --rm \
-v "$PWD:/work:ro" \
-v "$PWD/data:/science-input:ro" \
-v "<manifest.json>:/manifest/MANIFEST.json:ro" \
-v "<output dir>:/science-output" \
-w /work/python-geo-service --entrypoint python3 <image> \
-m science.build_dataset --config science/configs/public-room-v1.json \
--input-root /science-input --output-dir /science-output --expect-manifest /manifest/MANIFEST.json
  • Jeder Pfad in der Konfiguration ist relativ zu --input-root und darf es nicht verlassen.
  • --expect-manifest prüft die Dateien der abgestorbenen Bäume Byte für Byte gegen das Manifest des Datensatzes, aus dem die Ebenen des Raums geladen wurden.

Der Builder berechnet von jeder Eingabe einen Hash und schreibt drei Dateien, benannt nach der Datensatz-ID:

  • Ordnerscience-output/
    • public-forest-v1.json der Datensatz, den Sie im Raum laden
    • public-forest-v1.qa.json der QA-Beleg, für Werkzeuge
    • public-forest-v1.qa.md derselbe Beleg, zum Lesen

Er endet nur dann mit Status 0, wenn jede Pflichtprüfung bestanden ist:

  • die Eingaben haben sich während des Builds nicht verändert;
  • jedes Befliegungsjahr hat die erwartete Zahl abgestorbener Bäume;
  • die gespeicherte Area jedes Objekts entspricht der Fläche seiner Geometrie;
  • die Dateien der abgestorbenen Bäume stimmen mit dem Datensatz-Manifest des Raums überein (mit --expect-manifest);
  • für jede Zoneneinteilung ergeben die Zonen plus der nicht zugeordnete Rest das ganze Raster.

Der Beleg meldet außerdem, ohne den Build scheitern zu lassen, ob eine Zelle von zwei Zonen beansprucht wird. Pro Zone vergleicht er den Anteil abgestorbener Bäume aus den Objekten mit dem ausgerichteten 10-m-Totholzraster und mit dem veröffentlichten Anteil, und er zeigt, wie oft die abgeleitete letzte Befliegung mit dem Jahr in der Abdeckungsebene übereinstimmt. Lesen Sie die Datei .qa.md: Oben nennt sie das Gesamtergebnis, PASSED oder FAILED.

Das Panel zeichnet jede Zoneneinteilung aus einer Polygon-Ebene im Raum. Die Objekte dieser Ebene müssen das Schlüsselfeld der Zoneneinteilung — bei Kantonen KANTONSNUM — mit den Werten tragen, die der Datensatz verwendet. Am sichersten laden Sie genau die Shapefiles hoch, aus denen der Datensatz erstellt wurde.

python -m science.room_layers lädt jede Zoneneinteilung eines Datensatzes über die öffentliche API als Polygon-Ebene hoch und weist danach über dieselbe API nach, dass das Wissenschaftspanel sie nutzen kann. Es braucht nur die Python-Standardbibliothek (Python 3.12 oder neuer) und ein Raum-API-Token.

  1. Stellen Sie ein Token aus. Klicken Sie unter Meine Räume auf die Schaltfläche API-Tokens (Schlüssel) des Raums und erstellen Sie ein Token mit den Berechtigungen Lesen und Upload, das nach einem Tag abläuft. Speichern Sie das Geheimnis in einer Datei, die nur Sie lesen können (chmod 600): Das Werkzeug lehnt jede andere Datei ab und gibt das Token nie aus. Siehe Raum-API-Tokens.

  2. Führen Sie das Werkzeug aus — aus python-geo-service/, ein Schritt nach dem anderen, wie unten gezeigt. --api ist der Ursprung der App und --room die ID des Raums, der gefüllt wird; setzen Sie für beide Ihre eigenen Werte ein. apply läuft erst, wenn Sie ihm den Plan-Digest übergeben, den preflight ausgegeben hat.

  3. Widerrufen Sie das Token, wenn Sie fertig sind.

Terminal window
ARGS=(--config science/configs/public-room-v1.json --dataset ../data/science/public-forest-v1.json
--input-root ../data --api <app-origin> --room <room-id>)
python -m science.room_layers plan "${ARGS[@]}" # offline
python -m science.room_layers preflight "${ARGS[@]}" --token-file <file> # read-only; prints the plan digest
python -m science.room_layers apply "${ARGS[@]}" --token-file <file> --expect-plan <digest>
python -m science.room_layers verify "${ARGS[@]}" --token-file <file> # read-only, any time

Jeder Schritt prüft etwas, bevor der nächste laufen darf:

Schritt Prüft
plan Die Shapefile-Teile jeder Zoneneinteilung haben die SHA-256-Werte, die der Datensatz festhält, ihre Schlüsselwerte entsprechen den Zonen des Datensatzes, und das ZIP passt in eine einzige Upload-Anfrage. Gibt den Plan-Digest aus.
preflight Nur lesend. Das Token kann den Raum lesen, die Token-Sperre der API verweigert GET /api/account (fail-closed), und keine Ebene im Raum trägt bereits einen der Namen — Ebenennamen sind pro Raum eindeutig.
apply Führt nur den Plan aus, dessen Digest Sie freigegeben haben: lädt die Ebenen nacheinander hoch, wartet auf die Verarbeitung und führt dann verify aus.
verify Nur lesend. Eine Ebene pro Name, die richtige Objektzahl und der Polygontyp, die Vektorkacheln erzeugt, und die Kacheln tragen genau die Zonenschlüssel des Datensatzes — der einzige Weg, auf dem das Panel eine Zone auf der Karte findet.

Die ausgegebene Zusammenfassung (mit --receipt <file> auch in eine Datei geschrieben) listet die neuen Ebenen-IDs pro Zoneneinteilung. Ihr Exit-Status sagt, wie es ausging: 0 bestanden, 2 eine lokale Prüfung gescheitert, 3 von der API abgelehnt (Token, Berechtigung, Name vergeben, Kontingent), 4 Server- oder Netzwerkfehler, 5 Verifikation gescheitert.

  • Die Ebenen bleiben in der Legende verborgen, außer Sie geben --visible an: Das Panel zeichnet ihre Umrisse selbst, solange es offen ist.
  • Ein Token kann keine Ebenen löschen. Um einen Upload rückgängig zu machen, löscht der Eigentümer die Ebene im Raum.
  • Jeder Upload fügt der Zeitleiste des Raums einen Eintrag Add layer hinzu, erstellt von api-token:<name>.

Sie können eine Zoneneinteilung auch selbst als gezipptes Shapefile über den Reiter Ebene hochladen hochladen — siehe Shapefile hochladen. Verwenden Sie dasselbe Shapefile, aus dem der Datensatz erstellt wurde, damit die Objekte das Schlüsselfeld mit denselben Werten tragen. Niemand prüft das für Sie: Stimmen die Schlüssel nicht überein, zeigt das Panel zwar seine Werte, kann diese Zonen aber auf der Karte weder zeichnen noch wählen lassen.

Den Datensatz laden und die Zoneneinteilungen verknüpfen

Abschnitt betitelt „Den Datensatz laden und die Zoneneinteilungen verknüpfen“
  1. Klicken Sie im Raum rechts in der oberen Leiste auf das Zahnrad — Raumeinstellungen. Den Abschnitt Wissenschaftspanel sehen nur Eigentümer und Bearbeiter. (Dieselben Einstellungen gibt es auch unter Menü → Einstellungen in der linken Leiste.)

  2. Klicken Sie auf Datensatz laden (.json) und wählen Sie die Datensatzdatei. Der Abschnitt zeigt ihren Titel und ihre ID — für den öffentlichen Raum Baumarten und abgestorbene Bäume · public-forest-v1. Eine Datei, die kein gültiger Datensatz ist, wird mit Kein gültiger Wissenschaftsdatensatz: und dem Grund abgelehnt.

  3. Wählen Sie unter Kartenebene für Kantone, Kartenebene für Bezirke und so weiter die Ebene, die jede Zoneneinteilung zeichnet. Eine Ebene, deren Name die Zoneneinteilung erwähnt, ist vorausgewählt — nach ihren Zoneneinteilungen benannte Ebenen verknüpfen sich also von selbst. Keine Kartenebene lässt eine Zoneneinteilung ohne Umrisse.

  4. Wählen Sie optional die Standardzonen und die Standardansicht, mit denen sich das Panel für alle öffnet. Bleiben sie auf —, öffnet es sich mit der ersten Zoneneinteilung ohne übergeordnete Zoneneinteilung, in Zusammensetzung.

  5. Klicken Sie auf Speichern. Für alle im Raum gespeichert. bestätigt es, und die Schaltfläche des Panels erscheint für alle in der Kartenwerkzeugleiste.

  • Das Laden einer Datei füllt nur das Formular aus: Für niemanden ändert sich etwas, bevor Sie Speichern. Das Laden einer Datei setzt außerdem die Ebenen-Verknüpfungen auf die Vorschläge zurück und leert die Standardwerte — prüfen Sie sie also vor dem Speichern.
  • Speichert ein anderer Eigentümer oder Bearbeiter, während Sie bearbeiten, werden Ihre ungespeicherten Änderungen durch seine ersetzt.
  • Datensatz entfernen nimmt das Panel für alle aus dem Raum.
  • Ändert sich der Datensatz, beginnt das Panel bei allen wieder mit den Standardwerten des Raums.

Öffnen Sie das Wissenschaftspanel im Raum und dann:

  • wechseln Sie zwischen den Zoneneinteilungen — jede sollte ihre Umrisse auf der Karte zeichnen;
  • klicken Sie auf eine Zone in der Karte — sie sollte in der Liste ausgewählt werden;
  • öffnen Sie die Lesehilfe — die Quellen und das Erstellungsdatum sollten zum QA-Beleg passen.

Zeigt eine Zoneneinteilung ihre Werte, aber keine Umrisse, ist ihre Ebene nicht verknüpft, oder den Objekten der Ebene fehlt das Schlüsselfeld.

  • 512 KB. Der Raum bewahrt den Datensatz samt Ebenen-Verknüpfungen in seinen Einstellungen auf, bis 512 KB. Ein größerer Datensatz wird abgelehnt, nie gekürzt: Dieser Datensatz ist zu groß, um ihn im Raum zu speichern.
  • Zoneneinteilungen stehen beim Erstellen fest. Eine neue Zoneneinteilung oder neue Grenzen bedeuten, den Datensatz neu zu erstellen. Ein hochgeladenes oder gezeichnetes Polygon auszuwerten, ist nicht möglich.
  • Nach dem Klonen neu verknüpfen. Beim Klonen oder Exportieren eines Raums wird der Datensatz kopiert, aber seine Zonen-Verknüpfungen zeigen weiter auf die Ebenen des ursprünglichen Raums. Verknüpfen Sie sie in der Kopie unter Raumeinstellungen → Wissenschaftspanel neu — siehe Raum exportieren & importieren.
  • Ein strenges Format. Die App akzeptiert höchstens 16 Baumarten, 6 Zoneneinteilungen, 600 Zonen pro Zoneneinteilung, 16 Befliegungsjahre und 64 Quellen, mit Bezeichnungen von bis zu 120 Zeichen in bis zu 8 Sprachen.
  • Nicht im Präsentationsmodus. Die Präsentationsansicht zeigt das Panel nicht.

Das App-Repository dokumentiert den Rest:

  • docs/features/science-panel.md — der Entwurf, der Datensatz-Vertrag und die Kennzahlen;
  • python-geo-service/science/README.md — die Befehle für Builder und Upload und wie man ihre Tests ausführt;
  • python-geo-service/science/configs/public-room-v1.json — die Build-Konfiguration des öffentlichen Raums;
  • app/lib/science/science-dataset.ts — der Parser, der das Format durchsetzt.