Label | Explanation | Data Type |
Input features | The points or polygon features to be created. | Feature Layer |
Input rasters | The rasters must all have the same extent, coordinate system, and cell size. | Raster Layer; Mosaic Layer |
Output table | The output table contains a record for each point and each raster that has data. If polygon features are input, they are converted to points that coincide with the raster cell centers. | Table |
Output raster names table (Optional) | Saves the names of the Input rasters to disc. | Table |
Add warnings to output table (Optional) | Records if input features are partially or completely covered by the Input rasters.
| Boolean |
Available with Geostatistical Analyst license.
Summary
Extracts cell values from a set of rasters to a table, based on a point or polygon feature class.
Usage
This tool is primarily designed to analyze the output from the Gaussian Geostatistical Simulations tool.
All the rasters must have the same spatial reference and cell size.
If a point feature class is used, the output table has a record for each point and each raster that has data. Polygonal data will be treated as point data. The cell center of the input rasters will determine the number of points and will also be used to decide whether the cell is contained within the polygon or not.
Values outside the raster's extent will be ignored.
Multipart feature classes are not supported.
In the case of coincident points, the last one encountered will be used and the rest will be ignored. In the same vane, if overlapping polygons are encountered only one of the intersected features will be processed.
If Spatial Analyst is available, the Sample tool can also be used. However, the output table needs to be transposed if the values are to be graphed.
Parameters
arcpy.ga.ExtractValuesToTable(in_features, in_rasters, out_table, {out_raster_names_table}, {add_warning_field})
Name | Explanation | Data Type |
in_features | The points or polygon features to be created. | Feature Layer |
in_rasters [in_raster,...] | The rasters must all have the same extent, coordinate system, and cell size. | Raster Layer; Mosaic Layer |
out_table | The output table contains a record for each point and each raster that has data. If polygon features are input, they are converted to points that coincide with the raster cell centers. | Table |
out_raster_names_table (Optional) | Saves the names of the Input rasters to disc. | Table |
add_warning_field (Optional) | Records if input features are partially or completely covered by the Input rasters.
| Boolean |
Code sample
Extract the cell values from a raster to a table, based on a point feature class.
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", "", "")
Extract the cell values from a raster to a table, based on a point feature class.
# 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, "", "")
Environments
Licensing information
- Basic: Requires Geostatistical Analyst
- Standard: Requires Geostatistical Analyst
- Advanced: Requires Geostatistical Analyst