Integrieren (Data Management)

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 ist ein alternatives Werkzeug verfügbar. Weitere Informationen finden Sie in der Dokumentation zum Werkzeug Paarweise integrieren.

Abbildung

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 für die 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 dieses Werkzeug:

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

• Potenziell in den Daten vorhandene Probleme werden möglicherweise bei der Integration behoben. 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 davon abgeraten, einen Wert für den Parameter XY-Toleranz anzugeben. Bei keiner Wertangabe verwendet das Werkzeug den Raumbezug der Eingabe-Feature-Classes, um die bei der Integration zu verwendende XY-Toleranz zu bestimmen. Vergewissern Sie sich, dass der Raumbezug der Eingabedaten auf die standardmäßige XY-Auflösung und XY-Toleranz festgelegt ist.

  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 auf einen anderen Wert als den Standardwert für den Eingaberaumbezug festgelegt, kann dies dazu führen, dass Features zu viel oder zu wenig verschoben werden, 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.

  Weitere Informationen zur Cluster-Verarbeitung

• Dieses Werkzeug akzeptiert als Eingabe nur Simple-Feature-Classes (Point, Multipoint, Line oder Polygon).

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

• 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

Dialogfeld

Beschriftung	Erläuterung	Datentyp
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 auf einen kleinen Wert 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

Beschriftung	Erläuterung	Datentyp
Aktualisierte Eingabe-Features	Die aktualisierten Eingabe-Features.	Feature Layer

Python

arcpy.management.Integrate(in_features, {cluster_tolerance})

Name	Erläuterung	Datentyp
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 auf einen kleinen Wert 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

Name	Erläuterung	Datentyp
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)

Umgebungen

Aktueller Workspace, Ausdehnung, XY-Toleranz

Lizenzinformationen

• Basic: Ja
• Standard: Ja
• Advanced: Ja