Compara entidad (Gestión de datos)

Nivel de licencia:BasicStandardAdvanced

Resumen

Compara dos capas o clases de entidades y devuelve los resultados de la comparación. Comparar entidades puede informar de las diferencias de geometría, valores tabulares, referencia espacial y definiciones de campo.

Uso

Sintaxis

FeatureCompare_management (in_base_features, in_test_features, sort_field, {compare_type}, {ignore_options}, {xy_tolerance}, {m_tolerance}, {z_tolerance}, {attribute_tolerances}, {omit_field}, {continue_compare}, {out_compare_file})
ParámetroExplicaciónTipo de datos
in_base_features

Las Entidades base de entrada se comparan con las Entidades test de entrada. Entidades base de entrada se refiere a los datos que ha declarado como válidos. Estos datos base tienen las definiciones de geometría, las definiciones de campo y la referencia espacial correctas.

Feature Layer
in_test_features

Las Entidades test de entrada se comparan con las Entidades base de entrada. Las Entidades test de entrada se refieren a los datos que usted modificó al editar o compilar entidades nuevas.

Feature Layer
sort_field
[sort_field,...]

El campo o los campos utilizados para ordenar los registros en la Tabla base de entrada y la Tabla test de entrada. Los registros se clasifican en orden ascendente. El ordenamiento por campo común en las Entidades base de entrada y las Entidades test de entrada asegura que se está comparando la misma fila de cada dataset de entrada.

Value Table
compare_type
(Opcional)

Tipo de comparación. ALL es el valor predeterminado. El valor predeterminado comparará todas las propiedades de las entidades que se están comparando.

  • TODOSe compararán todas las propiedades de las clases de entidades. Esta es la opción predeterminada.
  • GEOMETRY_ONLYSólo se compararán las geometrías de las clases de entidades.
  • ATTRIBUTES_ONLYSólo se compararán los atributos y sus valores.
  • SCHEMA_ONLYSólo se compararán los esquemas de las clases de entidades.
  • SPATIAL_REFERENCE_ONLYSólo se compararán las referencias espaciales de las dos clases de entidades.
String
ignore_options
[ignore_option,...]
(Opcional)

Estas propiedades no se compararán durante la comparación.

  • IGNORE_MNo comparar propiedades de medición.
  • IGNORE_ZNo comparar propiedades de elevación.
  • IGNORE_POINTIDNo comparar propiedades de Id. de punto.
  • IGNORE_EXTENSION_PROPERTIESNo comparar propiedades de extensión.
  • IGNORE_SUBTYPESNo comparar subtipos.
  • IGNORE_RELATIONSHIPCLASSESNo comparar clases de relación.
  • IGNORE_REPRESENTATIONCLASSESNo comparar clases de representación.
String
xy_tolerance
(Opcional)

La distancia que determina el rango en el cual las entidades se consideran iguales. Para minimizar el error, el valor que elija para la tolerancia de comparación debe ser tan pequeño como sea posible. Por defecto, la tolerancia de comparación es la tolerancia XY de las entidades base de entrada.

Linear unit
m_tolerance
(Opcional)

La tolerancia de medición es la distancia mínima entre las medidas antes de que se las considere iguales.

Double
z_tolerance
(Opcional)

La tolerancia Z es la distancia mínima entre las coordenadas Z antes de que se las considere iguales.

Double
attribute_tolerances
[[Field, {Tolerance}],...]
(Opcional)

El valor numérico que determina el rango en el cual los valores de atributos se consideran iguales. Esto sólo se aplica a los tipos de campos numéricos.

Value Table
omit_field
[omit_field,...]
(Opcional)

El campo o los campos que se omitirán durante la comparación. Se ignorarán las definiciones de campo y los valores tabulares para estos campos.

String
continue_compare
(Opcional)

Indica si se deben comparar todas las propiedades después de encontrar la primera falta de coincidencia.

  • NO_CONTINUE_COMPARESe detiene después de encontrar la primera falta de coincidencia. Esta es la opción predeterminada.
  • CONTINUE_COMPARECompara otras propiedades después de encontrar la primera falta de coincidencia.
Boolean
out_compare_file
(Opcional)

Este archivo contendrá todas las similitudes y diferencias entre las Entidades base de entrada y las Entidades test de entrada. Este archivo es un archivo de texto delimitado por comas que se puede ver y utilizar como una tabla en ArcGIS.

File

Ejemplo de código

Ejemplo de la herramienta FeatureCompare (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python demuestra cómo utilizar la función FeatureCompare en el modo inmediato.

import arcpy
arcpy.FeatureCompare_management(r'C:/Workspace/baseroads.shp', r'C:/Workspace/newroads.shp', 'ROAD_ID', 'ALL', 'IGNORE_M;IGNORE_Z', '0.001 METERS', 0, 0, 'Shape_Length 0.001', '#', 'CONTINUE_COMPARE', e = r'C:/Workspace/roadcompare.txt')
Ejemplo de la herramienta FeatureCompare (secuencia de comandos independiente)

Ejemplo de cómo utilizar la herramienta FeatureCompare en una secuencia de comandos independiente.

# Name: FeatureCompare.py
# Description: Compare two feature classes and return comparison result.

# import system modules 
import arcpy

try:
    # Set local variables
    base_features = "C:/Workspace/baseroads.shp"
    test_features = "C:/Workspace/newroads.shp"
    sort_field = "ROAD_ID"
    compare_type = "ALL"
    ignore_option = "IGNORE_M;IGNORE_Z"
    xy_tolerance = "0.001 METERS"
    m_tolerance = 0
    z_tolerance = 0
    attribute_tolerance = "Shape_Length 0.001"
    omit_field = "#"
    continue_compare = "CONTINUE_COMPARE"
    compare_file = "C:/Workspace/roadcompare.txt"
 
    # Process: FeatureCompare
    compare_result = arcpy.FeatureCompare_management(base_features, test_features, sort_field, compare_type, ignore_option, xy_tolerance, m_tolerance, z_tolerance, attribute_tolerance, omit_field, continue_compare, compare_file)
    print compare_result.getOutpuput(1)
    print arcpy.GetMessages()
 
except:
    # Print error message if an error occurs
    print arcpy.GetMessages()

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Temas relacionados

Información sobre licencias

ArcGIS for Desktop Basic: Sí
ArcGIS for Desktop Standard: Sí
ArcGIS for Desktop Advanced: Sí
5/12/2014