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.
- Preparare i livelli: caricare i raster, con nomi univoci e descrizioni delle bande.
- Scrivere la configurazione: le misure, le dimensioni, una fonte per livello e le viste.
- Caricare la configurazione nelle impostazioni della stanza, oppure con uno script.
- Verificare: scegliere alcuni punti.
Che cosa permette
Sezione intitolata “Che cosa permette”| 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.
Preparare i livelli
Sezione intitolata “Preparare i livelli”- 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.
Scrivere la configurazione
Sezione intitolata “Scrivere la configurazione”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.
Dimensioni
Sezione intitolata “Dimensioni”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 |
seriesindica una dimensione categoriale di al massimo quattro valori: una linea o una barra per valore.controlspermettono 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 lungox. 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).
Come una vista trova i suoi livelli
Sezione intitolata “Come una vista trova i suoi livelli”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.
Caricarla
Sezione intitolata “Caricarla”Nelle impostazioni della stanza
Sezione intitolata “Nelle impostazioni della stanza”-
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.
-
Fai clic su Carica configurazione (.json) e scegli il file. Contiene la configurazione stessa, oppure
{ "config": …, "bindings": … }. -
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.
Con uno script
Sezione intitolata “Con uno script”Un token della stanza con il permesso write salva la configurazione via HTTP. Verificala prima con
validate, che non salva nulla:
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.
Verificarla
Sezione intitolata “Verificarla”- 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.