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
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.
Si se indica más de un ráster multidimensional, todos ellos deberán compartir los mismos nombres de dimensión.
Las capas ráster de NetCDF son el único tipo de rásteres multidimensionales que se admiten.
Si los rásteres de entrada son una mezcla de rásteres bidimensionales y multidimensionales, solo se muestreará la parte actual de cualquier ráster multidimensional.
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.
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.
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 |
Ejemplo 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 for Desktop Basic: Requiere Spatial Analyst
- ArcGIS for Desktop Standard: Requiere Spatial Analyst
- ArcGIS for Desktop Advanced: Requiere Spatial Analyst