Skip To Content

Features verbinden

Zusammenfassung

Verbindet Attribute aus einem Layer mit denen eines anderen basierend auf räumlichen, zeitlichen oder Attributbeziehungen bzw. einer Kombination aus diesen.

Abbildung

Werkzeug "Features verbinden"
Features verbinden: beide Beispiele weisen eine räumlich/zeitliche Verbindung auf.

Verwendung

  • Bei der räumlichen Verbindung werden Features (Zeilen) aus den Eingabe-Features (namens Ziel-Layer und Join-Layer) basierend auf ihren räumlichen Positionen zugeordnet. Bei der zeitlichen Verbindung werden Features (Zeilen) aus den Eingabe-Features basierend auf ihren zeitlichen Beziehungen zugeordnet. Bei Attributverbindungen werden Features basierend auf Werten in Feldern zugeordnet.

  • Wenn sich Ziel- und Verbindungs-Features in unterschiedlichen Koordinatensystemen befinden, werden die Koordinatensysteme des Ziel-Features verwendet. Wird ein Ausgabe-Koordinatensystem angegeben, werden beide Features an das Ausgabe-Koordinatensystem projiziert und anschließend verbunden.

  • Wenn der Parameter für Verbindungsvorgang Eins zu vielen verbinden lautet, kann für jedes Ziel-Feature mehr als eine Zeile in der Ausgabe-Feature-Class vorhanden sein.

  • Wenn ein Verbindungs-Feature eine räumliche Beziehung mit mehreren Ziel-Features aufweist, wird es so oft gezählt, wie es dem Ziel-Feature zugeordnet wurde. Wenn sich beispielsweise ein Punkt in drei Polygonen befindet, wird er dreimal gezählt – einmal pro Polygon.

  • Wenn die ausgewählte räumliche BeziehungNEAR lautet, muss fürFeatures verbinden der Ziel-Layer projiziert werden oder das Ausgabe-Koordinatensystem muss als ein Projiziertes Koordinatensystem eingestellt sein.

  • Sie können einen Arcade-Ausdruck verwenden, um eine Verbindungsbedingung zu erstellen. Nur Features, die der Verbindungsbedingung entsprechen, werden in der Analyse verwendet. Weitere Informationen finden Sie unter Join Features expressions.

  • Dieses Geoverarbeitungswerkzeug wird unterstützt durch ArcGIS GeoAnalytics Server. Die Analyse wird auf dem GeoAnalytics Server ausgeführt, und die Ergebnisse werden im Inhalt in ArcGIS Enterprise gespeichert.

  • Es wird empfohlen, Feature-Layer zu verwenden, die in Ihrem ArcGIS Enterprise-Portal gehostet werden. Alternativ können Sie Daten einer Big-Data-Dateifreigabe verwenden, wenn Sie GeoAnalytics Tools in ArcGIS Pro ausführen. Bei anderen Datenquellen kann es zu einer langsamen Performance kommen, wenn mehr als 1000 Features vorhanden sind.

    Weitere Informationen zum Freigeben von Daten in Ihrem Portal

    Weitere Informationen zum Erstellen einer Big-Data-Dateifreigabe über Server Manager

  • Eine ähnliche Analyse ist auch mit dem Werkzeug Räumliche Verbindung in der Toolbox "Analysis" möglich.

Syntax

JoinFeatures_geoanalytics (target_layer, join_layer, output_name, join_operation, {spatial_relationship}, {spatial_near_distance}, {temporal_relationship}, {temporal_near_distance}, {attribute_relationship}, {summary_fields}, {join_condition}, {data_store})
ParameterErläuterungDatentyp
target_layer

Die Attribute der Ziel-Features und die Attribute aus den verbundenen Features werden in die Ausgabe übertragen.

Record Set
join_layer

Die Attribute aus den Verbindungs-Features werden mit den Attributen der Ziel-Features verbunden. In der Erläuterung zum Parameter Verbindungsvorgang (join_operation für Python) finden Sie Informationen darüber, inwiefern sich der Verbindungsvorgang auf die Zusammenfassung der verbundenen Attribute auswirkt.

Record Set
output_name

Der Name des Ausgabe-Feature-Service.

String
join_operation

Bestimmt die Behandlung von Verbindungen zwischen dem target_layer und dem join_layer im Ausgabe-Feature, wenn mehrere Verbindungs-Features gefunden werden, die über die gleiche räumliche Beziehung zu einem einzelnen Ziel-Feature verfügen.

  • JOIN_ONE_TO_ONE Die Attribute aus den verschiedenen Verbindungs-Features werden aggregiert. Wenn innerhalb von zwei separaten Polygon-Verbindungs-Features beispielsweise ein einzelnes Punkt-Ziel-Feature gefunden wird, werden die Attribute aus den beiden Polygonen zusammengefasst, bevor sie in die Ausgabe-Point-Feature-Class übertragen werden. Verfügt ein Polygon über einen Attributwert von 3 und das andere über einen Wert von 7, lautet der zusammengefasste Wert in der Ausgabe-Feature-Class 10, wenn das Ergebnis der Summenstatistik angegeben wird. Standardmäßig wird nur die Anzahlstatistik zurückgegeben. Join one to one ist die Standardeinstellung.
  • JOIN_ONE_TO_MANYDie Ausgabe-Feature-Class enthält mehrere Kopien (Datensätze) des Ziel-Features. Wenn zum Beispiel ein einzelnes Punkt-Ziel-Feature innerhalb von zwei separaten Polygon-Verbindungs-Features gefunden wird, enthält die Ausgabe-Feature-Class zwei Kopien des Ziel-Features: einen Eintrag mit den Attributen des einen Polygons und einen Eintrag mit den Attributen des anderen Polygons. Für diese Methode ist keine Summenstatistik verfügbar.
String
spatial_relationship
(optional)

Definiert die Kriterien für die räumliche Verbindung von Features.

  • INTERSECTSDie Features in den Verbindungs-Features werden zugeordnet, wenn sie ein Ziel-Feature schneiden. Dies ist die Standardeinstellung.
  • EQUALSDie Features in den Verbindungs-Features werden zugeordnet, wenn sie über die gleiche Geometrie wie das Ziel-Feature verfügen.
  • NEARDie Features in den Verbindungs-Features werden zugeordnet, wenn sie sich innerhalb einer bestimmten Entfernung zum Ziel-Feature befinden. Geben Sie im Parameter "Räumliche Near-Entfernung" eine Entfernung an.
  • CONTAINSDie Features in den Verbindungs-Features werden zugeordnet, wenn ein Ziel-Feature sie enthält. Als Ziel-Features müssen Polygone oder Polylinien verwendet werden. Die Verbindungs-Features können nur dann Polygone sein, wenn die Ziel-Features auch Polygone sind. Polygone können jeden beliebigen Feature-Typ enthalten. Polylinien können nur Polylinien und Punkte enthalten. Punkte können kein Feature enthalten, nicht einmal einen Punkt. Wenn sich das Verbindungs-Feature vollständig auf der Grenze des Ziel-Features befindet (kein Teil liegt inner- oder außerhalb), wird das Feature nicht zugeordnet.
  • WITHINDie Features in den Verbindungs-Features werden zugeordnet, wenn sich ein Ziel-Feature innerhalb von ihnen befindet. Es ist das Gegenteil der Beziehung "Enthält". Bei dieser Option können die Ziel-Features nur dann Polygone sein, wenn es sich bei den Verbindungs-Features ebenfalls um Polygone handelt. Punkte können nur dann Join-Features sein, wenn Punkte auch das Ziel-Feature sind. Wenn das gesamte Feature in den Verbindungs-Features sich auf der Grenze des Ziel-Features befindet, wird das Feature nicht zugeordnet.
  • TOUCHESDie Features in den Verbindungs-Features werden zugeordnet, wenn ihre Grenze ein Ziel-Feature berührt. Wenn es sich bei den Ziel- und Verbindungs-Features um Linien oder Polygone handelt, kann die Grenze der Verbindungs-Features die Grenze des Ziel-Features nur berühren. Kein Teil des Verbindungs-Features kann die Grenze des Ziel-Features durchdringen.
  • CROSSESDie Features in den Verbindungs-Features werden zugeordnet, wenn ein Ziel-Feature durch ihren Umriss gekreuzt wird. Die Verbindungs- und Ziel-Features müssen über eine Linien- oder Polygonform verfügen. Wenn für die Verbindungs- oder Ziel-Features Polygone verwendet werden, wird die Grenze (Linie) des Polygons verwendet. Linien, die einen Punkt schneiden, werden zugeordnet. Dies gilt jedoch nicht für Linien, die ein Liniensegment gemeinsam haben.
  • OVERLAPSDie Features in den Verbindungs-Features werden zugeordnet, wenn sie sich mit einem Ziel-Feature überschneiden.
String
spatial_near_distance
(optional)

Verbindungs-Features, die sich innerhalb der hier angegebenen Entfernung eines Ziel-Features befinden, werden für die räumliche Verbindung berücksichtigt. Ein Suchradius ist nur gültig, wenn für spatial_relationship NEAR angegeben ist.

Linear Unit
temporal_relationship
(optional)

Definiert die zeitlichen Kriterien für die Zuordnung von Features.

  • MEETSWenn ein Zielzeitintervallende gleich dem Verbindungszeitintervallstart ist, entspricht die Zielzeit der Verbindungszeit.
  • MET_BYWenn ein Zielzeitintervallstart gleich dem Verbindungszeitintervallende ist, wird die Zielzeit von der Verbindungszeit erfüllt.
  • OVERLAPSWenn ein Zielzeitintervall vor dem Start und Ende eines Verbindungszeitintervalls beginnt und endet, überlappt die Zielzeit die Verbindungszeit.
  • OVERLAPPED_BYWenn ein Zielzeitintervall nach der Start- und Endzeit eines Verbindungszeitintervalls beginnt und endet, wird die Zielzeit von der Verbindungszeit überlappt.
  • DURINGWenn eine Zielzeit zwischen dem Start und dem Ende eines Verbindungszeitintervalls auftritt, liegt die Zielzeit während der Verbindungszeit.
  • CONTAINSWenn eine Verbindungs-Feature-Zeit zwischen dem Start und dem Ende eines Zielzeitintervalls auftritt, enthält die Zielzeit die Verbindungszeit.
  • EQUALSZwei Zeiten sind gleich, wenn die Zeitpunkte oder Intervalle identisch sind.
  • FINISHESWenn eine Zielzeit zeitgleich mit einer Verbindungszeit endet und die Zielzeit nach der Verbindungszeit begonnen hat, beendet die Zielzeit die Verbindungszeit.
  • FINISHED_BYWenn eine Verbindungszeit zeitgleich mit einer Zielzeit endet und die Verbindungszeit nach der Zielzeit begonnen hat, wird die Zielzeit von der Verbindungszeit beendet.
  • STARTSWenn eine Zielzeit zeitgleich mit einem Verbindungszeitintervall beginnt und vor dem Intervallende der Verbindungszeit endet, dann startet die Zielzeit die Verbindungszeit.
  • STARTED_BYWenn eine Zielintervallzeit zeitgleich mit einer Verbindungszeit beginnt und nach der Verbindungszeit endet, dann wird die Zielzeit von der Verbindungszeit gestartet.
  • INTERSECTSWenn ein Teil der Zielzeit zeitgleich mit der Verbindungszeit auftritt, dann schneidet die Zielzeit die Verbindungszeit.
  • NEARWenn eine Zielzeit innerhalb eines angegebenen Bereichs der Verbindungszeit auftritt, dann ist die Zielzeit nahe der Verbindungszeit.
  • NEAR_BEFOREWenn eine Zielzeit vor der Verbindungszeit liegt, aber innerhalb eines angegebenen Bereichs ausgehend von der Verbindungszeit auftritt, dann ist die Zielzeit nahe vor der Verbindungszeit. Diese Option ist in ArcGIS Enterprise 10.6 oder höher verfügbar.
  • NEAR_AFTERWenn eine Zielzeit nach der Verbindungszeit liegt, aber innerhalb eines angegebenen Bereichs ausgehend von der Verbindungszeit auftritt, dann ist die Zielzeit nahe nach der Verbindungszeit. Diese Option ist in ArcGIS Enterprise 10.6 oder höher verfügbar.
String
temporal_near_distance
(optional)

Verbindungs-Features, die sich innerhalb der hier angegebenen zeitlichen Entfernung zu einem Ziel-Feature befinden, werden für die räumliche Verbindung berücksichtigt. Eine Zeit ist nur gültig, wenn für temporal_relationship die Option NEAR, NEAR_BEFORE oder NEAR_AFTER angegeben ist und für beide Features Zeiteigenschaften aktiviert sind.

Time unit
attribute_relationship
[attribute_relationship,...]
(optional)

Verbindungs-Features basierend auf Werten innerhalb von Attributfeldern. Sie müssen angeben, welches Attributfeld aus dem Ziel-Layer dem Attributfeld aus dem Join-Layer entspricht.

  • Zielfeld: ein Attributfeld aus dem Ziel-Layer mit zuzuordnenden Werten.
  • Join-Feld: ein Attributfeld aus dem Join-Layer mit zuzuordnenden Werten.

Value Table
summary_fields
[summary_fields,...]
(optional)

Statistiken, die für bestimmte Felder berechnet werden.

  • COUNTBerechnet die Anzahl der Nicht-NULL-Werte. Es kann für numerische Felder oder Zeichenfolgen verwendet werden. Die Anzahl von [null, 0, 2] ist 2.
  • SUMDie Summe der numerischen Werte in einem Feld. Die Summe von [null, null, 3] ist 3.
  • MEANDer Mittelwert der numerischen Werte. Der Mittelwert von [0, 2, null] ist 1.
  • MINDer Minimalwert eines numerischen Feldes. Das Minimum von [0, 2, null] ist 0.
  • MAXDer Maximalwert eines numerischen Feldes. Der Maximalwert von [0, 2, null] ist 2.
  • STDDEVDie Standardabweichung eines numerischen Feldes. Die Standardabweichung von [1] ist null. Die Standardabweichung von [null, 1,1,1] ist 1.
  • VARDie Varianz eines numerischen Feldes in einer Spur. Die Varianz von [1] ist null. Die Varianz von [null, 1, 1, 1] ist 1.
  • RANGEDer Bereich eines numerischen Feldes. Dieser wird durch die Subtraktion der Minimalwerte vom Maximalwert berechnet. Der Bereich von [0, null, 1] ist 1. Der Bereich von [null, 4] ist 0.
  • ANYDies ist eine Beispielzeichenfolge aus einem Feld vom Typ "Zeichenfolge".
Value Table
join_condition
(optional)

Wendet eine Bedingung auf angegebene Felder an. Nur Features mit Feldern, die diese Bedingungen erfüllen, werden verbunden.

Ein Beispiel: Sie könnten eine Verbindungsbedingung auf Features anwenden, bei denen das Attribut HealthSpending (Gesundheitskosten) im Join-Layer mehr als 20 Prozent vom Attribut Income (Einkommen) im Ziel-Layer ausmacht. In Version 10.5 und 10.5.1 lautet die Verbindungsbedingung für die Anwendung dieses Ausdrucks join["HealthSpending"] > target["Income"] * .2. Verwenden Sie in Version 10.6 und höher Arcade-Ausdrücke, wie zum Beispiel $join["HealthSpending"] > $target["Income"] * .2.

String
data_store
(optional)

Gibt den ArcGIS Data Store für das Speichern der Ausgabe an. Die Standardeinstellung ist SPATIOTEMPORAL_DATA_STORE. Alle im SPATIOTEMPORAL_DATA_STORE gespeicherten Ergebnisse werden im WGS84 gespeichert. Ergebnisse, die in einem RELATIONAL_DATA_STORE gespeichert werden, behalten ihr Koordinatensystem bei.

  • SPATIOTEMPORAL_DATA_STOREDie Ausgabe wird in einem Big Data Store vom Typ "spatiotemporal" gespeichert. Dies ist die Standardeinstellung.
  • RELATIONAL_DATA_STOREDie Ausgabe wird in einem Data Store vom Typ "relational" gespeichert.
String

Codebeispiel

JoinFeatures – Beispiel (Python-Fenster)

Das folgende Skript veranschaulicht die Verwendung des Werkzeugs JoinFeatures im Python-Fenster.

#-------------------------------------------------------------------------------
# Name: JoinFeatures.py
# Description: Join crime events that are close together in time and space, and return the count of nearby crimes 
# This example is a self join (joining the same layer to itself) 
# Requirements: ArcGIS GeoAnalytics Server 
# Import system modules 
import arcpy 
# Set local variables 
inFeatures = "https://MyGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_Crimes/BigDataCatalogServer/Chicago"
spatialOperation = "NEAR" 
nearDistance = "1 Kilometers" 
temporalOperation = "NEAR" 
nearTime = "3 Hours" 
outFS = "CloseCrimes" 
dataStore = "SPATIOTEMPORAL_DATA_STORE" 
# Execute Join Features
arcpy.geoanalytics.JoinFeatures(inFeatures, inFeatures, outFS, "JOIN_ONE_TO_ONE", 
                                spatialOperation, nearDistance, temporalOperation, 
                                nearTime, None, None, None, dataStore)

Umgebungen

Ausgabe-Koordinatensystem

Das Koordinatensystem, das für die Analyse verwendet wird. Die Analyse wird im Eingabe-Koordinatensystem ausgeführt, sofern nicht anders durch diesen Parameter angegeben. Für GeoAnalytics Tools werden die Endergebnisse im Data Store vom Typ "spatiotemporal" in WGS84 gespeichert.

Lizenzinformationen

  • ArcGIS Desktop Basic: Erfordert ArcGIS GeoAnalytics Server
  • ArcGIS Desktop Standard: Erfordert ArcGIS GeoAnalytics Server
  • ArcGIS Desktop Advanced: Erfordert ArcGIS GeoAnalytics Server

Verwandte Themen