Disponible con una licencia de Spatial Analyst.
Resumen
Extrae las celdas de un ráster según un círculo.
Uso
El centro de la celda se utiliza para determinar si una celda se encuentra dentro o fuera de un círculo. Si el centro se encuentra dentro del arco del círculo, la celda se considera completamente dentro, incluso si algunas porciones de la celda caen fuera del círculo
A las ubicaciones de las celdas que no están seleccionadas se les asigna el valor NoData.
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 un ráster de geodatabase. Si se especifica una pila en Cuadrícula de Esri como formato de salida, tenga en cuenta que el nombre no puede empezar con un número, utilizar espacios o tener más de nueve caracteres de longitud.
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 sólo 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.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.
Sintaxis
ExtractByCircle (in_raster, center_point, radius, {extraction_area})| Parámetro | Explicación | Tipo de datos |
in_raster |
El ráster de entrada desde el cual se extraerán las celdas. | Raster Layer |
center_point | La clase Point determina la coordenada central (x,y) del círculo que define el área que se extraerá. El formato de la clase es:
Las coordenadas se especifican en las mismas unidades de mapa que el ráster de entrada. | Point |
radius | Radio del círculo que define el área que se extraerá. El radio se especifica en unidades de mapa y está expresado en las mismas unidades que el ráster de entrada. | Double |
extraction_area (Opcional) | Identifica si debe extraer celdas dentro o fuera del círculo de entrada.
| String |
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
Ejemplo 1 de ExtractByCircle (ventana de Python)
En este ejemplo se extraen las celdas dentro de un radio de 500 metros alrededor de una ubicación de punto.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outExtCircle = ExtractByCircle("elevation", arcpy.Point(482838.823, 222128.982),
500, "INSIDE")
outExtCircle.save("c:/sapyexamples/output/extcircle")
Ejemplo 2 de ExtractByCircle (secuencia de comandos independiente)
En este ejemplo se extraen las celdas dentro de un radio de 1,000 metros alrededor de una ubicación de punto.
# Name: ExtractByCircle_Ex_02.py
# Description: Extracts the cells of a raster based on a circle.
# 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")
centerPoint = arcpy.Point(482838.823, 222128.982)
circRadius = 1000
extractType = "INSIDE"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute ExtractByCircle
outExtCircle = ExtractByCircle(inRaster, centerPoint, circRadius,
extractType)
# Save the output
outExtCircle.save("c:/sapyexamples/output/extcircle02")
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