Diferencia simétrica (Análisis)

Disponible con una licencia Advanced.

Resumen

Calcula una intersección geométrica de las entidades de entrada y actualización, y devuelve las entidades de entrada y actualización que no se superponen. Las entidades o partes de entidades en las entidades de entrada y de actualización que no se superpongan se escribirán en la clase de entidad de salida.

Ilustración

Ilustración de la herramienta Diferencia simétrica

Uso

  • La clase de entidad o capa de entidades de entrada y de actualización deben ser del mismo tipo de geometría.

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

  • Para mejorar el rendimiento y la escalabilidad, esta herramienta utiliza un proceso de ordenamiento en teselas para manejar datasets muy grandes. Para más información, consulte Procesamiento en teselas de datasets grandes.

  • Esta herramienta puede generar entidades multiparte en la salida, aunque todas las entradas tengan una única parte. Si no desea tener entidades multiparte, utilice la herramienta De multiparte a parte simple en la clase de entidad de salida.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

La capa o clase de entidad de entrada.

Feature Layer
Entidades de actualización

La capa o clase de entidad de actualización. El tipo de geometría debe ser el mismo que el de la capa o clase de entidad de entrada.

Feature Layer
Clase de entidad de salida

La clase de entidad en la que se escribirán los resultados.

Feature Class
Atributos para unir
(Opcional)

Especifica los atributos que se transferirán a la clase de entidad de salida.

  • Todos los atributosTodos los atributos de las entidades de entrada se transferirán a la clase de entidad de salida. Esta es la opción predeterminada.
  • Todos los atributos excepto los Id. de entidadTodos los atributos excepto el FID de las entidades de entrada se transferirán a la clase de entidad de salida.
  • Solo Id. de entidadSolo se transferirá a la clase de entidad de salida el campo FID de las entidades de entrada.
String
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.SymDiff(in_features, update_features, out_feature_class, {join_attributes}, {cluster_tolerance})
NombreExplicaciónTipo de datos
in_features

La capa o clase de entidad de entrada.

Feature Layer
update_features

La capa o clase de entidad de actualización. El tipo de geometría debe ser el mismo que el de la capa o clase de entidad de entrada.

Feature Layer
out_feature_class

La clase de entidad en la que se escribirán los resultados.

Feature Class
join_attributes
(Opcional)

Especifica los atributos que se transferirán a la clase de entidad de salida.

  • ALLTodos los atributos de las entidades de entrada se transferirán a la clase de entidad de salida. Esta es la opción predeterminada.
  • NO_FIDTodos los atributos excepto el FID de las entidades de entrada se transferirán a la clase de entidad de salida.
  • ONLY_FIDSolo se transferirá a la clase de entidad de salida el campo FID de las entidades de entrada.
String
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 de SymDiff (ventana de Python)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.analysis.SymDiff("climate.shp", "elevlt250.shp", "C:/output/symdiff.shp", 
                       "ALL", 0.001)
Ejemplo 2 de SymDiff (script independiente)

El siguiente script independiente muestra cómo utilizar la función SymDiff.


# Name: SymDiff_Example2.py
# Description: Create symmetrical difference between input and update features
 
# Import system modules
import arcpy
 
# Set environment settings
arcpy.env.workspace = "C:/data"
 
# Set local variables
inFeatures = "climate.shp"
updateFeatures = "elevlt250.shp"
outFeatureClass = "C:/output/symdiff.shp"
clusterTolerance = 0.001
 
# Run SymDiff
arcpy.analysis.SymDiff(inFeatures, updateFeatures, outFeatureClass, "ALL",
                       clusterTolerance)

Entornos

Casos especiales

Factor de procesamiento en paralelo

Esta herramienta respeta el entorno de Factor de procesamiento en paralelo. Si no se establece el entorno (valor predeterminado) o si se establece en 0, se desactivará el procesamiento en paralelo. El procesamiento paralelo no se utilizará y el procesamiento se hará de forma secuencial. Si se establece el entorno en 100, se habilitará el procesamiento en paralelo. Se utilizará el procesamiento paralelo y el procesamiento se hará en paralelo. Se utilizarán hasta 10 núcleos cuando se active el procesamiento en paralelo.

Información de licenciamiento

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

Temas relacionados