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

ÉtiquetteExplicationType 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.

  • TousLa statistique est extraite sur toutes les dimensions. Il s’agit de l’option par défaut.
  • Mot-clé d’intervalleLa 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 quotidienneLa statistique est extraite des jours.
  • Récurrence hebdomadaireLa statistique est extraite des semaines.
  • Récurrence mensuelleLa statistique est extraite des mois.
  • Récurrence trimestrielleLa statistique est extraite des trimestres.
  • Toutes les heuresLa statistique est extraite pour l’heure à laquelle la statistique a été atteinte.
  • Tous les joursLa statistique est extraite pour le jour auquel la statistique a été atteinte.
  • Par semaineLa statistique est extraite pour la semaine à laquelle la statistique a été atteinte.
  • Par moisLa statistique est extraite pour le mois auquel la statistique a été atteinte.
  • Par trimestreLa statistique est extraite pour le trimestre auquel la statistique a été atteinte.
  • AnnuelleLa 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 minimumLa valeur de dimension à laquelle la valeur de variable minimale est atteinte est extraite. Il s’agit de l’option par défaut.
  • Argument du maximumLa valeur de dimension à laquelle la valeur de variable maximale est atteinte est extraite.
  • Argument de la médianeLa valeur de dimension à laquelle la valeur de variable médiane est atteinte est extraite.
  • DurationLa valeur de durée de dimension la plus longue entre les valeurs des variables minimale et maximale est extraite.
  • Argument de la valeurLa 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 occurrenceLa 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 occurrenceLa valeur de la dimension est renvoyée la dernière fois que la statistique d’argument est atteinte.
String

Valeur renvoyée

ÉtiquetteExplicationType de données
Raster en sortie

Jeu de données raster en sortie.

Raster

FindArgumentStatistics(in_raster, {dimension}, {dimension_def}, {interval_keyword}, {variables}, {statistics_type}, {min}, {max}, {multiple_occurrence}, {ignore_nodata}, {value}, {comparison}, {occurrence})
NomExplicationType 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.

  • ALLLa statistique est extraite sur toutes les dimensions. Il s’agit de l’option par défaut.
  • INTERVAL_KEYWORDLa 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_DAILYLa statistique est extraite des jours.
  • RECURRING_WEEKLYLa statistique est extraite des semaines.
  • RECURRING_MONTHLYLa statistique est extraite des mois.
  • RECURRING_QUARTERLYLa statistique est extraite des trimestres.
  • HOURLYLa statistique est extraite pour l’heure à laquelle la statistique a été atteinte.
  • DAILYLa statistique est extraite pour le jour auquel la statistique a été atteinte.
  • WEEKLYLa statistique est extraite pour la semaine à laquelle la statistique a été atteinte.
  • MONTHLYLa statistique est extraite pour le mois auquel la statistique a été atteinte.
  • QUARTERLYLa statistique est extraite pour le trimestre auquel la statistique a été atteinte.
  • YEARLYLa 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_MINLa valeur de dimension à laquelle la valeur de variable minimale est atteinte est extraite. Il s’agit de l’option par défaut.
  • ARGUMENT_MAXLa valeur de dimension à laquelle la valeur de variable maximale est atteinte est extraite.
  • ARGUMENT_MEDIANLa valeur de dimension à laquelle la valeur de variable médiane est atteinte est extraite.
  • DURATIONLa valeur de durée de dimension la plus longue entre les valeurs des variables minimale et maximale est extraite.
  • ARGUMENT_VALUELa 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.

  • DATAL’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.
  • NODATALe 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_TOLa dimension extraite est égale à la valeur définie. Il s’agit de l’option par défaut.
  • GREATER_THANLa dimension extraite est supérieure à la valeur définie.
  • SMALLER_THANLa 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_OCCURRENCELa 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_OCCURRENCELa valeur de la dimension est renvoyée la dernière fois que la statistique d’argument est atteinte.
String

Valeur renvoyée

NomExplicationType 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")

Rubriques connexes