Найти схожие местоположения (GeoAnalytics)

Краткая информация

Определяет, какой из объектов-кандидатов имеет наибольшее сходство или наибольшее различие с одним или несколькими входными объектами на основе их атрибутов.

Иллюстрация

Найти схожие местоположения

Использование

  • Можно использовать таблицу, точечные, линейные или полигональные объекты.

  • Требуется входной слой поиска (слой кандидатов). Объекты в слое поиска будут отсортированы от наибольшего до наименьшего сходства.

  • Если во Входном слое больше одного объекта, сопоставление проводится по средним значениям Входного слоя. Поэтому, например, если у вас есть два Входных слоя, и один из Полей анализа является численностью населения, инструмент будет искать Слои поиска с населением, наиболее соответствующим среднему значению. Если значения населения равны 100 и 102, например, инструмент ищет кандидаты со значением около 101.

    Примечание:

    Если имеется более одного Входного слоя, выберите атрибуты Полей анализа с аналогичными значениями. Если, например, первый объект имеет значение населения 100, а другой – 100 000 жителей, инструмент возьмет среднее от этих значений и будет искать кандидатов с населением около 50050. Обратите внимание, что это усредненное значение далеко от значения численности населения любого Входного слоя.

  • С помощью параметра Наибольшее или наименьшее сходство можно искать объекты с наибольшим или наименьшим сходством по сравнению с объектами Входного слоя, используя опции Наибольшее сходство или Наименьшее сходство соответственно. В некоторых случаях вам может понадобиться увидеть оба значения. Если значение параметра Число результатов равно 3 и значение параметра Наибольшее или наименьшее сходство установлено Оба, например, инструмент вернет три наиболее сходных и три наименее сходных объекта-кандидата.

  • Каждое полученное решение в Выходных объектах будет либо решением наибольшего сходства, либо решением наименьшего сходства с целевым Входным слоем; одно решение не может быть тем и другим (и полученные решения не будут дублироваться в Выходных объектах). Соответственно, когда для параметра Наибольшее или наименьшее сходство вы выбираете Оба, максимально возможное число сопоставленных результатов (Число результатов) будет равно половине тех, что находятся в Слое поиска.

  • Будет возвращено максимум 10000 объектов.
  • Параметр Метод сопоставления имеет следующие варианты значений:

    • Значения атрибутов – наиболее похожие кандидаты будут иметь наименьшую сумму квадратов различий для всех атрибутов Полей анализа. Все значения стандартизированы до расчета различий.
    • Профили атрибутов - вычисляется косинусный коэффициент подобия. Косинусный коэффициент подобия определяет те же связи среди стандартизованных значений атрибутов, а не пытается сопоставить значения. Например, предположим, что три Поля анализа называются A1, A2 и A3. A2 вдвое больше A1, а A3 почти равен A2. Если значение параметра Метода сопоставления будет Профили атрибутов, инструмент будет искать кандидатов с теми же атрибутивными соотношениями: A2 вдвое больше A1, а А3 почти равно A2. Так как этот метод ищет отношения между атрибутами, вы должны указать минимум два Поля анализа. Вы можете использовать метод косинусного подобия (опция Профили атрибутов) для поиска места, схожего с Лос Анджелесом, но по другой шкале, например, рассматривая профиль численности населения, сравнив количество машин с количеством жителей моложе 20-ти лет. Косинусный коэффициент подобия может иметь значения от 1.0 (полное сходство) до -1.0 (полное различие). Индекс косинусного подобия записывается в Выходные объекты в поле simindex.

  • Поля анализа должны быть числовыми и присутствовать с тем же именем, а также быть того же типа в обоих наборах данных: у Входного слоя и в Поле поиска. Если инструмент не находит соответствующие поля в Слое поиска, появится предупреждение о том, что отсутствующие атрибуты не будут участвовать в анализе.

  • Все атрибуты, использованные для сопоставления, записываются в выходные данные. Параметр Присоединяемые поля позволяет указать поля, которые будут добавлены в выходную таблицу. По умолчанию добавляются все поля. Используйте параметр Присоединяемые поля для выбора полей, которые хотите добавить из Слоя поиска.

  • Все Входные слои и итоги сопоставления записываются в выходные объекты вместе с Полями анализа и Присоединяемыми полями. Кроме того, в выходные объекты будут добавлены следующие поля:

    Имя поляОписаниеПримечания

    location_type

    Строка, указывающая какие объекты являются базовым слоем (входным), а какие слоем кандидатов (поиска).

    simrank

    Когда вы выбираете значение Наиболее схожие или Оба для параметра Наиболее или наименее схожие, все найденные решения получают ранг от наиболее до наименее схожих. Наиболее сходное решение получает значение ранга 1.

    Это поле включается в Выходные объекты, когда вы выбираете Наиболее схожие или Оба для параметра Наиболее или наименее схожие.

    dissimrank

    Когда вы выбираете значение Наименее схожие или Оба для параметра Наиболее или наименее схожие, все найденные решения получают ранг от наименее к наиболее схожим. Наименее схожее решение получает значение ранга 1.

    Это поле включается в Выходные объекты, когда вы выбираете Наименее схожие или Оба для параметра Наиболее или наименее схожие.

    simindex

    В этом поле определяется количественное значение сходства с целевым объектом. Когда вы указываете Значения атрибутов для Метода сопоставления, значение представляет собой сумму квадратов разности значений.

    Подробнее о вычислении этого индекса см. в разделе Как работает Поиск сходства.

    Это поле включается в Выходные объекты, когда вы выбираете Значения атрибута как Метод сопоставления.

    cosimindex

    В этом поле определяется количественное значение сходства с целевым объектом. Когда вы указываете Профили атрибутов для Метода сопоставления, это значение представляет собой сходство косинусов.

    Подробнее о вычислении этого индекса см. в разделе Как работает Поиск сходства.

    Это поле включается в Выходные объекты, когда вы выбираете Профили атрибутов как Метод сопоставления.

    labelrank

    Это поле используется только для целей отображения. Инструмент использует это поле для задания метода отображения результатов анализа по умолчанию.

    reference_id

    Уникальное значение ID для базовых объектов. Объектам поиска дается значение null.

    Данное поле доступно в версии ArcGIS Enterprise 10.6.1 или более поздней.

    search_id

    Уникальное значение ID для объектов поиска. Базовым объектам дается значение null.

    Данное поле доступно в версии ArcGIS Enterprise 10.6.1 или более поздней.

  • Выходные данные объектов автоматически добавляются в таблицу содержания с методом отображения по умолчанию, примененного к полю labelrank.

  • Чтобы повысить производительность инструмента Найти схожие местоположения, выполните одно или несколько следующих действий:

    • Установите параметр среды Экстент так, чтобы вы анализировали только интересующие вас данные.
    • Выберите только несколько объектов для справочного слоя.
    • Используйте локальные данные там, где запускается анализ.

  • Этот инструмент геообработки работает на ArcGIS GeoAnalytics Server. Анализ выполняется на вашем GeoAnalytics Server, а результаты сохраняются в ресурсы на вашем ArcGIS Enterprise.

  • При работе инструментов GeoAnalytics Server, анализ выполняется на GeoAnalytics Server. Для оптимальной производительности сделайте данные доступными для GeoAnalytics Server через векторные слои, размещенные на вашем портале ArcGIS Enterprise или через файловое хранилище больших данных. Данные, которые не являются локальными для GeoAnalytics Server, будут перемещены на GeoAnalytics Server до начала анализа. Это означает, что для запуска инструмента потребуется больше времени, а в некоторых случаях перемещение данных с ArcGIS Pro на GeoAnalytics Server может завершиться ошибкой. Порог сбоя зависит от скорости сети, а также от размера и сложности данных. Соответственно рекомендуется всегда предоставлять доступ к данным или создавать файловое хранилище больших данных.

    Более подробно о публикации локаторов на портале

    Более подробно о создании файловых хранилищ больших данных в Server Manager

  • Аналогичный анализ можно выполнить при помощи инструмента Поиск сходства из набора инструментов Пространственная статистика в ArcGIS Pro.

Параметры

ПодписьОписаниеТип данных
Входной слой

Базовый слой (или выборка в слое), содержащий объекты для сопоставления. Инструмент ищет объекты, подобные этим объектам. Если указано более одного объекта, сопоставление основывается на средних значениях атрибутов.

Record Set
Поиск в слое

Слой кандидатов (или выборка в слое), содержащий объекты-кандидаты. Инструмент ищет среди этих кандидатов объекты с наибольшим сходством (или наибольшим различием) с Входным слоем.

Record Set
Выходное имя

Имя выходного класса пространственных объектов. Выходной класс объектов содержит запись для каждого из Входных слоев и для всех найденных объектов.

String
Поля анализа

Список числовых атрибутов, отображающий критерии соответствия.

String
Наибольшее или наименьшее сходство

Указывает, являются ли объекты наиболее или наименее похожими на параметр Входной слой.

  • Наибольшее сходствоНаходит объекты с наибольшим сходством.
  • Наименьшее сходствоНаходит объекты с наименьшим сходством.
  • ОбаНаходит объекты с наибольшим и с наименьшим сходством.
String
Метод сопоставления

Указывает, будет ли сопоставление основываться на значениях или на отношениях между косинусами.

  • Значения атрибутаСходство или различие будет основано на сумме квадратов разницы значений стандартизованных атрибутов для всех атрибутов Полей анализа.
  • Профили атрибутовСходство или различие будет вычислено как функция сходства по косинусу для всех атрибутов Полей анализа.
String
Число результатов

Число сопоставлений для поиска. Ввод нулевого значения, либо числа большего, чем общее число объектов Слоя поиска, приведет к ранжированию всех объектов-кандидатов с максимальным значением 10000.

Long
Присоединить поля
(Дополнительный)

Дополнительный список атрибутов для включения с выходными данными. Вам может потребоваться включить, например, идентификатор имени, категорийное поле или поле даты. Эти поля не используются для определения сходства, они включаются для справки в атрибуты выходных параметров. По умолчанию добавляются все поля.

Field
Хранилище данных
(Дополнительный)

Задает ArcGIS Data Store, где будут сохраняться выходные данные. По умолчанию это Хранилище больших пространственно-временных данных. Все результаты, находящиеся в хранилище пространственно-временных больших данных, будут храниться в системе WGS84. Результаты в реляционном хранилище данных сохраняют свои систему координат.

  • Хранилище пространственно-временных больших данныхРезультаты будут храниться в хранилище больших пространственно-временных данных. Это значение по умолчанию.
  • Реляционное хранилище данныхРезультаты будут храниться в хранилище реляционных данных.
String

Производные выходные данные

ПодписьОписаниеТип данных
Выходной класс объектов

Найдены объекты из входных данных и для всех объектов решений.

Набор записей

arcpy.geoanalytics.FindSimilarLocations(input_layer, search_layer, output_name, analysis_fields, most_or_least_similar, match_method, number_of_results, {append_fields}, {data_store})
ИмяОписаниеТип данных
input_layer

Базовый слой (или выборка в слое), содержащий объекты для сопоставления. Инструмент ищет объекты, подобные этим объектам. Если указано более одного объекта, сопоставление основывается на средних значениях атрибутов.

Record Set
search_layer

Слой кандидатов (или выборка в слое), содержащий объекты-кандидаты. Инструмент ищет среди этих кандидатов объекты с наибольшим сходством (или наибольшим различием) с input_layer.

Record Set
output_name

Имя выходного сервиса пространственных объектов. Выходной сервис объектов содержит запись для каждого из input_layer и для всех найденных объектов.

String
analysis_fields
[analysis_fields,...]

Список числовых атрибутов, отображающий критерии соответствия.

String
most_or_least_similar

Указывает, являются ли объекты наиболее или наименее похожими на параметр input_layer.

  • MOST_SIMILARНаходит объекты с наибольшим сходством.
  • LEAST_SIMILARНаходит объекты с наименьшим сходством.
  • BOTHНаходит объекты с наибольшим и с наименьшим сходством.
String
match_method

Указывает, будет ли сопоставление основываться на значениях или на отношениях между косинусами.

  • ATTRIBUTE_VALUESСходство или различие будет основано на сумме квадратов разницы значений стандартизованных атрибутов для всех атрибутов analysis_fields.
  • ATTRIBUTE_PROFILESСходство или различие будет вычислено как функция сходства по косинусу для всех атрибутов analysis_fields.
String
number_of_results

Число сопоставлений для поиска. Ввод нулевого значения, либо числа большего, чем общее число объектов search_layer, приведет к ранжированию всех объектов-кандидатов с максимальным значением 10000.

Long
append_fields
[append_fields,...]
(Дополнительный)

Дополнительный список атрибутов для включения с выходными данными. Вам может потребоваться включить идентификатор имени, категорийное поле или поле даты, например. Эти поля не используются для определения сходства, они включаются для справки в атрибуты выходных параметров. По умолчанию добавляются все поля.

Field
data_store
(Дополнительный)

Задает ArcGIS Data Store, где будут сохраняться выходные данные. По умолчанию – SPATIOTEMPORAL_DATA_STORE. Все результаты, находящиеся в хранилище пространственно-временных больших данных, будут храниться в системе WGS84. Результаты в реляционном хранилище данных сохраняют свои систему координат.

  • SPATIOTEMPORAL_DATA_STOREРезультаты будут храниться в хранилище больших пространственно-временных данных. Это значение по умолчанию.
  • RELATIONAL_DATA_STOREРезультаты будут храниться в хранилище реляционных данных.
String

Производные выходные данные

ИмяОписаниеТип данных
output

Найдены объекты из входных данных и для всех объектов решений.

Набор записей

Пример кода

FindSimilarLocations, пример 1 (окно Python)

В следующем скрипте окна Python показано, как используется инструмент FindSimilarLocations.

#-------------------------------------------------------------------------------
# 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)

Параметры среды

Особые случаи

Выходная система координат

Система координат, используемая при анализе. Если данный параметр не указан, анализ будет выполнен во входной системе координат. Для GeoAnalytics Tools готовые результаты будут храниться в пространственно-временном хранилище данных в системе координат WGS84.

Информация о лицензиях

  • Basic: Обязательно ArcGIS GeoAnalytics Server
  • Standard: Обязательно ArcGIS GeoAnalytics Server
  • Advanced: Обязательно ArcGIS GeoAnalytics Server

Связанные разделы