Ähnliche Positionen suchen (GeoAnalytics)

Zusammenfassung

Identifiziert die Kandidaten-Features, die basierend auf Feature-Attributen, die größte oder geringste Ähnlichkeit mit einem oder mehreren abzugleichenden Eingabe-Features aufweisen.

Vorversion:

Die Erweiterung ArcGIS GeoAnalytics Server wird in ArcGIS Enterprise abgekündigt. Die letzte Version von GeoAnalytics Server ist in ArcGIS Enterprise 11.3 enthalten. Dieses Geoverarbeitungswerkzeug steht in ArcGIS Enterprise 11.3 und früheren Versionen zur Verfügung.

Abbildung

Abbildung des Werkzeugs "Ähnliche Positionen suchen"

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:

    FeldnameBeschreibungHinweise

    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 ausgeführt. Für eine optimale Performance sollten die Daten 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 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 zu GeoAnalytics Server fehlschlägt. Die Wahrscheinlichkeit eines Fehlers hängt dabei von der Netzwerkgeschwindigkeit sowie der Größe und Komplexität der Daten ab. Es 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.

Parameter

BeschriftungErläuterungDatentyp
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.

Record Set
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.

Record Set
Ausgabename

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.

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

  • Größte ÄhnlichkeitFindet die Features mit der größten Ähnlichkeit.
  • Geringste ÄhnlichkeitFindet die Features mit der geringsten Ähnlichkeit.
  • BeidesFindet die Features mit der größten und die Features mit der geringsten Ähnlichkeit.
String
Abgleichmethode

Gibt an, ob der Abgleich auf Werten oder Kosinusbeziehungen basiert.

  • AttributwerteÄhnlichkeiten oder Unterschiede basieren auf der Summe der quadrierten standardisierten Attributwertunterschiede für alle Attribute der Analysefelder.
  • AttributprofileÄhnlichkeiten oder Unterschiede werden als Funktion von Kosinusähnlichkeit für alle Attribute der Analysefelder berechnet.
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
Data Store
(optional)

Gibt den ArcGIS Data Store an, in dem die Ausgabe gespeichert wird. 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.

  • Big Data Store vom Typ "spatiotemporal"Die Ausgabe wird in einem Big Data Store vom Typ "spatiotemporal" gespeichert. Dies ist die Standardeinstellung.
  • Data Store vom Typ "relational"Die Ausgabe wird in einem Data Store vom Typ "relational" gespeichert.
String

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Ausgabe-Feature-Class

Features aus der Eingabe sowie für alle ermittelten Features, die der Lösung entsprechen.

Record Set

arcpy.geoanalytics.FindSimilarLocations(input_layer, search_layer, output_name, analysis_fields, most_or_least_similar, match_method, number_of_results, {append_fields}, {data_store})
NameErläuterungDatentyp
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.

  • MOST_SIMILARFindet die Features mit der größten Ähnlichkeit.
  • LEAST_SIMILARFindet die Features mit der geringsten Ähnlichkeit.
  • BOTHFindet die Features mit der größten und die Features mit der geringsten Ähnlichkeit.
String
match_method

Gibt an, ob der Abgleich auf Werten oder Kosinusbeziehungen basiert.

  • ATTRIBUTE_VALUESÄhnlichkeiten oder Unterschiede basieren auf der Summe der quadrierten standardisierten Attributwertunterschiede für alle Attribute der analysis_fields.
  • ATTRIBUTE_PROFILESÄhnlichkeiten oder Unterschiede werden als Funktion von Kosinusähnlichkeit für alle Attribute der analysis_fields berechnet.
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 an, in dem die Ausgabe gespeichert wird. 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.

  • SPATIOTEMPORAL_DATA_STOREDie Ausgabe wird in einem Big Data Store vom Typ "spatiotemporal" gespeichert. Dies ist die Standardeinstellung.
  • RELATIONAL_DATA_STOREDie Ausgabe wird in einem Data Store vom Typ "relational" gespeichert.
String

Abgeleitete Ausgabe

NameErläuterungDatentyp
output

Features aus der Eingabe sowie für alle ermittelten Features, die der Lösung entsprechen.

Record Set

Codebeispiel

FindSimilarLocations (Python-Fenster)

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

Sonderfälle

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

Verwandte Themen