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
Los valores de celda se extraerán de todos los rásteres de entrada en cada ubicación. 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 incluirán en la tabla de salida.
Los rásteres de entrada no se remuestrearán respetando el entorno de análisis. En su lugar, los valores de celda se extraen de todos los rásteres de entrada en su resolución y referencia espacial originales proyectando ubicaciones de entrada en la referencia espacial del ráster del que se extraen los valores.
Sin embargo, el entorno de análisis se aplica a las ubicaciones de entrada.
A las ubicaciones que extraen valores de celdas NoData en el ráster de entrada se les proporcionará un valor <null> en la tabla de salida. Para shapefiles, dado que los campos nulos no son compatibles, las celdas NoData se representan en la tabla con un valor de -9999.
Cualquier combinación de rásteres (de banda única o multibanda) se puede especificar como Rásteres de entrada (in_rasters en Python).
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.
En caso de que los datos de ubicación de entrada sean un ráster, los centros de las celdas que contengan valores válidos (no NoData) se usarán para extraer los valores de celda de todos los rásteres de entrada de esa ubicación.
Si los datos de ubicación de entrada son una clase de entidad de punto y no tienen ningún índice espacial, se emitirá una advertencia. Para mejorar el rendimiento de la herramienta en entidades de puntos de entrada grandes, cree un índice espacial.
La herramienta no se podrá ejecutar con entidades multipunto. Para realizar un análisis con entidades multipunto, primero conviértalas a entidades de puntos sencillas antes de usarlas en la herramienta de extracción. Consulte Procesar datos multipunto para obtener más información.
La referencia espacial de las coordenadas x,y de la tabla de muestra de salida es la misma que la de las Entidades de puntos o ráster de ubicación de entrada (in_location_data en Python), salvo que se especifique en el entorno Sistema de coordenadas de salida. Si no se conoce la referencia espacial de los datos de ubicación de entrada, la referencia espacial de las coordenadas x,y tampoco se conoce.
La referencia espacial de las coordenadas x,y se identifica al final de la ejecución de la herramienta como un mensaje de geoprocesamiento.
La opción Técnica de remuestreo (resampling_type en Python) determina cómo se obtendrán los valores desde el ráster. La opción predeterminada es Más cercano, que extrae el valor de celda exacto en las ubicaciones de entrada. Para extraer valores interpolados, especifique la opción Bilineal o Cúbico.
El tipo de campo que contiene los valores de celda coincide con el tipo de ráster de la opción más cercana. Sin embargo, para mantener la precisión de los valores interpolados, el tipo de campo siempre será de punto flotante para la opción Bilineal o Cúbico. Cuando la opción de remuestreo se establece como Más cercano, el campo de la tabla de salida coincidirá con el del tipo de ráster. Sin embargo, para mantener la precisión de los valores interpolados, el tipo de campo siempre será de punto flotante para la opción Bilineal o Cúbico.
Se agrega un campo llamado Sample_point a la tabla de salida para almacenar los valores especificados en el Campo de Id. único (unique_id_field en Python). Se recomienda usar un campo que contenga valores únicos como el identificador para cada ubicación, para realizar más análisis.
Cuando se especifica un ráster multidimensional como ráster de entrada y el parámetro Procesar como multidimensional no está activado (ALL_SLICES para el parámetro process_as_multidimensional en Python), 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 el parámetro Procesar como multidimensional.
Si el parámetro Procesar como multidimensional está activado (ALL_SLICES para el parámetro process_as_multidimensional en Python), verá que ocurre lo siguiente.
La herramienta tan solo procesará un ráster multidimensional. Si se especifica más de un ráster multidimensional, solo se procesa el primer ráster.
Los valores extraídos se almacenan en un campo con el mismo nombre que la variable. Se crean campos adicionales para almacenar los valores de dimensión no espacial con el mismo nombre que la dimensión.
Si el ráster multidimensional tiene varias bandas, no se crean más campos para cada banda. En su lugar, los valores extraídos para las bandas se almacenan en el campo de variable. Se crea un campo adicional para la dimensión que se usó para especificar la banda, para almacenar los valores de dimensión.
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. También se pueden usar servicios de imágenes de datos multidimensionales, siempre y cuando el servicio de imágenes esté configurado para permitirlo.
Si se especifica una entidad en el entorno de Máscara, se crea un ráster interno con el tamaño de celda mínimo de los rásteres de entrada. Durante la extracción, el ráster de máscara interno se vuelve a remuestrear al tamaño de celda de cada ráster de entrada.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a 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 ninguna 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 Sample (script 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
- Basic: Requiere Spatial Analyst
- Standard: Requiere Spatial Analyst
- Advanced: Requiere Spatial Analyst