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.
Dieses Feld ist ab ArcGIS Enterprise 10.6.1 oder höher verfügbar.
search_id
Ein eindeutiger ID-Wert für Such-Features. Referenz-Features erhalten einen NULL-Wert.
Dieses Feld ist ab ArcGIS Enterprise 10.6.1 oder höher verfügbar.
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 ArcGIS GeoAnalytics Server. Die Analyse wird auf dem GeoAnalytics Server ausgeführt, und die Ergebnisse werden in den eigenen Inhalten in ArcGIS Enterprise gespeichert.
Bei der Ausführung von GeoAnalytics Server-Werkzeugen wird die Analyse auf dem GeoAnalytics Server abgeschlossen. Für eine optimale Performance sollten die Daten dem GeoAnalytics Server über Feature-Layer zur Verfügung stehen, die auf Ihrem ArcGIS Enterprise-Portal gehostet werden. Alternativ können Big-Data-Dateifreigaben verwendet werden. Daten, auf die der GeoAnalytics Server nicht lokal zugreifen kann, werden vor Analysebeginn auf den GeoAnalytics Server verschoben. Dadurch dauert die Ausführung eines Werkzeugs länger. Es kann zudem vorkommen, dass das Verschieben der Daten von ArcGIS Pro zum GeoAnalytics Server fehlschlägt. Die Wahrscheinlichkeit eines Fehlers hängt dabei von der Netzwerkgeschwindigkeit sowie der Größe und Komplexität der Daten ab. Daher wird empfohlen, dass Sie Ihre Daten stets freigeben oder eine Big-Data-Dateifreigabe erstellen.
Weitere Informationen zum Freigeben von Daten in Ihrem Portal
Weitere Informationen zum Erstellen einer Big-Data-Dateifreigabe über Server Manager
Eine ähnliche Analyse ist auch mit dem Werkzeug Ähnlichkeitssuche in der Toolbox "Spatial Statistics" in ArcGIS Pro möglich.
Syntax
arcpy.geoanalytics.FindSimilarLocations(input_layer, search_layer, output_name, analysis_fields, most_or_least_similar, match_method, number_of_results, {append_fields}, {data_store})| Parameter | Erklärung | 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. | Record Set |
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. | Record Set |
output_name | Der Name des Ausgabe-Feature-Service. Der Ausgabe-Feature-Service enthält einen Datensatz für alle input_layer-Parameter sowie für alle ermittelten Features, die der Lösung entsprechen. | String |
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 |
data_store (optional) | Gibt den ArcGIS Data Store für das Speichern der Ausgabe an. Die Standardeinstellung ist SPATIOTEMPORAL_DATA_STORE. Alle in einem Big Data Store vom Typ "spatiotemporal" gespeicherten Ergebnisse werden im WGS84 gespeichert. Ergebnisse, die in einem Data Store vom Typ "relational" gespeichert werden, behalten ihr Koordinatensystem bei.
| String |
Abgeleitete Ausgabe
| Name | Erklärung | Datentyp |
| output | Features aus der Eingabe sowie für alle ermittelten Features, die der Lösung entsprechen. | Datensatz |
Codebeispiel
Das folgende Skript veranschaulicht die Verwendung des Werkzeugs FindSimilarLocations im Python-Fenster.
#-------------------------------------------------------------------------------
# Name: FindSimilarLocations.py
# Description: Find Similar stores to a top performing store
#
# Requirements: ArcGIS GeoAnalytics Server
# Import system modules
import arcpy
# Set local variables
referenceStore = "https://MyGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_Stores/BigDataCatalogServer/TopPerformer"
candidateStores = "https://MyGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_Stores/BigDataCatalogServer/AllStores"
analysisFields = [ "SickDays", "TotalCustomers", "AvgPurchaseAmount"]
outputName = "BestStores_10"
dataStore = "SPATIOTEMPORAL_DATA_STORE"
# Execute Find Similar Locations
arcpy.geoanalytics.FindSimilarLocations(referenceStore, candidateStores,
outputName, analysisFields,
"MOST_SIMILAR", "ATTRIBUTE_VALUES", 10,
None, dataStore)Umgebungen
- Ausgabe-Koordinatensystem
Das Koordinatensystem, das für die Analyse verwendet wird. Die Analyse wird im Eingabe-Koordinatensystem ausgeführt, sofern nicht anders durch diesen Parameter angegeben. Für GeoAnalytics Tools werden die Endergebnisse im Data Store vom Typ "spatiotemporal" in WGS84 gespeichert.
Lizenzinformationen
- Basic: Erfordert ArcGIS GeoAnalytics Server
- Standard: Erfordert ArcGIS GeoAnalytics Server
- Advanced: Erfordert ArcGIS GeoAnalytics Server