Aller au contenu
FR

Attributs des couches — valeurs, couleurs et filtres

Une couche vectorielle importée conserve toutes les colonnes de votre fichier, et la carte s’en sert : cliquer sur une entité affiche ses valeurs, et peut aussi lire les couches raster de la salle sous l’entité ; une couche peut être colorée selon l’un de ses attributs, avec les lignes correspondantes dans la légende ; et quiconque consulte la carte peut filtrer la couche depuis la légende — sans rien changer pour les autres.

Cliquer sur une entité d’une couche importée ouvre une bulle avec les attributs de cette entité : les huit premiers, et Afficher les N attributs pour en voir jusqu’à 50. Les colonnes techniques comme fid sont omises. Les nombres suivent votre langue (0.452 en anglais, 0,452 en français ou en allemand), sans séparateur de milliers, si bien que les identifiants et les années se lisent tels qu’ils sont écrits.

Une bulle d’entité listant des valeurs avec leurs libellés : classe de santé, valeurs NDVI à quatre décimales, score de détection et surface de la couronne en mètres carrés.

Cela fonctionne pour toutes les couches importées. Une couche peut aussi être configurée pour n’afficher que des valeurs choisies, avec des libellés, des décimales et des unités — voir Mise en place. Les formes que vous dessinez dans la salle n’ont pas d’attributs.

Une couche peut aussi être configurée pour que sa bulle lise les couches raster de la salle sous l’entité cliquée, dans une partie à part, Valeurs des couches raster : le NDVI moyen d’une couronne d’arbre tiré d’un raster NDVI, la hauteur moyenne de la canopée d’un peuplement forestier, l’indice de sécheresse sous un champ. Cela fonctionne pour toute couche vectorielle et toute couche raster de la même salle, y compris celles qui sont masquées.

Chaque ligne lit une bande d’un raster, de l’une de deux façons :

  • La cellule sous le clic, pour toute entité.
  • Une statistique sur la forme cliquée, pour les polygones : la moyenne, la médiane, le 10e ou le 90e centile, le minimum, le maximum ou l’écart type de ses cellules, ou le nombre d’entre elles qui contiennent des données. Une cellule compte quand son centre se trouve dans la forme, trous exclus. Une forme trop petite pour contenir le centre d’une cellule lit la cellule qui se trouve dessous.

Une entité linéaire ou ponctuelle n’affiche que la cellule sous le clic. Les statistiques utilisent la forme complète de l’entité, pas la partie dessinée à l’écran.

Les nombres sont les valeurs enregistrées du raster, pas les couleurs de la carte. Les cellules sans données sont omises, et une forme sans aucune donnée affiche Aucune donnée, jamais 0. Une ligne sans libellé propre prend le nom du raster et de ce qu’elle lit, par exemple NDVI des couronnes : moyenne sur la forme.

Contrairement aux valeurs propres de l’entité, les lignes raster sont lues sur le serveur à chaque clic :

La ligne affiche Signification
Lecture… la valeur arrive
Préparation des données… le raster n’a pas été lu depuis un moment, le serveur le récupère donc d’abord ; la ligne redemande d’elle-même
Aucune donnée le raster n’a pas de valeur à cet endroit
Hors du raster l’entité se trouve au-delà du bord du raster
Couche raster introuvable · Plusieurs couches raster portent ce nom la ligne nomme un raster que la salle n’a pas, ou un nom que deux rasters partagent
Le raster n’a pas de bande N la ligne demande une bande que le raster n’a pas
Forme trop grande pour être lue la forme a plus de 5000 sommets, ou couvre plus de cellules qu’une lecture ne peut en contenir
La forme n’a pas pu être chargée · Pas encore prêt ; rouvrez la fenêtre plus tard · Lecture impossible la lecture n’a pas abouti cette fois ; réessayez plus tard

Tous ceux qui peuvent consulter la salle voient ces lignes, y compris les visiteurs d’une salle publique. Les présentations ne les affichent pas.

Au lieu d’une seule couleur, une couche peut tirer ses couleurs d’un attribut :

Type Pour Exemple
Gradué des nombres, répartis en classes entre des seuils NDVI inférieur à 0,20 ; 0,20–0,25 ; 0,25–0,30 … — une valeur égale à un seuil appartient à la classe supérieure
Catégorisé des valeurs nommées des codes d’occupation du sol, chacun avec sa propre couleur, et une couleur pour tout le reste
Continu des nombres, sur un dégradé de couleurs continu l’altitude, du bleu au brun

Les entités sans valeur — valeur absente, vide ou non numérique — reçoivent leur propre couleur « sans valeur ». La légende liste les classes de la couche sous sa ligne, ou bien le dégradé avec ses valeurs extrêmes.

Dans la légende, les lignes de classe d’une couche colorée sont des bascules : cliquez sur l’une d’elles pour masquer ou afficher ses entités. Une couche peut aussi proposer des filtres de plage — deux curseurs pour la plus petite et la plus grande valeur affichées, appliqués quand vous les relâchez.

La légende avec les classes de santé d’une couche, dont une désactivée, et un curseur de score de détection restreint à 0,50–1,00.

Les filtres n’appartiennent qu’à vous :

  • Ils ne changent que votre propre carte. Rien n’est enregistré dans la salle, aucune entrée n’apparaît dans la chronologie, et tous les autres — y compris la personne qui présente — voient toujours toutes les entités.
  • Les lecteurs peuvent aussi filtrer.
  • Un rechargement, ou la diapositive suivante d’une présentation, réaffiche tout.
  • Une plage restreinte masque aussi les entités sans valeur ; la plage complète ne masque rien.
  • Une entité exclue par vos filtres n’est pas dessinée et ne peut pas être cliquée.

La salle n’a pas encore d’éditeur pour cela. Une couche reçoit ces réglages — son affichage des attributs — de l’une de ces trois façons :

  • À l’import, via l’API : ajoutez attributeDisplay au style de POST /api/layers/upload ou de POST /api/layers/process-chunked, ou comme champ de POST /api/rooms/:roomId/layers pour du GeoJSON en ligne.
  • Sur une couche déjà présente dans la salle : envoyez PATCH /api/layers/:layerId avec {"attributeDisplay": …}, à l’aide d’un jeton de salle disposant de write. La carte se met à jour aussitôt et la chronologie enregistre la modification ; null supprime le réglage. Un PATCH remplace tout le réglage : envoyez donc chaque partie que vous voulez garder. Cela fonctionne pour les couches de plus de 100 entités ; une couche plus petite est gardée dans la salle comme une forme dessinée et reçoit son réglage à l’import du fichier ou à l’import d’une salle.
  • Avec un GeoPackage de salle : l’export et l’import conservent l’affichage des attributs de chaque couche, tout comme le clonage d’une salle.

Un exemple pour des couronnes d’arbres qui portent une valeur NDVI et un score de détection :

{
"version": 1,
"popup": {
"mode": "fields",
"fields": [
{ "key": "health_class", "label": "Health class" },
{ "key": "ndvi_mean", "label": "NDVI mean", "decimals": 4 },
{ "key": "detector_score", "label": "Detector score", "decimals": 3 },
{ "key": "area_m2", "label": "Crown area", "decimals": 1, "unit": "m²" }
]
},
"classification": {
"type": "graduated",
"field": "ndvi_mean",
"breaks": [0.2, 0.25, 0.3, 0.4],
"colors": ["#a50026", "#f46d43", "#fee08b", "#66bd63", "#006837"],
"labels": ["Dead", "Severely stressed", "Stressed", "Healthy", "Very healthy"],
"nullColor": "#9aa0a6",
"nullLabel": "No NDVI"
},
"filters": [
{ "type": "range", "field": "detector_score", "label": "Detector score",
"min": 0.2, "max": 1, "step": 0.01, "decimals": 2 }
],
"rasters": [
{ "layer": { "name": "Crown NDVI (2 m raster)" }, "stat": "mean",
"label": "NDVI, 2 m raster: crown mean", "decimals": 4 },
{ "layer": { "name": "Crown NDVI (2 m raster)" }, "stat": "value",
"label": "NDVI, 2 m raster: under the click", "decimals": 4 }
]
}

Les deux lignes rasters lisent la couche raster de la salle nommée « Crown NDVI (2 m raster) » : la moyenne sur la couronne cliquée et la cellule sous le clic.

Enregistré sous crowns-display.json, il s’applique à une couche avec :

Terminal window
curl -X PATCH "$API/api/layers/$LAYER_ID" -H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" -d "{\"attributeDisplay\": $(cat crowns-display.json)}"
Partie Rôle Limites
popup.mode auto : d’abord les champs listés, puis tous les autres · fields : seulement les champs listés · none : aucune valeur (les lignes raster s’affichent quand même) —
popup.fields key, et en option label, decimals (0–10) et unit jusqu’à 40
classification graduated : breaks, une couleur de plus dans colors que de seuils, labels en option · categorical : des categories faites de value, color et label, plus otherColor · continuous : des stops faits de value et color · pour les trois : nullColor et nullLabel pour les entités sans valeur 19 seuils, 64 catégories, 2 à 16 arrêts de couleur
filters des filtres range sur des champs numériques : min et max, et en option step, decimals, unit et initial (la plage affichée au départ) jusqu’à 4
rasters des lignes lues dans une couche raster de la salle : layer (son name exact, son id, ou les deux), band (1 par défaut), stat (value pour la cellule sous le clic ; mean, median, p10, p90, min, max, std ou count sur la forme), et en option label, decimals (0–10) et unit jusqu’à 8, pas deux identiques

Une ligne raster trouve son raster d’abord par son id, puis par son nom exact. Préférez le nom : le clonage ou l’import d’une salle donnent de nouveaux ID aux rasters, et le nom les retrouve quand même.

Les couleurs s’écrivent #rgb ou #rrggbb. Les libellés peuvent compter jusqu’à 64 caractères et les unités 16 ; le réglage complet ne dépasse pas 24 Kio. Un réglage que l’application ne peut pas utiliser est refusé avec 400 invalid_attribute_display et une liste de codes d’erreur dans details, et rien n’est enregistré — corrigez-le et renvoyez-le.