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

Abbildung zum Werkzeug "Kannibalisierung ermitteln"

Verwendung

  • Kennwerte zur Beschreibung der Überlappungsflä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 werden anhand von vier Kennwerten die Anteile der überlappten Fläche verglichen. Dabei werden die Kennwerte 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 weiteren vier Felder 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 ID1

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

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Features

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

Feature Layer
Einzugsgebiets-ID

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

Field
Beschreibung des Einzugsgebiets

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

Field
Ausgabe-Feature-Class

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

Feature Class
ID-Feld der Filiale
(optional)

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

Field
Bericht erstellen
(optional)

Gibt an, ob ein Bericht erstellt wird.

  • Aktiviert: Es wird ein Bericht erstellt.
  • Deaktiviert: Es wird kein Bericht erstellt. Dies ist die Standardeinstellung.
Boolean
Berichtstitel
(optional)

Titel des Berichts. Der Standardwert ist Measure Cannibalization.

String
Ausgabeordner für den Bericht
(optional)

Das Ausgabeverzeichnis, in dem der Bericht gespeichert wird.

Folder
Berichtsausgabeformate
(optional)

Die Ausgabeformate des Berichts.

String
Variablen
(optional)

Eine oder mehrere Variablen, die zur Berechnung zusätzlicher Überlappungs-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 überlappten Fläche liegt.

String

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Ausgabebericht

Die Ausgabeberichtsdateien.

File

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})
NameErläuterungDatentyp
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 ist Measure Cannibalization.

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 mehrere Variablen, die zur Berechnung zusätzlicher Überlappungs-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 überlappten Fläche liegt.

String

Abgeleitete Ausgabe

NameErläuterungDatentyp
output_report

Die Ausgabeberichtsdateien.

File

Codebeispiel

MeasureCannibalization – Beispiel (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion MeasureCannibalization verwenden.

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