Paarweise integrieren (Analysis)

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.

Paarweise 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 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 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 Paarweise 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 bestimmen. 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 des Parameters XY-Toleranz ist kritisch. Es wird empfohlen, die Eigenschaften des Raumbezugs der Eingabe-Feature-Class auf die Standardwerte zu setzen und das Werkzeug Paarweise integrieren standardmäßig die Eigenschaften der Eingabe-Feature-Class verwenden zu lassen. Weitere Informationen finden Sie unter Cluster-Verarbeitung.

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

• Wenn Sie an den Eingabe-Features vorgenommene Änderungen rückgängig machen möchten, verwenden Sie das Werkzeug Paarweise integrieren in einer Editiersitzung.

• 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

• Dieses Werkzeug berücksichtigt die Umgebung Faktor für parallele Verarbeitung. Wenn die Umgebungsvariable nicht (Standardeinstellung) oder auf 100 festgelegt ist, wird die vollständige parallele Verarbeitung aktiviert und das Werkzeug versucht, die Arbeit auf alle logischen Kerne auf dem Computer zu verteilen. Durch Festlegen der Umgebung auf 0 wird die parallele Verarbeitung deaktiviert. Wenn ein Faktor zwischen 1 und 99 festgelegt wird, identifiziert das Werkzeug den Prozentsatz der zu verwendenden logischen Kerne, indem die Formel (Faktor für parallele Verarbeitung / 100 * logische Kerne) auf die nächste ganze Zahl aufgerundet angewendet wird. Wenn das Ergebnis dieser Formel 0 oder 1 ist, wird die parallele Verarbeitung nicht aktiviert.

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

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

Python

arcpy.analysis.PairwiseIntegrate(in_features, {cluster_tolerance})

Name	Erläuterung	Datentyp
in_features [in_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).	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

Name	Erläuterung	Datentyp
out_features	Die aktualisierten Eingabe-Features.	Feature Layer

Codebeispiel

PairwiseIntegrate – Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion PairwiseIntegrate 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.analysis.PairwiseIntegrate("C:/output/output.gdb/vegtype")

PairwiseIntegrate –Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Skript ist ein Beispiel für die Anwendung der Funktion PairwiseIntegrate 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"

# Execute CopyFeatures (since Integrate modifies the original data, this 
# ensures the original is preserved)
arcpy.management.CopyFeatures(inFeatures, integrateFeatures)

# Execute Integrate
arcpy.analysis.PairwiseIntegrate(integrateFeatures)

Umgebungen

Aktueller Workspace, Ausdehnung, XY-Toleranz, Faktor für parallele Verarbeitung

Lizenzinformationen

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