标注 | 说明 | 数据类型 |
输入要素类 | 将为其计算 General G 统计数据的要素类。 | Feature Layer |
输入字段 | 要评估的数字字段。 | Field |
生成报表 (可选) | 指定是否将结果的图形摘要创建为 .html 文件。
| Boolean |
空间关系的概念化 | 指定要素空间关系的定义方式。
| String |
距离法 | 指定计算每个要素与邻近要素之间的距离的方式。
| String |
标准化 | 指定是否对空间权重执行标准化。 当要素的分布由于采样设计或施加的聚合方案而可能偏离时,建议使用行标准化。
| String |
距离范围或距离阈值 (可选) | 为“反距离”和“固定距离”选项指定中断距离。 将在对目标要素的分析中忽略为该要素指定的中断之外的要素。 但是,对于无差别的区域,指定距离之外的要素的影响会随距离的减小而变弱,而在距离阈值之内的影响则被视为是等同的。 输入的距离值应该与输出坐标系的值匹配。 对于空间关系的反距离概念化,值为 0 表示未应用任何阈值距离;当将此参数留空时,将计算并应用默认阈值。 此默认值为确保每个要素至少具有一个邻域的欧氏距离。 当选择了面邻接(仅邻接边或邻接边拐角)或通过文件获取空间权重的空间概念化时,该参数无效。 | Double |
权重矩阵文件 (可选) | 包含权重(定义要素间的空间关系以及可能的时态关系)的文件的路径。 | File |
相邻要素的数目 (可选) | 用于指定将包含在分析中的相邻要素数目的整数。 | Long |
插图
使用情况
高/低聚类工具可返回四个值:General G 观测值、General G 期望值、z 得分以及 p 值。 在工具执行期间,这些值会在地理处理窗格底部以消息的形式写入,并将作为派生输出值进行传递,以满足模型或脚本中的潜在使用需要。 可将鼠标悬停在进度条上、单击弹出按钮或展开地理处理窗格中的消息部分来访问消息。 您还可以通过地理处理历史访问之前运行工具的消息。 此外,您还可以使用此工具创建一个 HTML 报表文件,其中包含了结果的图形汇总。 报表路径将随附在汇总工具执行参数的消息中。 单击此路径将打开报表文件。
输入字段应包含多种非负值。 如果输入字段包含负值,则将出现一条错误消息。 此外,此统计数学方法要求待分析的变量存在一定程度的变化;例如,如果所有输入都是 1 便无法求解。 要使用此工具分析事件数据的空间模式,应考虑聚合事件数据。 优化的热点分析工具也可以用于分析事件数据的空间模式。
注:
如果您重点关注各点存在与否,而不是每个点的特定测量属性,则事件数据为表示事件(犯罪、交通事故)或对象(树、店铺)的点。
z 分数和 p 值是统计显著性的度量值。 这些值可以帮助您确定是否拒绝零假设。 对于此工具,零假设表明与要素关联的值是随机分布的。
z 得分基于随机化零假设进行计算。 有关 z 得分的详细信息,请参阅什么是 z 得分? 什么是 p 值?
z 得分越高(或越低),聚类程度就越高。 如果 z 得分接近零,则表示研究区域内不存在明显的聚类。 z 得分为正表示高值的聚类。 负 z 分数表示低值的聚类。
如果未投影输入要素类参数值(即,坐标单位为度、分和秒),或者将输出坐标系环境设置为地理坐标系,则采用弦测量方法计算距离。 使用弦距离测量法是因为此方法不仅计算速度快,而且提供真实测地线距离的良好估测,至少对于彼此 30 度以内的点是这样。 弦距离是基于扁椭球体计算的。 给定地球表面上的任意两点,两点之间的弦距离是从三维地球穿过然后连接该两点的一条线的长度。 弦距离报表将以米为单位。
警告:
如果您的研究区域超过 30 度,则请确保投影数据。 弦距离无法准确估算超出 30 度的测地线距离。
分析时如使用弦距离,距离范围或距离阈值参数(如指定)应以米为单位。
对于线和面要素,距离计算中会使用要素的质心。 对于多点、折线或由多部分组成的面,将会使用所有要素部分的加权平均中心来计算质心。 点要素的加权项是 1;线要素的加权项是长度;而面要素的加权项是面积。
空间关系的概念化参数的选择应反映要分析的要素之间的固有关系。 对要素在空间中彼此交互方式构建的模型越逼真,结果就越准确。 选择空间关系的概念化:最佳做法中给出了建议。 以下是其他提示:
- 固定距离范围
距离范围或距离阈值参数将确保每个要素至少拥有一个相邻要素。 这一点非常重要,但通常,此计算所得的默认值并不是适用于分析的最合适的距离。 为分析选择适合的比例(距离范围)的其他策略在选择固定距离范围值中进行了概括介绍。
- 反距离或反距离平方
如果为距离范围或阈值距离参数输入 0,则所有要素均被视为所有其他要素的相邻要素;如果将此参数留空,则将采用默认距离。
如果距离权重小于 1,则对其取倒数时将变得不稳定。 因此,相隔小于 1 个单位距离的要素的权重为 1。
对于“反距离”选项(反距离、反距离平方和无差别的区域),为避免产生除数为零的情况,任何重合两点的权重值均将指定为 1。 这样便可确保将要素包含在分析之内。
- 固定距离范围
空间关系的概念化参数的附加选项(包括三维和空间-时间关系)在使用生成空间权重矩阵工具时可用。 要利用这些附加选项,请在分析前先构造空间权重矩阵文件,然后为空间关系的概念化参数使用通过文件获取空间权重选项,并为权重矩阵文件参数指定您所创建的空间权重文件的路径。
地图图层可用于定义输入要素类参数值。 使用带选区的图层时,只有选定的要素才会包含在分析中。
如果您提供带有 .swm 扩展名的权重矩阵文件参数值,则预计将使用生成空间权重矩阵工具创建空间权重矩阵文件;否则,需要一个 ASCII 格式的空间权重矩阵文件。 在某些情况下,根据您所使用的以下空间权重矩阵文件类型,行为会有所不同:
- ASCII 格式的空间权重矩阵文件
- 按原样使用权重。 将缺失的要素转要素关系视为零。
- 如果对权重进行了行标准化,则选择集的分析结果很有可能不正确。 如果需要对选择集运行分析,则通过以下方法将 ASCII 空间权重文件转换为 .swm 文件:将 ASCII 数据读入表,然后将转换表选项与生成空间权重矩阵工具结合使用。
- SWM 格式的空间权重矩阵文件
- 如果对权重进行了行标准化,则会针对选择集将其重新标准化;否则按原样使用权重。
- ASCII 格式的空间权重矩阵文件
使用 ASCII 格式的空间权重矩阵文件运行您的分析会占用大量内存。 如果要分析的要素超过 5,000 个,则考虑将 ASCII 格式的空间权重矩阵文件转换为 SWM 格式的文件。 首先,将 ASCII 权重置入一个带格式的表中(例如,使用 Excel)。 接下来运行生成空间权重矩阵工具,并使用空间关系的概念化参数值的转换表。 输出是 SWM 格式的空间权重矩阵文件:
有关此工具参数的其他信息,请参阅建模空间关系帮助主题。
警告:
Shapefile 不能存储空值。 根据其他类型输入创建 shapefile 的工具或其他过程可能会将空值存储(或解释)为零。 某些情况下,空值则以极大的负值储存于 shapefile 中,这会导致意外结果。 有关详细信息,请参阅 shapefile 输出的地理处理注意事项。
参数
arcpy.stats.HighLowClustering(Input_Feature_Class, Input_Field, {Generate_Report}, Conceptualization_of_Spatial_Relationships, Distance_Method, Standardization, {Distance_Band_or_Threshold_Distance}, {Weights_Matrix_File}, {number_of_neighbors})
名称 | 说明 | 数据类型 |
Input_Feature_Class | 将为其计算 General G 统计数据的要素类。 | Feature Layer |
Input_Field | 要评估的数字字段。 | Field |
Generate_Report (可选) | 指定是否将结果的图形摘要创建为 .html 文件。
| Boolean |
Conceptualization_of_Spatial_Relationships | 指定要素空间关系的定义方式。
| String |
Distance_Method | 指定计算每个要素与邻近要素之间的距离的方式。
| String |
Standardization | 指定是否对空间权重执行标准化。 当要素的分布由于采样设计或施加的聚合方案而可能偏离时,建议使用行标准化。
| String |
Distance_Band_or_Threshold_Distance (可选) | 为“反距离”和“固定距离”选项指定中断距离。 将在对目标要素的分析中忽略为该要素指定的中断之外的要素。 但是,对于 ZONE_OF_INDIFFERENCE,指定距离之外的要素的影响会随距离的减小而变弱,而在距离阈值之内的影响则被视为是等同的。 输入的距离值应该与输出坐标系的值匹配。 对于空间关系的反距离概念化,值为 0 表示未应用任何阈值距离;当将此参数留空时,将计算并应用默认阈值。 此默认值为确保每个要素至少具有一个邻域的欧氏距离。 当选择了面邻接(CONTIGUITY_EDGES_ONLY 或 CONTIGUITY_EDGES_CORNERS)或 GET_SPATIAL_WEIGHTS_FROM_FILE 的空间概念化时,该参数无效。 | Double |
Weights_Matrix_File (可选) | 包含权重(定义要素间的空间关系以及可能的时态关系)的文件的路径。 | File |
number_of_neighbors (可选) | 用于指定将包含在分析中的相邻要素数目的整数。 | Long |
派生输出
名称 | 说明 | 数据类型 |
Observed_General_G | General G 观测值统计数据。 | Double |
ZScore | z 得分。 | Double |
PValue | p 值。 | Double |
Report_File | 一个 HTML 文件,其中包含结果的图形汇总。 | File |
代码示例
以下 Python 窗口脚本演示了如何使用 HighLowClustering 函数。
import arcpy
arcpy.env.workspace = r"C:\data"
arcpy.stats.HighLowClustering("911Count.shp", "ICOUNT", "false",
"GET_SPATIAL_WEIGHTS_FROM_FILE", "EUCLIDEAN_DISTANCE",
"NONE", "#", "euclidean6Neighs.swm")
以下独立 Python 脚本演示了如何使用 HighLowClustering 函数。
# Analyze the spatial distribution of 911 calls in a metropolitan area
# using the High/Low Clustering (Getis-Ord General G) tool
# Import system modules
import arcpy
# Set property to overwrite existing outputs
arcpy.env.overwriteOutput = True
# Local variables...
workspace = r"C:\Data"
try:
# Set the current workspace (to avoid having to specify the full path to the feature classes each time)
arcpy.env.workspace = workspace
# Copy the input feature class and integrate the points to snap
# together at 500 feet
# Process: Copy Features and Integrate
cf = arcpy.management.CopyFeatures("911Calls.shp", "911Copied.shp",
"#", 0, 0, 0)
integrate = arcpy.management.Integrate("911Copied.shp #", "500 Feet")
# Use Collect Events to count the number of calls at each location
# Process: Collect Events
ce = arcpy.stats.CollectEvents("911Copied.shp", "911Count.shp", "Count", "#")
# Add a unique ID field to the count feature class
# Process: Add Field and Calculate Field
af = arcpy.management.AddField("911Count.shp", "MyID", "LONG", "#", "#", "#", "#",
"NON_NULLABLE", "NON_REQUIRED", "#",
"911Count.shp")
cf = arcpy.management.CalculateField("911Count.shp", "MyID", "!FID!", "PYTHON")
# Create Spatial Weights Matrix for Calculations
# Process: Generate Spatial Weights Matrix...
swm = arcpy.stats.GenerateSpatialWeightsMatrix("911Count.shp", "MYID",
"euclidean6Neighs.swm",
"K_NEAREST_NEIGHBORS",
"#", "#", "#", 6,
"NO_STANDARDIZATION")
# Cluster Analysis of 911 Calls
# Process: High/Low Clustering (Getis-Ord General G)
hs = arcpy.stats.HighLowClustering("911Count.shp", "ICOUNT",
"false",
"GET_SPATIAL_WEIGHTS_FROM_FILE",
"EUCLIDEAN_DISTANCE", "NONE",
"#", "euclidean6Neighs.swm")
except arcpy.ExecuteError:
# If an error occurred when running the tool, print out the error message.
print(arcpy.GetMessages())
环境
特殊情况
- 输出坐标系
在进行分析之前将要素几何投影到输出坐标系。所有数学计算都基于输出坐标系空间参考。输出坐标系基于度、分、秒时,测地线距离用弦距离估测。
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是