Disponible con una licencia de 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.
Los rásteres de entrada pueden ser bidimensionales o multidimensionales. La estructura de la tabla de salida cambia cuando los rásteres de entrada son multidimensionales.
Uso
Cualquier combinación de rásteres (de banda única o multibanda) se puede especificar como una entrada.
Se extraerá un valor de celda por cada ráster de entrada. Se creará una tabla con campos que contienen los valores de celda para cada ráster de entrada.
En caso de que la tabla del ráster de entrada contuviera atributos adicionales, estos no se trasladarán a la tabla de salida.
Cuando se especifica un ráster multibanda como uno de los Rásteres de entrada (in_rasters en Python), se utilizarán todas las bandas de esa entrada.
Para procesar una selección de bandas a partir de un ráster multibanda de entrada, cree primero un dataset ráster nuevo formado por esas bandas concretas con la herramienta Bandas compuestas. Utilice el resultado en la lista de rásteres de entrada.
Cuando se especifica un ráster multidimensional como ráster de entrada, si la opción Procesar como multidimensional (ALL_SLICES para el parámetro process_as_multidimensional en Python) no está activada, solamente se muestreará la porción actual del ráster multidimensional.
Para extraer valores de todas las porciones de todas las variables del dataset multidimensional de entrada, active la opción Procesar como multidimensional.
Los tipos de ráster multidimensional admitidos actualmente por esta herramienta para el procesamiento multidimensional son: capas ráster netCDF y datasets de mosaico multidimensionales. Los servicios de imágenes de datos multidimensionales no se admiten actualmente.
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.
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.
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, y dado que el concepto de nulo no está admitido, se asignará un valor de -9999.
Si los rásteres de entrada son bidimensionales, el tipo de campo de los valores muestreados en la tabla de salida siempre será 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.
Los datasets multipunto no están admitidos como entrada.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.
Sintaxis
Sample (in_rasters, in_location_data, out_table, {resampling_type}, {unique_id_field}, {process_as_multidimensional})| 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. De forma predeterminada, la salida será una tabla de geodatabase. Si la ruta no está en una geodatabase, el formato lo determinará la extensión. Si la extensión es .dbf, tendrá el formato de dBASE. Si no se especifica una extensión, la salida será una tabla INFO. | Table |
resampling_type (Opcional) | El algoritmo de remuestreo utilizado para muestrear un ráster.
| String |
unique_id_field (Opcional) | Un campo que contiene un valor diferente para cada ubicación o entidad en el ráster de ubicación o entidades de puntos de entrada. | Field |
process_as_multidimensional (Opcional) | Determina cómo se procesan los rásteres de entrada.
| Boolean |
Muestra de código
Ejemplo 1 de Muestra (ventana de Python)
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")
Ejemplo 2 de Muestra (secuencia de comandos independiente)
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)
Entornos
Información sobre licencias
- ArcGIS Desktop Basic: Requiere Spatial Analyst
- ArcGIS Desktop Standard: Requiere Spatial Analyst
- ArcGIS Desktop Advanced: Requiere Spatial Analyst