Benachbarte Polygone (Analysis)

Zusammenfassung

Erstellt eine statistische Tabelle auf der Basis der Polygonnachbarschaft (Überlappungen, übereinstimmende Kanten oder Knoten).

Weitere Informationen zur Funktionsweise von "Benachbarte Polygone"

Abbildung

Abbildung des Werkzeugs "Benachbarte Polygone"
Gezeigt ist ein Diagramm mit einem Quell-Polygon und den zugehörigen Nachbarpolygonen.

Verwendung

  • Das Werkzeug analysiert die Polygonnachbarschaft, wobei die folgenden Aspekte zwischen Quell-Polygonen und Nachbarpolygonen zusammengefasst werden:

    • Überlappende Fläche (überlappende Nachbarn – optional)
    • Länge der lagegleichen Kanten (benachbarte Kanten)
    • Häufigkeit, mit der sich Grenzen an einem Punkt kreuzen oder berühren (Knotennachbarn)
    Die Zusammenfassung wird in eine Ausgabetabelle geschrieben. Ein Quell-Polygon kann über ein oder mehrere benachbarte Polygone verfügen. Ein benachbartes Polygon steht auf mindestens eine der obigen Arten in räumlicher Beziehung zum Quell-Polygon.

  • Das Werkzeug analysiert und erfasst nur Nachbarschaften erster Ordnung. Darüber hinaus gehende Beziehungen werden nicht untersucht, d. h. Nachbarn von Nachbarn (Nachbarschaft zweiter Ordnung) werden nicht geprüft.

  • Der Parameter Nach Feldern erfassen wird verwendet, um eindeutige Polygone oder Polygongruppen zu identifizieren und ihre Nachbarschaftsinformationen nach Polygonen bzw. Polygongruppen zu erfassen. Um die Nachbarn eines jeden einzelnen Polygons in der Eingabe zu finden, geben Sie ein oder mehrere Eingabefelder an, die für jedes Polygon einen eindeutigen Wert bzw. ein Werteset (im Falle mehrerer Felder) liefern.

    Wenn die angegebenen Felder eindeutige Polygongruppen identifizieren, werden die Nachbarschaftsinformationen zusammengefasst und nach den Gruppen erfasst.

    Weitere Informationen zur Verwendung dieses Parameters finden Sie unter Funktionsweise von benachbarten Polygonen.

  • Sie können den Parameter Bereichsüberlappungen einbeziehen verwenden, um Beziehungen von Bereichsüberlappungen zu analysieren. Wenn Bereichsüberlappungen einbeziehen ausgewählt wird, enthält die Ausgabetabelle das Feld AREA, in dem die Bereichsüberlappungen für den analysierten überlappenden Nachbarn gespeichert werden. Wenn keine Überschneidung gefunden wird, ist der Feldwert für AREA gleich 0.

    Tipp:

    Die Berechnung von Beziehungen überlappender Bereiche ist eine Operation mit hohem Ressourcenaufwand. Die Performance wird daher möglicherweise stärker beeinträchtigt als beim Bestimmen von Kanten- und Knotennachbarbeziehungen. Wenn Sie wissen, dass die Daten keine überlappenden Features enthalten, oder wenn die Analyse von überlappenden Nachbarn nicht von Interesse ist, deaktivieren Sie den Parameter Bereichsüberlappungen einbeziehen.

    Vorsicht:

    Der Parameter Bereichsüberlappungen einbeziehen muss aktiviert sein, um Datensätze für Nachbarn zu erhalten, die vollständig in einem Quell-Polygon enthalten sind. Wenn der Parameter Bereichsüberlappungen einbeziehen nicht aktiviert ist, enthält die Ausgabetabelle keine Datensätze für Nachbarn, die vollständig in einem Quell-Polygon enthalten sind.

  • Es gibt keinen Eintrag in der Ausgabetabelle für Features, die keine Nachbarn sind.

  • Mit dem Parameter Beide Seiten der Nachbarbeziehung einbeziehen wird gesteuert, welche Beziehungen in der Ausgabe enthalten sind. Um alle Nachbarschaftsbeziehungen einschließlich gegenseitiger Beziehungen zu erfassen, aktivieren Sie Beide Seiten der Nachbarbeziehung einbeziehen. Wenn z. B. OID1 ein Nachbar von OID2 ist, wird in der Ausgabetabelle für OID1 der Eintrag angelegt, dass OID1 den Nachbarn OID2 hat, und für OID2, dass er den Nachbarn OID1 hat. Wenn Sie nur die erste Seite der Beziehung wünschen, deaktivieren Sie Beide Seiten der Nachbarbeziehung einbeziehen. Wenn im obigen Beispiel Beide Seiten der Nachbarbeziehung einbeziehen deaktiviert ist, wird in die Ausgabetabelle nur eingetragen, dass OID1 einen Nachbarn OID2 hat.

  • Lineare Ausgabeeinheiten gibt die Einheiten an, die für die gemeinsame Grenzlänge zwischen Nachbarn verwendet werden sollen. Standardmäßig werden die gleichen Einheiten verwendet, die durch das Eingabe-Feature-Koordinatensystem definiert werden.

  • Ausgabe-Flächeneinheiten wird nur verwendet, wenn der Parameter Bereichsüberlappung aktiviert wurde. Wenn Bereichsüberlappungen einbeziehen aktiviert wird, werden die Einheiten, mit denen die Bereichsüberlappung von Nachbarn berechnet wird, mit dem Parameter Ausgabe-Flächeneinheiten angegeben. Standardmäßig werden die gleichen Einheiten verwendet, die durch das Eingabe-Feature-Koordinatensystem definiert werden.

  • Der Parameterwert Ausgabetabelle kann eine File-Geodatabase- oder .dbf-Tabelle sein.

  • Für jedes Feld, das im Parameter Nach Feldern erfassen angegeben wurde, enthält die Ausgabetabelle zwei Felder. Dabei findet die folgende Namenskonvention Anwendung: src_<field> und nbr_<field>. Die Felder repräsentieren die Feldwerte für die Quelle und den Nachbarn aus der Eingabe.

    Die Ausgabetabelle enthält zudem die folgenden Felder:

    • AREA: In diesem Feld wird die gesamte überlappende Fläche zwischen einem Quell-Polygon und einem benachbarten Polygon (überlappende Nachbarn) gespeichert. Dieses Feld wird nur dann in die Ausgabetabelle aufgenommen, wenn der Parameter Bereichsüberlappungen einbeziehen aktiviert ist.
    • LENGTH: Dieses Feld speichert die Gesamtlänge von lagegleichen Kanten zwischen einem Quell-Polygon und einem benachbarten Polygon.
    • NODE_COUNT: Dieses Feld speichert die Anzahl, wie oft ein Quell-Polygon und ein benachbartes Polygon einander an einem Punkt überkreuzen oder berühren.

  • Wenn unter den Eingabe-Features eine Auswahl vorgenommen wurde, werden nur die selektierten Features analysiert.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Features

Die Eingabe-Polygon-Features.

Feature Layer
Ausgabetabelle

Dies ist die Ausgabetabelle.

Table
Nach Feldern erfassen
(optional)

Eingabe-Attributfelder oder Felder, die zur Identifizierung von Polygonen oder Polygongruppen benutzt werden und diese in der Ausgabe repräsentieren.

Field
Bereichsüberlappungen einbeziehen
(optional)

Bestimmt, ob Beziehungen zwischen überlappenden Flächen analysiert und in die Ausgabe einbezogen werden.

  • Deaktiviert: Überlappungsbeziehungen werden nicht analysiert oder sind nicht in der Ausgabe enthalten. Dies ist die Standardeinstellung.
  • Aktiviert: Überlappungsbeziehungen werden analysiert und sind in der Ausgabe enthalten.

Boolean
Beide Seiten der Nachbarbeziehung einbeziehen
(optional)

Gibt an, ob beide Seiten von Nachbarschaftsbeziehungen in der Ausgabe enthalten sind.

  • Aktiviert: Für ein benachbartes Polygonpaar werden sowohl die Nachbarschaftsinformationen des Quell-Polygons als auch die Informationen des benachbarten Polygons erfasst und umgekehrt. Dies ist die Standardeinstellung.
  • Deaktiviert: Für ein benachbartes Polygonpaar werden nur die Nachbarschaftsinformationen des Quell-Polygons und des benachbarten Polygons erfasst. Die gegenseitige Beziehung wird nicht einbezogen.

Boolean
XY-Toleranz
(optional)

Die minimale Entfernung zwischen Koordinaten, ehe sie als gleich betrachtet werden. Standardmäßig ist dies die XY-Toleranz der Eingabe-Features.

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
Lineare Ausgabeeinheiten
(optional)

Gibt die Einheiten an, die verwendet werden, um die Gesamtlänge der lagegleichen Kante zwischen benachbarten Polygonen zu erfassen. Die Standardeinstellung ist die Einheit des Eingabe-Features.

  • UnbekanntDie Längeneinheit ist unbekannt.
  • KilometerDie Längeneinheit ist Kilometer.
  • MeterDie Längeneinheit ist Meter.
  • DezimeterDie Längeneinheit ist Dezimeter.
  • ZentimeterDie Längeneinheit ist Zentimeter.
  • MillimeterDie Längeneinheit ist Millimeter.
  • Meilen (Britisch)Die Längeneinheit ist Meilen (Britisch).
  • Seemeilen (International)Die Längeneinheit ist Seemeilen (International).
  • Yards (International)Die Längeneinheit ist Yards (International).
  • Fuß (International)Die Längeneinheit ist Fuß (International).
  • Zoll (International)Die Längeneinheit ist Zoll (International).
  • Meilen (US Survey)Die Längeneinheit ist Meilen (US Survey).
  • Seemeilen (US Survey)Die Längeneinheit ist Seemeilen (US Survey).
  • Yards (US Survey)Die Längeneinheit ist Yards (US Survey).
  • Fuß (US Survey)Die Längeneinheit ist Fuß (US Survey).
  • Zoll (US Survey)Die Längeneinheit ist Zoll (US Survey).
  • DezimalgradDie Längeneinheit ist Dezimalgrad.
  • PunkteDie Längeneinheit ist Punkte.
String
Ausgabe-Flächeneinheiten
(optional)

Gibt die Einheiten an, die verwendet werden, um die Bereichsüberlappung von benachbarten Polygonen zu erfassen. Die Standardeinstellung ist die Einheit des Eingabe-Features. Dieser Parameter ist nur aktiv, wenn der Parameter Bereichsüberlappung einbeziehen aktiviert wurde.

  • UnbekanntDie Flächeneinheit ist unbekannt.
  • QuadratkilometerDie Flächeneinheit ist Quadratkilometer.
  • QuadratmeterDie Flächeneinheit ist Quadratmeter.
  • QuadratdezimeterDie Flächeneinheit ist Quadratdezimeter.
  • QuadratzentimeterDie Flächeneinheit ist Quadratzentimeter.
  • QuadratmillimeterDie Flächeneinheit ist Quadratmillimeter.
  • Quadratmeilen (Britisch)Die Flächeneinheit ist Quadratmeilen (Britisch).
  • Quadratyards (International)Die Flächeneinheit ist Quadratyards (International).
  • Quadratfuß (International)Die Flächeneinheit ist Quadratfuß (International).
  • Quadratzoll (International)Die Flächeneinheit ist Quadratzoll (International).
  • Quadratmeilen (US Survey)Die Flächeneinheit ist Quadratmeilen (US Survey).
  • Quadratyards (US Survey)Die Flächeneinheit ist Quadratyards (US Survey).
  • Quadratfuß (US Survey)Die Flächeneinheit ist Quadratfuß (US Survey).
  • Quadratzoll (US Survey)Die Flächeneinheit ist Quadratzoll (US Survey).
  • Acres (US Survey)Die Flächeneinheit ist Acres (US Survey).
  • HektarDie Flächeneinheit ist Hektar.
  • AcresDie Flächeneinheit ist Acres (International).
  • ArDie Flächeneinheit ist Ar.
String

arcpy.analysis.PolygonNeighbors(in_features, out_table, {in_fields}, {area_overlap}, {both_sides}, {cluster_tolerance}, {out_linear_units}, {out_area_units})
NameErläuterungDatentyp
in_features

Die Eingabe-Polygon-Features.

Feature Layer
out_table

Dies ist die Ausgabetabelle.

Table
in_fields
[in_fields,...]
(optional)

Eingabe-Attributfelder oder Felder, die zur Identifizierung von Polygonen oder Polygongruppen benutzt werden und diese in der Ausgabe repräsentieren.

Field
area_overlap
(optional)

Gibt an, ob Überlappungsbeziehungen analysiert werden und in der Ausgabe enthalten sind.

  • NO_AREA_OVERLAPÜberlappungsbeziehungen werden nicht analysiert oder sind nicht in der Ausgabe enthalten. Dies ist die Standardeinstellung.
  • AREA_OVERLAPÜberlappungsbeziehungen werden analysiert und sind in der Ausgabe enthalten.
Boolean
both_sides
(optional)

Gibt an, ob beide Seiten von Nachbarschaftsbeziehungen in der Ausgabe enthalten sind.

  • BOTH_SIDESFür ein benachbartes Polygonpaar werden sowohl die Nachbarschaftsinformationen des Quell-Polygons als auch die Informationen des benachbarten Polygons erfasst und umgekehrt. Dies ist die Standardeinstellung.
  • NO_BOTH_SIDESFür ein benachbartes Polygonpaar werden nur die Nachbarschaftsinformationen des Quell-Polygons und des benachbarten Polygons erfasst. Die gegenseitige Beziehung wird nicht einbezogen.
Boolean
cluster_tolerance
(optional)

Die minimale Entfernung zwischen Koordinaten, ehe sie als gleich betrachtet werden. Standardmäßig ist dies die XY-Toleranz der Eingabe-Features.

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

Gibt die Einheiten an, die verwendet werden, um die Gesamtlänge der lagegleichen Kante zwischen benachbarten Polygonen zu erfassen. Die Standardeinstellung ist die Einheit des Eingabe-Features.

  • UNKNOWNDie Längeneinheit ist unbekannt.
  • KILOMETERSDie Längeneinheit ist Kilometer.
  • METERSDie Längeneinheit ist Meter.
  • DECIMETERSDie Längeneinheit ist Dezimeter.
  • CENTIMETERSDie Längeneinheit ist Zentimeter.
  • MILLIMETERSDie Längeneinheit ist Millimeter.
  • MILES_INTERNATIONALDie Längeneinheit ist Meilen (Britisch).
  • NAUTICAL_MILES_INTERNATIONALDie Längeneinheit ist Seemeilen (International).
  • YARDS_INTERNATIONALDie Längeneinheit ist Yards (International).
  • FEET_INTERNATIONALDie Längeneinheit ist Fuß (International).
  • INCHES_INTERNATIONALDie Längeneinheit ist Zoll (International).
  • MILESDie Längeneinheit ist Meilen (US Survey).
  • NAUTICAL_MILESDie Längeneinheit ist Seemeilen (US Survey).
  • YARDSDie Längeneinheit ist Yards (US Survey).
  • FEETDie Längeneinheit ist Fuß (US Survey).
  • INCHESDie Längeneinheit ist Zoll (US Survey).
  • DECIMAL_DEGREESDie Längeneinheit ist Dezimalgrad.
  • POINTSDie Längeneinheit ist Punkte.
String
out_area_units
(optional)

Gibt die Einheiten an, die verwendet werden, um die Bereichsüberlappung von benachbarten Polygonen zu erfassen. Die Standardeinstellung ist die Einheit des Eingabe-Features. Dieser Parameter wird nur aktiviert, wenn der Parameter area_overlap auf AREA_OVERLAP festgelegt ist.

  • UNKNOWNDie Flächeneinheit ist unbekannt.
  • SQUARE_KILOMETERSDie Flächeneinheit ist Quadratkilometer.
  • SQUARE_METERSDie Flächeneinheit ist Quadratmeter.
  • SQUARE_DECIMETERSDie Flächeneinheit ist Quadratdezimeter.
  • SQUARE_CENTIMETERSDie Flächeneinheit ist Quadratzentimeter.
  • SQUARE_MILLIMETERSDie Flächeneinheit ist Quadratmillimeter.
  • SQUARE_MILESDie Flächeneinheit ist Quadratmeilen (Britisch).
  • SQUARE_YARDSDie Flächeneinheit ist Quadratyards (International).
  • SQUARE_FEETDie Flächeneinheit ist Quadratfuß (International).
  • SQUARE_INCHESDie Flächeneinheit ist Quadratzoll (International).
  • SQUARE_MILES_USDie Flächeneinheit ist Quadratmeilen (US Survey).
  • SQUARE_YARDS_USDie Flächeneinheit ist Quadratyards (US Survey).
  • SQUARE_FEET_USDie Flächeneinheit ist Quadratfuß (US Survey).
  • SQUARE_INCHES_USDie Flächeneinheit ist Quadratzoll (US Survey).
  • ACRES_USDie Flächeneinheit ist Acres (US Survey).
  • HECTARESDie Flächeneinheit ist Hektar.
  • ACRESDie Flächeneinheit ist Acres (International).
  • ARESDie Flächeneinheit ist Ar.
String

Codebeispiel

PolygonNeighbors: Beispiel (Python-Fenster)

Mit diesem Beispielskript wird nach benachbarten Wahlbezirken in Nova Scotia gesucht.

import arcpy

arcpy.management.MakeFeatureLayer(r"C:\Data\Canada\CanadaElecDist.shp", 
                                  "Canada_ElectoralDist")

arcpy.management.SelectLayerByAttribute("Canada_ElectoralDist", "NEW_SELECTION", 
                                        "\"PROVCODE\" = 'NS'")
count = arcpy.management.GetCount("Canada_ElectoralDist")[0]
print("Selected feature count: {}".format(count))

arcpy.analysis.PolygonNeighbors("Canada_ElectoralDist", 
                                r"C:\Data\Output\NS_elec_neigh.dbf", "ENNAME")
print(arcpy.GetMessages())

Lizenzinformationen

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

Verwandte Themen