Extraire des valeurs vers une table (Outils Geostatistical Analyst)

Résumé

Extrait les valeurs de cellule d’un jeu de rasters vers une table, selon une classe d’entités ponctuelles ou surfaciques.

Utilisation

Cet outil est principalement conçu pour analyser la sortie de l’outil Simulations géostatistiques gaussiennes.
Tous les rasters doivent avoir la même référence spatiale et la même taille de cellule.
Si une classe d’entités ponctuelles est utilisée, la table en sortie comporte un enregistrement pour chaque point et chaque raster possédant des données. Les données polygonales sont traitées comme des données ponctuelles. Le centre de cellule des rasters en entrée détermine le nombre de points et permet également de choisir si la cellule est contenue dans le polygone ou non.
Les valeurs à l’extérieur de l’étendue du raster sont ignorées.
Les classes d’entités multi-parties ne sont pas prises en charge.
Dans le cas des points coïncidents, le dernier rencontré est utilisé et le reste est ignoré. De même, si des polygones superposés sont rencontrés, une seule des entités intersectées est traitée.
Si Spatial Analyst est disponible, l’outil Échantillon peut également être utilisé. La table en sortie doit cependant être transposée si les valeurs doivent être représentées dans un diagramme.

Etiqueter	Explication	Type de données
Entités en entrée	Points ou entités surfaciques à créer.	Feature Layer
Rasters en entrée	Les rasters doivent tous avoir la même étendue, le même système de coordonnées et la même taille de cellule.	Raster Layer; Mosaic Layer
Table en sortie	La table en sortie comporte un enregistrement pour chaque point et chaque raster possédant des données. Si des entités surfaciques sont saisies, elles sont converties en points qui coïncident avec les centres des cellules raster.	Table
Table des noms de raster en sortie (Facultatif)	Enregistre les noms des rasters en entrée sur le disque.	Table
Ajouter des avertissements dans la table en sortie (Facultatif)	Consigne si les entités en entrée sont partiellement ou entièrement couvertes par les rasters en entrée. Activé—Un champ d’avertissement est ajouté dans la table en sortie et renseigné avec un P lorsqu’une entité est couverte partiellement par les valeurs des rasters. Décoché—Le champ d’avertissement n’est pas ajouté à la table en sortie.	Boolean

arcpy.ga.ExtractValuesToTable(in_features, in_rasters, out_table, {out_raster_names_table}, {add_warning_field})

Nom	Explication	Type de données
in_features	Points ou entités surfaciques à créer.	Feature Layer
in_rasters [in_raster,...]	Les rasters doivent tous avoir la même étendue, le même système de coordonnées et la même taille de cellule.	Raster Layer; Mosaic Layer
out_table	La table en sortie comporte un enregistrement pour chaque point et chaque raster possédant des données. Si des entités surfaciques sont saisies, elles sont converties en points qui coïncident avec les centres des cellules raster.	Table
out_raster_names_table (Facultatif)	Enregistre les noms des rasters en entrée sur le disque.	Table
add_warning_field (Facultatif)	Consigne si les entités en entrée sont partiellement ou entièrement couvertes par les rasters en entrée. `ADD_WARNING_FIELD`—Un champ d’avertissement est ajouté dans la table en sortie et renseigné avec un P lorsqu’une entité est couverte partiellement par les valeurs des rasters. `DO_NOT_ADD_WARNING_FIELD`—Le champ d’avertissement n’est pas ajouté à la table en sortie.	Boolean

Exemple de code

Exemple 1 d’utilisation de la fonction ExtractValuesToTable (fenêtre Python)

Extrayez les valeurs de cellule d’un raster vers une table, en fonction d’une classe d'entités ponctuelles.

import arcpy
from arcpy import env
env.workspace = "C:/gapyexamples/data"
arcpy.ga.ExtractValuesToTable("C:/gapyexamples/data/ca_ozone_pts.shp",
                              "C:/gapyexamples/data/inraster",
                              "C:/gapyexamples/output/outEVFR.dbf", "", "")

Exemple 2 d’utilisation de la fonction ExtractValuesToTable (script autonome)

Extrayez les valeurs de cellule d’un raster vers une table, en fonction d’une classe d'entités ponctuelles.

# Name: ExtractValuesToTable_Example_02.py
# Description: Extract the cell values from a raster, based on
#              a point feature class, to a table.
# Requirements: Geostatistical Analyst extension

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/gapyexamples/data"

# Set local variables
inPoints = "C:/gapyexamples/data/ca_ozone_pts.shp"
raster = "C:/gapyexamples/data/inraster"
outTable = "C:/gapyexamples/output/outEVFR.dbf"

# Run ExtractValuesToTable
arcpy.ga.ExtractValuesToTable(inPoints, raster, outTable, "", "")

Environnements

Espace de travail courant, Etendue, Espace de travail temporaire

Informations de licence