Statistiques de déplacement dimensionnel (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Disponible avec une licence Image Analyst.

Synthèse

Calcule les statistiques sur une fenêtre de déplacement sur des données multidimensionnelles le long d’une dimension spécifiée.

Utilisation

  • Les statistiques de déplacement peuvent également s’appeler statistiques de la fenêtre de déplacement, statistiques de roulement ou statistiques de fonctionnement. Une fenêtre prédéfinie autour de chaque valeur de dimension permet de calculer différentes statistiques avant de passer à la prochaine. Les paramètres Backward Window (Fenêtre arrière) et Forward Window (Fenêtre avant) permettent de définir la taille des fenêtres des deux côtés de la dimension.

  • Le raster en entrée peut uniquement être un raster multidimensionnel au format Cloud Raster Format (fichier .crf).

  • Une seule dimension est traitée par cet outil. Par défaut, la première dimension (autre que x,y) est utilisée comme dimension de traitement.

  • Le type de statistique Circular Mean (Moyenne circulaire) calcule la moyenne des angles ou d’autres quantités cycliques, par exemple la direction de la boussole en degrés. Lorsque cette option est sélectionnée, le paramètre Circular Wrap Value (Valeur d’enroulement circulaire) devient accessible. Utilisez ce paramètre pour désigner une valeur d’enroulement et calculer la moyenne circulaire. Par exemple, pour le calcul d’angle, la valeur d’enroulement circulaire doit être de 360 degrés, ce qui signifie que la valeur 360 sera arrondie à 0, et que la valeur 370 sera arrondie à 10. Vous pouvez également utiliser ce paramètre pour calculer les mois dans une année. Dans ce cas, la valeur d’enroulement circulaire doit être de 12. Dans ce cas, une valeur en entrée de 13 est arrondie à 1.

  • Si le raster multidimensionnel en entrée est un entier, les options valides pour Statistics Type (Type de statistique) sont Mean, Circular Mean (Moyenne circulaire), Majority (Majorité), Maximum, Median (Médiane), Minimum et Percentile (Centile). Si le raster en entrée est de type flottant, l’option Majority (Majorité) n’est pas disponible.

  • Si le raster en entrée est un entier, le raster en sortie est un entier pour les statistiques Majority (Majorité), Maximum et Minimum. La sortie est de type flottant pour Mean (Moyenne), Circular Mean (Moyenne circulaire), Median (Médiane) et Percentile (Centile).

    Si le raster en entrée est de type réel simple, la sortie est un réel simple pour tous les types de statistique disponibles.

  • Pour la statistique Majority (Majorité) du paramètre Statistics Type (Type de statistique), si une valeur de cellule revient le plus souvent dans le voisinage (une valeur unique qui présente la fréquence d’occurrence la plus élevée), cette valeur est renvoyée pour la cellule de traitement. Si au moins deux valeurs de cellule présentent la fréquence d’occurrence la plus élevée (une association parmi les valeurs de cellule), aucune valeur de majorité unique n’est identifiée et la sortie renvoyée pour cette cellule de traitement est NoData.

  • Pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil, reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst.

Paramètres

ÉtiquetteExplicationType de données
Raster multidimensionnel en entrée

Le raster en entrée peut uniquement être un raster multidimensionnel au format Cloud Raster Format (fichier .crf).

Raster Layer
Dimension
(Facultatif)

Le nom de la dimension le long de laquelle la fenêtre va être déplacée.

La valeur par défaut est la première dimension (autre que x,y) trouvée dans le raster multidimensionnel en entrée.

String
Fenêtre arrière
(Facultatif)

La valeur du nombre de coupes avant ou au-dessus à inclure dans la fenêtre définie. La valeur doit être un entier positif compris entre 1 et 100. La valeur par défaut est 1.

L’unité de ce paramètre est la coupe.

Long
Fenêtre avant
(Facultatif)

La valeur du nombre de coupes après ou au-dessous à inclure dans la fenêtre définie. La valeur doit être un entier positif compris entre 1 et 100. La valeur par défaut est 1.

L’unité de ce paramètre est la coupe.

Long
Gestion NoData
(Facultatif)

Précise comment les valeurs NoData sont gérées par le calcul de statistiques.

  • DonnéesLes valeurs NoData de la valeur en entrée sont ignorées dans les résultats de la fenêtre définie dans laquelle elles se trouvent. Il s’agit de l’option par défaut.
  • NoDataLes valeurs en sortie sont de type NoData si des valeurs NoData se trouvent dans l’entrée au sein de la fenêtre définie.
  • Remplir NoDataLes valeurs de cellule NoData sont remplacées à l’aide de la statistique sélectionnée sur les valeurs dans la fenêtre définie.
String
Type de statistique
(Facultatif)

Spécifie le type de statistique à calculer.

  • MoyenneLa moyenne (valeur moyenne) des cellules dans la fenêtre définie va être calculée. Il s’agit de l’option par défaut.
  • Moyenne circulaireLa moyenne circulaire (valeur moyenne) des cellules dans la fenêtre va être calculée. Lorsque ce type de statistique est sélectionné, le paramètre Circular Wrap Value (Valeur d’enroulement circulaire) devient accessible. Utilisez ce paramètre pour désigner une valeur d’enroulement à utiliser.
  • MajoritéLa majorité (valeur la plus fréquente) des cellules dans la fenêtre définie va être identifiée.
  • MaximumLe maximum (valeur la plus élevée) des cellules dans la fenêtre définie va être identifié.
  • MédianeLa médiane des cellules dans la fenêtre définie va être identifiée.
  • MinimumLe minimum (valeur la plus faible) des cellules dans la fenêtre définie va être identifié.
  • CentileUn centile des cellules dans la fenêtre définie est calculé. Le 90è centile est calculé par défaut. Lorsque ce type de statistique est sélectionné, les paramètres Percentile Value (Valeur du centile) et Percentile Interpolation Type (Type d’interpolation en centile) deviennent accessibles. Utilisez ces nouveaux paramètres pour désigner le centile à calculer et choisir le type d’interpolation à utiliser, respectivement.
String
Valeur du centile
(Facultatif)

Valeur de centile qui est calculée. La valeur par défaut est de 90, soit le 90è centile.

La valeur peut être comprise entre 0 et 100. Le centile 0 équivaut sensiblement à la statistique de minimum, tandis que le 100e centile équivaut à la statistique de maximum. La valeur 50 produit essentiellement le même résultat que la statistique médiane.

Ce paramètre est pris en charge uniquement si le paramètre Statistics type (Type de statistique) est défini sur Percentile (Centile).

Double
Percentile Interpolation Type (Type d’interpolation en centile)
(Facultatif)

Définit la méthode d’interpolation à utiliser lorsque la valeur de centile se situe entre deux valeurs de cellule.

Ce paramètre est pris en charge uniquement si le paramètre Statistics type (Type de statistique) est défini sur Median (Médiane) ou Percentile (Centile).

  • Auto-detect (Détection automatique)Si le type de pixel du raster en entrée est entier, la méthode Nearest (La plus proche) est utilisée. Si le type de pixel du raster en entrée est flottant, la méthode Linear (Linéaire) est utilisée.
  • Les plus prochesLa valeur disponible la plus proche du centile va être utilisée. Dans ce cas, le type de pixel en sortie est identique à celui du raster en entrée.
  • LinéaireLa moyenne pondérée des deux valeurs environnantes du centile va être utilisée. Dans ce cas, le type de pixel en sortie est à virgule flottante.
String
Valeur d’enroulement circulaire
(Facultatif)

La valeur utilisée pour arrondir une valeur linéaire sur la plage d’une moyenne circulaire donnée. Sa valeur doit être positive. La valeur par défaut est 360 degrés.

Ce paramètre est pris en charge uniquement si le paramètre Statistics type (Type de statistique) est défini sur Circular Mean (Moyenne circulaire).

Double

Sortie obtenue

ÉtiquetteExplicationType de données
JSON des arguments de la fonction raster

Arguments de la fonction. Cette sortie est réservée à un usage en interne uniquement.

String

Valeur renvoyée

ÉtiquetteExplicationType de données
Raster multidimensionnel en sortie

Le raster en sortie peut uniquement être un raster multidimensionnel au format Cloud Raster Format (fichier .crf).

Raster

DimensionalMovingStatistics(in_raster, {dimension}, {backward_window}, {forward_window}, {nodata_handling}, {statistics_type}, {percentile_value}, {percentile_interpolation_type}, {circular_wrap_value})
NomExplicationType de données
in_raster

Le raster en entrée peut uniquement être un raster multidimensionnel au format Cloud Raster Format (fichier .crf).

Raster Layer
dimension
(Facultatif)

Le nom de la dimension le long de laquelle la fenêtre va être déplacée.

La valeur par défaut est la première dimension (autre que x,y) trouvée dans le raster multidimensionnel en entrée.

String
backward_window
(Facultatif)

La valeur du nombre de coupes avant ou au-dessus à inclure dans la fenêtre définie. La valeur doit être un entier positif compris entre 1 et 100. La valeur par défaut est 1.

L’unité de ce paramètre est la coupe.

Long
forward_window
(Facultatif)

La valeur du nombre de coupes après ou au-dessous à inclure dans la fenêtre définie. La valeur doit être un entier positif compris entre 1 et 100. La valeur par défaut est 1.

L’unité de ce paramètre est la coupe.

Long
nodata_handling
(Facultatif)

Précise comment les valeurs NoData sont gérées par le calcul de statistiques.

  • DATALes valeurs NoData de la valeur en entrée sont ignorées dans les résultats de la fenêtre définie dans laquelle elles se trouvent. Il s’agit de l’option par défaut.
  • NODATALes valeurs en sortie sont de type NoData si des valeurs NoData se trouvent dans l’entrée au sein de la fenêtre définie.
  • FILL_NODATALes valeurs de cellule NoData sont remplacées à l’aide de la statistique sélectionnée sur les valeurs dans la fenêtre définie.
String
statistics_type
(Facultatif)

Spécifie le type de statistique à calculer.

  • MEANLa moyenne (valeur moyenne) des cellules dans la fenêtre définie va être calculée. Il s’agit de l’option par défaut.
  • CIRCULAR_MEANLa moyenne circulaire (valeur moyenne) des cellules dans la fenêtre va être calculée. Lorsque ce type de statistique est sélectionné, utilisez le paramètre circular_wrap_value pour désigner une valeur d’enroulement à utiliser.
  • MAJORITYLa majorité (valeur la plus fréquente) des cellules dans la fenêtre définie va être identifiée.
  • MAXIMUMLe maximum (valeur la plus élevée) des cellules dans la fenêtre définie va être identifié.
  • MEDIANLa médiane des cellules dans la fenêtre définie va être identifiée.
  • MINIMUMLe minimum (valeur la plus faible) des cellules dans la fenêtre définie va être identifié.
  • PERCENTILEUn centile des cellules dans la fenêtre définie est calculé. Le 90è centile est calculé par défaut. Lorsque ce type de statistique est sélectionné, utilisez les paramètres percentile_value et percentile_interpolation_type pour désigner le centile à calculer et choisir le type d’interpolation à utiliser, respectivement.
String
percentile_value
(Facultatif)

Valeur de centile qui est calculée. La valeur par défaut est de 90, soit le 90è centile.

La valeur peut être comprise entre 0 et 100. Le centile 0 équivaut sensiblement à la statistique de minimum, tandis que le 100e centile équivaut à la statistique de maximum. La valeur 50 produit essentiellement le même résultat que la statistique médiane.

Ce paramètre est pris en charge uniquement lorsque le paramètre statistics_type est défini sur PERCENTILE. Si d’autres types de statistique sont spécifiés, ce paramètre est ignoré.

Double
percentile_interpolation_type
(Facultatif)

Définit la méthode d’interpolation à utiliser lorsque la valeur de centile se situe entre deux valeurs de cellule.

Ce paramètre est pris en charge uniquement lorsque le paramètre statistics_type est défini sur MEDIAN ou PERCENTILE. Si d’autres types de statistique sont spécifiés, ce paramètre est ignoré.

  • AUTO_DETECTSi le type de pixel du raster en entrée est entier, la méthode NEAREST est utilisée. Si le type de pixel du raster en entrée est flottant, la méthode LINEAR est utilisée.
  • NEARESTLa valeur disponible la plus proche du centile va être utilisée. Dans ce cas, le type de pixel en sortie est identique à celui du raster en entrée.
  • LINEARLa moyenne pondérée des deux valeurs environnantes du centile va être utilisée. Dans ce cas, le type de pixel en sortie est à virgule flottante.
String
circular_wrap_value
(Facultatif)

La valeur utilisée pour arrondir une valeur linéaire sur la plage d’une moyenne circulaire donnée. Sa valeur doit être positive. La valeur par défaut est 360 degrés.

Ce paramètre est pris en charge uniquement lorsque le paramètre statistics_type est défini sur CIRCULAR_MEAN. Si d’autres types de statistique sont spécifiés, ce paramètre est ignoré.

Double

Valeur renvoyée

NomExplicationType de données
out_raster

Le raster en sortie peut uniquement être un raster multidimensionnel au format Cloud Raster Format (fichier .crf).

Raster

Sortie obtenue

NomExplicationType de données
raster_function_arguments_json

Arguments de la fonction. Cette sortie est réservée à un usage en interne uniquement.

String

Exemple de code

Exemple 1 d’utilisation de l’outil DimensionalMovingStatistics (fenêtre Python)

Cet exemple calcule la valeur moyenne dans une fenêtre composée de trois coupes autour de chaque cellule dans le raster multidimensionnel en entrée.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
out_dimstats = DimensionalMovingStatistics("md_raster.crf", "StdTime", 
                                           1, 1, "NODATA", "MEAN")
out_dimstats.save("C:/sapyexamples/output/DMS01.crf")
Exemple 2 d’utilisation de l’outil DimensionalMovingStatistics (script autonome)

Cet exemple définit la valeur la plus récurrente dans une fenêtre de déplacement composée de cinq coupes autour de chaque cellule dans le raster multidimensionnel en entrée.

# Name: DimensionalMovingStatistics_standalone.py
# Description: Calculates majority on a multidimensional raster 
#                along its time dimension.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Set the analysis environment
env.workspace = "C:/sapyexamples/data"

# Set local variables
in_raster = "mining_location.crf"
dimension = "StdTime"
backward_window = 2
forward_window = 2
nodata_handling = "FILL_NODATA"
statistics_type = "MAJORITY"

# Execute DimensionalMovingStatistics
out_dimstats = DimensionalMovingStatistics(in_raster, dimension, 
                 backward_window, forward_window, nodata_handling, 
                 statistics_type)

# Save the output
out_dimstats.save("C:/sapyexamples/output/mining_location_out.crf")

Informations de licence

  • Basic: Nécessite Spatial Analyst ou Image Analyst
  • Standard: Nécessite Spatial Analyst ou Image Analyst
  • Advanced: Nécessite Spatial Analyst ou Image Analyst

Rubriques connexes