Integrieren (Datenmanagement)

Zusammenfassung

Analysiert die Koordinatenpositionen von Feature-Stützpunkten in mindestens einer Feature-Class. Die Stützpunkte, die innerhalb eines bestimmten Abstands zu anderen Stützpunkten angeordnet sind, werden als lagegleich festgelegt und einem gemeinsamen Koordinatenwert zugewiesen. Das Werkzeug fügt auch Stützpunkte hinzu, wenn Feature-Stützpunkte innerhalb der XY-Toleranz liegen und sich mit Linien-Segmenten überschneiden.

Integrieren führt die folgenden Verarbeitungs-Tasks aus:

  • Innerhalb der jeweiligen XY-Toleranz liegende Stützpunkte werden derselben Koordinatenposition zugewiesen.
  • Wenn ein Stützpunkt eines Features innerhalb der XY-Toleranz einer Kante eines anderen Features liegt, wird auf der Kante ein neuer Stützpunkt eingefügt.
  • Wenn sich Liniensegmente überschneiden, wird für jedes an der Überschneidung beteiligte Feature am Schnittpunkt ein Stützpunkt eingefügt.

Für die Integration von Vektordaten gibt es ein alternatives Werkzeug. Weitere Informationen finden Sie in der Dokumentation zum Werkzeug Paarweise integrieren.

Abbildung

Abbildung des Werkzeugs "Integrieren"

Verwendung

    Vorsicht:

    Mit diesem Werkzeug werden die Eingabedaten geändert. Weitere Informationen und Strategien zur Vermeidung unerwünschter Datenänderungen finden Sie unter Werkzeuge, die Eingabedaten ändern oder aktualisieren.

  • Falls Eingabe-Features ausgewählt werden, wird dieses Werkzeug nur an diesen ausgewählten Features ausgeführt.

  • Dieses Werkzeug führt insofern die gleiche Art von Aufgaben wie eine Topologie aus, als es Features innerhalb einer XY-Toleranz verschiebt und Stützpunkte an Schnittpunkten von Features einfügt. Verwenden Sie ggf. für Vorgänge dieser Art eine Topologie, da Sie bei Topologien Regeln und Bedingungen angeben können, die definieren, in welchem Verhältnis Features zueinander stehen.

    Verwenden Sie in folgenden Fällen anstelle einer Topologie Integrieren:

    • Sie müssen keine Regeln zum Verschieben von Features angeben, und es sollen sich alle Features innerhalb der angegebenen Toleranz verbinden.
    • Linien sollen Stützpunkte an allen Schnittpunkten aufweisen.
    • Sie arbeiten mit Features, die nicht zur Geodatabase gehören, z. B. Shapefiles, oder mit Features aus anderen Geodatabases (alle Features in einer Topologie müssen aus demselben Feature-Dataset stammen).

  • Viele in den Daten vorhandene potenzielle Probleme können möglicherweise bei der Integration behoben werden. Die Behandlung sehr kleiner Über- oder Unterstände, die automatische Splitterentfernung doppelter Segmente und die Ausdünnung von Koordinaten entlang von Grenzlinien können möglicherweise behoben werden.

  • Es wird empfohlen, den Parameter XY-Toleranz nicht zu verwenden. Bei fehlender Angabe verwendet das Werkzeug den Raumbezug der Eingabe-Feature-Classes, um die bei der Integration zu verwendende XY-Toleranz zu identifizieren. Für den Raumbezug der Eingabe-Daten muss die XY-Standardauflösung und die XY-Toleranz verwendet werden. Weitere Informationen über Raumbezüge finden Sie unter Eigenschaften eines Raumbezugs.

    Der Parameter XY-Toleranz ist nicht zum Generalisieren von Geometrieformen bestimmt. Er ist für die Integration von Liniendaten und Grenzen im Kontext eines korrekt eingerichteten Raumbezugs einer Eingabe-Feature-Class vorgesehen. Wird der Parameter XY-Toleranz abseits des Standards für den Eingaberaumbezug festgelegt, könnte dies dazu führen, dass Features sich zu viel oder zu wenig bewegen, was Geometrieprobleme zur Folge hat. Werden die korrekten Eigenschaften des Raumbezugs verwendet, kann durch Ausführen des Werkzeugs Integrieren die Anzahl der Datenbewegungen bei nachfolgenden topologischen Vorgängen (wie Überlagerung und Zusammenführung) minimiert werden.

    Der Wert für XY-Toleranz ist wichtig. Es wird empfohlen, die Eigenschaften des Raumbezugs der Eingabe-Feature-Class auf die Standardwerte zu setzen und das Werkzeug Integrieren standardmäßig die Eigenschaften der Eingabe-Feature-Class verwenden zu lassen. Weitere Informationen finden Sie unter Cluster-Verarbeitung.

  • Das Werkzeug Integrieren akzeptiert als Eingaben nur Simple-Feature-Classes (Point, Multipoint, Line oder Polygon).

  • Zum Rückgängigmachen von Änderungen an den Eingabe-Features verwenden Sie das Werkzeug Integrieren in einer Editiersitzung.

  • Beim Verarbeiten von Datasets, die individuelle Features mit einer extrem großen Anzahl von Stützpunkten enthalten (z. B. mehrere Hunderttausend bis Millionen von Stützpunkten in einem einzigen Feature), kann es vorkommen, dass für einige geometrische Verarbeitungsvorgänge nicht genügend Speicher zur Verfügung steht. Weitere Informationen finden Sie unter Geoverarbeitung mit großen Datasets.

  • Das Ausgabe-Datenelement dieses Werkzeugs ist eine abgeleitete mehrwertige Ausgabe. Verwenden Sie die Eingaben dieses Werkzeugs unmittelbar und legen Sie seine Ausgabe als Vorbedingung für das andere Werkzeug fest, um die Ausgaben dieses Werkzeugs mit einem anderen Werkzeug zu verwenden.

    Weitere Informationen zum Festlegen einer Vorbedingung

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Features

Die zu integrierenden Feature-Classes. Wenn die Entfernung zwischen den Features im Vergleich zur Toleranz klein ist, werden die Stützpunkte oder Punkte gruppiert (verschoben, um lagegleich zu sein). Die Feature-Class/der Layer mit der niedrigeren Rangstufe wird an dem Feature der Feature-Class/des Layers mit der höheren Rangstufe ausgerichtet (wobei 1 eine höhere Rangstufe ist als 2). Features in der Feature-Class mit der Rangstufe 1 werden möglicherweise verschoben, wenn eine große XY-Toleranz verwendet wird. Weitere Informationen finden Sie im Abschnitt zu Rangstufen und Geoverarbeitungswerkzeugen.

Value Table
XY-Toleranz
(optional)

Die Entfernung, die den Bereich bestimmt, in dem die Feature-Stützpunkte lagegleich gemacht werden. Damit das unerwünschte Verschieben von Stützpunkten minimiert wird, sollten Sie die XY-Toleranz relativ klein festlegen. Falls kein Wert angegeben ist, wird die XY-Toleranz aus dem ersten Dataset in der Liste der Eingaben verwendet.

Vorsicht:

Das Ändern dieses Parameterwertes kann zu einem Fehler oder zu unerwarteten Ergebnissen führen. Es wird empfohlen, diesen Parameter nicht zu ändern. Er wurde im Werkzeug-Dialogfeld aus der Ansicht entfernt. Standardmäßig wird die Eigenschaft XY-Toleranz des Raumbezugs der Eingabe-Feature-Class verwendet.

Linear Unit

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Aktualisierte Eingabe-Features

Die aktualisierten Eingabe-Features.

Feature Layer

arcpy.management.Integrate(in_features, {cluster_tolerance})
NameErläuterungDatentyp
in_features
[[Feature Layer, Long],...]

Die zu integrierenden Feature-Classes. Wenn die Entfernung zwischen den Features im Vergleich zur Toleranz klein ist, werden die Stützpunkte oder Punkte gruppiert (verschoben, um lagegleich zu sein). Die Feature-Class/der Layer mit der niedrigeren Rangstufe wird an dem Feature der Feature-Class/des Layers mit der höheren Rangstufe ausgerichtet (wobei 1 eine höhere Rangstufe ist als 2). Features in der Feature-Class mit der Rangstufe 1 werden möglicherweise verschoben, wenn eine große XY-Toleranz verwendet wird. Weitere Informationen finden Sie im Abschnitt zu Rangstufen und Geoverarbeitungswerkzeugen.

Value Table
cluster_tolerance
(optional)

Die Entfernung, die den Bereich bestimmt, in dem die Feature-Stützpunkte lagegleich gemacht werden. Damit das unerwünschte Verschieben von Stützpunkten minimiert wird, sollten Sie die XY-Toleranz relativ klein festlegen. Falls kein Wert angegeben ist, wird die XY-Toleranz aus dem ersten Dataset in der Liste der Eingaben verwendet.

Vorsicht:

Das Ändern dieses Parameterwertes kann zu einem Fehler oder zu unerwarteten Ergebnissen führen. Es wird empfohlen, diesen Parameter nicht zu ändern. Er wurde im Werkzeug-Dialogfeld aus der Ansicht entfernt. Standardmäßig wird die Eigenschaft XY-Toleranz des Raumbezugs der Eingabe-Feature-Class verwendet.

Linear Unit

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_features

Die aktualisierten Eingabe-Features.

Feature Layer

Codebeispiel

Integrieren – Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion Integrate im unmittelbaren Modus verwendet wird.

import arcpy

arcpy.env.workspace = "C:/data"
arcpy.management.CopyFeatures("Habitat_Analysis.gdb/vegtype", "C:/output/output.gdb/vegtype")
arcpy.management.Integrate("C:/output/output.gdb/vegtype")
Integrieren – Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Skript ist ein Beispiel für die Anwendung der Funktion Integrate in einer Skriptumgebung.

# Description: Run Integrate on a feature class
 
# Import system modules
import arcpy
 
# Set environment settings
arcpy.env.workspace = "C:/data/Habitat_Analysis.gdb"
 
# Set local variables
inFeatures = "vegtype"
integrateFeatures = "C:/output/output.gdb/vegtype"
 
# Run CopyFeatures (since Integrate modifies the original data,
#  this ensures the original is preserved)
arcpy.management.CopyFeatures(inFeatures, integrateFeatures)
 
# Run Integrate
arcpy.management.Integrate(integrateFeatures)