Überschneiden (Intersect) (Analyse)

Zusammenfassung

Berechnet einen geometrischen Schnittpunkt der Eingabe-Features. Die Ausgabe-Feature-Class enthält alle Features bzw. Teile von Features, die sich in allen Layern oder Feature-Classes überlappen.

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

Das Werkzeug Paarweise überschneiden ähnelt diesem Werkzeug 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 "Überschneiden (Intersect)"

Abbildung

Abbildung des Werkzeugs "Überschneiden (Intersect)"

Verwendung

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

  • Die Attributwerte der Eingabe-Feature-Classes werden in die Ausgabe-Feature-Class kopiert. Wenn es sich bei der Eingabe jedoch um Layer handelt, die mit dem Werkzeug Feature-Layer erstellen erstellt wurden, und die Option Verhältnismethode verwenden eines Feldes aktiviert ist, wird ein Verhältnis zum Eingabe-Attributwert berechnet. Ist die Option Verhältnismethode verwenden aktiviert, stellen die Attribute des resultierenden Features bei jeder Teilung eines Features in einem Überlagerungsvorgang ein Verhältnis des Attributwertes des Eingabe-Features dar. Der Ausgabewert basiert auf dem Verhältnis, in dem die Eingabe-Feature-Geometrie geteilt wurde. Wenn die Geometrie beispielsweise in gleiche Teile geteilt wurde, wird dem Attributwert jedes neuen Features der halbe Wert des Attributwertes des Eingabe-Features zugewiesen. Verhältnismethode verwenden gilt nur für numerische Feldtypen.

    Vorsicht:

    Geoverarbeitungswerkzeuge berücksichtigen die Teilungsmethoden von Geodatabase-Feature-Class- oder -Tabellenfeldern nicht.

  • Dieses Werkzeug wendet einen Kachelungsvorgang an, um beim Verarbeiten großer Datasets eine bessere Performance und Skalierbarkeit zu erzielen. Weitere Informationen finden Sie unter Gekachelte Verarbeitung großer Datasets.

  • Lizenz:

    Bei ArcGIS Desktop Basic- und Desktop Standard-Lizenzen ist die Anzahl der Eingabe-Feature-Classes oder -Layer auf zwei begrenzt.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Features

Eine Liste der Eingabe-Feature-Classes oder Layer. Wenn die Entfernung zwischen Features geringer als die Cluster-Toleranz ist, werden die Features mit der niedrigeren Rangstufe vom Feature mit der höheren Rangstufe gefangen. Die höchste Rangstufe ist 1.

Value Table
Ausgabe-Feature-Class

Die Ausgabe-Feature-Class.

Feature Class
Zu verbindende Attribute
(optional)

Gibt die Attribute der Eingabe-Features an, die 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 des FID-Attributs werden in die Ausgabe-Feature-Class übertragen.
  • Nur Feature-IDsNur das FID-Attribut 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.Intersect(in_features, out_feature_class, {join_attributes}, {cluster_tolerance}, {output_type})
NameErläuterungDatentyp
in_features
[[in_features, {Rank}],...]

Eine Liste der Eingabe-Feature-Classes oder Layer. Wenn die Entfernung zwischen Features geringer als die Cluster-Toleranz ist, werden die Features mit der niedrigeren Rangstufe vom Feature mit der höheren Rangstufe gefangen. Die höchste Rangstufe ist 1. Weitere Informationen finden Sie im Abschnitt zu Rangstufen und Geoverarbeitungswerkzeugen.

Value Table
out_feature_class

Die Ausgabe-Feature-Class.

Feature Class
join_attributes
(optional)

Gibt die Attribute der Eingabe-Features an, die 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 des FID-Attributs werden in die Ausgabe-Feature-Class übertragen.
  • ONLY_FIDNur das FID-Attribut 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

Überschneiden (Intersect): Beispiel (Python-Fenster)

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

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

Im folgenden eigenständigen Skript wird die Funktion Intersect (Intersect) mit anderen Analysewerkzeugen als Teil eines Workflows verwendet, um die Art der Vegetation im Umkreis von 100 Metern aller Furten zu bestimmen.

#Name: VegRoadIntersect.py
# Purpose: Determine the type of vegetation within 100 meters of all stream 
#          crossings

# 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 stream crossings (points)
inFeatures = ["roads", "streams"]
intersectOutput = "stream_crossings"
arcpy.analysis.Intersect(inFeatures, intersectOutput, "", "", "point")
 
# Process: Buffer all stream crossings by 100 meters
bufferOutput = "stream_crossings_100m"
bufferDist = "100 meters"
arcpy.analysis.Buffer(intersectOutput, bufferOutput, bufferDist)

# Process: Clip the vegetation feature class to stream_crossing_100m
clipInput = "vegetation"
clipOutput = "veg_within_100m_of_crossings"
arcpy.analysis.Clip(clipInput, bufferOutput, clipOutput)

# Process: Summarize how much (area) of each type of vegetation is found
# within 100 meters of the stream crossings
statsOutput = "veg_within_100m_of_crossings_stats"
statsFields = [["shape_area", "sum"]]
caseField = "veg_type"
arcpy.analysis.Statistics(clipOutput, statsOutput, statsFields, caseField)

Umgebungen

Sonderfälle

Faktor für parallele Verarbeitung

Dieses Werkzeug berücksichtigt die Umgebung "Faktor für parallele Verarbeitung". Wenn die Umgebung nicht festgelegt ist (Standardeinstellung) oder auf 0 festgelegt ist, ist die parallele Verarbeitung deaktiviert. Die parallele Verarbeitung wird nicht verwendet; die Verarbeitung erfolgt stattdessen sequenziell. Durch Festlegen der Umgebung auf 100 wird die parallele Verarbeitung aktiviert. Die Verarbeitung erfolgt dann parallel. Es werden bis zu 10 Kerne verwendet, wenn die parallele Verarbeitung aktiviert ist.

Die parallele Verarbeitung wird derzeit für Überlagerungsvorgänge vom Typ "Polygon auf Polygon", "Linie auf Polygon" und "Punkt auf Polygon" unterstützt.