Extraer por consulta de atributos (Spatial Analyst)
Resumen
Extrae las celdas de un ráster según una consulta lógica.
Ilustración
Uso
-
Si la Cláusula where se evalúa como verdadera, se devuelve el valor de entrada original para la ubicación de celda. Si se evalúa como falsa, a la ubicación de celda se le asigna NoData.
-
Cualquier elemento adicional (que no sea Valor y Conteo) del ráster de entrada se elimina para el ráster de salida.
-
Si en la Cláusula where se especifica un elemento del ráster de entrada diferente a Valor, se devuelve el valor de entrada original para la ubicación de celda.
-
Cuando un ráster multibanda se especifica como entrada, se creará un ráster multibanda nuevo como salida. Cada banda individual del ráster multibanda de entrada se analizará como corresponda.
El formato de salida predeterminado es una Pila de Esri Grid. Note que el nombre de una pila de Esri Grid no puede comenzar con un número, utilizar espacios o tener más de 9 caracteres de largo.
-
Si la entrada es una capa creada desde un ráster multibanda con más de tres bandas, la operación de extracción considerará únicamente las bandas que fueron cargadas (simbolizadas) por la capa. Como resultado, el ráster multibanda de salida solo puede tener tres bandas, que corresponden a las utilizadas en la visualización de la capa de entrada.
-
Si el ráster de entrada es un entero, el ráster de salida será un entero. Si la entrada es de punto flotante, la salida será de punto flotante.
Sintaxis
Parámetro | Explicación | Tipo de datos |
in_raster |
El ráster de entrada desde el cual se extraerán las celdas. | Raster Layer |
where_clause | Una expresión lógica que selecciona un subconjunto de celdas de ráster. La expresión sigue la forma general de una expresión SQL. Consulte la documentación si desea obtener más información acerca de la referencia SQL para expresiones de consulta utilizadas en ArcGIS y acerca de la especificación de consultas en Python. | SQL Expression |
Valor de retorno
Nombre | Explicación | Tipo de datos |
out_raster |
Ráster de salida que contiene los valores de las celdas extraídos del ráster de entrada. | Raster |
Ejemplo de código
En este ejemplo se extraen celdas de un ráster en función de una consulta lógica donde la elevación es superior a 1.000 metros.
import arcpy from arcpy import env from arcpy.sa import * env.workspace = "C:/sapyexamples/data" attExtract = ExtractByAttributes("elevation", "VALUE > 1000") attExtract.save("c:/sapyexamples/output/attextract")
En este ejemplo se extraen celdas de un ráster en función de una consulta lógica donde la elevación es superior a 1.000 metros.
# Name: ExtractByAttributes_Ex_02.py # Description: Extracts the cells of a raster based on a logical query. # 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 inRaster = "elevation" inSQLClause = "VALUE > 1000" # Check out the ArcGIS Spatial Analyst extension license arcpy.CheckOutExtension("Spatial") # Execute ExtractByAttributes attExtract = ExtractByAttributes(inRaster, inSQLClause) # Save the output attExtract.save("c:/sapyexamples/output/attextract02")