Statistiques zonales

Available with Image Server

L’outil Statistiques zonales récapitule les valeurs d’un raster dans les zones d’un autre jeu de données.

La sortie correspond à une couche d'imagerie hébergée.

Fonctionnement des outils de statistiques zonales

Remarque :

L’outil Statistiques zonales est nommé Synthétiser un raster à l’intérieur dans Map Viewer Classic.

Exemples

Les exemples de scénario d’utilisation de cet outil comprennent les suivants :

• En prenant une couche de limites de bassin versant et une couche de limites d’utilisation du sol par type d’utilisation du sol, calculez la superficie totale du type d’utilisation du sol pour chaque bassin versant.
• En prenant une couche de parcelles dans un comté et une couche de limites de ville, synthétisez la valeur moyenne des parcelles vacantes au sein de chaque limite de ville.

Remarques sur l’utilisation

L’outil Statistiques zonales comprend des configurations pour les couches en entrée, les paramètres d’analyses statistiques et la couche de résultat.

Couches en entrée

Le groupe Input layers (Couches en entrée) comprend les paramètres suivants :

• Le paramètre Input zone raster or features (Entités ou raster de zones en entrée) spécifie l’entrée qui définit les limites des zones, ou des surfaces, à synthétiser. Une zone est définie comme l’ensemble des surfaces en entrée ayant la même valeur. Les surfaces ne sont pas nécessairement contiguës. Vous pouvez utiliser à la fois des données d’entité et de raster pour la zone en entrée.

  Si la zone en entrée est un raster, il doit s’agir d’un raster de type entier. Les zones sont définies par tous les emplacements dans l’entrée dont la valeur de cellule est identique.

  Si la zone en entrée est une entité, elle est convertie en raster en interne en utilisant la taille de cellule et l’alignement de cellule spécifiés par le paramètre Input value raster (Raster de valeurs en entrée).

  Si la zone en entrée est une entité ponctuelle, il se peut qu’elle comporte plusieurs points contenus dans une cellule particulière du raster de valeurs en entrée. Pour de telles cellules, la valeur de zone est déterminée par le point doté du champ ObjectID le plus faible (OID ou FID, par exemple).

• Le paramètre Zone field (Champ de zone) spécifie le champ contenant les valeurs qui définissent chaque zone.

  Il peut s’agir d’un champ de type entier ou chaîne de la couche de zones.

  Lorsque vous spécifiez la zone en entrée, le champ de zone par défaut est le premier champ d’entier ou de texte disponible. S’il n’existe aucun autre champ valide, le champ ObjectID (par exemple, OID ou FID) est utilisé par défaut.

• Le paramètre Input value raster (Raster de valeurs en entrée) indique le raster qui contient les valeurs sur lesquelles calculer une statistique.

  Il peut être de type entier ou à virgule flottante. Toutefois, si son type est à virgule flottante, les options de calcul de la statistique de majorité, de minorité et de variété ne sont pas disponibles.

Les interactions existant entre les paramètres du groupe Input layers (Couches en entrée) sont les suivantes.

• Lorsque la zone ou les valeurs en entrée sont des rasters avec la même taille de cellule et que les cellules sont alignées, elles utilisent directement l’outil et ne sont pas ré-échantillonnées en interne.

• Lorsque la taille de la cellule du raster de zones et du raster de valeurs est différente, la taille de la cellule en sortie correspond au maximum de l’entrée, et le raster de valeurs est utilisé en interne comme raster de capture.

  Si la taille de cellule est identique mais que les cellules ne sont pas alignées, le raster de valeur sert en interne de raster de capture.

  Le groupe Input layers (Couches en entrée) comprend les paramètres suivants :

• Si une zone spécifique ne chevauche aucun centre de cellule du raster de valeur, ces zones ne sont pas converties en raster de zones interne. Ces zones ne sont par conséquent pas représentées et deviennent des zones NoData dans la sortie.

  Vous pouvez gérer cela en déterminant d’abord une résolution de raster appropriée, qui conservera les détails de la zone en entrée, puis en utilisant cette résolution comme taille de cellule dans l’environnement.

  Spécifier une taille de cellule inférieure dans le paramètre d’environnement Cell size (Taille de cellule) génère un raster en sortie plus grand. La résolution supérieure en sortie ne fournira pas nécessairement un résultat d’aussi bonne qualité, car les détails supplémentaires n’existent pas.

• Le paramètre d’environnement Processing extent (Étendue de traitement) a un impact sur la manière dont les couches en entrée sont analysées. Dans les paramètres Environment (Environnement), si le paramètre Processing extent (Étendue de traitement) est défini sur Use current map extent (Utiliser l’étendue courante de la carte), seuls les éléments des couches Input zone raster or features (Entités ou raster de zones en entrée) et Input value raster (Raster de valeurs en entrée) qui sont visibles dans l’étendue courante de la carte sont analysés.

  Si l’environnement Processing extent (Étendue de traitement) est défini sur l’option Default (Par défaut), tous les éléments dans la couche de zones et la couche de valeurs sont analysés, même s’ils se trouvent en dehors de l’étendue courante de la carte.

Paramètres d’analyse statistique

Le groupe Statistical analysis settings (Paramètres d’analyse statistique) inclut les paramètres suivants :

• Le paramètre Statistic type (Type de statistique) spécifie le type de statistique à calculer. La statistique est calculée pour toutes les cellules du raster de valeurs qui appartiennent à la même zone que la cellule en sortie.

  Le type de statistique peut être Majority (Majorité), Maximum, Mean (Moyenne), Median (Médiane), Minimum, Minority (Minorité), Percentile (Centile), Range (Plage), Standard deviation (Écart type), Sum (Somme) ou Variety (Variété). La valeur par défaut est Moyenne.

  Le type de statistique disponible dépend du type de données de la valeur Input value raster (Raster de valeur en entrée) et du type de calcul de statistiques spécifié par le paramètre Calculate circular statistics (Calculer les statistiques circulaires).

  Si les données sont de type entier, le calcul de statistiques arithmétiques prend en charge les options Mean (Moyenne), Majority (Majorité), Maximum, Median (Médiane), Minimum, Minority (Minorité), Percentile (Centile), Range (Plage), Standard deviation (Écart type), Sum (Somme) et Variety (Variété). Le calcul de statistiques circulaires prend en charge les options Mean (Moyenne), Majority (Mojorité), Minority (Minorité), Standard deviation (Écart type) et Variety (Variété).

  Si les données sont de type flottant, le calcul de statistiques arithmétiques prend en charge les options Mean (Moyenne), Maximum, Median (Médiane), Minimum, Percentile (Centile), Range (Plage), Standard deviation (Écart type) et Sum (Somme). Le calcul de statistiques circulaires prend en charge les options Mean (Moyenne) et Standard deviation (Écart type).

  Si la valeur du paramètre Input value raster (Raster de valeurs en entrée) est de type virgule flottante, les calculs pour Majority (Majorité), Minority (Minorité) et Variety (Variété) ne peuvent pas être effectués.

  Pour les calculs de majorité) et de minorité, en cas d’égalité, la sortie correspond à la plus faible des valeurs égales.

• Le paramètre Percentile value (Valeur de centile) spécifie le centile à calculer. La valeur par défaut est de 90, soit le 90e centile.

  La valeur peut être comprise entre 0 et 100. Le résultat obtenu en spécifiant le centile n° 0 équivaut à celui obtenu en spécifiant la statistique minimum, et le 100è centile équivaut à la statistique maximum. Une valeur de 50 donne le même résultat que la statistique médiane.

  Ce paramètre n’est disponible que si le paramètre Statistic type (Type de statistique) est défini sur Percentile (Centile).

• Le paramètre Percentile interpolation type (Type d’interpolation en centile) spécifie la méthode d’interpolation à utiliser lorsque la valeur du centile se situe entre deux valeurs de cellule du raster de valeurs en entrée. Cela peut se produire lorsque le nombre de valeurs du raster en entrée à calculer est pair.

  Le paramètre de cette entrée peut être Auto-detect (Détection automatique), Nearest (La plus proche) ou Linear (Linéaire). La valeur par défaut est Auto-detect (Détection automatique).

  Pour Auto-detect (Détection automatique), si le type de pixel du raster de valeurs en entrée est de type entier, la méthode Nearest (La plus proche) est utilisée. Si le type de pixel du raster de valeurs en entrée est de type virgule flottante, la méthode Linear (Linéaire) est utilisée.

  Pour Nearest (La plus proche), la valeur disponible la plus proche du centile spécifié est utilisée. Dans ce cas, le type de pixel en sortie est identique à celui du raster de valeurs en entrée.

  Pour Linear (Linéaire), la moyenne pondérée des deux valeurs environnantes du centile spécifié est utilisée. Dans ce cas, le type de pixel en sortie est à virgule flottante.

  Ce paramètre n’est disponible que si le paramètre Statistic type (Type de statistique) est défini sur Percentile (Centile).

• Le paramètre Calculate circular statistics(Calculer les statistiques circulaires) indique comment le type de statistique est calculé pour les données circulaires.

  Si ce paramètre n’est pas sélectionné, les statistiques arithmétiques (linéaires) sont calculées. Il s’agit de l’option par défaut.

  Si ce paramètre est sélectionné, les statistiques circulaires sont calculées. Spécifiez une valeur appropriée pour le paramètre Circular wrap value (Valeur de repli circulaire).

  Pour les statistiques circulaires, les options de statistiques circulaires dépendent du type de données de la valeur du paramètre Input value raster (Raster de valeurs en entrée). S’il s’agit du type entier, les options Mean (Moyenne), Majority (Majorité), Minority (Minorité), Standard deviation (Écart type) et Variety (Variété) sont disponibles. S’il s’agit du type virgule flottante, les options Mean (Moyenne) et Standard deviation (Écart type) sont disponibles.

  Les statistiques circulaires sont appropriées aux quantités cycliques, telles que la direction de la boussole en degrés, les journées ou la partie décimale des nombres réels.

• Le paramètre Circular wrap value (Valeur de repli circulaire) spécifie la valeur à utiliser pour arrondir une valeur linéaire sur la plage d’une statistique circulaire donnée. Il s’agit d’un nombre positif. La valeur de repli est la valeur la plus élevée possible (limite supérieure) dans les données cycliques. Cette valeur représente également la même quantité que la valeur possible la plus basse (limite inférieure). La valeur par défaut est 360.

  Ce paramètre n’est disponible que lorsque les statistiques circulaires sont calculées.

• Le paramètre Ignore NoData (Ignorer NoData) indique si les cellules NoData figurant dans le raster de valeurs en entrée sont ignorées dans les résultats des zones auxquelles elles appartiennent.

  Si ce paramètre est sélectionné, dans une zone particulière, seules les cellules ayant une valeur dans le raster de valeurs en entrée sont utilisées pour déterminer la valeur en sortie de cette zone. Les cellules NoData dans le raster de valeurs seront ignorées dans le calcul statistique. Il s’agit de l’option par défaut.

  Si ce paramètre n’est pas sélectionné, dans une zone particulière, s’il existe des cellules NoData dans le raster de valeurs, elles ne sont pas ignorées et leur existence indique que les informations sont insuffisantes pour exécuter des calculs statistiques pour l’ensemble des cellules de cette zone. Par conséquent, toute la zone reçoit la valeur NoData dans le raster en sortie.

• Le paramètre Process as multidimensional (Traiter comme multidimensionnel) spécifie le mode de traitement des rasters en entrée s’il s’agit de rasters multidimensionnels.

  S’il est sélectionné, les statistiques sont calculées à partir de la tranche actuelle du jeu de données multidimensionnelles en entrée.

  S’il n’est pas sélectionné, les statistiques sont calculées pour toutes les dimensions du jeu de données multidimensionnelles en entrée. Il s’agit de l’option par défaut.

Couche de résultat

Le groupe Result layer (Couche de résultat) comprend les paramètres suivants :

• Le paramètre Output raster name (Nom du raster en sortie) spécifie le nom de la couche raster en sortie allant être créée et ajoutée à la carte.

  Le nom doit être unique. Si une couche du même nom existe déjà dans votre organisation, l’outil échoue et vous êtes invité à utiliser un autre nom.

• Le paramètre Save in folder (Enregistrer dans un dossier) indique le nom d’un dossier de My Content (Mon contenu) dans lequel est enregistré le résultat.

Limitations

Les limitations suivantes s’appliquent à l'outil :

Si les données du paramètre Input zone raster or features (Entités ou raster de zones en entrée) contiennent des polygones superposés, l’analyse zonale n’est pas effectuée pour chaque polygone spécifique. Comme l’entité en entrée est convertie en raster, chaque emplacement ne peut avoir qu’une seule valeur.

Environnements

Les paramètres d’environnement d’analyse sont des paramètres supplémentaires qui affectent les résultats d’un outil. Vous pouvez accéder aux paramètres d’environnement d’analyse de l'outil à partir du groupe de paramètres Environment settings (Paramètres d'environnement).

Cet outil respecte les environnements d'analyse suivants :

• Système de coordonnées en sortie
• Etendue de traitement

  Remarque :

  L’étendue de traitement par défaut dans Map Viewer correspond à l’étendue Full extent (Étendue totale). Ce paramètre par défaut diffère de Map Viewer Classic, où Use current map extent (Utiliser l’étendue courante de la carte) est activé par défaut.

• Raster de capture
• Taille de cellule
• Masque
• Facteur de traitement parallèle

Sorties

Cet outil comprend les sorties suivantes :

• Une couche raster affichant le résultat de l’opération de zone

  L’outil Statistiques zonales calcule une statistique à la fois. Pour chaque cellule de la sortie, la valeur représente la valeur calculée pour toutes les cellules en entrée qui correspondent à cette zone.

Licences requises

Cet outil requiert les licences et configurations suivantes :

• Type d’utilisateur Creator ou GIS Professional
• Rôle d’éditeur ou d’administrateur, ou rôle personnalisé équivalent
• ArcGIS Image Server configuré pour l’analyse raster

Ressources

Référez-vous aux ressources suivantes pour en savoir plus :

• Fonctionnement des outils de statistiques zonales dans ArcGIS Pro
• Synthétiser un raster à l’intérieur dans ArcGIS REST API
• summarize_raster_within dans ArcGIS API for Python
• zonal_statistics dans ArcGIS API for Python
• Statistiques zonales (table) dans ArcGIS Enterprise
• Synthétiser un raster à l’intérieur dans ArcGIS Pro avec l’extension Analyse raster
• Statistiques zonales dans ArcGIS Pro avec l’extension Spatial Analyst