Muestra (Spatial Analyst)

Resumen

Crea una tabla o una clase de entidad de punto que muestrea los valores de las celdas de un ráster, o conjunto de rásteres, para detectar ubicaciones definidas. Las ubicaciones se definen por celdas ráster, puntos, polilíneas o polígonos.

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

Uso

  • Los valores de celda se extraerán de todos los rásteres de entrada (in_rasters en Python) en cada ubicación. Se creará una tabla o una clase de entidad de punto 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.

  • Se puede especificar cualquier combinación de rásteres (de banda única o multibanda) para los rásteres de entrada. La estructura de la tabla de salida cambia automáticamente cuando los rásteres de entrada son multidimensionales.

    Cuando se especifica un ráster multibanda como uno de los rásteres de entrada, se utilizan todas las bandas de esa entrada.

  • A continuación se indican los valores de parámetro que pueden utilizarse como Ráster o entidades de ubicación de entrada (in_location_data en Python):

    • Ráster: las celdas que contienen valores válidos (que no sean NoData) se utilizarán para extraer valores de celda de todos los rásteres de entrada, y el centro de la celda se utilizará como ubicaciones de punto.
    • Punto: valores que se muestrearán en cada ubicación de punto.
    • Polilínea o polígono: el valor medio de todas las celdas que intersecan cada polilínea o polígono se calculará si la entrada es un ráster bidimensional o varios rásteres. Se pueden especificar tipos de estadísticas adicionales si la entrada es un ráster multidimensional y se procesa como multidimensional.

  • 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.

  • Los Rásteres de entrada se muestrean en su referencia y resolución espaciales nativas. Si hay varios rásteres de entrada con diferentes referencias espaciales, las ubicaciones de entrada se proyectan primero a la referencia espacial de cada ráster individualmente; a continuación, se extraen los valores Esto significa que, aunque los rásteres de entrada no respetarán ninguna configuración de entorno de análisis, se aplicarán los entornos adecuados a las ubicaciones de entrada.

  • De forma predeterminada, la referencia espacial de las coordenadas x,y del parámetro Tabla de salida o clase de entidad (out_table en Python) será la misma que la de los valores del parámetro Entidades o ráster de ubicación de entrada, a menos que se especifique una diferente en el entorno del 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 notifica al final de la ejecución de la herramienta como un mensaje de geoprocesamiento.

  • Si Entidades o ráster de ubicación de entrada es una clase de entidad de puntos sin ningún índice espacial, se emitirá una advertencia. Para mejorar el rendimiento de la herramienta para una entrada con un gran número de puntos, cree un índice espacial. Consulte Agregar índice espacial para obtener más información.

  • La herramienta no se podrá ejecutar con entidades multipunto. Para realizar un análisis con entidades multipunto, 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.

  • Si el parámetro Técnica de remuestreo se establece en Más cercano (resampling_type = "NEAREST" en Python), el tipo de campo de la tabla de salida coincidirá con el del tipo de ráster. Si la opción de remuestreo es Bilineal o Cúbico, el tipo de campo siempre será de punto flotante para mantener la precisión de los valores interpolados.

  • Se agregará un campo a la tabla de salida para almacenar los valores especificados en el parámetro Campo de Id. único (unique_id_field en Python). De forma predeterminada, el nombre del campo es el mismo que el nombre del dataset de ubicaciones de entrada. Se recomienda usar un campo que contenga valores únicos como el identificador para cada ubicación, para realizar más análisis.

  • Si el parámetro Proceso como multidimensional no está activado (process_as_multidimensional = "CURRENT_SLICE" en Python), se aplicarán las condiciones siguientes:

    • Si la entrada es un ráster multidimensional, solo se muestreará la parte actual.
    • Si la entrada es un ráster multivariable, solo se muestreará la variable actual.

  • Si el parámetro Proceso como multidimensional no está activado (process_as_multidimensional = "ALL_SLICES" en Python), se aplicarán las condiciones siguientes:

    • Si la entrada es un ráster multidimensional, se muestrearán todas las partes.
    • Si la entrada es un ráster multivariable, se muestrearán todas las variables.
    • Si la entrada es un ráster multidimensional con múltiples variables, se muestrearán todas las partes de todas las variables. Las variables deben tener las mismas dimensiones.

  • Si el parámetro Procesar como multidimensional está activado (process_as_multidimensional = "ALL_SLICES" en Python), se aplicará el escenario apropiado de entre los siguientes:

    • El parámetro Información de adquisición de los datos de ubicación (acquisition_definition en Python) se utilizará para especificar el subconjunto del ráster de entrada que se utilizará para el muestreo.

      • Si se especifican la dimensión, el valor de inicio y el valor final, se procesan las secciones existentes dentro de los valores inicial y final. El valor final predeterminado es el valor máximo de la dimensión. Para una dimensión de tiempo, especifique el valor en el formato estándar. Para otras dimensiones, especifique el valor en la misma unidad que el del ráster de entrada.

      • Si se especifican la dimensión, el campo inicial y el campo final (el campo inicial y final provienen de los datos de la ubicación), se utilizan valores de estos campos para especificar un subconjunto del ráster de entrada mientras se muestrean los valores de esa ubicación.

      • Es posible usar los valores Valor relativo o días anteriores y Valor relativo o días posteriores para especificar un subconjunto en relación con el valor inicial, en el que el valor anterior especifica el comienzo del subconjunto y el valor posterior especifica el final del subconjunto. Los valores de tiempo se especifican en días y los demás valores de dimensión se especifican en la misma unidad que la del ráster de entrada.

    • El parámetro Tipo de estadística (statistics_type en Python) agrega los valores del parámetro Ráster de entrada como se especifica en el subconjunto del parámetro Información de adquisición de los datos de ubicación.

    • Si el parámetro Diseño por columnas está desactivado (layout = "ROW_WISE" en Python), los valores extraídos se almacenan en un campo con el mismo nombre que el de 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 parámetro Diseño por columnas está activado (layout = "COLUMN_WISE" en Python), los valores extraídos se almacenan en campos cuyo nombre sique una convención <variable_name>_<dimension_name>_<dimension_value>. Tenga en cuenta que el parámetro Diseño por columnas es compatible cuando el ráster multidimensional contiene solo una variable, la variable tiene solo una dimensión y cada porción tiene una sola banda. De lo contrario, se generará un mensaje de error.

    • Si el ráster multidimensional tiene varias bandas, se crea un campo adicional para cada banda, el cual almacena el valor extraído de dicha banda.

    • A las localizaciones que extraigan valores de celdas NoData se les asignará el valor NoData del ráster multidimensional de entrada.

  • Un ráster multidimensional puede ser una capa de ráster netCDF, una capa de ráster multidimensional, un dataset de mosaico multidimensional, un CRF multidimensional, un servicio de imágenes multidimensionales o un archivo netCDF. No es posible buscar un archivo netCDF desde el cuadro de diálogo de la herramienta, pero puede especificar la ruta al archivo.

  • Si el parámetro Generar clase de entidad está activado (generate_feature_class = "FEATURE_CLASS" en Python), la salida es una clase de entidad de puntos con los valores muestreados en la tabla de atributos. A continuación, se presentan los posibles tipos de ubicación con descripciones de cómo se muestrean los valores:

    • Ráster: se crean puntos a partir de la ubicación del centro de la celda.
    • Punto: se crea un punto en cada una de las ubicaciones de punto.
    • Polilínea o polígono: se crea un punto en cada polígono o centroide de polilínea.

  • La referencia espacial de la clase de entidad de salida es la misma que la de Ráster o entidades de ubicación de entrada, salvo que se especifique en el entorno Sistema de coordenadas de salida.

  • El entorno Factor de procesamiento en paralelo solo se admite cuando el parámetro Procesar como multidimensional está activado.

  • Si se especifica una entidad en el entorno 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 válidos para esta herramienta.

Parámetros

EtiquetaExplicaciónTipo de datos
Rásteres de entrada

Rásteres con valores que se muestrearán en función de los datos de localización de entrada.

El parámetro Procesar como multidimensional solo está disponible cuando la entrada es un único ráster multidimensional.

Raster Layer
Ráster o entidades de ubicación  de entrada

Datos que identifican las posiciones en las que se tomará una muestra.

La entrada puede ser un ráster o una clase de entidad.

Raster Layer; Feature Layer
Tabla o clase de entidad de salida

Tabla de salida o clase de entidad que contiene los valores de las celdas muestreadas.

El formato de salida está determinado por la ubicación y la ruta de salida. De forma predeterminada, la salida será una tabla de geodatabase o una clase de entidad de geodatabase en un espacio de trabajo de geodatabase o una tabla de dBASE o una clase de entidad de shapefile en un espacio de trabajo de carpetas.

El tipo de datos de salida para generar una tabla o una clase de entidad se controla mediante el parámetro Generar clase de entidad.

Table; Point feature class
Técnica de remuestreo
(Opcional)

Algoritmo de remuestreo que se utilizará para muestrear un ráster para determinar cómo se obtendrán los valores del ráster.

  • Más cercanoAsignación de vecino más cercano que se va a utilizar. Esta es la opción predeterminada.
  • BilinealInterpolación bilineal que se va a utilizar.
  • CúbicoConvolución cúbica que se va a utilizar.
String
Campo de Id. único
(Opcional)

Un campo que contiene un valor diferente para cada ubicación o entidad en el ráster de ubicación o entidades de entrada.

Field
Procesar como multidimensional
(Opcional)

Especifica cómo se procesarán los rásteres de entrada.

Este parámetro solo está disponible cuando la entrada es un único ráster multidimensional.

  • Desactivado: las muestras se procesarán de la parte actual de un dataset multidimensional. Esta es la opción predeterminada.
  • Activado: las muestras se procesarán para todas las dimensiones (como el tiempo o la profundidad) de un dataset multidimensional.
Boolean
Información de adquisición de los datos de ubicación
(Opcional)

Especifica la hora, profundidad y otros datos de adquisición asociados con las entidades de ubicación.

Solo se admiten las siguientes combinaciones:

  • Dimensión + Valor o campo de inicio
  • Dimensión + Valor o campo de inicio + Valor o campo de finalización
  • Dimensión + Valor o campo de inicio + Valor relativo o días anteriores + Valor relativo o días posteriores

Valor relativo o días anteriores y Valor relativo o días posteriores solo admiten valores que no sean negativos.

Se calcularán estadísticas mediante el parámetro Tipo de estadísticas para las variables de este rango de dimensión.

Value Table
Tipo de estadísticas
(Opcional)

Especifica el tipo de estadística que se calculará.

  • MínimoSe calculará el valor mínimo dentro del rango especificado.
  • MáximoSe calculará el valor máximo dentro del rango especificado.
  • MedianaSe calculará el valor medio dentro del rango especificado.
  • Valor medioSe calculará el promedio del intervalo especificado.
  • SumaSe calculará el valor total de las variables dentro del rango especificado.
  • MayoríaSe calculará el valor que se produzca con mayor frecuencia.
  • MinoríaSe calculará el valor que se produzca con menor frecuencia.
  • Desviación estándarSe calculará la desviación típica.
  • PercentilSe calculará un percentil definido dentro del rango especificado.
String
Valor de percentil
(Opcional)

El valor puede variar del 0 al 100. El valor predeterminado es 90.

Double
Valor o campo de distancia de zona de influencia
(Opcional)

Distancia que rodea las entidades de datos de ubicación. La distancia de zona de influencia se especifica en la unidad lineal de la referencia espacial de la entidad de ubicación. Si la entidad utiliza una referencia geográfica, la unidad estará en grados.

Se calcularán las estadísticas dentro de esta área de zona de influencia.

Double; Field
Diseño por columnas
(Opcional)

Especifica si los valores de muestra aparecerán en filas o columnas de la tabla de salida.

  • Los valores de muestra aparecerán en filas separadas en la tabla de salida. Esta es la opción predeterminada.
  • Los valores de muestra aparecerán en columnas separadas en la tabla de salida. Esta opción solo es válida cuando el ráster multidimensional de entrada contiene una variable y una dimensión y cada división es un ráster de una sola banda.
Boolean
Generar clase de entidad.
(Opcional)

Especifica si se generará una clase de entidad de puntos con valores muestreados en su tabla de atributos o una tabla con valores muestreados.

  • No activado: se generará una tabla con valores muestreados. Esta es la opción predeterminada.
  • Activado: se generará una clase de entidad de puntos con valores muestreados en su tabla de atributos.
Boolean

Sample(in_rasters, in_location_data, out_table, {resampling_type}, {unique_id_field}, {process_as_multidimensional}, {acquisition_definition}, {statistics_type}, {percentile_value}, {buffer_distance}, {layout}, {generate_feature_class})
NombreExplicaciónTipo de datos
in_rasters
[in_raster,...]

Rásteres con valores que se muestrearán en función de los datos de localización de entrada.

El parámetro process_as_multidimensional solo se admite cuando la entrada es un único ráster multidimensional.

Raster Layer
in_location_data

Datos que identifican las posiciones en las que se tomará una muestra.

La entrada puede ser un ráster o una clase de entidad.

Raster Layer; Feature Layer
out_table

Tabla de salida o clase de entidad que contiene los valores de las celdas muestreadas.

El formato de salida está determinado por la ubicación y la ruta de salida. De forma predeterminada, la salida será una tabla de geodatabase o una clase de entidad de geodatabase en un espacio de trabajo de geodatabase o una tabla de dBASE o una clase de entidad de shapefile en un espacio de trabajo de carpetas.

El tipo de datos de salida para generar una tabla o una clase de entidad se controla mediante el parámetro generate_feature_class.

Table; Point feature class
resampling_type
(Opcional)

Algoritmo de remuestreo que se utilizará para muestrear un ráster para determinar cómo se obtendrán los valores del ráster.

  • NEARESTAsignación de vecino más cercano que se va a utilizar. Esta es la opción predeterminada.
  • BILINEARInterpolación bilineal que se va a utilizar.
  • CUBICConvolución cúbica que se va a utilizar.
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 entrada.

Field
process_as_multidimensional
(Opcional)

Especifica cómo se procesarán los rásteres de entrada.

Este parámetro solo está disponible cuando la entrada es un único ráster multidimensional.

  • ALL_SLICESLas muestras se procesarán para todas las dimensiones (como el tiempo o la profundidad) de un dataset multidimensional.
  • CURRENT_SLICELas muestras se procesarán de la parte actual de un dataset multidimensional. Esta es la opción predeterminada.
Boolean
acquisition_definition
[acquisition_definition,...]
(Opcional)

Especifica la hora, profundidad y otros datos de adquisición asociados con las entidades de ubicación.

Solo se admiten las siguientes combinaciones:

  • Dimensión + Valor o campo de inicio
  • Dimensión + Valor o campo de inicio + Valor o campo de finalización
  • Dimensión + Valor o campo de inicio + Valor relativo o días anteriores + Valor relativo o días posteriores

Relative value or days before y Relative value or days after solo admiten valores no negativos.

Se calcularán estadísticas mediante el parámetro statistics_type para las variables de este rango de dimensión.

Value Table
statistics_type
(Opcional)

Especifica el tipo de estadística que se calculará.

  • MINIMUMSe calculará el valor mínimo dentro del rango especificado.
  • MAXIMUMSe calculará el valor máximo dentro del rango especificado.
  • MEDIANSe calculará el valor medio dentro del rango especificado.
  • MEANSe calculará el promedio del intervalo especificado.
  • SUMSe calculará el valor total de las variables dentro del rango especificado.
  • MAJORITYSe calculará el valor que se produzca con mayor frecuencia.
  • MINORITYSe calculará el valor que se produzca con menor frecuencia.
  • STDSe calculará la desviación típica.
  • PERCENTILESe calculará un percentil definido dentro del rango especificado.
String
percentile_value
(Opcional)

El percentil que se va a calcular cuando el parámetro Tipo de estadísticas está establecido en Percentil.

Percentil que se va a calcular cuando el parámetro statistics_type esté establecido en PERCENTILE.

El valor puede variar del 0 al 100. El valor predeterminado es 90.

Double
buffer_distance
(Opcional)

Distancia que rodea las entidades de datos de ubicación. La distancia de zona de influencia se especifica en la unidad lineal de la referencia espacial de la entidad de ubicación. Si la entidad utiliza una referencia geográfica, la unidad estará en grados.

Se calcularán las estadísticas dentro de esta área de zona de influencia.

Double; Field
layout
(Opcional)

Especifica si los valores de muestra aparecerán en filas o columnas de la tabla de salida.

  • ROW_WISELos valores de muestra aparecerán en filas separadas en la tabla de salida. Esta es la opción predeterminada.
  • COLUMN_WISELos valores de muestra aparecerán en columnas separadas en la tabla de salida. Esta opción solo es válida cuando el ráster multidimensional de entrada contiene una variable y una dimensión y cada división es un ráster de una sola banda.
Boolean
generate_feature_class
(Opcional)

Especifica si se generará una clase de entidad de puntos con valores muestreados en su tabla de atributos o una tabla con valores muestreados.

  • TABLESe generará una tabla con valores muestreados. Esta es la opción predeterminada.
  • FEATURE_CLASSSe generará una clase de entidad de puntos con valores muestreados en su tabla de atributos.
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 feature class that shows the values of cells from 
#              rasters, for defined locations. 
#              The locations are defined by a set of points.
#              Sampling method is Bilinear.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Set the analysis environments
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRasters = ["elevation",
             "costraster"]
locations = "observers.shp"
outFeatureClass = "c:/sapyexamples/output/samptable02.shp"
sampMethod = "BILINEAR"
generate_feature_class = "FEATURE_CLASS"

# Execute Sample
Sample(inRasters, locations, outFeatureClass, sampMethod, "", "", "", "", "", "", "", generate_feature_class)
Ejemplo 3 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_03.py
# Description: Creates a table that shows the temperature values from 
#              a multidimensional raster, for defined locations. 
#              The locations are defined 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 = "temperature_1990_2019.nc"
locations = "observers.shp"
outTable = "C:/sapyexamples/output/samptable_03"
sampMethod = ""
uniqueIDField = "FID"
process_as_multidimensional = True

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute Sample
# the temperature value at each slice in temperature_1990_2019.nc will be extracted for each point
Sample(inRasters, locations, outTable, sampMethod, uniqueIDField, process_as_multidimensional)
Ejemplo 4 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_04.py
# Description: Creates a table that shows, for each polygon, the maximum temperature value within the period [1999-01-01T00:00:00 , 2019-01-01-T00:00:00]
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRasters = "temperature_1990_2019.nc"
locations = "observers_polygons.shp"
outTable = "C:/sapyexamples/output/samptable_04.dbf"
sampMethod = "BILINEAR"
uniqueIDField = "OBSERVATIONID"
process_as_multidimensional = True
# StdTime in acquisition_definition is the name of the dimension in inRasters that are related with time
# 1999-01-01T00:00:00 in acquisition_definition is the start time of the period
# 2019-01-01-T00:00:00 in acquisition_definition is the end time of the period
acquisition_definition = "StdTime 1999-01-01T00:00:00 2019-01-01-T00:00:00"
statistic_method = "MAXIMUM"

# Execute Sample
# for each polygon in locations, the maximum temperature value within the period [1999-01-01T00:00:00 , 2019-01-01-T00:00:00] will be extracted
Sample(inRasters, locations, outTable, sampMethod, uniqueIDField, process_as_multidimensional, acquisition_definition, statistic_method)