Cet outil crée une table ou une classe d’entités ponctuelles indiquant les valeurs de cellules d’un raster ou d’un jeu de rasters, pour des localisations définies. Les localisations sont définies par des cellules raster, des entités surfaciques, des entités polylignes ou par un ensemble de points.
Remarque :
Cet outil est maintenant disponible dans Map Viewer, l’outil moderne de création de cartes dans ArcGIS Enterprise on Kubernetes. Pour en savoir plus, reportez-vous à la rubrique Échantillon (Map Viewer).
Pour que cet outil puisse être exécuté, l’organisation doit être configurée pour l’analyse raster.
Si vous ne voyez pas cet outil dans Map Viewer Classic, contactez l’administrateur de votre organisation. Il se peut que votre portail ne soit pas configuré pour l'analyse raster ou que vous ne disposiez pas des privilèges requis pour exécuter l'outil.
Diagramme de workflow
Exemples
Voici les quelques exemples d’applications de cet outil :
- Extraire les attributs de la localisation d’une antenne-relais à partir de plusieurs rasters, comme l’utilisation du sol, le type de sol, l’élévation et la distance par rapport à la route.
- Extraire la température du sol à des profondeurs différentes pour un ensemble donné de points.
- À partir de 30 années de données mensuelles de température à la surface de la mer, récapitulez les localisations de présence animale ou les observations d’une espèce animale pendant des plages temporelles données.
Remarques sur l’utilisation
Les valeurs de cellule seront extraites de tous les rasters en entrée à chaque emplacement. Une table ou une classe d’entités ponctuelles est créée avec des champs contenant les valeurs de pixel pour chaque raster en entrée. Les attributs supplémentaires provenant de la table raster en entrée ne sont pas inclus dans la table en sortie.
Vous pouvez définir n’importe quelle combinaison de rasters (monocanal, multicanal, multidimensionnel ou multivarié), comme rasters en entrée. La structure de la table en sortie change lorsque les rasters en entrée sont multidimensionnels. Lorsqu’un raster multicanal est spécifié comme un des rasters en entrée, tous les canaux de cette entrée sont utilisés. Pour traiter une sélection de canaux à partir d’un raster multicanal en entrée, créez d’abord un jeu de données raster composé de ces canaux en particulier. Utilisez le résultat dans la liste des rasters en entrée.
La localisation en entrée peut être un raster ou une entité :
- Raster : les pixels contenant des valeurs valides (pas NoData) sont utilisés pour extraire les valeurs de pixel de tous les rasters en entrée, et le centre du pixel est utilisé pour les localisations des points.
- Point : les valeurs sont échantillonnées à chaque localisation de point.
- Polyligne ou polygone : les valeurs sont échantillonnées au centroïde du polygone ou de la polyligne. Si le raster en entrée est multidimensionnel, les valeurs sont agrégées en fonction du type Statistics (Statistiques).
Un champ est ajouté à la table en sortie afin de stocker les valeurs spécifiées dans le paramètre Specify unique ID field (Spécifier un champ d’ID unique). Par défaut, le nom du champ est identique au nom du jeu de données de localisation en entrée. Il est recommandé d’utiliser un champ qui contient des valeurs uniques comme identifiant de chaque localisation en vue d’une analyse future.
Les localisations qui extraient les valeurs des cellules NoData dans le raster en entrée ont la valeur <null> dans la table en sortie.
Les rasters en entrée sont échantillonnés dans leur référence spatiale native et résolution. S’il existe plusieurs rasters en entrée avec différentes références spatiales, les localisations en entrée sont projetées sur la référence spatiale de chaque raster d’où les valeurs sont extraites. L’environnement d’analyse est appliqué aux localisations en entrée, mais les rasters en entrée ne le respectent pas.
La référence spatiale des coordonnées x,y dans la table d’échantillonnage ou de la classe d’entités en sortie est la même que celle des entités ponctuelles ou raster de la localisation en entrée, sauf si elle est spécifiée dans l’environnement Output Coordinate System (Système de coordonnées en sortie). Si la référence spatiale des données d’emplacements en entrée est inconnue, la référence spatiale des coordonnées x,y est également inconnue. Si la localisation en entrée est une classe d’entités ponctuelles sans index spatial, un avertissement est émis. Pour améliorer les performances de l’outil d’une entrée comportant un nombre élevé de points, créez un index spatial.
Pour réaliser une analyse avec des entités multi-points, convertissez-les d’abord en entités ponctuelles uniques avant de les utiliser dans cet outil.
Le paramètre Specify acquisition information of location data (Spécifier les informations d’acquisition des données de localisation) est utilisé pour spécifier le sous-ensemble du raster multidimensionnel en entrée à utiliser pour l’échantillonnage.
- Lorsque la dimension, la valeur de départ et la valeur de fin sont spécifiées, les tranches comprises entre les valeurs de départ et de fin sont traitées. La valeur de fin par défaut est la valeur de dimension maximale. Dans le cas d’une dimension temporelle, indiquez la valeur au format standard. Pour les autres dimensions, spécifiez la valeur dans la même unité que celle du raster en entrée.
- Lorsque la dimension, le champ de début et le champ de fin sont spécifiés (le champ de début et le champ de fin proviennent des données de localisation), les valeurs de ces champs sont utilisées pour préciser un sous-ensemble du raster en entrée avec des valeurs d’échantillonnage à cette localisation.
- Les valeurs de Relative value or days before (Valeur relative ou jours avant) et de Relative value or days after (Valeur relative ou jours après) permettent de spécifier un sous-ensemble relatif à la valeur de début, dans lequel la valeur avant indique le début du sous-ensemble et la valeur après la fin du sous-ensemble. Les valeurs temporelles sont indiquées en jours et les valeurs des autres dimensions sont spécifiées dans la même unité que celle du raster en entrée.
Le paramètre Choose statistic type (Choisir le type de statistiques) agrège les valeurs du paramètre Input raster (Raster en entrée) tel qu’indiqué par le sous-ensemble dans le paramètre Specify acquisition information of location data (Spécifier les informations d’acquisition des données de localisation).
Si le paramètre Sampled values appear in row (Les valeurs échantillonnées apparaissent en ligne) est sélectionné, les valeurs extraites sont stockées avec le même nom que la variable. Des champs supplémentaires sont créés pour stocker les valeurs de dimensions non spatiales portant le même nom que la dimension. Si le paramètre Sampled values appear in column (Les valeurs échantillonnées apparaissent en colonne) est sélectionné, les valeurs extraites sont stockées dans des champs dont le nom respecte la convention <nom_variable>_<nom_dimension>_<valeur_dimension>.
Si le raster multidimensionnel contient plusieurs canaux, un champ supplémentaire est créé pour chaque canal, dans lequel est stockée la valeur extraite de ce canal.
Lorsque le paramètre Specify resampling technique (Spécifier la méthode de rééchantillonnage) est défini sur Nearest (Le plus proche), le type de champ dans la table en sortie correspond à celui du type raster. Lorsque l’option de rééchantillonnage est définie sur Bilinear (Bilinéaire) ou sur Cubic (Cubique), le champ est toujours de type virgule flottante afin de conserver la précision des valeurs interpolées.
Par défaut, la sortie est Table. Si le paramètre Specify output type (Spécifier le type en sortie) est défini sur Features (Entités), la sortie est une classe d’entités dont la table attributaire comporte les valeurs échantillonnées. Voici les types de localisations possibles, ainsi que les descriptions du mode d’échantillonnage des valeurs :
- Raster : des points sont créés avec la localisation du centre de cellule.
- Point : un point est créé à chaque localisation de point.
- Polyligne ou polygone : un point est créé à chaque centroïde de polygone ou de polyligne.
La référence spatiale de la classe d’entités en sortie est identique à celle des entités ou du raster de la localisation en entrée, sauf si elle est spécifiée dans l’environnement Output Coordinate System (Système de coordonnées en sortie).
L’environnement Parallel Processing Factor (Facteur de traitement parallèle) est uniquement pris en charge lorsque l’entrée est un raster multidimensionnel.
Si une entité est spécifiée dans l’environnement Mask (Masque), un raster interne est créé avec la taille de cellule minimale des rasters en entrée. Lors de l’extraction, le raster de masque interne est à nouveau rééchantillonné sur la taille de cellule de chaque raster en entrée.
Si l’option Use current map extent (Utiliser l’étendue courante de la carte) est sélectionnée, les variables ou les canaux de la couche qui sont visibles au sein de l’étendue courante de la carte seront analysés. Si cette option n’est pas sélectionnée, les variables ou les canaux de toute la couche seront analysés, même s’ils 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ètre | Explication |
---|---|
Choisir des couches d’imagerie à échantillonner | Image unique ou liste d’images dont les valeurs sont échantillonnées en fonction des données de localisation en entrée. Pour échantillonner toutes les tranches d’une couche d’imagerie multidimensionnelle, ce doit être le seul raster en entrée. |
Choisir la couche de localisants | Données identifiant les positions à échantillonner. Les données de localisation en entrée peuvent être un raster, ou une classe d’entités ponctuelles, polylignes ou surfaciques. |
Specify Unique ID field (Optional) (Spécifier un champ d’ID unique (facultatif)) | Champ qui contient une valeur différente pour chaque localisation ou entité de la classe d’entités ou du raster de localisation en entrée. |
Spécifier les informations d’acquisition des données de localisation (facultatif) | Spécifiez la dimension temporelle, la profondeur ou d’autres données d’acquisition associées aux entités ou cellules de localisation. Pour chaque dimension, trois options permettent de spécifier les informations d’acquisition associées aux entités ou cellules de localisation :
Ce paramètre est disponible uniquement lorsque le paramètre Choose imagery layer(s) to sample (Sélectionner les couches d’images à échantillonner) est un raster multidimensionnel. |
Specify buffer distance field or value (Optional) (Spécifier le champ ou la valeur de distance de la zone tampon (facultatif)) | Distance spécifiée autour des entités de données d’emplacement. La distance de la zone tampon est spécifiée dans les unités linéaires de la référence spatiale de l’entité de localisation. Si l’entité utilise une référence géographique, l’unité sont les degrés. Les statistiques sont calculées dans cette zone tampon. Ce paramètre est disponible uniquement lorsque le paramètre Choose imagery layer(s) to sample (Sélectionner les couches d’images à échantillonner) est un raster multidimensionnel. |
Choose statistics type (Optional) (Choisir le type de statistiques (facultatif)) | Type de statistique à calculer.
Ce paramètre est disponible uniquement lorsque le paramètre Choose imagery layer(s) to sample (Sélectionner les couches d’images à échantillonner) est un raster multidimensionnel, et que les paramètres Choose location layer (Choisir la couche de localisants) sont des polylignes ou des polygones, ou que le paramètre Specify buffer distance field or value (Optional) (Spécifier le champ ou la valeur de distance de la zone tampon (Facultatif)) est spécifié. |
Percentile value (Optional) (Valeur de centile (facultatif)) | Cette valeur peut être comprise entre 0 et 100. La valeur par défaut est 90. Ce paramètre est disponible uniquement lorsque le paramètre Choose statistics Type (Choisir le type de statistiques) est défini sur Percentile (Centile). |
Specify resampling technique (Optional) (Spécifier la méthode de rééchantillonnage (facultatif)) | Algorithme de rééchantillonnage utilisé lors de l'échantillonnage d'un raster.
|
Specify output layout (Optional) (Spécifier la couche en sortie (facultatif)) | Spécifie si les valeurs échantillonnées apparaissent sur des lignes ou dans des colonnes dans la table en sortie.
Ce paramètre est disponible uniquement lorsque le paramètre Choose imagery layer(s) to sample (Sélectionner les couches d’images à échantillonner) est un raster multidimensionnel et qu’il contient une variable et une dimension, et que chaque tranche est un raster monocanal. |
Specify output type (Optional) (Spécifier le type en sortie (facultatif)) | Indique si une classe d’entités ponctuelles doit être générée avec des valeurs échantillonnées dans sa table, ou uniquement une table avec des valeurs échantillonnées.
|
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). |
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 l'icône représentant un engrenage 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.
- Masque : désigne une couche de masque, où seules les cellules qui se trouvent dans la zone du masque seront utilisées pour l’analyse.
- Facteur de traitement parallèle : contrôle les instances CPU ou GPU du traitement parallèle.
Fonctions raster et outils similaires
Utilisez l'outil Sample (Échantillon) pour créer une table ou une classe d'entités ponctuelles avec des valeurs de données dans des localisations définies extraites d'un raster ou d'un jeu de rasters. D’autres outils peuvent vous aider à résoudre des problèmes similaires.
Outils d’analyse et fonctions raster dans Map Viewer Classic
Utilisez l'outil Summarize Raster Within (Synthétiser un raster à l’intérieur) ou la fonction raster Zonal Statistics (Statistiques zonales) pour récapituler les rasters dans les limites et créer une sortie du service d'imagerie.
Fonctions raster et outils d’analyse ArcGIS Pro
Les outils de géotraitement Sample (Échantillon), Zonal Statistics (Statistiques zonales) et Zonal Statistics as Table (Statistiques zonales (table)) sont disponibles dans les boîtes d’outils Image Analyst et Spatial Analyst.
Les outils de géotraitement Summarize Raster Within (Synthétiser un raster à l’intérieur) et Zonal Statistics As Table (Statistiques zonales (table)) sont disponibles dans la boîte d’outils Analyse raster.
L'outil Zonal Statistics (Statistiques zonales) est également disponible sous forme de fonction raster.
Ressources de développeur ArcGIS Enterprise
Si vous utilisez ArcGIS REST API, utilisez les tâches Sample, Summarize Raster Within ou Zonal Statistics As Table.
Si vous utilisez ArcGIS API for Python, utilisez sample , summarize_raster_within ou zonal_statistics_as_table à partir du module arcgis.raster.analytics ou utilisez zonal_statistics à partir du module arcgis.raster.functions.gbl.
Vous avez un commentaire à formuler concernant cette rubrique ?