Aller au contenu
FR

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.

  1. Préparer les couches : importer les rasters, avec des noms uniques et des descriptions de bandes.
  2. Écrire la configuration : les mesures, les dimensions, une source par couche et les vues.
  3. Charger la configuration dans les réglages de la salle, ou par un script.
  4. Vérifier : choisir quelques points.
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.

  • 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.

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.

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
  • series nomme une dimension catégorielle d’au plus quatre valeurs : une ligne ou une barre par valeur.
  • controls laissent 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é.
  • reference est 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 de x. 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).

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.

  1. 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.

  2. Cliquez sur Charger une configuration (.json) et choisissez le fichier. Il contient la configuration elle-même, ou { "config": …, "bindings": … }.

  3. 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.

Un jeton de salle avec la permission write enregistre la configuration par HTTP. Vérifiez-la d’abord avec validate, qui n’enregistre rien :

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

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.

  • 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.