Zum Inhalt springen
DE

Wissenschaftspanel konfigurieren

Eine Science-Konfiguration macht aus den Rasterebenen eines Raums Diagramme. Wer liest, wählt einen Punkt auf der Karte, und das Wissenschaftspanel zeigt, wie eine Messgröße dort verläuft: entlang von Jahren oder Monaten, oder im Vergleich zwischen Szenarien oder Perioden. Die Konfiguration ist eine JSON-Datei (comap.science/2), die festhält, was jede Ebene ist. Den Rest ermittelt das Panel selbst; die Datei verdrahtet nie ein Diagramm mit bestimmten Ebenen.

  1. Vorbereiten: die Rasterebenen hochladen, mit eindeutigen Namen und Bandbeschreibungen.
  2. Schreiben: die Messgrößen, die Dimensionen, eine Quelle pro Ebene und die Ansichten.
  3. Laden: in den Raumeinstellungen oder mit einem Skript.
  4. Prüfen: einige Punkte wählen.
Jetzt Später
Daten Rasterebenen: ein Wert pro Zelle oder Bänder entlang von Jahren oder Monaten Kategorie- und Klassenraster, Kartenobjekte, Tabellen pro Zone
Orte Ein Punkt: die gespeicherte Zelle unter einem Klick Zonen, eine gezeichnete Fläche, alles
Zusammenfassungen Wert, Reihe (entlang von Jahren oder Monaten), Vergleich (zwischen Szenarien oder Perioden) Zusammensetzung, Verteilung, Rangfolge

Bewusst nicht vorgesehen sind Formeln oder abgeleitete Ebenen, Interpolation, mehr als vier Reihen in einem Diagramm und freie Farben. Ein fehlender Wert ist immer eine Lücke, nie eine Null.

  • Laden Sie jedes Raster als eigene Ebene hoch (GeoTIFF hochladen). Geben Sie jeder einen eindeutigen, beständigen Namen: Die Konfiguration findet Ebenen über ihren Namen.
  • Ein Stapel von Jahren oder Monaten ist ein mehrbandiges GeoTIFF mit einem Band pro Jahr oder Monat. Schreiben Sie das Jahr (2020) oder den Monat in die Beschreibung jedes Bands: seinen Namen auf Deutsch, Englisch, Französisch oder Italienisch (Juni, June, juin, giugno) oder seine Nummer (6). Das Panel liest die Achse daraus. Ein Stapel ohne Beschreibungen kann stattdessen ein Startjahr angeben (siehe Quellen).
  • Setzen Sie den Nodata-Wert im GeoTIFF, damit leere Zellen als fehlende Daten gelesen werden und nicht als Zahlen.

Dieses Beispiel zeigt die Hitzetage pro Jahr, beobachtet und unter einem Klimaszenario, im Vergleich mit dem Mittel einer Referenzperiode:

{
"schema": "comap.science/2",
"id": "summer-heat",
"title": { "en": "Summer heat", "de": "Sommerhitze", "fr": "Chaleur estivale", "it": "Caldo estivo" },
"measures": [
{ "key": "hot_days", "label": { "en": "Hot days" }, "unit": { "en": "days" },
"decimals": 0, "direction": "higher-worse", "zero": true }
],
"dimensions": [
{ "key": "scenario", "kind": "categorical", "label": { "en": "Scenario" }, "values": [
{ "key": "obs", "label": { "en": "Observed" }, "slot": 1 },
{ "key": "rcp85", "label": { "en": "RCP8.5" }, "slot": 4 }
] },
{ "key": "period", "kind": "interval", "label": { "en": "Period" }, "values": [
{ "key": "1991-2020", "label": { "en": "1991–2020" }, "start": 1991, "end": 2020 }
] },
{ "key": "year", "kind": "year", "label": { "en": "Year" } }
],
"sources": [
{ "key": "obs-yearly", "kind": "raster", "layer": { "name": "Hot days · yearly · observed" },
"measure": "hot_days", "at": { "scenario": "obs" }, "bands": { "dim": "year", "from": "descriptions" } },
{ "key": "rcp85-yearly", "kind": "raster", "layer": { "name": "Hot days · yearly · RCP8.5" },
"measure": "hot_days", "at": { "scenario": "rcp85" }, "bands": { "dim": "year", "from": "descriptions" } },
{ "key": "obs-mean", "kind": "raster", "layer": { "name": "Hot days · 1991–2020 mean" },
"measure": "hot_days", "at": { "scenario": "obs", "period": "1991-2020" } }
],
"views": [
{ "key": "yearly", "label": { "en": "Year by year" }, "summary": "series", "places": ["point"],
"x": "year", "series": "scenario",
"reference": { "at": { "scenario": "obs", "period": "1991-2020" }, "label": { "en": "1991–2020 mean" },
"modes": ["overlay", "difference"] } }
],
"defaults": { "view": "yearly", "measure": "hot_days" },
"info": { "en": "Hot days: days with a maximum above 30 °C, counted per year." }
}

Jede Beschriftung ist reiner Text, nach Sprache geordnet (en, de, fr, it usw., höchstens acht). Das Panel zeigt die Sprache der lesenden Person, sonst Englisch. Ein einfacher Text gilt als Englisch.

Was gemessen wird. unit steht neben den Werten, decimals (0–6) rundet sie. direction (higher-worse, lower-worse oder neutral) hält fest, wie sie zu lesen sind. zero: true lässt die Werteachse bei null beginnen, was zu Zählungen und Summen passt.

Wie die Daten aufgeteilt sind:

kind Werte Verwendet für
categorical Aufgezählt; slot 1–4 wählt Farbe und Strichart einer Reihe Eine Facette wie das Szenario und die Reihen eines Diagramms
interval Aufgezählt, jeweils mit start und end Eine Facette wie die Periode und die Achse eines Vergleichs
year Aus den Daten gelesen Die Bänder eines Stapels und die x-Achse einer Reihe
month 1–12, aus den Daten gelesen Die Bänder eines Stapels und die x-Achse einer Reihe

Eine pro Ebene des Raums. Eine Quelle nennt ihre Ebene mit deren genauem Namen. Sie gibt außerdem ihre Messgröße an, die Facetten, für die sie steht (at: ein Wert pro kategorialer oder Intervall-Dimension), und bei einem Stapel, wie seine Bänder verlaufen:

  • "bands": { "dim": "year", "from": "descriptions" } liest das Jahr (oder den Monat) jedes Bands aus seiner Beschreibung;
  • "from": "start" mit "start": 1981 (und "step", standardmäßig 1) zählt die Jahre ab dem ersten Band;
  • "from": "values" nennt ein Jahr oder einen Monat pro Band.

Ohne bands ist eine Quelle ein Wert pro Zelle, gelesen aus Band 1 oder aus dem Band, das band nennt. Zwei solche Quellen mit derselben Messgröße und denselben Facetten werden abgelehnt: eine Zelle, ein Wert.

Was das Panel anbietet, in dieser Reihenfolge. Jede Ansicht hat eine Zusammenfassung (summary), die Orte, für die sie gilt (places, vorerst point), die Messgrößen, die sie zeigt (measures, standardmäßig alle), und ihre Dimensionen:

summary x Diagramm
series Eine Jahres- oder Monatsdimension Eine Linie pro Reihe, Lücken bei fehlenden Werten
comparison Eine kategoriale oder Intervall-Dimension Gruppierte Balken
value Keine Der Wert jeder Reihe, als Tabelle
  • series nennt eine kategoriale Dimension mit höchstens vier Werten: eine Linie oder ein Balken pro Wert.
  • controls lassen die lesende Person einen Wert einer weiteren Dimension wählen, zum Beispiel [{ "dim": "period", "default": "2070-2099" }] für die Periode, deren Monatsprofil gezeigt wird.
  • reference ist der Ausschnitt, der zum Vergleich gezeichnet wird: eine waagrechte Linie, wenn er ein einzelner Wert ist, oder eine gestrichelte Reihe, wenn seine Bänder entlang x verlaufen. Mit "modes": ["overlay", "difference"] bietet das Panel auch Differenz zur Referenz an.

defaults nennt die Ansicht und die Messgröße, mit denen sich das Panel öffnet, und info enthält den Text der Lesehilfe in jeder Sprache (reiner Text, höchstens 8000 Zeichen pro Sprache).

Sie listen die Ebenen einer Ansicht nie auf. Bei einer Reihe fügt jede Quelle der gewählten Messgröße, deren Bänder entlang x verlaufen, einen Punkt pro Band hinzu, und zwar der Reihe, in die ihre Facetten sie stellen. Bei einem Vergleich fügt jede Einzelwert-Quelle mit einer Facette auf x einen Balken hinzu. Die Steuerelemente einer Ansicht grenzen die Quellen zuerst ein; eine Quelle ohne Facette auf der Dimension eines Steuerelements ändert sich entlang dieser nicht und bleibt dabei. Eine weitere Ebene in einer Reihe ist deshalb nur eine weitere Quelle, ohne Änderung an der Ansicht.

Höchstens 16 Messgrößen, 8 Dimensionen, 128 Quellen und 16 Ansichten, vier Reihen pro Diagramm, Beschriftungen von 120 Zeichen und 512 KB für die ganze Datei.

  1. Klicken Sie im Raum auf das Zahnrad — Raumeinstellungen — rechts in der oberen Leiste. Der Abschnitt Science-Konfiguration ist nur für Eigentümer und Bearbeiter sichtbar, über dem Abschnitt Wissenschaftspanel eines Wissenschaftsdatensatzes.

  2. Klicken Sie auf Konfiguration laden (.json) und wählen Sie die Datei. Sie enthält die Konfiguration selbst oder { "config": …, "bindings": … }.

  3. Eine gültige Datei wird sofort gespeichert: Für alle im Raum gespeichert. Der Abschnitt zeigt dann ihren Titel und ihre ID und wie viele ihrer Ebenen gefunden wurden (3 von 3 Ebenen in diesem Raum gefunden.). Eine Quelle, die keine oder mehr als eine Ebene gefunden hat, wird darunter aufgeführt.

Hat die Datei Probleme, wird nichts gespeichert: Nicht gespeichert: 2 Probleme in der Konfiguration., gefolgt von jedem Problem mit seiner Stelle in der Datei, zum Beispiel sources[3].measure: unknown_measure. Der Raum behält seine bisherige Konfiguration, bis eine gültige geladen wird. Konfiguration entfernen entfernt sie für alle. Solange ein Raum eine Konfiguration hat, ist der Abschnitt Wissenschaftspanel eines Wissenschaftsdatensatzes ausgeblendet.

Ein Raum-Token mit der Berechtigung write speichert die Konfiguration über HTTP. Prüfen Sie sie zuerst mit validate, das nichts speichert:

Terminal window
curl -X POST "$API/api/rooms/$ROOM/science/validate" \
-H "Authorization: Bearer $COMAP_API_TOKEN" -H "Content-Type: application/json" \
-d "{\"config\": $(cat summer-heat.json)}"
curl -X PUT "$API/api/rooms/$ROOM/science" \
-H "Authorization: Bearer $COMAP_API_TOKEN" -H "Content-Type: application/json" \
-d "{\"config\": $(cat summer-heat.json)}"

Eine ungültige Konfiguration wird als Ganzes abgelehnt, mit 400 invalid_science_config und dem Pfad jedes Problems. Siehe Wissenschaftspanel in der API-Referenz.

  • Öffnen Sie das Wissenschaftspanel und wählen Sie einen Punkt innerhalb der Daten. Jede Ansicht sollte ihre Reihen zeigen, und die Lesehilfe sollte jede Quelle mit ihrer Ebene und ihren Bändern aufführen, etwa 80 Bänder, 2020–2099.
  • Eine Quelle ohne Ebene zeigt keine Ebene mit diesem Namen im Raum, und ein Stapel, dessen Bandbeschreibungen keine Jahre oder Monate sind, zeigt Band 2 lässt sich nicht als Jahr oder Monat lesen.
  • Um einen Wert mit seiner Quelle zu vergleichen, lesen Sie dieselbe Zelle aus dem GeoTIFF, zum Beispiel mit gdallocationinfo -wgs84 layer.tif LON LAT. Das Panel liefert den gespeicherten Wert: Nichts wird interpoliert.

Alle, die den Raum sehen können, lesen seine Konfiguration, auch anonyme Gäste eines öffentlichen Raums. Halten Sie Namen und E-Mail-Adressen aus ihr heraus.