Résumé
Calcule les statistiques des valeurs d’un raster dans chaque zone d’un autre jeu de données.
Illustration
Utilisation
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 entités et un raster pour la zone en entrée.
Cet outil du portail d’analyse raster est disponible lorsque vous êtes connecté à un portail ArcGIS Enterprise
comportant un ArcGIS Image Server configuré pour Raster Analysis . Lorsque cet outil est appelé, ArcGIS Pro est utilisé comme client et le traitement est effectué dans les serveurs fédérés avec ArcGIS Enterprise. Cet outil du portail prend en charge les couches de votre portail en entrée et crée la sortie dans le portail.La couche raster en entrée prend en charge les éléments suivants : couche du portail, URI ou URL d’un service d’imagerie ou sortie de l’outil Créer une couche de serveur d’imagerie. La couche d’entités en entrée peut être une couche du portail. Il peut également s’agir de l’URI ou de l’URL d’un service d’entités. Cet outil ne prend pas en charge les données raster ou les couches locales. Bien que vous ayez la possibilité d’utiliser des données d’entité et des couches locales en entrée dans cet outil du portail, il est recommandé d’utiliser les couches de votre portail en entrée.
Si la couche de zones en entrée (inputZoneLayer dans Python) est un raster, son type de données doit être entier.
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 du raster de valeurs.
Si la taille de cellule de la couche de zones en entrée (inputZoneLayer dans Python) et de la couche raster en entrée à synthétiser (inputRasterLayertoSummarize dans Python) sont différentes, la taille de cellule en sortie correspond au maximum des entrées 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. L’une de ces cases déclenche un ré-échantillonnage interne avant l’exécution de l’opération zonale.
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 une zone donnée de la couche de zones en entrée ne se superpose à aucun centre de cellule du raster de valeurs en entrée, la valeur de la zone devient NoData. Le cas échéant, déterminez une résolution de raster appropriée, qui conservera les détails de votre zone en entrée, et utilisez cette résolution comme taille de cellule dans l’environnement. L’indication d’une taille de cellule inférieure génère un raster en sortie plus grand. Une sortie avec une résolution élevée ne présente pas nécessairement une qualité supérieure, car les détails supplémentaires n’existent pas réellement dans la couche raster en entrée à synthétiser.
Si la couche de zones en entrée contient des polygones superposés, l’analyse zonale n’est pas effectuée pour chaque polygone individuel. Comme l'entité en entrée est convertie en raster, chaque emplacement peut avoir une seule valeur.
Une méthode alternative consiste à traiter l’opération zonale de façon itérative pour chaque zone du polygone et à assembler les résultats.
Si la couche de zones en entrée est une entité ponctuelle, il est possible qu’une cellule du raster de valeurs en entrée contienne plusieurs points. 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).
Lorsque vous spécifiez la couche de zones 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.
La couche raster en entrée à synthétiser peut être de type entier ou à virgule flottante. Toutefois, lorsque son type est à virgule flottante, les options de calcul de la majorité, de la médiane, de la minorité et de la variété ne sont pas disponibles. Pour les statistiques de majorité et de minorité, lorsqu’il existe un rattachement, la sortie pour la zone est basée sur la plus faible des valeurs associées.
Les types de jeu de données multidimensionnelles pris en charge incluent le service d’imagerie multidimensionnelle.
Syntaxe
SummarizeRasterWithin(inputZoneLayer, zoneField, inputRasterLayertoSummarize, outputName, {statisticType}, {ignoreMissingValues}, {processAsMultidimensional}, {percentileValue})| Paramètre | Explication | Type de données |
inputZoneLayer | Entrée qui définit les zone. Vous pouvez utiliser à la fois des données d’entités et raster pour la zone en entrée. | Raster Layer; Feature Layer |
zoneField | Champ qui définit chaque zone. Il peut s'agir d'un champ de type entier ou chaîne du jeu de données de zones. | String |
inputRasterLayertoSummarize | Raster contenant les valeurs sur lesquelles vous synthétisez une statistique. | Raster Layer |
outputName | Nom du service raster en sortie. Si la couche du service d’imagerie existe déjà, vous êtes invité à fournir un autre nom. | String |
statisticType (Facultatif) | Spécifie le type de statistique à calculer. Les options disponibles lorsque le type de données du raster à synthétiser est entier sont Average (Moyenne), Majority (Majorité), Maximum, Median (Médiane), Minimum, Minority (Minorité), Percentile (Centile), Range (Plage), Standard deviation (Écart type), Sum (Somme) et Variety (Variété). Si le type de données du raster à synthétiser est à virgule flottante, les options sont Average (Moyenne), Maximum, Minimum, Range (Plage), Standard deviation (Écart type) et Sum (Somme).
| String |
ignoreMissingValues (Facultatif) | Spécifie si les valeurs manquantes dans la couche raster à synthétiser seront ignorées dans les résultats des zones dans lesquelles elles se trouvent.
| Boolean |
processAsMultidimensional (Facultatif) | Indique le mode de traitement des rasters en entrée multidimensionnels.
| Boolean |
percentileValue (Facultatif) | Pourcentage à calculer. La valeur par défaut est 90, soit le 90e centile. Les valeurs peuvent varier entre 0 et 100. Le centile 0 est équivalent à la statistique minimale, tandis que le 100e centile équivaut au maximum. La valeur 50 produit essentiellement le même résultat que la statistique médiane. Cette option est uniquement disponible si le paramètre statisticType est défini sur PERCENTILE. | Double |
Sortie dérivée
| Nom | Explication | Type de données |
| outputRaster | Raster en sortie. | Couche raster |
Exemple de code
Cet exemple détermine pour chaque zone la moyenne des valeurs de cellules de la couche raster à synthétiser.
import arcpy
arcpy.SummarizeRasterWithin_ra('https://MyPortal.esri.com/server/rest/services/Hosted/landuse/ImageServer',
'Landuse', 'https://MyPortal.esri.com/server/rest/services/Hosted/elevation/ImageServer',
'outRaster', 'MEAN', 'DATA')Cet exemple détermine pour chaque zone la valeur moyenne de la couche raster à synthétiser.
#-------------------------------------------------------------------------------
# Name: SummarizeRasterWithin_Ex_02.py
# Description: Calculates the maximum sea-surface temperature at different ecological zones.
# Requirements: ArcGIS Image Server
# Import system modules
import arcpy
# Set local variables
inputZoneLayer = 'https://MyPortal.esri.com/server/rest/services/Hosted/zones/ImageServer'
zoneField = 'temperature'
inputRasterLayertoSummarize = 'https://MyPortal.esri.com/server/rest/services/Hosted/seaSurfaceTemperature/ImageServer'
outputName = 'outSSTRaster'
statisticType = 'MAXIMUM'
ignoreMissingValues = ''
processAsMultidimensional = 'ALL_SLICES'
# Execute Multidimensional Summarize Raster Within operation
arcpy.SummarizeRasterWithin_ra(inputZoneLayer, zoneField, inputRasterLayertoSummarize,
outputName, statisticType, ignoreMissingValues)Environnements
Informations de licence
- Basic: Requiert ArcGIS Image Server
- Standard: Requiert ArcGIS Image Server
- Advanced: Requiert ArcGIS Image Server
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?