Muestra (Spatial Analyst)
Resumen
Crea una tabla que muestrea los valores de las celdas de un ráster, o conjunto de rásteres, para ubicaciones definidas. Las ubicaciones se definen por celdas ráster o por un conjunto de puntos.
Uso
-
Cuando la ubicación de entrada es un ráster, el conjunto de celdas de ubicación consta de toda celda que tenga un valor de cero o mayor. Las celdas que tienen valores NoData no se incluyen en el conjunto de la ubicación. Un ráster de ubicación puede crearse fácilmente con las herramientas de extracción.
-
A las ubicaciones que muestran celdas NoData en los rásteres o en el ráster de entrada se les proporcionará un valor <null> en una tabla de geodatabases de salida. Para la salida a INFO o .dbf, se asignará un valor de 0 (cero), ya que el concepto de nulo no está admitido.
-
El tipo de campo de los valores muestreados en la tabla de salida siempre es de punto flotante. Esto es así para asegurarse de que se mantiene el grado de precisión apropiado si se seleccionan las opciones Bilineal o Cúbico para la técnica de remuestreo.
-
Cuando la entrada de ubicación es ráster, el tamaño de celda y el registro de los rásteres de entrada y el ráster de ubicación deben ser los mismos para obtener un resultado óptimo.
-
La salida de la herramienta es una tabla.
Los datasets multipunto no están admitidos como entrada.
Sintaxis
| Parámetro | Explicación | Tipo de datos |
in_rasters [in_raster,...] |
La lista de rásteres cuyos valores se muestrearán según los datos de ubicación de entrada. | Raster Layer |
in_location_data |
Los datos que identifican las posiciones en las que desea tomar la muestra. Puede ser un ráster o un dataset de entidad de puntos. | Raster Layer | Feature Layer |
out_table |
Tabla de salida que contiene los valores de celda muestreados. El formato de la tabla está determinado por la ubicación y la ruta de salida. Si no se especifica una extensión, se creará una tabla INFO. Si la ubicación es en una geodatabase, la tabla de salida se creará con ese tipo particular (por ejemplo, un archivo o una geodatabase ArcSDE). Si el nombre tiene una extensión .dbf, la salida estará en formato dBASE. | Table |
resampling_type (Opcional) |
El algoritmo de remuestreo utilizado para muestrear un ráster.
| String |
Ejemplo de código
Extraiga los valores de celda a de varios rásteres a una tabla basada en ubicaciones de entrada.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
Sample(["elevation", "costraster"], "observers.shp",
"c:/sapyexamples/output/samptable","NEAREST")
Extraiga los valores de celda a de varios rásteres a una tabla basada en ubicaciones de entrada.
# Name: Sample_Ex_02.py
# Description: Creates a table that shows the values of cells from
# a raster, or set of rasters, for defined locations.
# The locations are defined by raster cells or by a set
# of points.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inRasters = ["elevation",
"costraster"]
locations = "observers.shp"
outTable = "c:/sapyexamples/output/samptable02"
sampMethod = "NEAREST"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Sample
Sample(inRasters, locations, outTable, sampMethod)