Feature-Vergleich (Data Management)

Lizenzstufe:BasicStandardAdvanced

Zusammenfassung

Vergleicht zwei Feature-Classes oder Layer und gibt die Vergleichsergebnisse zurück. Mit Feature-Vergleich können Abweichungen bei Geometrie, Tabellenwerten, Raumbezügen und Felddefinitionen angegeben werden.

Verwendung

Syntax

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})
ParameterErläuterungDatentyp
in_base_features

Die Eingabe-Basis-Features werden mit den Eingabe-Test-Features verglichen. Eingabe-Basis-Features beziehen sich auf Daten, die als gültig deklariert wurden. Diese Basisdaten verfügen über die richtigen Geometriedefinitionen, Felddefinitionen und Raumbezüge.

Feature Layer
in_test_features

Die Eingabe-Test-Features werden mit den Eingabe-Basis-Features verglichen. Eingabe-Test-Features beziehen sich auf Daten, an denen Sie durch Bearbeiten oder Kompilieren neuer Features Änderungen vorgenommen haben.

Feature Layer
sort_field
[sort_field,...]

Das Feld bzw. die Felder, die zur Sortierung von Datensätzen in der Eingabe-Basistabelle oder der Eingabe-Testtabelle verwendet werden. Die Datensätze werden in aufsteigender Reihenfolge sortiert. Standardmäßig wird mit einem gemeinsamen Feld der Eingabe-Basis-Features und der Eingabe-Test-Features sichergestellt, dass für jedes Eingabe-Dataset dieselbe Zeile verglichen wird.

Value Table
compare_type
(optional)

Der Vergleichstyp. Die Standardeinstellung ist ALL. Mit der Standardeinstellung werden alle Eigenschaften der zu vergleichenden Features verglichen.

  • ALLAlle Eigenschaften der Feature-Classes werden verglichen. Dies ist die Standardeinstellung.
  • GEOMETRY_ONLYNur die Geometrien der Feature-Classes werden verglichen.
  • ATTRIBUTES_ONLYNur die Attribute und ihre Werte werden verglichen.
  • SCHEMA_ONLYNur das Schema der Feature-Classes wird verglichen.
  • SPATIAL_REFERENCE_ONLYNur die Raumbezüge der beiden Feature-Classes werden verglichen.
String
ignore_options
[ignore_option,...]
(optional)

Diese Eigenschaften werden während des Vergleichs nicht verglichen.

  • IGNORE_MDie Messwerteigenschaften werden nicht verglichen.
  • IGNORE_ZDie Höheneigenschaften werden nicht verglichen.
  • IGNORE_POINTIDDie Punkt-ID-Eigenschaften werden nicht verglichen.
  • IGNORE_EXTENSION_PROPERTIESDie Erweiterungseigenschaften werden nicht verglichen.
  • IGNORE_SUBTYPESDie Subtypes werden nicht verglichen.
  • IGNORE_RELATIONSHIPCLASSESDie Beziehungsklassen werden nicht verglichen.
  • IGNORE_REPRESENTATIONCLASSESDie Repräsentationsklassen werden nicht verglichen.
String
xy_tolerance
(optional)

Die Entfernung, die den Bereich bestimmt, in welchem die Features als identisch betrachtet werden. Um Fehler auf ein Minimum zu reduzieren, sollte der für die Vergleichstoleranz gewählte Wert so klein wie möglich sein. Die Vergleichstoleranz ist standardmäßig die XY-Toleranz der Eingabe-Basis-Features.

Linear unit
m_tolerance
(optional)

Die Messwerttoleranz ist der minimale Abstand zwischen Messwerten, ehe sie als gleich betrachtet werden.

Double
z_tolerance
(optional)

Die Z-Toleranz ist der minimale Abstand zwischen Z-Koordinaten, ehe sie als gleich betrachtet werden.

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

Der numerische Wert, mit dem festgelegt wird, in welchem Bereich Attributwerte als gleich betrachtet werden. Diese Option ist nur für Zahlenfelder relevant.

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

Das Feld beziehungsweise die Felder, die beim Vergleich übergangen werden. Die Felddefinitionen und die Tabellenwerte für diese Felder werden ignoriert.

String
continue_compare
(optional)

Gibt an, ob nach dem Auffinden des ersten Übereinstimmungsfehlers alle Eigenschaften verglichen werden sollen.

  • NO_CONTINUE_COMPARENach dem Auffinden des ersten Übereinstimmungsfehlers wird angehalten. Dies ist die Standardeinstellung.
  • CONTINUE_COMPARENach dem Auffinden des ersten Übereinstimmungsfehlers werden weitere Eigenschaften verglichen.
Boolean
out_compare_file
(optional)

Diese Datei enthält alle Ähnlichkeiten und Unterschiede zwischen den Eingabe-Basis-Features und den Eingabe-Test-Features. Diese Datei ist eine kommagetrennte Textdatei, die in ArcGIS als Tabelle angezeigt und verwendet werden kann.

File

Codebeispiel

FeatureCompare – Beispiel (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion "FeatureCompare" im unmittelbaren Modus verwenden.

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')
FeatureCompare – Beispiel (eigenständiges Skript)

Beispiel für die Verwendung des Werkzeugs "FeatureCompare" in einem eigenständigen Skript.

# 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
    print arcpy.GetMessages()
 
except:
    # Print error message if an error occurs
    print arcpy.GetMessages()

Umgebung

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Verwandte Themen

Lizenzierungsinformationen

ArcGIS for Desktop Basic: Ja
ArcGIS for Desktop Standard: Ja
ArcGIS for Desktop Advanced: Ja
9/11/2013