Aller au contenu
FR

Créer un jeu de données scientifique

Le panneau scientifique lit un seul fichier : un jeu de données scientifique (comap.science-dataset/v1), enregistré dans les réglages de la salle. Il contient des sommes précalculées par zone, que le panneau additionne dans le navigateur pour les zones que chaque personne choisit. Personne ne l’écrit à la main : un générateur hors ligne le produit à partir des données sources, avec un reçu QA qui vérifie le résultat.

Pour tracer les propres couches raster de la salle en un point que choisit le lecteur, écrivez plutôt une configuration Science : voir Configurer le panneau scientifique.

Préparer une salle demande quatre étapes :

  1. Construire le fichier du jeu de données et examiner son reçu QA.
  2. Importer les polygones des découpages dans la salle, comme couches de carte.
  3. Charger le fichier dans Réglages de la salle → Panneau scientifique, et lier chaque découpage à sa couche.
  4. Vérifier le panneau dans la salle.
Donnée Ce que c’est Dans la salle publique
Carte des essences Un GeoTIFF avec une bande de probabilité par essence, dans le système de coordonnées suisse (EPSG:2056) Cellules de 30 m, 11 bandes : épicéa, sapin, pin, mélèze, arole, hêtre, érable, frêne, chêne, châtaignier, autres
Arbres morts Un GeoPackage des arbres morts détectés par année de vol, chacun avec sa surface dans un champ Area 2017 à 2024 — les mêmes fichiers que les couches Mortality de la salle
Découpages Des shapefiles de polygones, chacun avec un champ clé et, en option, un découpage parent à partir duquel descendre Cantons (KANTONSNUM), Districts (UUID, à l’intérieur des cantons), Écorégions forestières (Code)
Références QA Servent uniquement à vérifier le résultat Le raster du bois mort à 10 m, les parts d’arbres morts publiées et la couche de couverture des vols

Une configuration de construction nomme tout cela et ajoute ce que le panneau affiche : l’identifiant du jeu de données et son titre dans chaque langue, les libellés et groupes des essences, les années de vol avec leur nombre de lignes attendu, et pour chaque découpage ses champs de clé, de nom, de code et de parent. La configuration de la salle publique est python-geo-service/science/configs/public-room-v1.json dans le dépôt de l’application.

Le générateur se trouve dans python-geo-service/science/ du dépôt de l’application. Exécutez-le dans l’image du géo-service, avec les données d’entrée montées en lecture seule :

Terminal window
docker run --rm \
-v "$PWD:/work:ro" \
-v "$PWD/data:/science-input:ro" \
-v "<manifest.json>:/manifest/MANIFEST.json:ro" \
-v "<output dir>:/science-output" \
-w /work/python-geo-service --entrypoint python3 <image> \
-m science.build_dataset --config science/configs/public-room-v1.json \
--input-root /science-input --output-dir /science-output --expect-manifest /manifest/MANIFEST.json
  • Chaque chemin de la configuration est relatif à --input-root et ne peut pas en sortir.
  • --expect-manifest vérifie octet par octet les fichiers d’arbres morts par rapport au manifeste du jeu de données à partir duquel les couches de la salle ont été chargées.

Le générateur calcule l’empreinte de chaque donnée d’entrée et écrit trois fichiers, nommés d’après l’identifiant du jeu de données :

  • Répertoirescience-output/
    • public-forest-v1.json le jeu de données à charger dans la salle
    • public-forest-v1.qa.json le reçu QA, pour les outils
    • public-forest-v1.qa.md le même reçu, à lire

Il ne se termine avec le statut 0 que si chaque contrôle obligatoire a réussi :

  • les données d’entrée n’ont pas changé pendant la construction ;
  • chaque année de vol a le nombre attendu d’arbres morts ;
  • l’Area enregistrée de chaque objet est égale à la surface de sa géométrie ;
  • les fichiers d’arbres morts correspondent au manifeste du jeu de données de la salle (avec --expect-manifest) ;
  • pour chaque découpage, les zones plus le reste hors zone couvrent toute la grille.

Le reçu signale aussi, sans faire échouer la construction, si une cellule est revendiquée par deux zones. Par zone, il compare la part d’arbres morts calculée à partir des objets avec le raster du bois mort à 10 m aligné et avec la part publiée, et il montre à quelle fréquence le dernier vol déduit concorde avec l’année de la couche de couverture. Lisez le fichier .qa.md : en haut, il donne le résultat global, PASSED ou FAILED.

Le panneau dessine chaque découpage à partir d’une couche de polygones de la salle. Les objets de cette couche doivent porter le champ clé du découpage — pour les cantons, KANTONSNUM — avec les valeurs qu’utilise le jeu de données. Le plus sûr est d’importer les shapefiles mêmes à partir desquels le jeu de données a été construit.

python -m science.room_layers importe chaque découpage d’un jeu de données comme couche de polygones via l’API publique, puis prouve via la même API que le panneau scientifique peut l’utiliser. Il ne lui faut que la bibliothèque standard de Python (Python 3.12 ou plus récent) et un jeton d’API de salle.

  1. Émettez un jeton. Dans Mes salles, cliquez sur le bouton Jetons d’API (clé) de la salle et créez un jeton avec les permissions Lecture et Import, qui expire au bout d’un jour. Enregistrez le secret dans un fichier que vous seul pouvez lire (chmod 600) : l’outil refuse tout autre fichier et n’affiche jamais le jeton. Voir Jetons d’API de salle.

  2. Lancez l’outil depuis python-geo-service/, une étape après l’autre, comme ci-dessous. --api est l’origine de l’application et --room l’identifiant de la salle à remplir ; indiquez vos propres valeurs pour les deux. apply ne s’exécute que si vous lui passez l’empreinte du plan affichée par preflight.

  3. Révoquez le jeton une fois terminé.

Terminal window
ARGS=(--config science/configs/public-room-v1.json --dataset ../data/science/public-forest-v1.json
--input-root ../data --api <app-origin> --room <room-id>)
python -m science.room_layers plan "${ARGS[@]}" # offline
python -m science.room_layers preflight "${ARGS[@]}" --token-file <file> # read-only; prints the plan digest
python -m science.room_layers apply "${ARGS[@]}" --token-file <file> --expect-plan <digest>
python -m science.room_layers verify "${ARGS[@]}" --token-file <file> # read-only, any time

Chaque étape vérifie quelque chose avant que la suivante puisse s’exécuter :

Étape Vérifie
plan Les fichiers du shapefile de chaque découpage ont les SHA-256 enregistrés par le jeu de données, ses valeurs de clé correspondent aux zones du jeu de données, et le ZIP tient dans une seule requête d’import. Affiche l’empreinte du plan.
preflight En lecture seule. Le jeton peut lire la salle, le filtre à jetons de l’API refuse GET /api/account (fail-closed), et aucune couche de la salle ne porte déjà l’un des noms — les noms de couche sont uniques dans une salle.
apply N’exécute que le plan dont vous avez approuvé l’empreinte : importe les couches une par une, attend leur traitement, puis lance verify.
verify En lecture seule. Une couche par nom, le bon nombre d’objets et le type polygone, les tuiles vectorielles générées, et des tuiles portant exactement les clés de zone du jeu de données — le seul moyen pour le panneau de trouver une zone sur la carte.

Le résumé qu’il affiche (et écrit dans un fichier avec --receipt <file>) liste les identifiants des nouvelles couches par découpage. Son statut de sortie indique comment il s’est terminé : 0 réussi, 2 un contrôle local a échoué, 3 l’API a refusé (jeton, permission, nom déjà pris, quota), 4 erreur du serveur ou du réseau, 5 la vérification a échoué.

  • Les couches restent masquées dans la légende, sauf si vous ajoutez --visible : le panneau dessine lui-même leurs contours tant qu’il est ouvert.
  • Un jeton ne peut pas supprimer de couches. Pour annuler un import, le propriétaire de la salle supprime la couche dans la salle.
  • Chaque import ajoute une entrée Add layer à la chronologie de la salle, faite par api-token:<name>.

Vous pouvez aussi importer vous-même un découpage, sous forme de shapefile zippé, depuis l’onglet Importer une couche — voir Importer un Shapefile. Utilisez le shapefile à partir duquel le jeu de données a été construit, afin que les objets portent le champ clé avec les mêmes valeurs. Rien ne le vérifie pour vous : si les clés ne correspondent pas, le panneau affiche toujours ses chiffres, mais ne peut ni dessiner ni faire choisir ces zones sur la carte.

Charger le jeu de données et lier les découpages

Section intitulée « Charger le jeu de données et lier les découpages »
  1. Dans la salle, cliquez sur l’engrenage — Réglages de la salle — à droite de la barre du haut. La section Panneau scientifique n’est visible que des propriétaires et des éditeurs. (Les mêmes réglages se trouvent aussi sous Menu → Réglages dans la barre de gauche.)

  2. Cliquez sur Charger un jeu de données (.json) et choisissez le fichier. La section affiche son titre et son identifiant — pour la salle publique, Essences et arbres morts · public-forest-v1. Un fichier qui n’est pas un jeu de données valide est refusé avec Ce n’est pas un jeu de données scientifique valide : suivi de la raison.

  3. Sous Couche de carte pour Cantons, Couche de carte pour Districts, etc., choisissez la couche qui dessine chaque découpage. Une couche dont le nom mentionne le découpage est présélectionnée : les couches nommées d’après leur découpage se lient donc d’elles-mêmes. Aucune couche laisse un découpage sans contours.

  4. Choisissez, si vous le souhaitez, les Zones par défaut et la Vue par défaut sur lesquelles le panneau s’ouvre pour tout le monde. Laissées sur —, il s’ouvre sur le premier découpage sans parent, en Composition.

  5. Cliquez sur Enregistrer. Enregistré pour toute la salle. le confirme, et le bouton du panneau apparaît pour tout le monde dans la barre d’outils de la carte.

  • Charger un fichier ne fait que remplir le formulaire : rien ne change pour personne tant que vous n’avez pas cliqué sur Enregistrer. Charger un fichier réinitialise aussi les liens de couche aux suggestions et efface les valeurs par défaut — vérifiez-les avant d’enregistrer.
  • Si un autre propriétaire ou éditeur enregistre pendant que vous modifiez, vos changements non enregistrés sont remplacés par les siens.
  • Retirer le jeu de données retire le panneau de la salle pour tout le monde.
  • Quand le jeu de données change, le panneau de chacun repart des valeurs par défaut de la salle.

Ouvrez le panneau scientifique dans la salle, puis :

  • passez d’un découpage à l’autre — chacun devrait dessiner ses contours sur la carte ;
  • cliquez sur une zone de la carte — elle devrait être sélectionnée dans la liste ;
  • ouvrez Comment lire — les sources et la date de création devraient correspondre au reçu QA.

Si un découpage affiche ses chiffres mais pas de contours, sa couche n’est pas liée, ou les objets de la couche n’ont pas le champ clé.

  • 512 Ko. La salle conserve le jeu de données, avec ses liens de couche, dans ses réglages, jusqu’à 512 Ko. Un jeu de données plus gros est refusé, jamais tronqué : Ce jeu de données est trop volumineux pour être stocké dans la salle.
  • Les découpages sont fixés à la construction. Un nouveau découpage, ou de nouvelles limites, imposent de reconstruire le jeu de données. L’analyse d’un polygone importé ou dessiné n’est pas disponible.
  • Relier après un clonage. Cloner ou exporter une salle copie le jeu de données, mais ses liens de découpage pointent toujours vers les couches de la salle d’origine. Reliez-les dans la copie, sous Réglages de la salle → Panneau scientifique — voir Exporter et importer une salle.
  • Un format strict. L’application accepte au plus 16 essences, 6 découpages, 600 zones par découpage, 16 années de vol et 64 sources, avec des libellés de 120 caractères au plus, dans 8 langues au plus.
  • Pas en mode présentation. La vue de présentation n’affiche pas le panneau.

Le dépôt de l’application documente le reste :

  • docs/features/science-panel.md — la conception, le contrat du jeu de données et les indicateurs ;
  • python-geo-service/science/README.md — les commandes du générateur et de l’import, et comment lancer leurs tests ;
  • python-geo-service/science/configs/public-room-v1.json — la configuration de construction de la salle publique ;
  • app/lib/science/science-dataset.ts — l’analyseur qui fait respecter le format.