| Beschriftung | Erläuterung | Datentyp |
Eingabe-Layer | Der Referenz-Layer (oder eine Auswahl eines Layers), der die abzugleichenden Features enthält. Das Werkzeug sucht nach anderen Features, die diesen Features ähneln. Wenn mehrere Features bereitgestellt werden, erfolgt der Abgleich auf Basis der durchschnittlichen Attributwerte. | Table View |
Such-Layer | Der Kandidaten-Layer (oder eine Auswahl eines Layers), der Features enthält, die mit den Kandidaten übereinstimmen. Das Werkzeug sucht unter diesen Kandidaten nach Features, die dem Parameter Eingabe-Layer am ähnlichsten (oder unähnlichsten) sind. | Table View |
Ausgabe-Dataset | Der Name der Ausgabe-Feature-Class. Die Ausgabe-Feature-Class enthält einen Datensatz für alle Eingabe-Layer-Parameter sowie für alle ermittelten Features, die der Lösung entsprechen. | Feature Class; Table |
Analysefelder | Eine Liste der numerischen Attribute, die die Abgleichskriterien darstellen. | String |
Größte oder geringste Ähnlichkeit | Gibt an, ob die gesuchten Features die größte oder geringste Ähnlichkeit mit dem Parameter Eingabe-Layer aufweisen.
| String |
Abgleichmethode | Gibt an, ob der Abgleich auf Werten oder Kosinusbeziehungen basiert.
| String |
Anzahl der Ergebnisse | Die Anzahl der zu suchenden Lösungsentsprechungen. Durch die Eingabe von Null oder einer Zahl, die größer als die Gesamtanzahl der Such-Layer-Features ist, werden Rangstufen für alle Kandidaten-Features zurückgegeben, wobei das Maximum bei 10.000 liegt. | Long |
Anzuhängende Felder (optional) | Eine optionale Liste mit Attributen, die in die Ausgabe einbezogen werden sollen. Sie können beispielsweise eine Namenskennung, ein Kategoriefeld oder ein Datumsfeld einfügen. Diese Felder werden nicht zur Bestimmung der Ähnlichkeit verwendet; sie werden lediglich zu Referenzzwecken in die Ausgabeparameterattribute aufgenommen. Standardmäßig werden alle Felder hinzugefügt. | Field |
Zusammenfassung
Identifiziert die Kandidaten-Features, die basierend auf Feature-Attributen, die größte oder geringste Ähnlichkeit mit einem oder mehreren abzugleichenden Eingabe-Features aufweisen.
Abbildung
Verwendung
Es können Tabellen-, Punkt-, Linien- oder Flächen-Features verwendet werden.
Ein Eingabe-Such-Layer (Kandidat) ist erforderlich. Die Features des Such-Layers werden nach Ähnlichkeit mit den Eingabe-Positionen (Referenz) geordnet.
Wenn mehrere Features im Eingabe-Layer vorhanden sind, basiert der Abgleich auf Durchschnittswerten aus dem Eingabe-Layer. Wenn beispielsweise zwei Eingabe-Layer-Features vorhanden sind und eines der Analysefelder-Attribute eine Bevölkerungsvariable ist, sucht das Werkzeug nach Such-Layern mit Bevölkerungen, die den durchschnittlichen Bevölkerungswerten ähnlich sind. Wenn die Bevölkerungswerte 100 und 102 betragen, sucht das Werkzeug beispielsweise nach Kandidaten mit Bevölkerungswerten, die dem Wert 101 nahe kommen.
Hinweis:
Wenn es mehrere Eingabe-Layer gibt, wählen Sie für Analysefelder Attribute mit ähnlichen Werten aus. Wenn der Bevölkerungswert für eine der Eingaben 100 und die andere Eingabe 100.000 beträgt, sucht das Werkzeug nach Übereinstimmungen mit Bevölkerungszahlen, die dem Durchschnitt dieser beiden Werte nahe kommen: 50.050. Beachten Sie, dass dieser Durchschnittswert weit von dem Bevölkerungswert jedes Eingabe-Layers entfernt ist.
Verwenden Sie den Parameter Größte oder geringste Ähnlichkeit, um nach Features zu suchen, die gegenüber den Eingabe-Layer-Features die größte oder die geringste Ähnlichkeit aufweisen; wählen Sie hierzu die Option Größte Ähnlichkeit oder Geringste Ähnlichkeit aus. In einigen Fällen möchten Sie möglicherweise beides anzeigen. Wenn Sie "3" für den Parameter Anzahl der Ergebnisse und Beides für den Parameter Größte oder geringste Ähnlichkeit eingeben, gibt das Werkzeug beispielsweise die drei Kandidaten-Features mit der größten und der geringsten Ähnlichkeit aus.
Jede in Ausgabe-Features angegebene Lösungsentsprechung ist eine Lösung, die den vorgesehenen Eingabe-Features entweder am ähnlichsten ist oder sich am meisten von ihnen unterscheidet. Eine einzelne Lösung kann nicht beides sein (und Lösungsentsprechungen werden in den Ausgabe-Features nicht dupliziert). Wenn Sie für den Parameter Größte oder geringste Ähnlichkeit den Wert Beides auswählen, entspricht die maximale Anzahl möglicher resultierender Übereinstimmungen (Anzahl der Ergebnisse) demzufolge der Hälfte der Anzahl des Such-Layers.
- Es werden maximal 10.000 Such-Layer-Features zurückgegeben.
Der Parameter Abgleichmethode kann die folgenden Werte annehmen:
- Attributwerte: Die ähnlichsten Kandidaten weisen die kleinste Summe der quadrierten Differenzen für alle Attribute der Analysefelder auf. Alle Werte werden standardisiert, bevor die Unterschiede berechnet werden.
- Attributprofile: Die Kosinusähnlichkeit wird gemessen. Die Kosinusähnlichkeit sucht nach den gleichen Beziehungen zwischen standardisierten Attributwerten, anstatt Werte abzugleichen. Beispiel: Angenommen, es gibt die drei Analysefelder A1, A2, A3. A2 ist zweimal so groß wie A1, und A3 ist fast identisch mit A2. Bei der Option Attributprofile für den Parameterwert Abgleichmethode sucht das Werkzeug nach Kandidaten mit diesen Attributbeziehungen: A2 ist zweimal so groß wie A1 und A3 ist fast identisch mit A2. Da diese Methode nach Beziehungen zwischen Attributen sucht, müssen Sie mindestens zwei Attribute für Analysefelder angeben. Sie können die Methode der Kosinusähnlichkeit (Option Attributprofile) verwenden, um Orte wie Los Angeles zu suchen, insgesamt jedoch in einem kleineren Maßstab. Beispiel: Das Profil der Bevölkerung im Vergleich mit der Anzahl von Autos und der Anzahl der Einwohner unter 20 Jahren. Der Index der Kosinusähnlichkeit reicht von 1,0 (vollständige Ähnlichkeit) bis -1,0 (vollständige Unähnlichkeit). Der Index der Kosinusähnlichkeit wird in das Feld simindex (Kosinusähnlichkeit) der Ausgabe-Features eingetragen.
Der Parameter Analysefelder muss numerisch sein und in den Datasets Eingabe-Layer und Such-Layer mit dem gleichen Feldnamen und Feldtyp vorhanden sein. Wenn das Werkzeug keine entsprechenden Felder für den Such-Layer findet, wird eine Warnmeldung angezeigt, die Sie darauf hinweist, dass die fehlenden Attribute aus der Analyse entfernt wurden.
Alle für den Abgleich herangezogenen Attribute werden in die Ausgabe übernommen. Mit dem Parameter Felder anhängen können Sie Felder angeben, die der Ausgabetabelle hinzugefügt werden sollen. Standardmäßig werden alle Felder hinzugefügt. Mit dem Parameter Felder anhängen können Sie bestimmte Felder aus dem Such-Layer auswählen, die Sie hinzufügen möchten.
Alle Entsprechungen zwischen Eingabe-Layer und Lösung werden zusammen mit den Parametern Analysefelder und Felder anhängen in die Ausgabe-Features übernommen. Zudem werden folgende Felder in die Ausgabe-Features eingefügt:
Feldname Beschreibung Hinweise location_type
Eine Zeichenfolge, die angibt, ob Features ein Referenz-Layer (Eingabe) oder ein Kandidaten-Layer (Suche) sind.
simrank
Wenn Sie Größte Ähnlichkeit oder Beides als Wert für den Parameter Größte oder geringste Ähnlichkeit auswählen, werden alle Lösungsentsprechungen von der größten bis zur geringsten Ähnlichkeit geordnet. Die Lösungsentsprechung mit der größten Ähnlichkeit hat einen Rangwert von 1.
Das erste Feld wird nur dann in die Ausgabe-Features eingefügt, wenn Sie Größte Ähnlichkeit oder Beides als Wert für den Parameter Größte oder geringste Ähnlichkeit auswählen.
dissimrank
Wenn Sie Geringste Ähnlichkeit oder Beides als Wert für den Parameter Größte oder geringste Ähnlichkeit auswählen, werden alle Lösungsentsprechungen von der geringsten bis zur größten Ähnlichkeit geordnet. Die Auflösung mit der geringsten Ähnlichkeit erhält einen Rangstufenwert von 1.
Dieses Feld wird nur dann in die Ausgabe-Features eingefügt, wenn Sie Geringste Ähnlichkeit oder Beides als Wert für den Parameter Größte oder geringste Ähnlichkeit auswählen.
simindex
Dieses Feld bestimmt die Ähnlichkeit jeder Lösungsentsprechung mit dem Ziel-Feature. Wenn Sie für den Parameterwert Abgleichmethode die Option Attributwerte angeben, stellt der Wert die Summe der quadrierten Wertunterschiede dar.
Weitere Informationen zum Berechnen dieses Index finden Sie unter Funktionsweise der Ähnlichkeitssuche.
Dieses Feld wird nur dann in die Ausgabe-Features eingefügt, wenn Sie Attributwerte für den Parameterwert Abgleichmethode auswählen.
cosimindex
Dieses Feld bestimmt die Ähnlichkeit jeder Lösungsentsprechung mit dem Ziel-Feature. Wenn Sie für den Parameterwert Abgleichmethode die Option Attributprofile angeben, stellt der Wert die Kosinusähnlichkeit dar.
Weitere Informationen zum Berechnen dieses Index finden Sie unter Funktionsweise der Ähnlichkeitssuche.
Dieses Feld wird nur dann in die Ausgabe-Features eingefügt, wenn Sie Attributprofile für den Parameterwert Abgleichmethode auswählen.
labelrank
Dieses Feld dient lediglich zu Anzeigezwecken. Das Werkzeug verwendet dieses Feld, um das Standard-Rendering der Analyseergebnisse bereitzustellen.
reference_id
Ein eindeutiger ID-Wert für Referenz-Features. Such-Features erhalten einen NULL-Wert.
search_id
Ein eindeutiger ID-Wert für Such-Features. Referenz-Features erhalten einen NULL-Wert.
Die Ausgabe wird dem Inhaltsverzeichnis automatisch mit Standard-Rendering für das labelrank-Feld hinzugefügt.
Wenn Sie einen oder mehrere der folgenden Schritte durchführen, können Sie die Performance des Werkzeugs Ähnliche Positionen suchen verbessern:
- Legen Sie die Ausdehnungsumgebung so fest, dass nur die gewünschten Daten analysiert werden.
- Wählen Sie für den Referenz-Layer nur wenige Features aus.
- Verwenden Sie lokale Daten an der Stelle, an der die Analyse ausgeführt wird.
Dieses Geoverarbeitungswerkzeug wird unterstützt durch Spark. Bei Analysen auf Ihrem Desktop-Computer werden mehrere Kerne parallel verwendet. Weitere Informationen über die Ausführung der Analyse finden Sie unter Überlegungen zu GeoAnalytics Desktop-Werkzeugen.
Bei der Ausführung von GeoAnalytics Desktop-Werkzeugen wird die Analyse auf Ihrem Desktop-Computer durchgeführt. Für eine optimale Performance sollten die Daten auf Ihrem Desktop verfügbar sein. Wenn Sie einen gehosteten Feature-Layer verwenden, wird empfohlen, ArcGIS GeoAnalytics Server zu verwenden. Wenn Ihre Daten nicht lokal verfügbar sind, dauert die Ausführung eines Werkzeugs bedeutend länger. Informationen zur Verwendung von ArcGIS GeoAnalytics Server für Analysen finden Sie unter GeoAnalytics Tools.
Eine ähnliche Analyse ist auch mit dem Werkzeug Ähnlichkeitssuche in der Toolbox "Spatial Statistics" in ArcGIS AllSource möglich.
Parameter
arcpy.geoanalytics.FindSimilarLocations(input_layer, search_layer, output, analysis_fields, most_or_least_similar, match_method, number_of_results, {append_fields})| Name | Erläuterung | Datentyp |
input_layer | Der Referenz-Layer (oder eine Auswahl eines Layers), der die abzugleichenden Features enthält. Das Werkzeug sucht nach anderen Features, die diesen Features ähneln. Wenn mehrere Features bereitgestellt werden, erfolgt der Abgleich auf Basis der durchschnittlichen Attributwerte. | Table View |
search_layer | Der Kandidaten-Layer (oder eine Auswahl eines Layers), der Features enthält, die mit den Kandidaten übereinstimmen. Das Werkzeug sucht unter diesen Kandidaten nach Features, die dem Parameter input_layer am ähnlichsten (oder unähnlichsten) sind. | Table View |
output | Das Ausgabe-Dataset enthält einen Datensatz für alle input_layer-Parameterwerte sowie für alle ermittelten Features, die der Lösung entsprechen. | Feature Class; Table |
analysis_fields [analysis_fields,...] | Eine Liste der numerischen Attribute, die die Abgleichskriterien darstellen. | String |
most_or_least_similar | Gibt an, ob die gesuchten Features die größte oder geringste Ähnlichkeit mit dem Parameter input_layer aufweisen.
| String |
match_method | Gibt an, ob der Abgleich auf Werten oder Kosinusbeziehungen basiert.
| String |
number_of_results | Die Anzahl der zu suchenden Lösungsentsprechungen. Durch die Eingabe von Null oder einer Zahl, die größer als die Gesamtanzahl der search_layer-Features ist, werden Rangstufen für alle Kandidaten-Features zurückgegeben, wobei das Maximum bei 10.000 liegt. | Long |
append_fields [append_fields,...] (optional) | Eine optionale Liste mit Attributen, die in die Ausgabe einbezogen werden sollen. Sie können beispielsweise eine Namenskennung, ein Kategoriefeld oder ein Datumsfeld einfügen. Diese Felder werden nicht zur Bestimmung der Ähnlichkeit verwendet; sie werden lediglich zu Referenzzwecken in die Ausgabeparameterattribute aufgenommen. Standardmäßig werden alle Felder hinzugefügt. | Field |
Codebeispiel
Das folgende Skript für das Python-Fenster veranschaulicht, wie Sie die Funktion FindSimilarLocations verwenden.
#-------------------------------------------------------------------------------
# Name: FindSimilarLocations.py
# Description: Find Similar stores to a top performing store
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/SalesData.gdb"
# Set local variables
referenceStore = "TopPerformer"
candidateStores = "AllStores"
analysisFields = [ "SickDays", "TotalCustomers", "AvgPurchaseAmount"]
outputName = "BestStores_10"
# Run Find Similar Locations
arcpy.gapro.FindSimilarLocations(referenceStore, candidateStores,
outputName, analysisFields,
"MOST_SIMILAR", "ATTRIBUTE_VALUES", 10)