Échantillonnage (Map Viewer)

L’outil Échantillonnage extrait les valeurs de cellule de tous les rasters en entrée à chaque emplacement d’entité en entrée.

La sortie correspond à une couche tabulaire hébergée ou une couche d’entités hébergée.

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

L’outil Échantillonnage comporte des configurations pour les couches en entrée, les paramètres d’échantillonnage et les couches de résultat.

Couche(s) en entrée

Le groupe Input layer(s) (Couche(s) en entrée) comprend les paramètres suivants :

• Imagery layer(s) (Couche(s) d’imagerie) permet de choisir l’image unique ou la liste d’images dont les valeurs sont échantillonnées en fonction des données de localisation en entrée.

  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.

  Pour échantillonner toutes les tranches d’une couche d’imagerie multidimensionnelle, ce doit être le seul raster en entrée.
• Location layer (Couche de localisation) permet de choisir la couche identifiant les positions à échantillonner. Les types de couche suivants sont pris en charge :
  • 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 de l’option Statistics type (Type de statistiques).

Paramètres d’échantillonnage

Le groupe Sample settings (Paramètres d’échantillonnage) inclut les paramètres suivants :

• Resampling technique (Méthode de rééchantillonnage) indique l’algorithme de rééchantillonnage lors de l’échantillonnage. Ce paramètre inclut les options suivantes :
  • Nearest (Le plus proche) : méthode du voisin le plus proche qui utilise la valeur de la cellule la plus proche pour affecter une valeur à la cellule en sortie lors du rééchantillonnage. Il s’agit de l’option par défaut.
  • Bilinear (Bilinéaire) : méthode de l’interpolation bilinéaire qui détermine la nouvelle valeur d’une cellule en fonction d’une distance moyenne pondérée des valeurs des centres des quatre cellules en entrée les plus proches.
  • Cubic (Cubique) : méthode de convolution cubique qui détermine la nouvelle valeur d’une cellule en ajustant une courbe lissée suivant les valeurs des centres des 16 cellules en entrée les plus proches.
• Unique ID field (Champ d’ID unique) indique un champ de la couche qui contient une valeur différente pour chaque localisation ou entité en entrée.
• Process as multidimensional (Traiter comme multidimensionnel) indique si les couches d’imagerie en entrée incluent des données multidimensionnelles.
• Acquisition information of location data (Informations d’acquisition des données de localisation) indique l’heure, la profondeur ou d’autres données d’acquisition liées aux entités ou cellules d’emplacement. Ce paramètre est disponible lorsque l’option Process as multidimensional (Traiter comme multidimensionnel) est activée et inclut les sous-paramètres suivants :
  • Dimension : indique la dimension à partir de la couche multidimensionnelle en entrée.
  • Start field or value (Champ ou valeur de début) : indique le champ utilisé pour démarrer la période dans la couche multidimensionnelle en entrée ou entrer une valeur de dimension spécifique.
  • End field or value (Champ ou valeur de fin) : indique le champ utilisé pour terminer la période dans la couche multidimensionnelle en entrée ou entrer une valeur de dimension spécifique.
  • Relative value or days before (Valeur relative ou jours avant) : spécifiez un nombre non négatif à ajouter à la valeur ou au champ Dimension pour définir le début d’une plage de valeurs de dimension.
  • Relative value or days after (Valeur relative ou jours après) : spécifiez un nombre non négatif à ajouter à la valeur ou au champ Dimension pour définir la fin d’une plage de valeurs de dimension.
• Statistics type (Type de statistiques) indique le type de statistiques à calculer. Ce paramètre est disponible lorsque l’option Process as multidimensional (Traiter comme multidimensionnel) est activée. Statistics type (Type de statistiques) inclut les options suivantes :
  • Minimum : recherche la valeur minimale dans la plage spécifiée.
  • Maximum : recherche la valeur maximale dans la plage spécifiée.
  • Median (Médiane) : recherche la valeur médiane dans la plage spécifiée.
  • Mean (Moyenne) : calcule la moyenne de la plage spécifiée.
  • Sum (Somme) : calcule la somme des variables dans la plage spécifiée.
  • Majority (Majorité) : recherche la valeur qui survient le plus fréquemment.
  • Minority (Minorité) : recherche la valeur qui survient le moins fréquemment.
  • Standard Deviation (Écart type) : calcule l’écart type.
  • Percentile (Pourcentage) : calcule un pourcentage défini dans la plage spécifiée.
• Le paramètre Percentile value (Valeur de centile) spécifie le centile à utiliser pour l’échantillonnage. Ce paramètre est disponible lorsque l’option Process as multidimensional (Traiter comme multidimensionnel) est activée et qu e Percentile (Centile) est sélectionné pour le paramètre Statistics type (Type de statistiques).

  Cette valeur peut être comprise entre 0 et 100. La valeur par défaut est 90.

• Buffer distance field or value (Champ ou valeur de distance de la zone tampon) spécifie la distance autour des entités de données d’emplacement utilisées pour l’échantillonnage des couches d’imagerie multidimensionnelle. Ce paramètre est disponible lorsque l’option Process as multidimensional (Traiter comme multidimensionnel) est activée.

Couche de résultat

Le groupe Result layer (Couche de résultat) comprend les paramètres suivants :

• Le paramètre Output name (Nom en sortie) détermine le nom de la couche créée et ajoutée à la carte. Le nom doit être unique. Si une couche du même nom existe déjà dans votre organisation, l’outil échoue et vous êtes invité à utiliser un autre nom.
• Le paramètre Output type (Type de sortie) détermine le type de couche à créer. La sortie peut être une couche tabulaire ou une couche d’entités.
• Output layout (Couche en sortie) 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 Imagery layer(s) (Couche(s) d’imagerie) est un raster multidimensionnel et qu’il contient une variable et une dimension, et que chaque tranche est un raster monocanal.
• Le paramètre Save in folder (Enregistrer dans un dossier) indique le nom d’un dossier de My content (Mon contenu) dans lequel est enregistré le résultat.

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 à partir du groupe de paramètres Environment settings (Paramètres d'environnement).

Cet outil respecte les environnements d'analyse suivants :

• Système de coordonnées en sortie
• Etendue de traitement

  Remarque :

  L’étendue de traitement par défaut dans Map Viewer correspond à l’étendue Full extent (Étendue totale). Ce paramètre par défaut diffère de Map Viewer Classic, où Use current map extent (Utiliser l’étendue courante de la carte) est activé par défaut.

• Masque
• Facteur de traitement parallèle

Sorties

Cet outil comprend les sorties suivantes :

• Couche d’entités avec les valeurs de pixel provenant des couches d’imagerie sources pour chaque emplacement en entrée dans la table attributaire. Une couche d’entités est créée si le paramètre Output type (Type en sortie) est défini sur Features (Entités). La couche d’entités inclut les champs suivants :
  • X: indique les coordonnées horizontales du point en entrée.
  • Y: indique les coordonnées verticales du point en entrée.
  • Champ contenant des valeurs pour chaque bande raster ou raster source (le nom de la bande raster est inclus dans le nom de champ).

    Remarque :

    Si la couche en entrée est multidimensionnelle, la sortie inclut un champ pour chacune des tranches horaires indiquées.

• Couche tabulaire avec les valeurs de pixel provenant des couches d’imagerie sources pour chaque emplacement en entrée dans la table attributaire. Une couche tabulaire est créée si le paramètre Output type (Type en sortie) est défini sur Table. La couche tabulaire inclut les colonnes suivantes :
  • X: indique les coordonnées horizontales du point en entrée.
  • Y: indique les coordonnées verticales du point en entrée.
  • Colonnes contenant des valeurs pour chaque bande raster ou raster source (le nom de la bande raster est inclus dans le nom de colonne).

Conditions d’utilisation

Cet outil requiert les licences et configurations suivantes :

• Type d’utilisateur Creator ou GIS Professional
• Rôle d’éditeur ou d’administrateur, ou rôle personnalisé équivalent
• Disponible lorsque l’organisation est configurée pour l’analyse raster avec une licence pour une fonctionnalité Premium

Ressources

Référez-vous aux ressources suivantes pour en savoir plus :

• Échantillonnage dans ArcGIS REST API
• sample dans ArcGIS API for Python
• Échantillonnage dans ArcGIS Pro