Rechercher des statistiques d’arguments (Outils Image Analyst)

Résumé

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

Utilisation

Utilisez l’outil Find Argument Statistics (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 bande pour lequel la statistique est atteinte dans un raster multibande.

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 disposez d’une image de télédétection à huit bandes et souhaitez connaître la bande dans laquelle 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.

Etiqueter	Explication	Type de données
Raster multidimensionnel ou multibande en entrée	Raster multidimensionnel ou multibande à 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. Tout—La statistique est extraite sur toutes les dimensions. Il s’agit de l’option par défaut. Mot-clé de l’intervalle—La statistique est extraite de la dimension temporelle selon le mot-clé de l’intervalle.	String
Intervalle de mot-clé (Facultatif)	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. Définissez le paramètre Statistics Type (Type de statistique) sur Argument of the maximum (Argument du maximum), le paramètre Dimension Definition (Définition de la dimension) sur Interval Keyword (Mot-clé de l’intervalle) et le paramètre Keyword Interval (Intervalle de mot-clé) sur Yearly (Par an). Si vous souhaitez connaître le mois au cours duquel la température maximale a été observée, vous pouvez également définir le paramètre Statistics Type (Type de statistique) sur Argument of the maximum (Argument du maximum), le paramètre Dimension Definition (Définition de la dimension) sur Interval Keyword (Mot-clé de l’intervalle) et le paramètre Keyword Interval (Intervalle de mot-clé) sur Recurring Monthly (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 StdTime et que le paramètre Dimension Definition (Définition de la dimension) est défini sur Interval Keyword (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. Par heure—La statistique est extraite pour l’heure à laquelle la statistique a été atteinte. Par jour—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. Par an—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 multibande 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. Durée—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 sera 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 Statistics Type (Type de statistique) est défini sur Duration (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 Statistics Type (Type de statistique) est défini sur Duration (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 spécifiée, 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écoché—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)	Valeur sur laquelle une comparaison est effectuée pour extraire la valeur de dimension. Ce paramètre est requis lorsque le paramètre Statistics Type (Type de statistique) est défini sur Argument of the value (Argument de la valeur).	Long
Comparaison (Facultatif)	Spécifie 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 est renvoyée la première 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 de retour

Etiqueter	Explication	Type 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})

Nom	Explication	Type de données
in_raster	Raster multidimensionnel ou multibande à 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)	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. Définissez le paramètre `statistics_type` sur `ARGUMENT_MAX`, le paramètre `dimension_def` sur `INTERVAL_KEYWORD` et le paramètre `interval_keyword` sur `YEARLY`. Si vous souhaitez connaître le mois au cours duquel la température maximale a été observée, vous pouvez également définir le paramètre `statistics_type` sur `ARGUMENT_MAX`, le paramètre `dimension_def` sur `INTERVAL_KEYWORD` et le paramètre `interval_keyword` sur `RECURRING_MONTHLY`. 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 `StdTime` et que le paramètre `dimension_def` est défini sur `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 multibande 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 sera 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 spécifiée, 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)	Valeur sur laquelle une comparaison est effectué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
comparison (Facultatif)	Spécifie 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 est renvoyée la première 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 de retour

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 *

# 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 *

# 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"

# Run
# 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

Informations de licence

Basic: Requiert Image Analyst
Standard: Requiert Image Analyst
Advanced: Requiert Image Analyst

Rechercher des statistiques d’arguments (Outils Image Analyst)

Résumé

Utilisation

Paramètres

Valeur de retour

Environnements

Informations de licence

Rubriques connexes