Kannibalisierung ermitteln (Business Analyst)

Mit der Business Analyst-Lizenz verfügbar.

Zusammenfassung

Berechnet die Überlappung zwischen zwei oder mehreren Polygonen. Überlappung bezieht sich auf die Ausdehnung der Polygone über den Schnittpunkt hinaus.

Sie können optional einen Bericht mit Überlappungsstatistiken erstellen.

Abbildung

Kannibalisierte Fläche

Verwendung

  • Kennwerte zur Beschreibung der kannibalisierten Flächen sind als Attribute in der Ausgabe-Feature-Class und in einem optionalen Bericht enthalten.

  • Sie können demografische und Lifestyle-Variablen aus dem Daten-Browser auswählen, um zusätzliche Felder in der Ausgabe zurückzugeben, mit denen die Anteile in den betroffenen Polygonen definiert werden.

  • Die Ausgabeattributtabelle umfasst einen Datensatz für jede Überlappung zwischen Eingabe-Polygonen.

  • Standardmäßig vergleichen vier Kennwerte die Anteile der kannibalisierten Fläche und werden als einzelne Felder in der Ausgabe zurückgegeben:

    • A1: Flächenanteil: ID1 bis ID2 (Fläche von Polygon ID1 / Fläche von Polygon ID2)
    • A2: Flächenanteil in Überlappung (Schnittpunkt der Fläche von Polygon ID1 und Polygon ID2 / Vereinigung der Fläche von Polygon ID1 und Polygon ID2)
    • A3: Flächenanteil: ID1 in ID2 (Schnittpunkt der Fläche von Polygon ID1 und Polygon ID2 / Fläche von Polygon ID1)
    • A4: Flächenanteil: ID2 in ID1 (Schnittpunkt der Fläche von Polygon ID1 und Polygon ID2 / Fläche von Polygon ID2)

  • Variablen können aus dem Daten-Browser ausgewählt und als zusätzliche Kennwerte in die Ausgabe aufgenommen werden.

  • Wenn zusätzliche Kennwerte ausgewählt werden, werden fünf zusätzliche Ausgabefelder zurückgegeben. Das erste Feld enthält den Wert der Variable in der Überlappungsfläche. Die folgenden vier folgen dem Muster der Standard-Kennwerte, verwenden jedoch Variablenwerte anstelle von Flächen.

  • Am Beispiel der Bevölkerung des aktuellen Jahrs gäbe es folgende zusätzliche Kennwerte-Felder:

    • populationtotals_totpop_cy: Bevölkerung in einer Überlappungsfläche
    • populationtotals_totpop_cy_A1: Bevölkerungsanteil: ID1 bis ID2
    • populationtotals_totpop_cy_A2: Bevölkerungsanteil in Überlappung
    • populationtotals_totpop_cy_A3: Bevölkerungsanteil: ID1 in ID2
    • populationtotals_totpop_cy_A4: Bevölkerungsanteil: ID2 in ID2

  • Wenn die Polygone sich nicht überlappen, enthält die Ausgabe-Feature-Class weder eine Geometrie noch Datensätze. Die Ausgabe-Feature-Class enthält nur die überlappende Geometrie aus der Eingabe.

  • Die Polygone müssen aus einer einzelnen Feature-Class stammen. Mit dem Werkzeug Zusammenführen (Merge) können Sie mehrere Feature-Classes zu einer zusammenfassen.

Syntax

arcpy.ba.MeasureCannibalization(in_features, area_id_field, area_description_field, out_feature_class, {store_id_field}, {create_report}, {report_title}, {report_folder}, {report_format}, {variables})
ParameterErklärungDatentyp
in_features

Die auf eine Überlappung zu untersuchenden Eingabe-Polygon-Features.

Feature Layer
area_id_field

Das Feld, das die einzelnen Features im Eingabe-Layer eindeutig identifiziert.

Field
area_description_field

Das Feld, das die Features im Eingabe-Layer beschreibt.

Field
out_feature_class

Die Ausgabe-Feature-Class mit den im Eingabe-Layer gefundenen Überlappungsflächen.

Feature Class
store_id_field
(optional)

Die eindeutige ID zur Verknüpfung einer Filiale mit einem Polygon, wenn es sich bei den Eingaben um Einzugsgebiete handelt.

Field
create_report
(optional)

Gibt an, ob ein Bericht erstellt wird.

  • CREATE_REPORTEs wird ein Bericht erstellt.
  • DO_NOT_CREATE_REPORTEs wird kein Bericht erstellt. Dies ist die Standardeinstellung.
Boolean
report_title
(optional)

Titel des Berichts. Der Standardwert lautet Measure Cannibalization (Measure Cannibalization in Python).

String
report_folder
(optional)

Das Ausgabeverzeichnis, in dem der Bericht gespeichert wird.

Folder
report_format
[report_format,...]
(optional)

Die Ausgabeformate des Berichts.

String
variables
[variables,...]
(optional)

Eine oder mehr Variablen, die zur Berechnung zusätzlicher Kannibalisierungs-Kennwerte verwendet werden – z. B. die Gesamtzahl der Personen und Haushalte in Schnittflächen oder der Prozentsatz der Gesamtzahl an Menschen und Haushalten in einem Einzugsgebiet, das in einer Kannibalisierungsfläche liegt.

String

Abgeleitete Ausgabe

NameErklärungDatentyp
output_report

Die Ausgabeberichtsdateien.

Datei

Codebeispiel

MeasureCannibalization – Beispiel (Python-Fenster)

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

import arcpy
arcpy.ba.MeasureCannibalization("SF_Stores_Rings", "AREA_ID", "AREA_DESC",
                                r"C:\ MyProject1\MyProject1.gdb\SF_Stores_RIngs_MeasureCannibalization",
                                "STORE_ID", "CREATE_REPORT",
                                "Measure Cannibalization",
                                r"C:\ MyProject1\MeasureCannibalization", "PDF")

Lizenzinformationen

  • Basic: Erfordert Business Analyst
  • Standard: Erfordert Business Analyst
  • Advanced: Erfordert Business Analyst

Verwandte Themen