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 ist ein alternatives Werkzeug verfügbar. 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 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.

• 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. Wird die Umgebung auf 0 festgelegt, wird die parallele Verarbeitung nicht aktiviert. 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 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.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 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

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 PairwiseIntegrate 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 PairwiseIntegrate modifies the original data, this 
# ensures the original is preserved)
arcpy.management.CopyFeatures(inFeatures, integrateFeatures)

# Run PairwiseIntegrate
arcpy.analysis.PairwiseIntegrate(integrateFeatures)

Umgebungen

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

Lizenzinformationen

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