Salta ai contenuti
IT

Configurare il pannello scientifico

Una configurazione Science trasforma i livelli raster di una stanza in grafici. Chi legge sceglie un punto sulla mappa, e il pannello scientifico mostra come vi si sviluppa una misura: lungo gli anni o i mesi, oppure a confronto tra scenari o periodi. La configurazione è un file JSON (comap.science/2) che dice che cos’è ogni livello. Il resto lo ricava il pannello; il file non collega mai un grafico a livelli precisi.

  1. Preparare i livelli: caricare i raster, con nomi univoci e descrizioni delle bande.
  2. Scrivere la configurazione: le misure, le dimensioni, una fonte per livello e le viste.
  3. Caricare la configurazione nelle impostazioni della stanza, oppure con uno script.
  4. Verificare: scegliere alcuni punti.
Ora Più avanti
Dati Livelli raster: un valore per cella, oppure bande lungo gli anni o i mesi Raster di categorie e di classi, oggetti della mappa, tabelle per zona
Luoghi Un punto: la cella memorizzata sotto un clic Zone, un’area disegnata, tutto
Riepiloghi Valore, serie (lungo gli anni o i mesi), confronto (tra scenari o periodi) Composizione, distribuzione, classifica

Alcune cose sono escluse di proposito: formule o livelli derivati, interpolazione, più di quattro serie in un grafico e colori liberi. Un valore mancante è sempre un vuoto, mai uno zero.

  • Carica ogni raster come livello a sé (Caricare un GeoTIFF). Dai a ciascuno un nome univoco e stabile: la configurazione trova i livelli per nome.
  • Una pila di anni o di mesi è un GeoTIFF multibanda, con una banda per anno o per mese. Scrivi l’anno (2020) o il mese nella descrizione di ogni banda: il suo nome in italiano, inglese, tedesco o francese (giugno, June, Juni, juin), oppure il suo numero (6). Il pannello ne ricava l’asse. Una pila senza descrizioni può indicare invece un anno di partenza (vedi Fonti).
  • Imposta il valore nodata nel GeoTIFF, così che le celle vuote si leggano come dati mancanti e non come numeri.

Questo esempio traccia i giorni di caldo per anno, osservati e secondo uno scenario climatico, a confronto con la media di un periodo di riferimento:

{
"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." }
}

Ogni etichetta è testo semplice, ordinato per lingua (en, de, fr, it e così via, al massimo otto). Il pannello mostra la lingua di chi legge, altrimenti l’inglese. Un testo semplice vale come inglese.

Che cosa si misura. unit compare accanto ai valori e decimals (0–6) li arrotonda. direction (higher-worse, lower-worse o neutral) indica come leggerli. zero: true fa partire l’asse dei valori da zero, adatto a conteggi e somme.

Come sono suddivisi i dati:

kind Valori Serve per
categorical Elencati; slot 1–4 sceglie colore e tratteggio di una serie Una sfaccettatura come lo scenario, e le serie di un grafico
interval Elencati, ciascuno con start e end Una sfaccettatura come il periodo, e l’asse di un confronto
year Letti dai dati Le bande di una pila, e l’asse x di una serie
month 1–12, letti dai dati Le bande di una pila, e l’asse x di una serie

Una per livello della stanza. Una fonte indica il suo livello con il nome esatto. Indica anche la sua misura, le sfaccettature che rappresenta (at: un valore per ogni dimensione categoriale o di intervallo) e, per una pila, come scorrono le sue bande:

  • "bands": { "dim": "year", "from": "descriptions" } legge l’anno (o il mese) di ogni banda dalla sua descrizione;
  • "from": "start" con "start": 1981 (e "step", 1 per impostazione predefinita) conta gli anni dalla prima banda;
  • "from": "values" indica un anno o un mese per banda.

Senza bands, una fonte è un valore per cella, letto dalla banda 1 o dalla banda che band indica. Due fonti di questo tipo con la stessa misura e le stesse sfaccettature vengono rifiutate: una cella, un valore.

Ciò che il pannello offre, in quest’ordine. Ogni vista ha un riepilogo (summary), i luoghi a cui si applica (places, per ora point), le misure che mostra (measures, tutte per impostazione predefinita) e le sue dimensioni:

summary x Grafico
series Una dimensione di anni o di mesi Una linea per serie, vuoti nei valori mancanti
comparison Una dimensione categoriale o di intervallo Barre raggruppate
value Nessuna Il valore di ogni serie, in tabella
  • series indica una dimensione categoriale di al massimo quattro valori: una linea o una barra per valore.
  • controls permettono a chi legge di scegliere un valore di un’altra dimensione, per esempio [{ "dim": "period", "default": "2070-2099" }] per il periodo di cui si mostra un profilo mensile.
  • reference è la porzione tracciata per il confronto: una linea orizzontale quando è un valore unico, o una serie tratteggiata quando le sue bande scorrono lungo x. Con "modes": ["overlay", "difference"] il pannello offre anche Differenza rispetto al riferimento.

defaults indica la vista e la misura con cui si apre il pannello, e info contiene il testo di Come leggere in ogni lingua (testo semplice, al massimo 8000 caratteri per lingua).

Non elenchi mai i livelli di una vista. Per una serie, ogni fonte della misura scelta le cui bande scorrono lungo x aggiunge un punto per banda, alla serie in cui la pongono le sue sfaccettature. Per un confronto, ogni fonte a valore unico con una sfaccettatura su x aggiunge una barra. Le scelte di una vista filtrano prima le fonti; una fonte senza sfaccettatura sulla dimensione di una scelta non varia lungo di essa e resta inclusa. Aggiungere un livello a una serie significa quindi aggiungere una fonte, senza toccare la vista.

Al massimo 16 misure, 8 dimensioni, 128 fonti e 16 viste, quattro serie per grafico, etichette di 120 caratteri e 512 KB per l’intero file.

  1. Nella stanza, fai clic sull’ingranaggio — Impostazioni della stanza — a destra della barra in alto. La sezione Configurazione Science è visibile solo a proprietari ed editor, sopra la sezione Pannello scientifico di un set di dati scientifico.

  2. Fai clic su Carica configurazione (.json) e scegli il file. Contiene la configurazione stessa, oppure { "config": …, "bindings": … }.

  3. Un file valido viene salvato subito: Salvata per tutti nella stanza. La sezione mostra quindi il suo titolo e il suo ID, e quanti dei suoi livelli ha trovato (3 livelli su 3 trovati in questa stanza.). Una fonte che non ha trovato alcun livello, o più di uno, viene elencata sotto.

Se il file ha problemi, non viene salvato nulla: Non salvata: 2 problemi nella configurazione., seguito da ogni problema con la sua posizione nel file, per esempio sources[3].measure: unknown_measure. La stanza conserva la configurazione precedente finché non ne viene caricata una valida. Rimuovi configurazione la rimuove per tutti. Finché una stanza ha una configurazione, la sezione Pannello scientifico di un set di dati scientifico è nascosta.

Un token della stanza con il permesso write salva la configurazione via HTTP. Verificala prima con validate, che non salva nulla:

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)}"

Una configurazione non valida viene rifiutata per intero, con 400 invalid_science_config e il percorso di ogni problema. Vedi Pannello scientifico nel riferimento dell’API.

  • Apri il pannello scientifico e scegli un punto all’interno dei dati. Ogni vista dovrebbe mostrare le sue serie, e Come leggere dovrebbe elencare ogni fonte con il suo livello e le sue bande, come 80 bande, 2020–2099.
  • Una fonte senza livello indica nessun livello con questo nome nella stanza, e una pila le cui descrizioni delle bande non sono anni né mesi indica la banda 2 non si legge come anno o mese.
  • Per confrontare un valore con la sua fonte, leggi la stessa cella dal GeoTIFF, per esempio con gdallocationinfo -wgs84 layer.tif LON LAT. Il pannello restituisce il valore memorizzato: nulla viene interpolato.

Chiunque possa vedere la stanza legge la sua configurazione, compresi i visitatori anonimi di una stanza pubblica. Non metterci nomi né indirizzi e-mail.