Сводка
Определяет, какой из объектов-кандидатов имеет наибольшее сходство или наибольшее различие с одним или несколькими входными объектами на основе их атрибутов.
Иллюстрация
Использование
Можно использовать таблицу, точечные, линейные или полигональные объекты.
Требуется входной слой поиска (слой кандидатов). Объекты в слое поиска будут отсортированы от наибольшего до наименьшего сходства.
Если во Входном слое больше одного объекта, сопоставление проводится по средним значениям Входного слоя. Поэтому, например, если у вас есть два Входных слоя, и один из Полей анализа является численностью населения, инструмент будет искать Слои поиска с населением, наиболее соответствующим среднему значению. Если значения населения равны 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.
Синтаксис
FindSimilarLocations(input_layer, search_layer, output_name, analysis_fields, most_or_least_similar, match_method, number_of_results, {append_fields}, {data_store})| Parameter | Объяснение | Тип данных |
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.
| String |
match_method | Указывает, будет ли сопоставление основываться на значениях или на отношениях между косинусами.
| String |
number_of_results | Число сопоставлений для поиска. Ввод нулевого значения, либо числа большего, чем общее число объектов search_layer, приведет к ранжированию всех объектов-кандидатов с максимальным значением 10000. | Long |
append_fields [append_fields,...] (Дополнительный) | Дополнительный список атрибутов для включения с выходными данными. Вам может потребоваться включить идентификатор имени, категорийное поле или поле даты, например. Эти поля не используются для определения сходства, они включаются для справки в атрибуты выходных параметров. По умолчанию добавляются все поля. | Field |
data_store (Дополнительный) | Задает ArcGIS Data Store, где будут сохраняться выходные данные. По умолчанию – SPATIOTEMPORAL_DATA_STORE. Все результаты из SPATIOTEMPORAL_DATA_STORE будут сохранены в WGS84. Результаты, сохраненные в RELATIONAL_DATA_STORE сохранят собственную систему координат.
| String |
Производные выходные данные
| Name | Объяснение | Тип данных |
| output | Найдены объекты из входных данных и для всех объектов решений. | Набор записей |
Пример кода
В следующем скрипте окна 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)Environments
- Выходная система координат
Система координат, используемая при анализе. Если данный параметр не указан, анализ будет выполнен во входной системе координат. Для Инструменты геоаналитики готовые результаты будут храниться в пространственно-временном хранилище данных в привязке WGS84.
Информация о лицензиях
- Basic: Требуется ArcGIS GeoAnalytics Server
- Standard: Требуется ArcGIS GeoAnalytics Server
- Advanced: Требуется ArcGIS GeoAnalytics Server