Extraire des valeurs vers une table (Geostatistical Analyst)

Disponible avec une licence Geostatistical Analyst.

Synthèse

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.

Paramètres

ÉtiquetteExplicationType 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ésactivé : 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})
NomExplicationType 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_FIELDUn 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_FIELDLe champ d’avertissement n’est pas ajouté à la table en sortie.
Boolean

Exemple de code

Exemple 2 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.ExtractValuesToTable_ga("C:/gapyexamples/data/ca_ozone_pts.shp",
                              "C:/gapyexamples/data/inraster", 
                              "C:/gapyexamples/output/outEVFR.dbf", "", "")
Exemple 1 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"

# Execute ExtractValuesToTable
arcpy.ExtractValuesToTable_ga(inPoints, raster, outTable, "", "")

Informations de licence

  • Basic: Nécessite Geostatistical Analyst
  • Standard: Nécessite Geostatistical Analyst
  • Advanced: Nécessite Geostatistical Analyst

Rubriques connexes