Raster de synthèse à l’intérieur

L'outil Summarize Raster Within (Synthétiser un raster à l’intérieur) synthétise les valeurs d'un raster dans les zones d'un autre jeu de données

Remarque :

Cet outil est maintenant disponible dans Map Viewer, l’outil moderne de création de cartes dans ArcGIS Enterprise. Pour en savoir plus, reportez-vous à la rubrique Statistiques zonales.

Pour que cet outil puisse être exécuté, l’organisation doit être configurée pour l’analyse raster.

Si vous ne voyez pas cet outil dans Map Viewer Classic, contactez l’administrateur de votre organisation. Il se peut que votre portail ne soit pas configuré pour l'analyse raster ou que vous ne disposiez pas des privilèges requis pour exécuter l'outil.

Diagramme de workflow

Exemples

Voici quelques exemples d'utilisation de cet outil :

• 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

Si la zone est une entité, elle est convertie en raster en interne à l'aide de la taille de cellule et de l'alignement des cellules du raster de valeurs.

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 au cours de l’exécution de l’outil.

Si la taille de cellule de la zone et le raster de valeurs sont différents, la taille de cellule en sortie correspond à la valeur Maximum Of Inputs (Maximum d’entrées) et le raster de valeurs est utilisé comme raster de capture en interne. 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. L’une de ces cases déclenche un ré-échantillonnage interne avant l’exécution de l’opération zonale.

Si la zone ne se chevauche pas avec le centre des cellules du raster de valeurs, elle devient NoData. Dans ce cas, déterminez une résolution de raster appropriée qui représentera les détails de votre entrée de zone d'entité ou de raster, puis utilisez cette résolution comme taille de cellule des paramètres d'analyse raster de l'environnement.

Si la zone est une entité ponctuelle, il est possible d'avoir plusieurs points contenus dans toute 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).

Si l’option Use current map extent (Utiliser l’étendue actuelle de la carte) est sélectionnée, seules les entités de la couche en entrée et de la couche à synthétiser qui sont visibles au sein de l’étendue courante de la carte seront analysées. Si l'option n'est pas sélectionnée, toutes les entités qui se trouvent à la fois dans la couche en entrée et dans la couche à synthétiser seront analysées, même si elles se trouvent en dehors de l'étendue courante de la carte.

Les paramètres de cet outil sont indiqués dans la table suivante :

Paramètre	Explication
Choisir une couche surfacique pour synthétiser une couche raster au sein des limites définies	Entrée qui définit les limites des zones, ou des surfaces, à synthétiser. Cette entrée peut être un raster d'entiers ou des données d'entité. Pour les rasters, les zones sont définies par tous les emplacements dans l'entrée dont la valeur de cellule est identique. Pour les entités, les zones peuvent être superposées. Les surfaces ne sont pas nécessairement contiguës.
Choisir un champ pour définir les limites	Champ contenant les valeurs qui définissent chaque zone. Il peut s'agir d'un champ de type entier ou chaîne du jeu de données de zones.
Choisir la couche raster à synthétiser	Raster contenant les valeurs sur lesquelles une statistique doit être calculée. Il peut être de type entier ou à virgule flottante. Toutefois, si son type est à virgule flottante, les options de calcul de la majorité, de la minorité et de la variété ne sont pas disponibles.
Choisir les statistiques à calculer (facultatif)	Spécifie le type de statistique à calculer. L'entrée peut être de type : Average (Moyenne), Majority (Majorité), Maximum (Maximum), Median (Médiane), Minimum (Minimum), Minority (Minorité), Percentile (Centile), Range (Plage), Standard deviation (Écart type), Sum (Somme) ou Variety (Variété). La valeur par défaut est Average (Moyenne).
Valeur de centile (facultatif)	Pourcentage à calculer. La valeur par défaut est de 90, soit le 90e centile. La valeur peut être comprise entre 0 et 100. Le fait de spécifier le centile n° 0 est équivalent à la statistique minimale tandis que spécifier le 100e centile équivaut au maximum. Une valeur de 50 donne le même résultat que la statistique médiane. Ce paramètre est pris en charge uniquement si le paramètre Choose statistic to calculate (Choisir les statistiques à calculer) est défini sur Percentile (Centile).
Ignorer les valeurs manquantes dans le calcul (facultatif)	Spécifie si les valeurs manquantes sont ignorées lors de l’analyse. Activé : l’analyse inclut les cellules qui ont une valeur dans le raster de valeurs en entrée au sein d’une zone en particulier 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. Désactivé : le résultat de l’analyse est NoData s’il existe des valeurs NoData pour les cellules du raster de valeurs dans une zone en particulier.
Traiter comme multidimensionnel (facultatif)	Spécifie la méthode de traitement des services d'images multidimensionnels en entrée si ces derniers sont multidimensionnels. Activé : les statistiques sont calculées à partir de la tranche actuelle du jeu de données multidimensionnelles en entrée. Il s’agit de l’option par défaut. Désactivé : les statistiques sont calculées pour toutes les dimensions du jeu de données multidimensionnelles en entrée.
Nom de la couche de résultat	Le nom de la couche qui sera créée dans la page My Content (Mon contenu) et ajoutée à la carte. Le nom par défaut repose sur le nom de l'outil et sur le nom de la couche en entrée. Si la couche existe déjà, vous êtes invité à fournir un autre nom. Vous pouvez spécifier le nom d’un dossier dans My Content (Mon contenu), dans lequel le résultat sera enregistré via la zone de liste déroulante Save result in (Enregistrer le résultat dans).

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 en cliquant sur l'icône représentant un engrenage dans la partie supérieure de la fenêtre de l'outil.

Cet outil respecte les environnements d’analyse suivants :

• Système de coordonnées en sortie : indique le système de coordonnées de la couche en sortie.
• Étendue : indique la surface à utiliser pour l’analyse.
• Raster de capture : ajuste l’étendue de sortie afin qu’elle corresponde à l’alignement des cellules de la couche Snap Raster (Raster de capture) spécifiée.
• Taille de cellule : taille de cellule à utiliser dans la couche en sortie.
• Masque : désigne une couche de masque, où seules les cellules qui se trouvent dans la zone du masque seront utilisées pour l’analyse.
• Facteur de traitement parallèle : contrôle les instances CPU ou GPU du traitement parallèle.

Fonctions raster et outils similaires

Utilisez l'outil Summarize Raster Within (Synthétiser un raster à l’intérieur) pour synthétiser les rasters dans les limites. D’autres outils peuvent vous aider à résoudre des problèmes similaires.

Outils d’analyse et fonctions raster dans Map Viewer Classic

Utilisez l'outil Zonal Statistics As Table (Statistiques zonales (table)) pour synthétiser les rasters dans les limites et afficher les résultats dans une table. La fonction raster Zonal Statistics (Statistiques zonales) effectue une analyse similaire.

Fonctions raster et outils d’analyse ArcGIS Pro

Les outils de géotraitement Zonal Statistics (Statistiques zonales) et Zonal Statistics as Table (Statistiques zonales (table)) sont disponibles dans les boîtes d’outils Image Analyst et Spatial Analyst.

Les outils de géotraitement Summarize Raster Within (Synthétiser un raster à l’intérieur) et Zonal Statistics As Table (Statistiques zonales (table)) sont disponibles dans la boîte d’outils Analyse raster.

L'outil Zonal Statistics (Statistiques zonales) est également disponible sous forme de fonction raster.

Ressources de développeur ArcGIS Enterprise

Si vous utilisez ArcGIS REST API, utilisez les tâches Summarize Raster Within ou Zonal Statistics As Table.

Si vous utilisez ArcGIS API for Python, utilisez summarize_raster_within ou zonal_statistics_as_table à partir du module arcgis.raster.analytics ou utilisez zonal_statistics à partir du module arcgis.raster.functions.gbl.