Resumen
Crea una nueva cobertura de salida mediante la superposición de polígonos de la cobertura de borrado sobre las entidades de la cobertura de entrada. Solo se copian en la cobertura de salida las partes de las entidades de cobertura de entrada que estén fuera de los límites exteriores del polígono de borrado.
Ilustración
Uso
La cobertura de salida no puede existir con anterioridad.
Se borra la anotación si su punto de partida inferior izquierdo queda comprendido en el polígono de borrado.
Los nodos nuevos tienen sus atributos establecidos en cero.
Se quitan los polígonos de la cobertura de entrada que coinciden con los polígonos de la cobertura de borrado.
La cobertura de borrado debe tener topología de polígono.
Los ID de usuario para todas las entidades son los mismos en la cobertura de salida que en la cobertura de entrada.
Con las opciones POLY y NET, la topología de polígono se vuelve a generar en la cobertura de salida. Siempre que sea posible, los puntos de etiqueta de polígono de entrada se conservan en los resultados. Cada polígono antiguo mantiene la posición inicial del punto de etiqueta si no queda comprendido en el polígono de la cobertura de borrado.
Los límites de los polígonos interiores en la cobertura de borrado no se utilizan en ERASE. Se considera que cualquier polígono de la cobertura de borrado cuyo número interno sea mayor a uno se encuentra dentro de la ventana de borrado; si el número del polígono interno es uno, se considerará que está fuera. Solamente se almacenan en la cobertura de salida las entidades de entrada (o partes de las mismas) que estén fuera de la región de borrado.
Los límites externos de la cobertura de borrado definen el área de las entidades de cobertura de entrada que se van a quitar. Se considera que cualquier polígono de la cobertura de borrado cuyo número interno sea mayor a uno se encuentra dentro de la ventana de borrado; si el número del polígono interno es uno, se considerará que está fuera.
Si el polígono de la cobertura de borrado queda totalmente comprendido en un polígono de entrada, no se borrarán polígonos. Se inserta un polígono adicional en la cobertura de salida, tal como defina el polígono del contorno de la cobertura de borrado y se le asigna un punto de etiqueta con un ID de usuario igual a cero (esto es para la opción POLY). Si se utiliza la opción LINE, no se agregará nada. La cobertura de salida sigue siendo idéntica a la cobertura de entrada.
Los sistemas de rutas se volverán a compilar para las opciones LINE, NET, LINK y RAW, pero con la opción POLY se omitirán. Los sistemas de rutas se duplican para los arcos divididos en diversas porciones y se eliminan para los arcos que se hayan eliminado. ERASE mantiene todas las subclases del sistema de rutas.
Con la opción POLY, se conservan las subclases de la región en la cobertura de entrada. Las regiones en la cobertura de entrada se borran en la cobertura de salida según la amplitud de la cobertura de borrado.
Las subclases de la región en la cobertura de borrado no se heredan.
Si una tabla de atributos de nodo (NAT) existe antes de ERASE, se conservará posteriormente para aquellos nodos que prevalezcan tras ejecutar ERASE. Los nodos nuevos tienen sus atributos establecidos en cero.
Los puntos de relevancia de la cobertura de salida se copian desde la cobertura de entrada.
El archivo de proyección (PRJ) se copia en la cobertura de salida.
La precisión de las coordenadas de la cobertura de salida la determina la regla de procesamiento actual según se establezca a través de la configuración de entorno Precisión de coberturas derivadas. Si no se establece la regla de procesamiento, la cobertura de salida tiene la misma precisión que la cobertura de entrada.
Cuando la cobertura de entrada contiene datos lineales que pertenecen a gráficos planares diferentes, los datos se mantendrán en la cobertura de salida. Por ejemplo, con los arcos coincidentes o colineales, como los arcos que representan cables de servicios a diferentes niveles o una carretera que sigue un río, se conservarán los segmentos de línea coincidentes o colineales. Sin embargo, se pueden insertar vértices adicionales. En el caso de los arcos de intersección, como una carretera que pasa sobre un río, no se insertarán nodos en la intersección aparente.
Más información sobre cómo se calcula la tolerancia difusa predeterminada.
Sintaxis
arcpy.arc.Erase(in_cover, erase_cover, out_cover, {feature_type}, {fuzzy_tolerance})| Parámetro | Explicación | Tipo de datos |
in_cover | La cobertura que contiene entidades que se van a borrar. | Coverage |
erase_cover | Cobertura cuyo polígono exterior define la región de borrado. | Coverage |
out_cover | La cobertura que se creará. | Coverage |
feature_type (Opcional) | Conjunto de entidades que se va a borrar:
| String |
fuzzy_tolerance (Opcional) | La distancia mínima entre las coordenadas en la cobertura de salida. De forma predeterminada, se utiliza el valor de tolerancia difusa mínimo de la cobertura de entrada y de la cobertura de borrado. Más información sobre cómo se calcula la tolerancia difusa predeterminada. | Double |
Muestra de código
Ejemplo de Borrar (secuencia de comandos independiente)
La siguiente secuencia de comandos independiente muestra cómo borrar una área de una cobertura.
# Name: Erase_Example.py
# Description: Creates an empty area inside a polygon coverage.
# Requirements: ArcInfo Workstation
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
inCover = "tongass1"
eraseCover = "tong_azone"
outCover = "C:/output/tong_nozone"
featureType = "POLY"
# Execute Erase
arcpy.Erase_arc(inCover, eraseCover, outCover, featureType, "")
Entornos
Información de licenciamiento
- Basic: No
- Standard: No
- Advanced: Requiere ArcInfo Workstation instalado