Échantillon

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 Sample (Échantillonnage) comporte des configurations pour les couches en entrée, les paramètres d’échantillonnage et la couche de résultat.

Couche en entrée

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

• Imagery layer (Couche d’imagerie) correspond à 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 éléments Input rasters (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. Ensuite, 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) correspond à 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.

    Le nombre d’entités dépend de facteurs supplémentaires, tels que les critères de filtrage et l’étendue d’analyse.

  • 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 la valeur Statistics type (Type de statistiques).

    Le nombre d’entités dépend de facteurs supplémentaires, tels que les critères de filtrage et l’étendue d’analyse.

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 à utiliser. Les options sont les 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) correspond à 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 : dimension à partir de la couche multidimensionnelle en entrée.
  • Start field or value (Valeur ou champ de début) : champ ou valeur de dimension utilisé pour démarrer la plage temporelle. Spécifiez un champ à partir de la couche multidimensionnelle en entrée ou indiquez une valeur.
  • End field or value (Valeur ou champ de fin) : champ ou valeur de dimension utilisé pour terminer la plage temporelle. Spécifiez un champ à partir de la couche multidimensionnelle en entrée ou indiquez une valeur.
  • 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. Les options disponibles sont les 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 que Percentile (Centile) est spécifié comme valeur 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) correspond à 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) spécifie le nom de la couche qui a été créée et est affichée. 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.
• Output type (Type en sortie) correspond au type de couche à créer. La sortie peut être une couche tabulaire ou une couche d’entités.
• Output layout (Mise en page 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 la valeur du paramètre Imagery layer(s) (Couche(s) d’imagerie) est un raster multidimensionnel qui 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
• Transformations géographiques
• Etendue de traitement

  Remarque :

  L’étendue de traitement par défaut correspond à l’étendue Full extent (Vue générale). 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

Crédits

Cet outil consomme des crédits.

Utilisez le paramètre Estimate credits (Estimer les crédits) pour calculer le nombre de crédits requis pour exécuter l’outil. Pour plus d’informations, reportez-vous à la rubrique Comprendre les crédits pour l’analyse spatiale.

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 : coordonnées horizontales du point en entrée.
  • Y : 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 : coordonnées horizontales du point en entrée.
  • Y : 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 le type d’utilisateur et les configurations suivants :

• Type d’utilisateur Professional ou Professional Plus
• Rôle d’éditeur, de facilitateur ou d’administrateur, ou rôle personnalisé équivalent avec le privilège Imagery Analysis (Analyse d’images)

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