Rechercher des statistiques d’arguments (Image Analyst)

Disponible avec une licence Image Analyst.

Synthèse

Extrait la valeur de dimension ou l’index de canal auquel une statistique donnée est atteinte pour chaque pixel dans un raster multidimensionnel ou multicanal.

Utilisation

• Utilisez l’outil Rechercher des statistiques d’arguments pour extraire la valeur de dimension (par exemple la date, la hauteur ou la profondeur) à laquelle une statistique en particulier est atteinte dans la pile de rasters dans un jeu de données raster multidimensionnel. Vous pouvez également rechercher le numéro de canal pour lequel la statistique est atteinte dans un raster multicanal.

  Par exemple, vous pouvez rechercher le mois auquel chaque pixel a atteint la température de la surface des océans la plus élevée sur 30 années de collecte de données. Autre exemple : vous avez une image de télédétection de huit canaux et vous souhaitez connaître le canal dans lequel la valeur de réflectance minimale a été atteinte pour chaque pixel.

• Parmi les jeux de données raster multidimensionnel pris en charge se trouvent le format Cloud Raster Format (CRF), les mosaïques multidimensionnelles ou les couches raster multidimensionnelles générées par des fichiers au format netCDF, GRIB ou HDF.

• Cet outil crée un jeu de données raster multidimensionnel au format Cloud Raster Format (CRF). Actuellement, aucun autre format en sortie n’est pris en charge.

• Si le raster multidimensionnel en entrée ne contient qu’une seule dimension, la sortie est un jeu de données raster monobande. Si le raster multidimensionnel en entrée contient plusieurs dimensions, le raster multidimensionnel en sortie inclut les dimensions qui ne figuraient pas dans l’analyse.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Raster multicanal ou multidimensionnel en entrée	Le raster multidimensionnel ou multicanal à analyser.	Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File
Dimension (Facultatif)	La dimension à partir de laquelle extraire la statistique. Si le raster en entrée n’est pas un raster multidimensionnel, ce paramètre n’est pas requis.	String
Définition de la dimension (Facultatif)	Indique comment la statistique est extraite de la dimension. Tous—La statistique est extraite sur toutes les dimensions. Il s’agit de l’option par défaut. Mot-clé d’intervalle—La statistique est extraite de la dimension temporelle selon le mot-clé de l’intervalle.	String
Intervalle de mot-clé (Facultatif)	L’unit de temps pour laquelle extraire la statistique. Admettons que vous ayez cinq années de données quotidiennes de température de surface des océans et que vous vouliez connaître l’année où la température la plus élevée a été observée. Configurez Type de statistiques sur Argument du maximum, Définition de la dimension sur Mot-clé d’intervalle et Intervalle de mot-clé sur Annuel. Si vous souhaitez connaître le mois au cours duquel la température maximale a été observée, vous pouvez également définir Type de statistiques sur Argument du maximum, Définition de la dimension sur Mot-clé d’intervalle et Intervalle de mot-clé sur Récurrence mensuelle. Un raster est généré, dans lequel chaque pixel contient le mois au cours duquel la statistique a été atteinte sur les cinq années (par exemple, 18/08/2018, 25/08/2016, 07/08/2013). Ce paramètre est requis lorsque le paramètre Dimension est défini sur Temps standard et que le paramètre Définition de la dimension a pour valeur Mot-clé de l’intervalle. Récurrence quotidienne—La statistique est extraite des jours. Récurrence hebdomadaire—La statistique est extraite des semaines. Récurrence mensuelle—La statistique est extraite des mois. Récurrence trimestrielle—La statistique est extraite des trimestres. Toutes les heures—La statistique est extraite pour l’heure à laquelle la statistique a été atteinte. Tous les jours—La statistique est extraite pour le jour auquel la statistique a été atteinte. Par semaine—La statistique est extraite pour la semaine à laquelle la statistique a été atteinte. Par mois—La statistique est extraite pour le mois auquel la statistique a été atteinte. Par trimestre—La statistique est extraite pour le trimestre auquel la statistique a été atteinte. Annuelle—La statistique est extraite pour l’année à laquelle la statistique a été atteinte.	String
Variables [info dimension] (Description) (Facultatif)	La variable ou les variables à analyser. Si le raster en entrée n’est pas multidimensionnel, les valeurs de pixel du raster multicanal sont considérées comme la variable. Si le raster en entrée est multidimensionnel et qu’aucune variable n’est spécifiée, toutes les variables avec la dimension sélectionnée sont analysées. Par exemple, pour trouver les années qui ont connu les plus fortes températures, spécifiez la température comme variable à analyser. Si vous ne spécifiez aucune variable et que vous possédez des variables de précipitation et de température, ces deux variables sont analysées et le raster multidimensionnel en sortie inclut alors les deux variables.	String
Type de statistique (Facultatif)	Indique la statistique à extraire de la ou des variables le long de la dimension donnée. Argument du minimum—La valeur de dimension à laquelle la valeur de variable minimale est atteinte est extraite. Il s’agit de l’option par défaut. Argument du maximum—La valeur de dimension à laquelle la valeur de variable maximale est atteinte est extraite. Argument de la médiane—La valeur de dimension à laquelle la valeur de variable médiane est atteinte est extraite. Duration—La valeur de durée de dimension la plus longue entre les valeurs des variables minimale et maximale est extraite. Argument de la valeur—La valeur de dimension à laquelle la valeur de variable spécifiée est atteinte est extraite.	String
Valeur minimale (Facultatif)	La valeur de la variable minimale à utiliser pour extraire la durée. Ce paramètre est requis lorsque le paramètre Type de statistiques est défini sur Durée.	Double
Valeur maximale (Facultatif)	La valeur de la variable maximale à utiliser pour extraire la durée. Ce paramètre est requis lorsque le paramètre Type de statistiques est défini sur Durée.	Double
Valeur d’occurrence multiple (Facultatif)	La valeur de pixel à utiliser pour indiquer qu’une statistique d’argument en particulier a été atteinte plusieurs fois dans le jeu de données raster en entrée. Si elle n’est pas définie, la valeur de pixel correspond à la valeur de la dimension telle qu’indiquée par le paramètre Occurrence, à savoir la première ou la dernière occurrence.	Long
Ignorer NoData (Facultatif)	Spécifie si les valeurs NoData sont ignorées lors de l’analyse. Activé : l’analyse inclut tous les pixels valides selon une dimension donnée et ignore les pixels NoData. Il s’agit de l’option par défaut. Désactivé : le résultat de l’analyse est NoData s’il existe des valeurs NoData pour les pixels selon la dimension donnée.	Boolean
Argument de la valeur (Facultatif)	La valeur à laquelle une comparaison est réalisée pour extraire la valeur de dimension. Ce paramètre est requis lorsque le paramètre Type de statistiques est défini sur Argument de la valeur. La valeur à laquelle une comparaison est réalisée pour extraire la valeur de dimension. Ce paramètre est requis lorsque le paramètre statistics_type est défini sur ARGUMENT_VALUE.	Long
Comparaison (Facultatif)	Indique le type de comparaison à utiliser pour extraire la valeur de dimension. Égal à—La dimension extraite est égale à la valeur définie. Il s’agit de l’option par défaut. Supérieur à—La dimension extraite est supérieure à la valeur définie. Inférieur à—La dimension extraite est inférieure à la valeur définie.	String
Occurrence (Facultatif)	Indique si la valeur de la dimension doit être renvoyée la première fois ou la dernière fois que la statistique d’argument est atteinte. Première occurrence—La valeur de la dimension est renvoyée la première fois que la statistique d’argument est atteinte. Il s’agit de l’option par défaut. Dernière occurrence—La valeur de la dimension est renvoyée la dernière fois que la statistique d’argument est atteinte.	String

Valeur renvoyée

Étiquette	Explication	Type de données
Raster en sortie	Jeu de données raster en sortie.	Raster

Python

FindArgumentStatistics(in_raster, {dimension}, {dimension_def}, {interval_keyword}, {variables}, {statistics_type}, {min}, {max}, {multiple_occurrence}, {ignore_nodata}, {value}, {comparison}, {occurrence})

Nom	Explication	Type de données
in_raster	Le raster multidimensionnel ou multicanal à analyser.	Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File
dimension (Facultatif)	La dimension à partir de laquelle extraire la statistique. Si le raster en entrée n’est pas un raster multidimensionnel, ce paramètre n’est pas requis.	String
dimension_def (Facultatif)	Indique comment la statistique est extraite de la dimension. ALL—La statistique est extraite sur toutes les dimensions. Il s’agit de l’option par défaut. INTERVAL_KEYWORD—La statistique est extraite de la dimension temporelle selon le mot-clé de l’intervalle.	String
interval_keyword (Facultatif)	L’unit de temps pour laquelle extraire la statistique. Admettons que vous ayez cinq années de données quotidiennes de température de surface des océans et que vous vouliez connaître l’année où la température la plus élevée a été observée. Configurez Type de statistiques sur Argument du maximum, Définition de la dimension sur Mot-clé d’intervalle et Intervalle de mot-clé sur Annuel. Si vous souhaitez connaître le mois au cours duquel la température maximale a été observée, vous pouvez également définir Type de statistiques sur Argument du maximum, Définition de la dimension sur Mot-clé d’intervalle et Intervalle de mot-clé sur Récurrence mensuelle. Un raster est généré, dans lequel chaque pixel contient le mois au cours duquel la statistique a été atteinte sur les cinq années (par exemple, 18/08/2018, 25/08/2016, 07/08/2013). Ce paramètre est requis si le paramètre dimension est défini sur StdTime et que le paramètre dimension_def a pour valeur INTERVAL_KEYWORD. RECURRING_DAILY—La statistique est extraite des jours. RECURRING_WEEKLY—La statistique est extraite des semaines. RECURRING_MONTHLY—La statistique est extraite des mois. RECURRING_QUARTERLY—La statistique est extraite des trimestres. HOURLY—La statistique est extraite pour l’heure à laquelle la statistique a été atteinte. DAILY—La statistique est extraite pour le jour auquel la statistique a été atteinte. WEEKLY—La statistique est extraite pour la semaine à laquelle la statistique a été atteinte. MONTHLY—La statistique est extraite pour le mois auquel la statistique a été atteinte. QUARTERLY—La statistique est extraite pour le trimestre auquel la statistique a été atteinte. YEARLY—La statistique est extraite pour l’année à laquelle la statistique a été atteinte.	String
variables [variables,...] (Facultatif)	La variable ou les variables à analyser. Si le raster en entrée n’est pas multidimensionnel, les valeurs de pixel du raster multicanal sont considérées comme la variable. Si le raster en entrée est multidimensionnel et qu’aucune variable n’est spécifiée, toutes les variables avec la dimension sélectionnée sont analysées. Par exemple, pour trouver les années qui ont connu les plus fortes températures, spécifiez la température comme variable à analyser. Si vous ne spécifiez aucune variable et que vous possédez des variables de précipitation et de température, ces deux variables sont analysées et le raster multidimensionnel en sortie inclut alors les deux variables.	String
statistics_type (Facultatif)	Indique la statistique à extraire de la ou des variables le long de la dimension donnée. ARGUMENT_MIN—La valeur de dimension à laquelle la valeur de variable minimale est atteinte est extraite. Il s’agit de l’option par défaut. ARGUMENT_MAX—La valeur de dimension à laquelle la valeur de variable maximale est atteinte est extraite. ARGUMENT_MEDIAN—La valeur de dimension à laquelle la valeur de variable médiane est atteinte est extraite. DURATION—La valeur de durée de dimension la plus longue entre les valeurs des variables minimale et maximale est extraite. ARGUMENT_VALUE—La valeur de dimension à laquelle la valeur de variable spécifiée est atteinte est extraite.	String
min (Facultatif)	La valeur de la variable minimale à utiliser pour extraire la durée. Ce paramètre est requis lorsque le paramètre statistics_type est défini sur DURATION.	Double
max (Facultatif)	La valeur de la variable maximale à utiliser pour extraire la durée. Ce paramètre est requis lorsque le paramètre statistics_type est défini sur DURATION.	Double
multiple_occurrence (Facultatif)	La valeur de pixel à utiliser pour indiquer qu’une statistique d’argument en particulier a été atteinte plusieurs fois dans le jeu de données raster en entrée. Si elle n’est pas définie, la valeur de pixel correspond à la valeur de la dimension telle qu’indiquée par le paramètre occurrence, à savoir la première ou la dernière occurrence.	Long
ignore_nodata (Facultatif)	Spécifie si les valeurs NoData sont ignorées lors de l’analyse. DATA—L’analyse inclut tous les pixels valides selon une dimension donnée et ignore les pixels NoData. Il s’agit de l’option par défaut. NODATA—Le résultat de l’analyse est NoData s’il existe des valeurs NoData pour les pixels selon la dimension donnée.	Boolean
value (Facultatif)	La valeur à laquelle une comparaison est réalisée pour extraire la valeur de dimension. Ce paramètre est requis lorsque le paramètre Type de statistiques est défini sur Argument de la valeur.	Long
comparison (Facultatif)	Indique le type de comparaison à utiliser pour extraire la valeur de dimension. EQUAL_TO—La dimension extraite est égale à la valeur définie. Il s’agit de l’option par défaut. GREATER_THAN—La dimension extraite est supérieure à la valeur définie. SMALLER_THAN—La dimension extraite est inférieure à la valeur définie.	String
occurrence (Facultatif)	Indique si la valeur de la dimension doit être renvoyée la première fois ou la dernière fois que la statistique d’argument est atteinte. FIRST_OCCURRENCE—La valeur de la dimension est renvoyée la première fois que la statistique d’argument est atteinte. Il s’agit de l’option par défaut. LAST_OCCURRENCE—La valeur de la dimension est renvoyée la dernière fois que la statistique d’argument est atteinte.	String

Valeur renvoyée

Nom	Explication	Type de données
out_raster	Jeu de données raster en sortie.	Raster

Exemple de code

Exemple 1 d’utilisation de la fonction FindArgumentStatistics (fenêtre Python)

Cet exemple recherche les valeurs de température et de précipitation mensuelles minimales pour un raster multidimensionnel de série chronologique. Si la même valeur minimale est trouvée plusieurs fois, la valeur de pixel est égale à 99999.

# Import system modules
import arcpy
from arcpy.ia import *

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

# get the date when the minimal precipitation was observed in each year
# as well as the date when the minimal temperature was observed in each year
argStatOutput = FindArgumentStatistics("prcp_temp_time_series.crf", "StdTime", "INTERVAL_KEYWORD", "YEARLY",
	"prcp;temp", "ARGUMENT_MIN", None, None, 0, "DATA")
	
# Save output
argStatOutput.save("C:/data/yearly_min_temp_precip.crf")

Exemple 2 d’utilisation de la fonction FindArgumentStatistics (script autonome)

Cet exemple recherche l’intervalle temporel le plus long pendant lequel la salinité a été comprise entre 10 et 15 unités de mesure dans le raster multidimensionnel.

# Import system modules
import arcpy
from arcpy.ia import *

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

# Define input parameters
inFile = "C:/data/salinity.crf"
dimensionName = "Time"
dimensiondef = "ALL"
intervalkeyword = ''
variables = "temp"
arg_statistics_type = "DURATION"
min_value = 20
max_value = 25
multiple_occurrances_value = None
ignore_nodata = "NODATA"

# Execute 
# get the number of continous slices that have temperature value between 20 and 25
argStatOutput = FindArgumentStatistics(inFile, dimensionName, dimensiondef, intervalkeyword,
	variables, arg_statistics_type, min_value, max_value, multiple_occurrances_value, ignore_nodata)
	
# Save output
argStatOutput.save("C:/data/arg_statistics_output2.crf")

Environnements

Taille de cellule, Compression, Espace de travail courant, Transformations géographiques, NoData, Mot-clé CONFIG en sortie, Système de coordonnées en sortie, Étendue, Facteur de traitement parallèle, Pyramide, Statistiques raster, Méthode de rééchantillonnage, Espace de travail temporaire, Raster de capture, Taille de tuile