Extraer por círculo (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Resumen

Extrae las celdas de un ráster basado en un círculo especificando el centro y el radio del círculo.

Ilustración

Ilustración de la herramienta Extraer por círculo
OutRas = ExtractByCircle(InRas1, Point(2.5,2.5), 2, "INSIDE")

Uso

  • En caso de que el ráster de entrada contuviera atributos adicionales, estos se trasladarán tal cual a la tabla de atributos del ráster de salida. En función de la propiedad que se va a registrar, es posible que haya que recalcular los valores de algunos atributos.

  • Cuando se especifica un ráster multibanda como el valor de Ráster de entrada (in_raster en Python), se utilizarán todas las bandas.

    Para procesar una selección de bandas a partir de un ráster multibanda, cree primero un dataset ráster formado por esas bandas concretas con la herramienta Bandas compuestas. A continuación, use el resultado como el valor de Ráster de entrada (in_raster en Python).

    El formato de salida predeterminado es un ráster de geodatabase. Si se especifica una pila de Cuadrícula de Esri como formato de salida, el nombre de la pila no puede comenzar por un número, usar espacios ni tener más de nueve caracteres de longitud.

  • 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 parte de la celda queda fuera del círculo.

  • A las ubicaciones de las celdas que no están seleccionadas se les asigna el valor NoData.

  • 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 que se aplican a esta herramienta.

Parámetros

EtiquetaExplicaciónTipo de datos
Ráster de entrada

El ráster de entrada desde el cual se extraerán las celdas.

Raster Layer
Punto central

La coordenada central (x,y) del círculo que define el área que se extraerá.

Las coordenadas se especifican en las mismas unidades de mapa que el ráster de entrada.

Point
Radio

El 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
Área de extracción
(Opcional)

Especifica si las celdas que se seleccionarán y se escribirán en el ráster de salida son las que se encuentran dentro o fuera del círculo de entrada.

  • DentroSe seleccionarán y se escribirán en el ráster de salida las celdas que se encuentren dentro del círculo de entrada. Todas las celdas fuera del círculo recibirán valores NoData en el ráster de salida.
  • FueraSe seleccionarán y se escribirán en el ráster de salida las celdas que se encuentren fuera del círculo de entrada. Todas las celdas dentro del círculo recibirán valores NoData en el ráster de salida.
String

Valor de retorno

EtiquetaExplicaciónTipo de datos
Ráster de salida

Ráster de salida que contiene los valores de las celdas extraídos del ráster de entrada.

Raster

ExtractByCircle(in_raster, center_point, radius, {extraction_area})
NombreExplicaciónTipo 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 el siguiente:

  • Point (x, y)

Las coordenadas se especifican en las mismas unidades de mapa que el ráster de entrada.

Point
radius

El 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)

Especifica si las celdas que se seleccionarán y se escribirán en el ráster de salida son las que se encuentran dentro o fuera del círculo de entrada.

  • INSIDESe seleccionarán y se escribirán en el ráster de salida las celdas que se encuentren dentro del círculo de entrada. Todas las celdas fuera del círculo recibirán valores NoData en el ráster de salida.
  • OUTSIDESe seleccionarán y se escribirán en el ráster de salida las celdas que se encuentren fuera del círculo de entrada. Todas las celdas dentro del círculo recibirán valores NoData en el ráster de salida.
String

Valor de retorno

NombreExplicaciónTipo de datos
out_raster

Ráster de salida que contiene los valores de las celdas extraídos del ráster de entrada.

Raster

Muestra 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 1000 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"

# Execute ExtractByCircle
outExtCircle = ExtractByCircle(inRaster, centerPoint, circRadius, 
                               extractType)

# Save the output 
outExtCircle.save("c:/sapyexamples/output/extcircle02")