查找相似位置 (GeoAnalytics Server 工具)

汇总

根据要素属性识别与单个或多个输入要素最相似或者最不相似的候选要素。

旧版本：

即将在 ArcGIS Enterprise 中弃用 ArcGIS GeoAnalytics Server 扩展模块。 GeoAnalytics Server 的最终版本已随 ArcGIS Enterprise 11.3 一同发布。可通过 ArcGIS Enterprise 11.3 及较早版本获取此地理处理工具。

插图

查找相似位置工具图示

用法

可使用表格、点、线或面要素。
需要输入搜索（候选）图层。将根据输入（参考）位置的相似性为搜索图层中的要素划分等级。
如果输入图层参数值中存在多个要素，可根据平均输入图层值进行匹配。例如，如果存在两个输入图层要素，并且其中一个分析字段参数属性为人口变量，那么工具会搜索人口数与平均人口值接近的搜索图层参数值。例如，如果人口值为 100 和 102，那么工具会搜索人口数接近 101 的候选要素。

注:

如果存在多个输入图层参数值，则请选择具有相似值的分析字段属性。例如，如果其中一个输入的人口值为 100，另一个输入的人口值为 100,000，则工具将搜索人口数接近两者平均值 50,050 的匹配。请注意，此平均值与任一输入图层值的人口值都相差甚远。
可使用最相似或最不相似参数，分别通过最相似或最不相似选项来搜索与输入图层要素最相似的要素或者最不相似的要素。在某些情况下，您可能希望看见上述两者。例如，如果结果数参数值为 3 且最相似或最不相似参数值为两者，则工具将查找三个最相似和三个最不相似的候选要素。
输出要素参数中的任何匹配解决方案均是与目标输入图层值最相似或最不相似的解决方案；单个解决方案不会同时出现两种情况（匹配的解决方案不会在输出要素中重复）。因此，如果最相似或最不相似参数值为两者，则可能出现的匹配结果的最大数量（结果数参数值）将是搜索图层值数量的一半。
最多将返回 10,000 个搜索图层要素。
匹配方法参数具有以下值选项：
- 属性值—最相似的候选要素会具有所有分析字段属性的最小平方差总和。计算差异之前，所有值均为标准化值。
- 属性剖面—将测量余弦相似性。余弦相似性将在标准化属性值间搜索相同关系，而并非尝试匹配量级。例如，假设有 A1、A2 和 A3 三个分析字段值。 A2 是 A1 的两倍，且 A3 与 A2 几乎相等。如果匹配方法参数值为属性剖面，该工具会搜索具有同样属性关系的候选要素：A2 是 A1 的两倍，A3 与 A2 几乎相等。由于该方法用于查找属性关系，您必须至少指定两个分析字段属性。您可以使用余弦相似性方法（属性剖面选项）来查找与洛杉矶相似但比例不同的地方；例如使用人口数量、汽车数量与 20 岁以下居民数量的对比剖面图。余弦相似性的指数范围在 1.0（完全相似）和 -1.0（完全不相似）之间。将余弦相似性指数写入输出要素 simindex（余弦相似性）字段。
分析字段参数应为数值型字段，且必须以相同字段名称和字段类型同时存在于输入图层和搜索图层参数值中。如果该工具未找到与搜索图层值对应的字段，则会出现一条警告，提示缺失的属性已从分析中删除。
将所有用于匹配的属性均写入输出。 追加字段参数可以用来指定要添加到输出表中的字段。默认情况下，将不添加任何字段。使用追加字段参数从搜索图层值中选择想要添加的特定字段。

所有输入图层和匹配的解决方案，以及分析字段和追加字段参数值都将写入输出要素。此外，下列字段也包含在输出要素中：


字段名	描述	备注
`location_type`	用于指示要素是参考图层（输入）还是候选图层（搜索）的字符串。
`simrank`	如果指定最相似或两者作为最相似或最不相似参数值，则所有匹配的解决方案均按照从最相似到最不相似的顺序进行排序。最相似的解决方案匹配的等级值为 1。	如果指定最相似或两者作为最相似或最不相似参数值，则该字段将仅包含在输出要素中。
`dissimrank`	如果为最相似或最不相似参数值指定最不相似或两者，则所有匹配的解决方案均按照从最不相似到最相似的顺序进行排序。最不相似的解决方案的等级值为 1。	如果指定最不相似或两者作为最相似或最不相似参数值，则该字段将仅包含在输出要素中。
`simindex`	该字段量化了每个匹配解决方案与目标要素的相似程度。如果将属性值指定为匹配方法参数值，则该值表示值平方差总和。有关如何计算该索引的详细信息，请参阅相似性搜索工作原理。	如果将属性值指定为匹配方法参数值，则该字段将仅包含在输出要素中。
`cosimindex`	该字段量化了每个匹配解决方案与目标要素的相似程度。如果将属性剖面指定为匹配方法参数值，则该值表示余弦相似性。有关如何计算该索引的详细信息，请参阅相似性搜索工作原理。	如果将属性剖面指定为匹配方法参数值，则该字段将仅包含在输出要素中。
`labelrank`	该字段仅用于显示。此工具使用该字段为分析结果提供默认渲染。
`reference_id`	参考要素的唯一 ID 值。搜索要素被赋予空值。	ArcGIS Enterprise 10.6.1 及更高版本支持此字段。
`search_id`	搜索要素的唯一 ID 值。参考要素被赋予空值。	ArcGIS Enterprise 10.6.1 及更高版本支持此字段。

输出会自动添加到内容列表中，同时对 labelrank 字段应用默认渲染。
您可以使用以下一种或多种方法来提升查找相似位置工具的性能：
- 设置范围环境，以便仅分析感兴趣的数据。
- 仅为参考图层选择几个要素。
- 使用与分析运行位置同属本地的数据。
该地理处理工具由 ArcGIS GeoAnalytics Server 提供支持。分析将在 GeoAnalytics Server 上完成，且结果将存储在 ArcGIS Enterprise 的内容中。
运行 GeoAnalytics Server 工具时，分析将在 GeoAnalytics Server 上完成。要获得最佳性能，请通过在 ArcGIS Enterprise 门户上托管的要素图层或通过大数据文件共享，使 GeoAnalytics Server 可以访问数据。非 GeoAnalytics Server 本地的数据，将在分析开始前移动至 GeoAnalytics Server。这意味着运行工具需要更长时间，并且在某些情况下，从 ArcGIS Pro 到 GeoAnalytics Server 移动数据可能会失败。失败的阈值取决于网络速度，以及数据的大小和复杂性。建议您始终共享数据或创建大数据文件共享。

了解有关将数据共享至您的门户的详细信息

了解有关通过 Server Manager 创建大数据文件共享的详细信息
类似的分析也可使用 ArcGIS Pro 中空间统计工具箱中的相似性搜索 工具来完成。

标注	说明	数据类型
输入图层	包含要匹配的要素的参考图层（或图层上的选择）。该工具用于搜索与这些要素类似的其他要素。当提供多个要素时，匹配基于属性平均值。	Record Set
搜索图层	候选图层（或者图层上的选择）包含候选匹配要素。该工具会在这些候选要素中查找与输入图层参数值最相似（或最不相似）的要素。	Record Set
输出名称	输出要素类的名称。输出要素类包含每个输入图层参数值的记录，以及查找到的所有与解决方案相匹配的要素的记录。	String
分析字段	表示匹配条件的数值属性列表。	String
最相似或最不相似	用于指定要查找的要素与输入图层参数值最相似还是最不相似。最相似—查找最相似的要素。最不相似—查找最不相似的要素。两者—查找最相似要素和最不相似要素。	String
匹配方法	用于指定是根据值还是余弦关系进行相似性与相异性匹配。属性值—相似性或相异性取决于所有分析字段属性的标准化属性值平方差的总和。属性剖面—将根据余弦相似性函数来计算所有分析字段属性的相似性或相异性。	String
结果数	要查找的匹配解决方案的数量。输入 0 或一个大于搜索图层要素总数的数字，将返回所有候选要素的排名（最多 10,000 个）。	Long
追加字段（可选）	将包含输出的可选属性列表。例如，您可以包含名称标识符、分类字段或者日期字段。这些字段不用于确定相似性；它们仅包含在输出参数属性中以供参考。默认情况下，将不添加任何字段。	Field
数据存储（可选）	指定将用于存储输出的 ArcGIS Data Store。在时空大数据存储中存储的所有结果都将存储在 WGS84 中。在关系数据存储中存储的结果都将保持各自的坐标系。时空大数据存储—输出将存储在时空大数据存储中。这是默认设置。关系数据存储—输出将存储在关系数据存储中。	String

派生输出

标注	说明	数据类型
输出要素类	输入中的要素以及查找到的所有解决方案匹配要素。	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})

名称	说明	数据类型
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	要查找的匹配解决方案的数量。输入 0 或一个大于 `search_layer` 要素总数的数字，将返回所有候选要素的排名（最多 10,000 个）。	Long
append_fields [append_fields,...] （可选）	将包含输出的可选属性列表。例如，您可以包含名称标识符、分类字段或者日期字段。这些字段不用于确定相似性；它们仅包含在输出参数属性中以供参考。默认情况下，将不添加任何字段。	Field
data_store （可选）	指定将用于存储输出的 ArcGIS Data Store。在时空大数据存储中存储的所有结果都将存储在 WGS84 中。在关系数据存储中存储的结果都将保持各自的坐标系。 `SPATIOTEMPORAL_DATA_STORE`—输出将存储在时空大数据存储中。这是默认设置。 `RELATIONAL_DATA_STORE`—输出将存储在关系数据存储中。	String

派生输出

名称	说明	数据类型
output	输入中的要素以及查找到的所有解决方案匹配要素。	Record Set

代码示例

FindSimilarLocations 示例（Python 窗口）

以下 Python 窗口脚本演示了如何使用 FindSimilarLocations 函数。

# Name: FindSimilarLocations.py
# Description: Find Similar stores to a top performing store
#
# Requirements: ArcGIS GeoAnalytics Server

# Import system modules
import arcpy
function
# 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"

# Run Find Similar Locations
arcpy.geoanalytics.FindSimilarLocations(referenceStore, candidateStores,
                                        outputName, analysisFields,
                                        "MOST_SIMILAR", "ATTRIBUTE_VALUES", 10,
                                        None, dataStore)

环境

输出坐标系, 范围, 当前工作空间

特殊情况

输出坐标系: The coordinate system that will be used for analysis. Analysis will be completed in the input coordinate system unless specified by this parameter. For GeoAnalytics Tools, final results will be stored in the spatiotemporal data store in WGS84.

许可信息

基本: 需要 ArcGIS GeoAnalytics Server
标准: 需要 ArcGIS GeoAnalytics Server
高级: 需要 ArcGIS GeoAnalytics Server

查找相似位置 (GeoAnalytics Server 工具)

汇总

旧版本：

插图

用法

注:

参数

派生输出

环境

特殊情况

许可信息

相关主题