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
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
MeasureCannibalization(in_features, area_id_field, area_description_field, out_feature_class, {store_id_field}, {create_report}, {report_title}, {report_folder}, {report_format}, {variables})
Parameter | Erklärung | Datentyp |
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.
| 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
Name | Erklärung | Datentyp |
output_report | Die Ausgabeberichtsdateien. | Datei |
Codebeispiel
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")
Umgebungen
Lizenzinformationen
- Basic: Erfordert Business Analyst
- Standard: Erfordert Business Analyst
- Advanced: Erfordert Business Analyst