Paarweise überschneiden (Analysis)

Zusammenfassung

Berechnet eine paarweise Überschneidung der Eingabe-Features. Die Ausgabe-Feature-Class enthält alle Features oder Teile von Features, die sich zwischen den Eingabe-Feature-Layern und Feature-Classes überlappen. Paarweise Überschneidung bezieht sich auf die Auswahl eines Features aus der ersten Eingabe und dessen Überschneidung mit den Features in der zweiten Eingabe, die es überlappt.

Für Überschneidungsvorgänge gibt es ein alternatives Werkzeug. Weitere Informationen finden Sie in der Dokumentation zum Werkzeug Überschneiden (Intersect).

Das Werkzeug Paarweise überschneiden ähnelt dem Werkzeug Überschneiden (Intersect) insofern, dass geometrische Schnittpunkte berechnet werden, es unterscheidet sich jedoch dadurch, dass Schnittpunkte für Feature-Paare statt Feature-Kombinationen berechnet werden.

Weitere Informationen zur Funktionsweise des Werkzeugs "Paarweise überschneiden"

Abbildung

Abbildung zum Werkzeug "Paarweise überschneiden"

Verwendung

  • Es werden nur zwei Eingabe-Feature-Classes unterstützt.

  • Die Eingabe müssen einfache Features sein, z. B. Punkt-, Multipoint-, Linien- oder Polygon-Features. Sie können keine komplexen Features wie Annotations-Features, Bemaßungs-Features oder Netzwerk-Features verwenden.

  • Wenn die Eingaben verschiedene Geometrietypen aufweisen, wird als Ausgabegeometrietyp standardmäßig die kleinste Dimension aus den Eingaben übernommen.

    • Wenn es sich bei der Eingabe um Punkt-Features handelt, sind Punkt-Features die Standardausgabe.
    • Wenn es sich bei der Eingabe um Linien-Features handelt und keine Punkt-Features vorhanden sind, sind Linien-Features die Standardausgabe.
    • Wenn es sich bei allen Eingaben um Polygon-Features handelt, sind Polygon-Features die Standardausgabe.

  • Der Parameterwert Ausgabetyp kann der Geometrietyp des Parameterwertes Eingabe-Features mit der kleinsten Geometriedimension oder ein noch niedrigerer Typ sein. Wenn beispielsweise die Eingabe aus Polygonen besteht, kann die Ausgabe ein Polygon-, Linien- oder Punkt-Feature sein. Wenn ein Eingabe-Feature ein Linien-Feature ist und keine Punkt-Features vorhanden sind, kann die Ausgabe ein Linien- oder ein Punkt-Feature sein. Falls eines der Eingabe-Features ein Punkt-Feature ist, kann der Wert des Ausgabetyps nur ein Punkt-Feature sein.

  • Im Gegensatz zum Werkzeug Überschneiden (Intersect) werden keine Rangstufen unterstützt.

  • Standardmäßig werden Kurven-Features aus der Eingabe in der Ausgabe verdichtet. Um Kurven in der Ausgabe zu unterstützen, verwenden Sie die Umgebung Kurvensegmente beibehalten.

  • Alle Eingaben müssen über einen räumlichen Index verfügen. Verwenden Sie das Werkzeug Räumlichen Index hinzufügen, um einen Index zu erstellen (insbesondere für Shapefiles) oder um einen vorhandenen Index neu zu erstellen, falls Zweifel hinsichtlich seiner Korrektheit bestehen.

  • Wenn die Eingabe-Features über M- oder Z-Werte verfügen, werden nur die M- oder Z-Werte der ersten Feature-Class auf die Ausgabe-Features übertragen. Wenn die erste Feature-Class keine M- oder Z-Werte enthält, enthält auch die Ausgabe keine M- oder Z-Werte.

  • Der Raumbezug der Ausgabe-Feature-Class entspricht dem der ersten Feature-Class im Parameter Eingabe-Features. Weitere Informationen finden Sie unter Raumbezug und Geoverarbeitung.

  • 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

BeschriftungErläuterungDatentyp
Eingabe-Features

Die zu überschneidenden Eingabe-Feature-Classes oder Layer. Es sind nur zwei Eingaben zulässig.

Value Table
Ausgabe-Feature-Class

Die Ausgabe-Feature-Class.

Feature Class
Ausgabe-Attribute
(optional)

Gibt an, welche Attribute der Eingabe-Features in die Ausgabe-Feature-Class übertragen werden.

  • Alle AttributeAlle Attribute der Eingabe-Features werden in die Ausgabe-Feature-Class übertragen. Dies ist die Standardeinstellung.
  • Alle Attribute mit Ausnahme von Feature-IDsAlle Attribute der Eingabe-Features mit Ausnahme der FID werden in die Ausgabe-Feature-Class übertragen.
  • Nur Feature-IDsNur das FID-Feld der Eingabe-Features wird auf die Ausgabe-Feature-Class übertragen.
String
XY-Toleranz
(optional)

Der Mindestabstand zwischen allen Feature-Koordinaten (Knoten und Stützpunkte) sowie die Strecke, die eine Koordinate auf der X- bzw. Y-Achse (oder beiden) verschoben werden kann.

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
Ausgabetyp
(optional)

Legt den Typ der zurückzugebenden Schnittpunkte fest.

  • Wie EingabeDie ermittelten Überschneidungen sind vom selben Geometrietyp wie die Eingabe-Features mit der kleinsten Geometriedimension. Wenn alle Eingabe-Features Polygone sind, enthält die Ausgabe-Feature-Class Polygone. Wenn mindestens eine Eingabe ein Linien-Feature ist und keine Punkt-Features vorhanden sind, enthält die Ausgabe-Feature-Class Linien. Wenn mindestens eine Eingabe ein Punkt-Feature ist, enthält die Ausgabe-Feature-Class Punkte. Dies ist die Standardeinstellung.
  • LinieDie zurückgegebenen Schnittpunkte sind Linien. Diese Option ist nur gültig, wenn die Eingabe keine Punkt-Features enthält.
  • PunktDie zurückgegebenen Schnittpunkte sind Punkte. Wenn es sich bei den Eingaben um Linien oder Polygone handelt, ist die Ausgabe eine Multipoint-Feature-Class.
String

arcpy.analysis.PairwiseIntersect(in_features, out_feature_class, {join_attributes}, {cluster_tolerance}, {output_type})
NameErläuterungDatentyp
in_features
[in_features,...]

Die zu überschneidenden Eingabe-Feature-Classes oder Layer. Es sind nur zwei Eingaben zulässig.

Value Table
out_feature_class

Die Ausgabe-Feature-Class.

Feature Class
join_attributes
(optional)

Gibt an, welche Attribute der Eingabe-Features in die Ausgabe-Feature-Class übertragen werden.

  • ALLAlle Attribute der Eingabe-Features werden in die Ausgabe-Feature-Class übertragen. Dies ist die Standardeinstellung.
  • NO_FIDAlle Attribute der Eingabe-Features mit Ausnahme der FID werden in die Ausgabe-Feature-Class übertragen.
  • ONLY_FIDNur das FID-Feld der Eingabe-Features wird auf die Ausgabe-Feature-Class übertragen.
String
cluster_tolerance
(optional)

Der Mindestabstand zwischen allen Feature-Koordinaten (Knoten und Stützpunkte) sowie die Strecke, die eine Koordinate auf der X- bzw. Y-Achse (oder beiden) verschoben werden kann.

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
output_type
(optional)

Legt den Typ der zurückzugebenden Schnittpunkte fest.

  • INPUTDie ermittelten Überschneidungen sind vom selben Geometrietyp wie die Eingabe-Features mit der kleinsten Geometriedimension. Wenn alle Eingabe-Features Polygone sind, enthält die Ausgabe-Feature-Class Polygone. Wenn mindestens eine Eingabe ein Linien-Feature ist und keine Punkt-Features vorhanden sind, enthält die Ausgabe-Feature-Class Linien. Wenn mindestens eine Eingabe ein Punkt-Feature ist, enthält die Ausgabe-Feature-Class Punkte. Dies ist die Standardeinstellung.
  • LINEDie zurückgegebenen Schnittpunkte sind Linien. Diese Option ist nur gültig, wenn die Eingabe keine Punkt-Features enthält.
  • POINTDie zurückgegebenen Schnittpunkte sind Punkte. Wenn es sich bei den Eingaben um Linien oder Polygone handelt, ist die Ausgabe eine Multipoint-Feature-Class.
String

Codebeispiel

PairwiseIntersect: Beispiel 1 (Python-Fenster)

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

import arcpy
arcpy.env.workspace = "C:/data/RedRiver_basin.gdb"
arcpy.analysis.PairwiseIntersect(["vegetation_stands", "road_buffer200m", "water_buffer100"], 
                                 "mysites", "ALL")
PairwiseIntersect: Beispiel 2 (eigenständiges Skript)

Suchen Sie den Vegetationstyp, durch den die Ströme fließen.

# Name: StreamsInVegetationIntersect.py
# Purpose: Determine the vegetation type streams are traveling through.

# Import system modules
import arcpy

# Set the workspace (to avoid having to type in the full path to the data every time)
arcpy.env.workspace = "c:/data/data.gdb"    

# Process: Find all streams in each vegetation type
inFeatures = ["vegetation", "streams"]
intersectOutput = "streams_in_vegtype"

arcpy.analysis.PairwiseIntersect(inFeatures, intersectOutput)

Lizenzinformationen

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

Verwandte Themen