Rechercher des statistiques d’arguments (Map Viewer Classic)

Rechercher des statistiques d’arguments L’outil Rechercher des statistiques d’arguments extrait la valeur de dimension ou l’index de canal auquel une statistique donnée est atteinte pour chaque pixel d’un raster multidimensionnel ou multicanal.

Remarque :

Cet outil est maintenant disponible dans Map Viewer, l’outil moderne de création de cartes dans ArcGIS Online. Pour en savoir plus, reportez-vous à la rubrique Rechercher des statistiques d’arguments (Map Viewer).

Si vous ne voyez pas cet outil dans Map Viewer Classic, contactez l’administrateur de votre organisation. Votre compte doit être associé à un type d’utilisateur Professional ou Professional Plus et disposer du privilège Imagery Analysis (Analyse d’images)

Diagramme de workflow

Rechercher des statistiques d’arguments - Processus

Exemple

Vous trouverez ci-dessous des exemples d’utilisation de l’outil.

  • Vous disposez de 30 ans de données mensuelles concernant la température à la surface de la mer et vous allez déterminer le mois où chaque pixel a atteint la température à la surface de la mer la plus élevée.
  • Vous disposez d’une image de télédétection à huit canaux et vous souhaitez déterminer le canal dans lequel la valeur de réflectance minimale a été atteinte pour chaque pixel.

Remarques sur l’utilisation

Utilisez cet outil pour extraire la valeur de la dimension (par exemple, la date, la hauteur ou la profondeur) à laquelle une statistique précise 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.

Pour plus d’informations sur la publication de couches d’imagerie multidimensionnelles, consultez la rubrique Publier des couches d’imagerie multidimensionnelles.

Si la couche d’imagerie multidimensionnelle en entrée ne contient qu’une seule dimension, la sortie est un jeu de données raster monocanal où chaque pixel contient la valeur de dimension de la statistique d’argument. Si la couche d’imagerie multidimensionnelle en entrée contient plusieurs dimensions, le raster multidimensionnel en sortie inclura les dimensions qui ne figuraient pas dans l’analyse.

Si l’option Use current map extent (Utiliser l’étendue courante de la carte) est sélectionnée, les variables de la couche qui sont visibles au sein de l’étendue courante de la carte sont analysées. Si cette option n’est pas sélectionnée, les variables de toute la couche sont analysées, même si elles se trouvent en dehors de l’étendue courante de la carte.

Les paramètres de cet outil sont indiqués dans la table suivante :

ParamètreExplication
Choisir une couche d’imagerie multidimensionnelle ou à plusieurs canaux à analyser

Le raster multidimensionnel ou multicanal à analyser.

Choisir la dimension à partir de laquelle extraire la statistique

Dimension à partir de laquelle extraire la statistique.

Choisir la ou les variables à analyser

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.

Choisir le type de statistique

Indique la statistique à extraire de la ou des variables le long de la dimension donnée.

  • Argument of the minimum (Argument du minimum) : la valeur de dimension à laquelle la valeur de variable minimale est atteinte sera extraite. Il s’agit de l’option par défaut.
  • Argument of the maximum (Argument du maximum) : la valeur de dimension à laquelle la valeur de variable maximale est atteinte sera extraite.
  • Argument of the median (Argument de la médiane) : la valeur de dimension à laquelle la valeur de variable médiane est atteinte sera extraite.
  • Argument of duration (Argument de durée) : la durée de dimension la plus longue pour laquelle les valeurs des variables sont comprises entre les valeurs minimale et maximale est extraite.
  • Argument of the value (Argument de la valeur) : la valeur de dimension à laquelle la valeur de variable spécifiée est atteinte sera extraite.
Spécifier une valeur à occurrences multiples (facultatif)

Valeur de pixel à utiliser dans la sortie qui indique que la statistique d’argument a été atteinte plusieurs fois dans le jeu de données raster en entrée. Si aucune valeur n’est spécifiée, la valeur de pixel est la valeur de la dimension la première fois que la statistique d’argument est atteinte.

Spécifier une valeur d’argument

Valeur sur laquelle une comparaison est effectuée pour extraire la valeur de dimension. Ce paramètre est requis lorsque le paramètre Choose statistics type (Choisir le type de statistiques) est défini sur Argument of the value (Argument de la valeur).

Spécifier la valeur minimale

La valeur de la variable minimale à utiliser pour extraire la durée.

Spécifier la valeur maximale

La valeur de la variable maximale à utiliser pour extraire la durée.

Ce paramètre est requis lorsque l’option Duration (Durée) est sélectionnée comme type de statistique.

Choisir la définition de la dimension

Indique comment la statistique est extraite de la dimension.

  • All (Tout) : la statistique est extraite sur toutes les dimensions. Il s’agit de l’option par défaut.
  • Interval Keyword (Mot-clé de l’intervalle) : la statistique est extraite de la dimension temporelle selon le mot-clé de l’intervalle.

Choisir le mot-clé de l’intervalle

L’unit de temps pour laquelle extraire la statistique.

  • Recurring daily (Récurrence quotidienne) : la statistique est extraite des jours.
  • Recurring weekly (Toutes les semaines) : la statistique est extraite des semaines.
  • Recurring monthly (Tous les mois) : la statistique est extraite des mois.
  • Recurring quarterly (Tous les trimestres) : la statistique est extraite des trimestres.
  • Hourly (Horaire) : la statistique est extraite pour l’heure à laquelle la statistique a été atteinte.
  • Daily (Quotidien) : la statistique est extraite pour le jour auquel la statistique a été atteinte.
  • Weekly (Hebdomadaire) : la statistique est extraite pour la semaine à laquelle la statistique a été atteinte.
  • Monthly (Mensuel) : la statistique est extraite pour le mois auquel la statistique a été atteinte.
  • Quarterly (Trimestriel) : la statistique est extraite pour le jour auquel le trimestre a été atteinte.
  • Yearly (Annuel) : la statistique est extraite pour l’année à laquelle la statistique a été atteinte.

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 Argument of the maximum (Argument du maximum) comme type de statistique, définissez Interval Keyword (Mot-clé de l’intervalle) comme définition de la dimension et définissez l’intervalle de mot-clé sur Yearly (Par an).

Ce paramètre est requis lorsque la définition de l’agrégation est définie sur Interval Keyword (Mot-clé de l’intervalle) et que la dimension est temporelle.

Ignorer les valeurs manquantes dans le calcul

Spécifie si les valeurs manquantes 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 le pixel le long de la dimension donnée.

Comparaison

Spécifie le type de comparaison à utiliser pour extraire la valeur de dimension. Les options sont les suivantes :

  • Equal to (Égal à) : la dimension extraite est égale à la valeur spécifiée. Il s’agit de l’option par défaut.
  • Greater than (Supérieur à) : la dimension extraite est supérieure à la valeur spécifiée.
  • Smaller than (Inférieur à) : la dimension extraite est inférieure à la valeur spécifiée.

Occurrence

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. Les options sont les suivantes :

  • First occurrence (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.
  • Last occurrence (Dernière occurrence) : la valeur de la dimension est renvoyée la dernière fois que la statistique d’argument est atteinte.

Nom de la couche de résultat

Le nom de la couche qui sera créée dans la page My Content (Mon contenu) et ajoutée à la carte. Le nom par défaut repose sur le nom de l'outil et sur le nom de la couche en entrée. Si la couche existe déjà, vous êtes invité à fournir un autre nom.

Vous pouvez spécifier le nom d’un dossier dans My Content (Mon contenu), dans lequel le résultat sera enregistré via la zone de liste déroulante Save result in (Enregistrer le résultat dans). Si vous disposez de privilèges permettant de créer des couches d’imagerie tuilée et d’imagerie dynamique, vous pouvez également spécifier le type de couche à utiliser en sortie à l’aide de la zone déroulante Save result as (Enregistrer le résultat sous).

Conseil :

Cliquez sur Show Credits (Afficher les crédits) avant d’exécuter l’analyse pour savoir combien de crédits seront consommés.

Environnements

Les paramètres d’environnement d’analyse sont des paramètres supplémentaires qui affectent les résultats d’un outil. Vous pouvez accéder aux paramètres d’environnement d’analyse de l’outil en cliquant sur le bouton des paramètres Analysis Environments (Environnements d’analyse) dans la partie supérieure de la fenêtre de l’outil.

Cet outil respecte les environnements d’analyse suivants :

  • Système de coordonnées en sortie : indique le système de coordonnées de la couche en sortie.
  • Étendue : indique la surface à utiliser pour l’analyse.
  • Raster de capture : ajuste l’étendue de sortie afin qu’elle corresponde à l’alignement des cellules de la couche Snap Raster (Raster de capture) spécifiée.
  • Taille de cellule : taille de cellule à utiliser dans la couche en sortie.
  • Méthode de rééchantillonnage : méthode à utiliser pour interpoler les valeurs de pixel.

Fonctions raster et outils similaires

Utilisez l’outil Rechercher des statistiques d’arguments pour extraire la valeur de dimension à laquelle une statistique est atteinte. D’autres outils peuvent vous aider à résoudre des problèmes similaires.

Fonctions raster et outils d’analyse Map Viewer Classic

La fonction raster ArgStatistics traite une liste de rasters en entrée pour identifier le canal dans lequel une statistique d’argument est atteinte.

Fonctions raster et outils d’analyse ArcGIS Pro

L’outil de géotraitement Rechercher des statistiques d’arguments est disponible dans les boîtes d’outils Image Analyst et Spatial Analyst.

ArgStatistics est également disponible sous forme de fonction raster.

Ressources de développeur ArcGIS Enterprise

Si vous travaillez dans ArcGIS REST API, utilisez la tâche Find Argument Statistics.

Si vous travaillez dans ArcGIS API for Python, utilisez find_argument_statisticssite Web ArcGIS API for Python du module arcgis.raster.analytics.