Raster de synthèse à l'intérieur (Analyse raster)

Synthèse

Calcule les statistiques des valeurs d’un raster dans chaque zone d’un autre jeu de données.

Illustration

Illustration de l’outil Raster de synthèse à l’intérieur

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 de portail d'analyse raster est disponible si vous êtes connecté à un portail ArcGIS EnterpriseArcGIS Image Server est configuré pour l'Analyse raster. Si cet outil est exécuté, ArcGIS Pro est utilisé comme client et le traitement est effectué sur les serveurs fédérés avec ArcGIS Enterprise. L'outil de portail accepte les couches de votre portail en entrée et crée la sortie dans votre portail.

    La couche raster en entrée prend en charge une couche du portail, un URI ou une URL vers un service d'imagerie, ou la sortie de l'outil Make Image Server Layer (Créer une couche de serveur d’imagerie). La couche d'entités en entrée peut correspondre à une couche du portail, un URI ou une URL vers un service d'entités. Cet outil ne prend pas en charge les couches ou données raster locales. Vous pouvez utiliser des couches et données d'entités locales en entrée dans cet outil de portail, mais il est recommandé d’utiliser les couches de votre portail en entrée.

  • Si Input Zone Layer (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 cell size (taille de cellule) dans Input Zone Layer (Couche de zones en entrée) (inputZoneLayer dans Python) et Input Raster Layer to Summarize (Couche raster en entrée à synthétiser) (inputRasterLayertoSummarize dans Python) sont différents, la taille de cellule en sortie correspond à la valeur de Maximum Of Inputs (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 valeurs est utilisé comme raster de capture en interne. L’une de ces cases déclenche un ré-échantillonnage interne avant l’exécution de l’opération zonale.

    Lorsque la zone et 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 du traitement 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 la 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 dans l’entrée 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 valeur 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.

  • Le type de statistique pris en charge dépend du type de données de Raster de valeurs en entrée et du type de calcul statistique spécifié par le paramètre Calculer les statistiques circulaires.

    Si le type de données est un entier, le calcul des statistiques arithmétiques prend en charge les options Moyenne, Majorité, Maximum, Médiane, Minimum, Minorité, Centile, Plage, Écart type, Somme et Variété. Le calcul des statistiques circulaires prend en charge les options Moyenne, Majorité, Minorité, Écart type et Variété.

    Si le type de données est flottant, le calcul des statistiques arithmétiques prend en charge les options Moyenne, Maximum, Médiane, Minimum, Centile, Plage, Écart type et Somme. Le calcul des statistiques circulaires prend en charge les options Moyenne et Écart type.

  • Pour les calculs de la majorité et de la minorité, lorsqu’il existe une association, la sortie est la plus faible des valeurs associées.

  • Pour calculer les statistiques circulaires, sélectionnez le paramètre Calculer les statistiques circulaires (circularCalculation = "CIRCULAR" dans Python), puis spécifiez un nombre pour Valeur de repli circulaire (circularWrapValue dans Python).

Paramètres

ÉtiquetteExplicationType de données
Couche de zones en entrée

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
Champ de zone

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
Couche raster en entrée à synthétiser

Raster contenant les valeurs sur lesquelles vous synthétisez une statistique.

Raster Layer
Nom en sortie

Nom du service raster en sortie.

Si la couche du service d’imagerie existe déjà, vous êtes invité à fournir un autre nom.

String
Type de statistique
(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, Median (Médiane), Minimum, Percentile (Centile), Range (Plage), Standard deviation (Écart type) et Sum (Somme).

  • MoyenneLa moyenne de toutes les cellules de la couche raster à synthétiser appartenant à la même zone que la cellule en sortie, est calculée. Il s’agit de l’option par défaut.
  • MajoritéLa valeur qui revient le plus souvent parmi toutes les cellules de la couche raster à synthétiser appartenant à la même zone que la cellule en sortie, est calculée.
  • MaximumLa valeur la plus élevée de toutes les cellules de la couche raster à synthétiser appartenant à la même zone que la cellule en sortie, est calculée.
  • MédianeLa valeur médiane de toutes les cellules de la couche raster à synthétiser appartenant à la même zone que la cellule en sortie, est calculée.
  • MinimumLa valeur la plus faible de toutes les cellules de la couche raster à synthétiser, appartenant à la même zone que la cellule en sortie, est calculée.
  • MinoritéLa valeur qui revient le moins souvent parmi toutes les cellules de la couche raster à synthétiser appartenant à la même zone que la cellule en sortie, est calculée.
  • CentileLe centile de toutes les cellules du raster de valeurs appartenant à la même zone que la cellule en sortie, est calculé. Le 90è centile est calculé par défaut. Vous pouvez spécifier d’autres valeurs (entre 0 et 100) à l’aide du paramètre Percentile Value (Valeur de centile).
  • PlageL’écart entre la plus petite valeur et la plus grande valeur parmi toutes les cellules de la couche raster à synthétiser appartenant à la même zone que la cellule en sortie, est calculé.
  • Écart typeL’écart type de toutes les cellules de la couche raster à synthétiser, appartenant à la même zone que la cellule en sortie, est calculé.
  • SommeLa valeur totale de toutes les cellules de la couche raster à synthétiser, appartenant à la même zone que la cellule en sortie, est calculée.
  • VariétéLe nombre de valeurs uniques pour toutes les cellules de la couche raster à synthétiser appartenant à la même zone que la cellule en sortie, est calculé.
String
Ignorer les valeurs manquantes
(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.

  • Activé : dans une zone donnée, seules les cellules qui ont une valeur dans la couche raster à synthétiser sont utilisées pour déterminer la valeur en sortie pour cette zone. Les cellules manquantes ou NoData sont ignorées dans le calcul statistique. Il s’agit de l’option par défaut.
  • Désactivé : dans une zone donnée, si des cellules de la couche raster à synthétiser n’ont pas de valeur, elles ne sont pas ignorées et leur existence indique que les informations sont suffisantes pour exécuter des calculs statistiques pour toutes les cellules de la zone. Par conséquent, toute la zone reçoit la valeur NoData dans le raster en sortie.
Boolean
Process as Multidimensional (Traiter comme multidimensionnel)
(Facultatif)

Indique le mode de traitement des rasters en entrée multidimensionnels.

  • Désactivé : 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.
  • Activé : les statistiques sont calculées pour toutes les dimensions (par exemple, temps ou profondeur) de toutes les tranches des rasters de données multidimensionnelles.
Boolean
Valeur du centile
(Facultatif)

Centile à 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.

Ce paramètre est disponible uniquement lors du calcul du centile.

Double
Type d’interpolation en centile
(Facultatif)

Définit 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.

  • Détection automatiqueSi le pixel du raster de valeurs en entrée est de type entier, la méthode La plus proche est utilisée. Si le pixel du raster de valeurs en entrée est de type virgule flottante, la méthode Linéaire est utilisée. Il s’agit de l’option par défaut.
  • Les plus prochesLa valeur disponible la plus proche du centile souhaité sera utilisée. Dans ce cas, le type de pixel en sortie est identique à celui du raster de valeurs en entrée.
  • LinéaireLa moyenne pondérée des deux valeurs environnantes du centile souhaité sera utilisée. Dans ce cas, le type de pixel en sortie est à virgule flottante.
String
Calculer les statistiques circulaires
(Facultatif)

Détermine le mode de calcul du type de statistique.

  • Désactivé : les statistiques arithmétiques sont calculées. Il s’agit de l’option par défaut.
  • Activé : les statistiques circulaires appropriées aux quantités cycliques sont calculées, telles que la direction en degrés, les heures du jour et les parties fractionnaires de nombres réels.
Boolean
Valeur d’enroulement circulaire
(Facultatif)

Valeur la plus élevée possible (limite supérieure) dans les données cycliques. Il s’agit d’un nombre positif, avec une valeur par défaut de 360. Cette valeur représente également la même quantité que la valeur la plus faible possible (limite inférieure).

Ce paramètre s’applique uniquement lorsque les statistiques circulaires sont calculées.

Double

Sortie obtenue

ÉtiquetteExplicationType de données
Raster en sortie

Raster en sortie.

Raster Layer

arcpy.ra.SummarizeRasterWithin(inputZoneLayer, zoneField, inputRasterLayertoSummarize, outputName, {statisticType}, {ignoreMissingValues}, {processAsMultidimensional}, {percentileValue}, {percentileInterpolationType}, {circularCalculation}, {circularWrapValue})
NomExplicationType 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, Median (Médiane), Minimum, Percentile (Centile), Range (Plage), Standard deviation (Écart type) et Sum (Somme).

  • MEANLa moyenne de toutes les cellules de la couche raster à synthétiser appartenant à la même zone que la cellule en sortie, est calculée. Il s’agit de l’option par défaut.
  • MAJORITYLa valeur qui revient le plus souvent parmi toutes les cellules de la couche raster à synthétiser appartenant à la même zone que la cellule en sortie, est calculée.
  • MAXIMUMLa valeur la plus élevée de toutes les cellules de la couche raster à synthétiser appartenant à la même zone que la cellule en sortie, est calculée.
  • MEDIANLa valeur médiane de toutes les cellules de la couche raster à synthétiser appartenant à la même zone que la cellule en sortie, est calculée.
  • MINIMUMLa valeur la plus faible de toutes les cellules de la couche raster à synthétiser, appartenant à la même zone que la cellule en sortie, est calculée.
  • MINORITYLa valeur qui revient le moins souvent parmi toutes les cellules de la couche raster à synthétiser appartenant à la même zone que la cellule en sortie, est calculée.
  • PERCENTILELe centile de toutes les cellules du raster de valeurs appartenant à la même zone que la cellule en sortie, est calculé. Le 90è centile est calculé par défaut. Vous pouvez spécifier d’autres valeurs (entre 0 et 100) à l’aide du paramètre Percentile Value (Valeur de centile).
  • RANGEL’écart entre la plus petite valeur et la plus grande valeur parmi toutes les cellules de la couche raster à synthétiser appartenant à la même zone que la cellule en sortie, est calculé.
  • STDL’écart type de toutes les cellules de la couche raster à synthétiser, appartenant à la même zone que la cellule en sortie, est calculé.
  • SUMLa valeur totale de toutes les cellules de la couche raster à synthétiser, appartenant à la même zone que la cellule en sortie, est calculée.
  • VARIETYLe nombre de valeurs uniques pour toutes les cellules de la couche raster à synthétiser appartenant à la même zone que la cellule en sortie, est calculé.
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.

  • DATADans une zone donnée, seules les cellules qui ont une valeur dans la couche raster à synthétiser sont utilisées pour déterminer la valeur en sortie pour cette zone. Les cellules manquantes ou NoData sont ignorées dans le calcul statistique. Il s’agit de l’option par défaut.
  • NODATADans une zone donnée, si des cellules de la couche raster à synthétiser n’ont pas de valeur, elles ne sont pas ignorées et leur existence indique que les informations sont suffisantes pour exécuter des calculs statistiques pour toutes les cellules de la zone. Par conséquent, toute la zone reçoit la valeur NoData dans le raster en sortie.
Boolean
processAsMultidimensional
(Facultatif)

Indique le mode de traitement des rasters en entrée multidimensionnels.

  • CURRENT_SLICELes statistiques sont calculées à partir de la tranche actuelle du jeu de données multidimensionnelles. Il s’agit de l’option par défaut.
  • ALL_SLICESLes statistiques sont calculées pour toutes les dimensions du jeu de données multidimensionnelles en entrée.
Boolean
percentileValue
(Facultatif)

Centile à 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.

Ce paramètre est disponible uniquement lors du calcul du centile.

Double
percentileInterpolationType
(Facultatif)

Définit 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.

  • AUTO_DETECTSi le pixel du raster de valeurs en entrée est de type entier, la méthode NEAREST est utilisée. Si le pixel du raster de valeurs en entrée est de type virgule flottante, la méthode LINEAR est utilisée. Il s’agit de l’option par défaut.
  • NEARESTLa valeur disponible la plus proche du centile souhaité sera utilisée. Dans ce cas, le type de pixel en sortie est identique à celui du raster de valeurs en entrée.
  • LINEARLa moyenne pondérée des deux valeurs environnantes du centile souhaité sera utilisée. Dans ce cas, le type de pixel en sortie est à virgule flottante.
String
circularCalculation
(Facultatif)

Détermine le mode de calcul du type de statistique.

  • ARITHMETICLes statistiques arithmétiques sont calculées. Il s’agit de l’option par défaut.
  • CIRCULARLes statistiques circulaires appropriées aux quantités cycliques sont calculées, telles que la direction en degrés, les heures du jour et les parties fractionnaires de nombres réels.
Boolean
circularWrapValue
(Facultatif)

Valeur la plus élevée possible (limite supérieure) dans les données cycliques. Il s’agit d’un nombre positif, avec une valeur par défaut de 360. Cette valeur représente également la même quantité que la valeur la plus faible possible (limite inférieure).

Ce paramètre s’applique uniquement lorsque les statistiques circulaires sont calculées.

Double

Sortie obtenue

NomExplicationType de données
outputRaster

Raster en sortie.

Raster Layer

Exemple de code

Exemple 1 d'utilisation de l'outil SummarizeRasterWithin (fenêtre Python)

Cet exemple détermine pour chaque zone la moyenne des valeurs de cellules de la couche raster à synthétiser.

import arcpy
arcpy.ra.SummarizeRasterWithin('https://MyPortal.esri.com/server/rest/services/Hosted/landuse/ImageServer',
                               'Landuse', 'https://MyPortal.esri.com/server/rest/services/Hosted/elevation/ImageServer',
                               'outRaster', 'MEAN', 'DATA')
Exemple 2 d'utilisation de l'outil SummarizeRasterWithin (script autonome)

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.ra.SummarizeRasterWithin(inputZoneLayer, zoneField, inputRasterLayertoSummarize,
                               outputName, statisticType, ignoreMissingValues)

Informations de licence

  • Basic: Nécessite ArcGIS Image Server
  • Standard: Nécessite ArcGIS Image Server
  • Advanced: Nécessite ArcGIS Image Server

Rubriques connexes