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.
- Vorbereiten: die Rasterebenen hochladen, mit eindeutigen Namen und Bandbeschreibungen.
- Schreiben: die Messgrößen, die Dimensionen, eine Quelle pro Ebene und die Ansichten.
- Laden: in den Raumeinstellungen oder mit einem Skript.
- Prüfen: einige Punkte wählen.
Was sie kann
Abschnitt betitelt „Was sie kann“| 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.
Die Ebenen vorbereiten
Abschnitt betitelt „Die Ebenen vorbereiten“- 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.
Die Konfiguration schreiben
Abschnitt betitelt „Die Konfiguration schreiben“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.
Messgrößen
Abschnitt betitelt „Messgrößen“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.
Dimensionen
Abschnitt betitelt „Dimensionen“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 |
Quellen
Abschnitt betitelt „Quellen“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.
Ansichten
Abschnitt betitelt „Ansichten“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 |
seriesnennt eine kategoriale Dimension mit höchstens vier Werten: eine Linie oder ein Balken pro Wert.controlslassen 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.referenceist der Ausschnitt, der zum Vergleich gezeichnet wird: eine waagrechte Linie, wenn er ein einzelner Wert ist, oder eine gestrichelte Reihe, wenn seine Bänder entlangxverlaufen. 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).
Wie eine Ansicht ihre Ebenen findet
Abschnitt betitelt „Wie eine Ansicht ihre Ebenen findet“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.
Grenzen
Abschnitt betitelt „Grenzen“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.
In den Raumeinstellungen
Abschnitt betitelt „In den Raumeinstellungen“-
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.
-
Klicken Sie auf Konfiguration laden (.json) und wählen Sie die Datei. Sie enthält die Konfiguration selbst oder
{ "config": …, "bindings": … }. -
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.
Mit einem Skript
Abschnitt betitelt „Mit einem Skript“Ein Raum-Token mit der Berechtigung write speichert die Konfiguration über HTTP. Prüfen Sie sie zuerst
mit validate, das nichts speichert:
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.