Disponible con una licencia Advanced.
Resumen
Crea una clase de entidad mediante la superposición de las entidades de entrada con los polígonos de las entidades de borrado. Solo las partes de las entidades de entrada que no queden comprendidas en los límites externos de las entidades de borrado se copiarán en la clase de entidad de salida.
Ilustración
Uso
Las geometrías de la entidad de entrada coincidentes con geometrías de la entidad de borrado se quitarán.
Las entidades de borrado pueden ser de puntos, de línea o de polígonos siempre que la entidad de entrada sea del mismo tipo de entidad de orden o menor. Una entidad de borrado poligonal se puede utilizar para borrar polígonos, líneas o puntos de las entidades de entrada. Una entidad de borrado lineal se puede utilizar para borrar líneas o puntos de las entidades de entrada. Una entidad de borrado puntual se puede utilizar para borrar puntos de las entidades de entrada.
Los valores de atributo de las clases de entidad de entrada se copiarán a la clase de entidad de salida. Sin embargo, si la entrada hay capas creadas por la herramienta Crear capa de entidades y el campo Utilizar política de relación está activado, se calculará una proporción del valor del atributo de entrada para el valor del atributo de salida. Cuando se habilita Utilizar política de relación, siempre que se divida una entidad en una operación de superposición, los atributos de las entidades resultantes son una relación del valor de atributo de la entidad de entrada. El valor de salida está basado en la relación en la que se dividió la geometría de la entidad de entrada. Por ejemplo, si la geometría de entrada se dividió equitativamente, al valor de atributo de cada entidad nueva se le asigna la mitad del valor de atributo de la entidad de entrada. Utilizar política de relación solo se aplica a los tipos de campos numéricos.
Esta herramienta utilizará un proceso de ordenamiento en tesela para controlar datasets muy grandes para mejorar el rendimiento y la escalabilidad. Para obtener más detalles, consulte Geoprocesamiento con datasets grandes.
Esta herramienta puede generar entidades multiparte en la salida aunque todas las entradas tengan una única parte. Si no se desea tener entidades multiparte, utilice la herramienta De multiparte a parte simple sobre la clase de entidad de salida.
Sintaxis
arcpy.analysis.Erase(in_features, erase_features, out_feature_class, {cluster_tolerance})
Parámetro | Explicación | Tipo de datos |
in_features | La capa o clase de entidad de entrada. | Feature Layer |
erase_features | Entidades que se van a utilizar para borrar entidades coincidentes en la entrada. | Feature Layer |
out_feature_class | Clase de entidad que contendrá solo las entidades de entrada que no sean coincidentes con las entidades de borrado. | Feature Class |
cluster_tolerance (Opcional) | La distancia mínima que separa todas las coordenadas de entidades (nodos y vértices), como también la distancia que se puede mover una coordenada en X o en Y (o en los dos). | Linear unit |
Muestra de código
Ejemplo de Borrar (ventana Puzzle)
La siguiente secuencia de comandos de la ventana Puzzle demuestra cómo utilizar la función Borrar en modo inmediato.
import arcpy
from arcpy import env
env.workspace = "C:/data/data/gdb"
arcpy.Erase_analysis(r'redlands.gdb\rdlswells\well',r'redlands.gdb\rdlsfloodzones\flood',r'redlands.gdb\wellsoutside_flood','#')
Ejemplo de Borrar (secuencia de comandos independiente)
Buscar áreas de vegetación adecuadas que excluyan áreas muy afectadas por carreteras importantes.
# Name: Erase.py
# Description: Find areas of suitable vegetation which exclude areas heavily impacted by major roads
# Author: ESRI
# import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data/Habitat_Analysis.gdb"
# Select suitable vegetation patches from all vegetation
veg = "vegtype"
suitableVeg = "C:/output/Output.gdb/suitable_vegetation"
whereClause = "HABITAT = 1"
arcpy.Select_analysis(veg, suitableVeg, whereClause)
# Buffer areas of impact around major roads
roads = "majorrds"
roadsBuffer = "C:/output/Output.gdb/buffer_output"
distanceField = "Distance"
dissolveField = "Distance"
arcpy.Buffer_analysis(roads, roadsBuffer, distanceField, "FULL", "ROUND", "LIST", dissolveField)
# Erase areas of impact around major roads from the suitable vegetation patches
eraseOutput = "C:/output/Output.gdb/suitable_vegetation_minus_roads"
xyTol = "1 Meters"
arcpy.Erase_analysis(suitableVeg, roadsBuffer, eraseOutput, xyTol)
Entornos
- Auto ejecución
- Nombres de campos calificados
- Valor Z de salida predeterminado
- Resolución M
- Tolerancia M
- Palabra clave CONFIG de salida
- Palabra clave CONFIG de salida
- Dominio XY de salida
- Dominio Z de salida
- Sistema de coordenadas de salida
- Extensión
- La salida tiene valores M
- La salida tiene valores Z
- Cuadrícula espacial de salida 1
- Cuadrícula espacial de salida 2
- Cuadrícula espacial de salida 3
- Resolución XY
- Tolerancia XY
- Resolución Z
- Tolerancia Z
Información de licenciamiento
- Basic: No
- Standard: No
- Advanced: Sí