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
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.
|
Traiter comme multidimensionnel (facultatif) | Spécifie la méthode de traitement des services d'images multidimensionnels en entrée si ces derniers sont multidimensionnels.
|
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.
Vous avez un commentaire à formuler concernant cette rubrique ?