Borrar por pares (Análisis)

Resumen

Calcula una intersección por pares de las entidades de entrada y de borrado. Solo esas partes de las entidades de entrada que queden fuera de las entidades de borrado se copiarán en la clase de entidad de salida.

Existe una herramienta alternativa para las operaciones de borrado. Consulte la documentación de la herramienta Borrar para obtener detalles.

Ilustración

Ilustración de la herramienta Borrar por pares

Uso

  • El valor del parámetro Entidades de borrado puede ser de puntos, de línea o de polígonos siempre que el valor del parámetro Entidades de entrada sea del mismo tipo de entidad de orden o menor. Se puede utilizar una entidad de borrado poligonal 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.

    El valor del parámetro Entidades de Entrada debe contener entidades simples: punto, multipunto, línea o polígono. No pueden ser entidades complejas tales como entidades de anotación, entidades de dimensión o entidades de red.

  • 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.

    Precaución:

    Las herramientas de geoprocesamiento no cumplen las políticas de división de campos de tabla o clases de entidad de geodatabase.

  • Las entidades de curva de entrada se densificarán en la salida.

  • Para usar esta herramienta, las entidades de entrada deben tener un índice espacial. Utilice la herramienta Agregar índice espacial para crear un índice (especialmente para los shapefiles) o volver a generar un índice existente si hay alguna duda de que sea correcto.

  • Cuando las entidades de entrada tienen valores m o z, solo los valores m o z de la primera clase de entidad se transferirán a las entidades de salida. Si la primera clase de entidad no tiene valores m ni z, la salida tampoco contendrá valores m ni z.

  • La referencia espacial de la clase de entidad de salida será la de la primera clase de entidad del parámetro Entidades de entrada. Consulte Referencia espacial y geoprocesamiento para obtener más información.

  • De forma predeterminada, las entidades de curva de la entrada se densifican en la salida. Para admitir curvas en la salida, utilice el entorno Mantener segmentos de curva.

  • Esta herramienta respeta el entorno Factor de procesamiento en paralelo. Si el entorno no está configurado (predeterminado) o está configurado con el valor 100, se permitirá el procesamiento en paralelo completo y la herramienta intentará distribuir el trabajo entre todos los núcleos lógicos del equipo. Configurar el entorno a 0 desactiva el procesamiento en paralelo. Especificar un factor entre 1 y 99 hará que la herramienta identifique el porcentaje de núcleos lógicos que debe usar aplicando la fórmula (Factor de procesamiento en paralelo / 100 * Núcleos lógicos) redondeada al entero más próximo. Si el resultado de la fórmula es 0 o 1, no se habilitará el procesamiento en paralelo.

  • La herramienta Borrar por pares es similar a la herramienta Borrar en cuanto a que se calculan las intersecciones geométricas, pero es distinta en cuanto a que las intersecciones se calculan por pares de entidades en vez de por todas las combinaciones de entidades. Esta herramienta es eficaz en situaciones en las que las clases de entidades de entrada o de borrado contienen una gran cantidad de entidades empaquetadas densamente.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

La capa o clase de entidad de entrada.

Feature Layer
Entidades de borrado

Las entidades que se van a utilizar para borrar entidades coincidentes en la entrada.

Feature Layer
Clase de entidad de salida

La clase de entidad de salida.

Feature Class
Tolerancia XY
(Opcional)

La distancia mínima que separa todas las coordenadas de entidades (nodos y vértices), así como también la distancia que se puede mover una coordenada en X o en Y (o en los dos).

Precaución:

El cambio del valor de este parámetro puede generar un fallo o resultados inesperados. Se recomienda no modificar este parámetro. Se ha eliminado de la vista en el cuadro de diálogo de la herramienta. Se utiliza de forma predeterminada la propiedad tolerancia x,y de referencia espacial de la clase de entidad de entrada.

Linear Unit

arcpy.analysis.PairwiseErase(in_features, erase_features, out_feature_class, {cluster_tolerance})
NombreExplicaciónTipo de datos
in_features

La capa o clase de entidad de entrada.

Feature Layer
erase_features

Las entidades que se van a utilizar para borrar entidades coincidentes en la entrada.

Feature Layer
out_feature_class

La clase de entidad de salida.

Feature Class
cluster_tolerance
(Opcional)

La distancia mínima que separa todas las coordenadas de entidades (nodos y vértices), así como también la distancia que se puede mover una coordenada en X o en Y (o en los dos).

Precaución:

El cambio del valor de este parámetro puede generar un fallo o resultados inesperados. Se recomienda no modificar este parámetro. Se ha eliminado de la vista en el cuadro de diálogo de la herramienta. Se utiliza de forma predeterminada la propiedad tolerancia x,y de referencia espacial de la clase de entidad de entrada.

Linear Unit

Muestra de código

Ejemplo 1 de PairwiseErase (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función PairwiseErase de modo inmediato.

import arcpy
arcpy.env.workspace = 'C:/data/gdb'
arcpy.analysis.PairwiseErase(r'redlands.gdb\rdlswells\well', 
                             r'redlands.gdb\rdlsfloodzones\flood', 
                             r'redlands.gdb\wellsoutside_flood')
Ejemplo 2 de PairwiseErase (script independiente)

Buscar áreas de vegetación adecuadas que excluyan áreas muy afectadas por carreteras importantes.

# Name: PairwiseErase.py
# Description: Find areas of suitable vegetation that exclude areas heavily 
#              impacted by major roads.

# Import system modules 
import arcpy

# Set environment settings
arcpy.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.analysis.Select(veg, suitableVeg, whereClause)

# Buffer areas of impact around major roads
roads = "majorrds"
roadsBuffer = "C:/output/Output.gdb/buffer_output"
distanceField = "Distance"
dissolveField = "Distance"
arcpy.analysis.Buffer(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"
arcpy.analysis.PairwiseErase(suitableVeg, roadsBuffer, eraseOutput)

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados