ArcMap

Muestra

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.

Más información sobre cómo funciona Muestra

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, y dado que el concepto de nulo no está admitido, se asignará un valor de -9999.

  • 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ámetroExplicaciónTipo 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.

  • NEAREST — Asignación de vecino más cercano
  • BILINEAR — Interpolación bilineal
  • CUBIC — Convolución cúbica
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.

  • ALL_SLICES — Las muestras se toman para todas las dimensiones (como el tiempo o la profundidad) de un dataset multidimensional.
  • CURRENT_SLICE —Las muestras se toman de la parte actual de un dataset multidimensional. Esta es la opción predeterminada.
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 Análisis espacial
  • ArcGIS Desktop Standard: Requiere Análisis espacial
  • ArcGIS Desktop Advanced: Requiere Análisis espacial

Temas relacionados