Configurer le panneau scientifique
Une configuration Science transforme les couches raster d’une salle en graphiques. Le lecteur choisit
un point sur la carte, et le panneau scientifique
montre comment une mesure y évolue : au fil des années ou des mois, ou en comparaison entre scénarios ou
périodes. La configuration est un fichier JSON (comap.science/2) qui dit ce qu’est chaque couche.
Le panneau déduit le reste ; le fichier ne relie jamais un graphique à des couches précises.
- Préparer les couches : importer les rasters, avec des noms uniques et des descriptions de bandes.
- Écrire la configuration : les mesures, les dimensions, une source par couche et les vues.
- Charger la configuration dans les réglages de la salle, ou par un script.
- Vérifier : choisir quelques points.
Ce qu’elle permet
Section intitulée « Ce qu’elle permet »| Aujourd’hui | Plus tard | |
|---|---|---|
| Données | Couches raster : une valeur par cellule, ou des bandes au fil des années ou des mois | Rasters de catégories et de classes, objets de la carte, tableaux par zone |
| Lieux | Un point : la cellule stockée sous un clic | Des zones, une surface dessinée, l’ensemble |
| Résumés | Valeur, série (au fil des années ou des mois), comparaison (entre scénarios ou périodes) | Composition, distribution, classement |
Certaines choses sont exclues à dessein : les formules ou couches dérivées, l’interpolation, plus de quatre séries dans un graphique et les couleurs libres. Une valeur manquante est toujours un trou, jamais un zéro.
Préparer les couches
Section intitulée « Préparer les couches »- Importez chaque raster comme une couche distincte (Importer un GeoTIFF). Donnez à chacune un nom unique et stable : la configuration trouve les couches par leur nom.
- Une pile d’années ou de mois est un GeoTIFF multibande, avec une bande par année ou par mois.
Écrivez l’année (
2020) ou le mois dans la description de chaque bande : son nom en français, anglais, allemand ou italien (juin,June,Juni,giugno), ou son numéro (6). Le panneau en tire l’axe. Une pile sans descriptions peut indiquer une année de départ à la place (voir Sources). - Définissez la valeur nodata dans le GeoTIFF, pour que les cellules vides se lisent comme des données manquantes et non comme des nombres.
Écrire la configuration
Section intitulée « Écrire la configuration »Cet exemple trace le nombre de jours de chaleur par année, observé et selon un scénario climatique, comparé à la moyenne d’une période de référence :
{ "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." }}Chaque libellé est du texte brut, classé par langue (en, de, fr, it, etc., huit au plus). Le
panneau affiche la langue du lecteur, sinon l’anglais. Un texte simple compte comme de l’anglais.
Ce qui est mesuré. unit s’affiche à côté des valeurs, et decimals (0–6) les arrondit. direction
(higher-worse, lower-worse ou neutral) indique comment les lire. zero: true fait partir l’axe des
valeurs de zéro, ce qui convient aux comptages et aux sommes.
Dimensions
Section intitulée « Dimensions »Comment les données sont découpées :
kind |
Valeurs | Sert à |
|---|---|---|
categorical |
Énumérées ; slot 1–4 choisit la couleur et le tracé d’une série |
Une facette comme le scénario, et les séries d’un graphique |
interval |
Énumérées, chacune avec start et end |
Une facette comme la période, et l’axe d’une comparaison |
year |
Lues dans les données | Les bandes d’une pile, et l’axe x d’une série |
month |
1–12, lus dans les données | Les bandes d’une pile, et l’axe x d’une série |
Une par couche de la salle. Une source désigne sa couche par son nom exact. Elle indique aussi sa
mesure, les facettes qu’elle représente (at : une valeur par dimension catégorielle ou
d’intervalle) et, pour une pile, comment courent ses bandes :
"bands": { "dim": "year", "from": "descriptions" }lit l’année (ou le mois) de chaque bande dans sa description ;"from": "start"avec"start": 1981(et"step", 1 par défaut) compte les années depuis la première bande ;"from": "values"donne une année ou un mois par bande.
Sans bands, une source est une valeur par cellule, lue dans la bande 1 ou dans la bande que nomme
band. Deux sources de ce type avec la même mesure et les mêmes facettes sont refusées : une cellule, une
valeur.
Ce que le panneau propose, dans cet ordre. Chaque vue a un résumé (summary), les lieux auxquels elle
s’applique (places, point pour l’instant), les mesures qu’elle montre (measures, toutes par défaut)
et ses dimensions :
summary |
x |
Graphique |
|---|---|---|
series |
Une dimension d’années ou de mois | Une ligne par série, des trous aux valeurs manquantes |
comparison |
Une dimension catégorielle ou d’intervalle | Des barres groupées |
value |
Aucune | La valeur de chaque série, en tableau |
seriesnomme une dimension catégorielle d’au plus quatre valeurs : une ligne ou une barre par valeur.controlslaissent le lecteur choisir une valeur d’une autre dimension, par exemple[{ "dim": "period", "default": "2070-2099" }]pour la période dont un profil mensuel est montré.referenceest la tranche tracée pour comparer : une ligne horizontale quand c’est une valeur unique, ou une série pointillée quand ses bandes courent le long dex. Avec"modes": ["overlay", "difference"], le panneau propose aussi Différence par rapport à la référence.
defaults nomme la vue et la mesure sur lesquelles le panneau s’ouvre, et info contient le texte de
Comment lire dans chaque langue (texte brut, 8000 caractères au plus par langue).
Comment une vue trouve ses couches
Section intitulée « Comment une vue trouve ses couches »Vous ne listez jamais les couches d’une vue. Pour une série, chaque source de la mesure choisie dont les
bandes courent le long de x ajoute un point par bande, à la série où la placent ses facettes. Pour une
comparaison, chaque source à valeur unique ayant une facette sur x ajoute une barre. Les choix d’une vue
filtrent d’abord les sources ; une source sans facette sur la dimension d’un choix ne varie pas selon elle
et reste incluse. Ajouter une couche à une série revient donc à ajouter une source, sans toucher à la vue.
Au plus 16 mesures, 8 dimensions, 128 sources et 16 vues, quatre séries par graphique, des libellés de 120 caractères et 512 Ko pour tout le fichier.
La charger
Section intitulée « La charger »Dans les réglages de la salle
Section intitulée « Dans les réglages de la salle »-
Dans la salle, cliquez sur l’engrenage — Réglages de la salle — à droite de la barre du haut. La section Configuration Science n’est visible que des propriétaires et des éditeurs, au-dessus de la section Panneau scientifique d’un jeu de données scientifique.
-
Cliquez sur Charger une configuration (.json) et choisissez le fichier. Il contient la configuration elle-même, ou
{ "config": …, "bindings": … }. -
Un fichier valide est enregistré aussitôt : Enregistrée pour tous dans la salle. La section affiche alors son titre et son identifiant, et combien de ses couches ont été trouvées (3 couches sur 3 trouvées dans cette salle.). Une source qui n’a trouvé aucune couche, ou plusieurs, est listée en dessous.
Si le fichier a des problèmes, rien n’est enregistré : Non enregistrée : 2 problèmes dans la
configuration., suivi de chaque problème avec sa place dans le fichier, par exemple
sources[3].measure: unknown_measure. La salle garde sa configuration précédente jusqu’à ce qu’une
configuration valide soit chargée. Supprimer la configuration la supprime pour tous. Tant qu’une
salle a une configuration, la section Panneau scientifique d’un jeu de données scientifique est
masquée.
Par un script
Section intitulée « Par un script »Un jeton de salle avec la permission write enregistre la configuration par HTTP. Vérifiez-la d’abord
avec validate, qui n’enregistre rien :
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)}"Une configuration invalide est refusée en bloc, avec 400 invalid_science_config et le chemin de chaque
problème. Voir Panneau scientifique dans la référence de l’API.
La vérifier
Section intitulée « La vérifier »- Ouvrez le panneau scientifique et choisissez un point à l’intérieur des données. Chaque vue doit montrer ses séries, et Comment lire doit lister chaque source avec sa couche et ses bandes, par exemple 80 bandes, 2020–2099.
- Une source sans couche affiche aucune couche de ce nom dans la salle, et une pile dont les descriptions de bandes ne sont ni des années ni des mois affiche la bande 2 ne se lit pas comme une année ou un mois.
- Pour comparer une valeur à sa source, lisez la même cellule dans le GeoTIFF, par exemple avec
gdallocationinfo -wgs84 layer.tif LON LAT. Le panneau renvoie la valeur stockée : rien n’est interpolé.
Toute personne qui voit la salle lit sa configuration, y compris les visiteurs anonymes d’une salle publique. N’y mettez ni noms ni adresses e-mail.