Statistiques de déplacement dimensionnel (Outils Image Analyst)
Résumé
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 être appelées statistiques de fenêtre de déplacement, statistiques mobiles ou statistiques en cours. Une fenêtre prédéfinie autour de chaque valeur de dimension est utilisée pour calculer diverses statistiques puis passer à la dimension suivante. Les paramètres Backward Window (Fenêtre arrière) et Forward Window (Fenêtre avant) vous permettent de définir des tailles de fenêtre sur les 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 autres quantités cycliques, telles que la direction de la boussole en degrés. Lorsque cette option est sélectionnée, le paramètre Circular Wrap Value (Valeur de repli circulaire) devient disponible. Utilisez ce paramètre pour désigner une valeur selon laquelle effectuer un repli afin de calculer la moyenne circulaire. Par exemple, pour le calcul de l’angle, la valeur de repli circulaire doit être de 360 degrés, ce qui signifie que la valeur 360 est redéfinie sur 0, et la valeur 370 sur 10. Ce paramètre peut également être utilisé pour les calculs temporels dans une année, auquel cas la valeur de repli circulaire doit être 12. Dans ce cas, une valeur en entrée de 13 est redéfinie sur 1.
Si le raster multidimensionnel en entrée est un entier, les options valides pour Statistics type (Type de statistique) sont Mean (Moyenne), 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 de type entier, le raster en sortie sera de type entier pour les options Majority (Majorité), Maximum et Minimum. Le raster en sortie est de type flottant pour les statistiques Mean (Moyenne), Circular Mean (Moyenne circulaire), Median (Médiane) et Percentile (Centile).
Si le raster en entrée est de type flottant, la sortie est de type flottant pour tous les types de statistiques disponibles.
Pour l’option Majority (Majorité), lorsqu’il existe un rattachement, la sortie est la plus faible des valeurs rattachées.
Le raster en entrée peut uniquement être un raster multidimensionnel au format Cloud Raster Format (fichier .crf).
Raster Layer
Dimension
(Facultatif)
Nom de la dimension le long de laquelle la fenêtre se déplace.
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 des valeurs NoData
(Facultatif)
Indique comment les valeurs NoData sont traitées par le calcul de statistiques.
Données—Les valeurs NoData dans la fenêtre définie sont ignorées lors du calcul de la statistique sélectionnée. Seules les cellules de la fenêtre définie dotées de valeurs de données sont utilisées dans la détermination de la valeur en sortie. Si la cellule de traitement présente une valeur NoData, cette cellule reçoit une valeur dans le raster en sortie, à condition qu’au moins une cellule dans la fenêtre définie présente une valeur valide. Il s’agit de l’option par défaut.
NoData—Les valeurs en sortie sont de type NoData si des valeurs NoData se trouvent dans la fenêtre définie. La présence d’une valeur NoData implique que les informations sont insuffisantes pour déterminer la valeur statistique de la fenêtre définie.
Remplir NoData—Les valeurs de cellule NoData sont remplacées dans la sortie à l’aide de la statistique sélectionnée calculée à partir des valeurs de la fenêtre définie. Les cellules en entrée possédant des valeurs de données restent inchangées dans la sortie.
String
Type de statistique
(Facultatif)
Détermine le type de statistique à calculer.
Moyenne—La 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 circulaire—La moyenne des angles ou d’autres quantités cycliques (direction en degrés, heures du jour ou parties fractionnaires de nombres réels) est calculée. Lorsque ce type de statistique est spécifié, le paramètre Circular Wrap Value (Valeur de repli circulaire) devient disponible. Utilisez ce paramètre pour désigner une valeur de repli.
Majorité—La majorité (valeur la plus fréquente) des cellules dans la fenêtre définie va être identifiée.
Maximum—Le maximum (valeur la plus élevée) des cellules dans la fenêtre définie va être identifié.
Médiane—La médiane des cellules dans la fenêtre définie va être identifiée.
Minimum—Le minimum (valeur la plus faible) des cellules dans la fenêtre définie va être identifié.
Centile—Un 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 de centile) et Percentile Interpolation Type (Type d’interpolation en centile) deviennent disponibles. Utilisez ces nouveaux paramètres afin de désigner le pourcentage à calculer et choisir le type d’interpolation à utiliser, respectivement.
String
Valeur du centile
(Facultatif)
Valeur de centile à calculer. La valeur par défaut est de 90, soit le 90è centile.
La valeur peut être comprise entre 0 et 100. Le centile n° 0 est équivalent à la statistique minimale tandis que le 100e centile équivaut à la statistique maximale. 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 Statistics Type (Type de statistique) est défini sur Percentile (Centile).
Double
Type d’interpolation en centile
(Facultatif)
Spécifie la méthode d’interpolation à utiliser lorsque la valeur de pourcentage 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).
Détection automatique—Si le type de pixel du raster en entrée est entier, la méthode Nearest (Le 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. Il s’agit de l’option par défaut.
Le plus proche—La 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éaire—La 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 de repli circulaire
(Facultatif)
Valeur utilisée pour convertir une valeur linéaire en plage d’une moyenne circulaire donnée. Cette 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 dérivée
Etiqueter
Explication
Type 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 de retour
Etiqueter
Explication
Type de données
Raster multidimensionnel en sortie
Le raster en sortie peut uniquement être un raster multidimensionnel au format Cloud Raster Format (fichier .crf).
Le raster en entrée peut uniquement être un raster multidimensionnel au format Cloud Raster Format (fichier .crf).
Raster Layer
dimension
(Facultatif)
Nom de la dimension le long de laquelle la fenêtre se déplace.
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)
Indique comment les valeurs NoData sont traitées par le calcul de statistiques.
DATA—Les valeurs NoData dans la fenêtre définie sont ignorées lors du calcul de la statistique sélectionnée. Seules les cellules de la fenêtre définie dotées de valeurs de données sont utilisées dans la détermination de la valeur en sortie. Si la cellule de traitement présente une valeur NoData, cette cellule reçoit une valeur dans le raster en sortie, à condition qu’au moins une cellule dans la fenêtre définie présente une valeur valide. Il s’agit de l’option par défaut.
NODATA—Les valeurs en sortie sont de type NoData si des valeurs NoData se trouvent dans la fenêtre définie. La présence d’une valeur NoData implique que les informations sont insuffisantes pour déterminer la valeur statistique de la fenêtre définie.
FILL_NODATA—Les valeurs de cellule NoData sont remplacées dans la sortie à l’aide de la statistique sélectionnée calculée à partir des valeurs de la fenêtre définie. Les cellules en entrée possédant des valeurs de données restent inchangées dans la sortie.
String
statistics_type
(Facultatif)
Détermine le type de statistique à calculer.
MEAN—La 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_MEAN—La moyenne des angles ou d’autres quantités cycliques (direction en degrés, heures du jour ou parties fractionnaires de nombres réels) est calculée. Lorsque ce type de statistique est spécifié, utilisez le paramètre circular_wrap_value pour désigner une valeur de repli.
MAJORITY—La majorité (valeur la plus fréquente) des cellules dans la fenêtre définie va être identifiée.
MAXIMUM—Le maximum (valeur la plus élevée) des cellules dans la fenêtre définie va être identifié.
MEDIAN—La médiane des cellules dans la fenêtre définie va être identifiée.
MINIMUM—Le minimum (valeur la plus faible) des cellules dans la fenêtre définie va être identifié.
PERCENTILE—Un 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 spécifié, 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 à calculer. La valeur par défaut est de 90, soit le 90è centile.
La valeur peut être comprise entre 0 et 100. Le centile n° 0 est équivalent à la statistique minimale tandis que le 100e centile équivaut à la statistique maximale. 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 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)
Spécifie la méthode d’interpolation à utiliser lorsque la valeur de pourcentage se situe entre deux valeurs de cellule.
Ce paramètre est pris en charge uniquement si 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_DETECT—Si 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.
NEAREST—La 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.
LINEAR—La 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)
Valeur utilisée pour convertir une valeur linéaire en plage d’une moyenne circulaire donnée. Cette 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 est défini sur CIRCULAR_MEAN. Si d’autres types de statistique sont spécifiés, ce paramètre est ignoré.
Double
Sortie dérivée
Nom
Explication
Type de données
raster_function_arguments_json
Arguments de la fonction. Cette sortie est réservée à un usage en interne uniquement.
String
Valeur de retour
Nom
Explication
Type de données
out_raster
Le raster en sortie peut uniquement être un raster multidimensionnel au format Cloud Raster Format (fichier .crf).
Raster
Exemple de code
Exemple 1 d’utilisation de la fonction 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.
Exemple 2 d’utilisation de la fonction 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: Image Analyst extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.ia import *
# Set the analysis environment
env.workspace = "C:/iapyexamples/data"
# Set local variables
in_raster = "mining_location.crf"
dimension = "StdTime"
backward_window = 2
forward_window = 2
nodata_handling = "FILL_NODATA"
statistics_type = "MAJORITY"
# Run DimensionalMovingStatistics
out_dimstats = DimensionalMovingStatistics(in_raster, dimension,
backward_window, forward_window, nodata_handling,
statistics_type)
# Save the output
out_dimstats.save("C:/iapyexamples/output/mining_location_out.crf")