Найти схожие местоположения (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

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

Подпись	Описание	Тип данных
Выходной класс объектов	Найдены объекты из входных данных и для всех объектов решений.	Набор записей

Python

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