描述空间统计模型文件 (空间统计)

摘要

描述空间统计模型文件的内容和诊断。

了解有关空间统计模型文件的详细信息

使用情况

  • 此工具的主要输出是描述输入模型文件的特征和内容的地理处理输出消息。 要访问消息,请将鼠标悬停在进度条上并单击弹出按钮,或者展开地理处理窗格中的消息部分。 您还可以通过地理处理历史记录访问之前运行工具的消息。

    这些消息包含如下信息和表:

    • 用于创建空间统计模型文件的工具和方法。
    • 模型参数表描述了用于预测的变量和用于创建模型的解释变量。 该表还包含每个变量的单位,因此您可以在使用模型进行预测时确认它们是否与预测变量一致。 可以使用设置空间统计模型文件属性工具设置变量描述和单位。
    • 创建模型文件的工具的消息和模型诊断。 有关消息和诊断的解释,请参阅相关工具的文档。

    注:

    如果在模型训练过程中没有保留验证数据,则某些诊断信息将不会显示在消息中。 在使用此类模型进行预测之前要谨慎。

    对于基于森林的分类和回归,袋外 (OOB) 错误不会出现在消息中,因为它们未保存在模型文件中。 对于仅存在预测,用于训练模型的存在和背景点的计数以及交叉验证结果不会出现,因为此信息可能是敏感或机密信息。

    警告:

    某些模型诊断(例如混淆矩阵)和模型文件的内容可能会用于对用于创建文件的输入数据进行逆向工程。 如果用于训练模型的数据是机密或敏感信息,请谨慎共享模型文件。

  • 您可以使用广义线性回归基于森林的增强分类与回归仅存在预测工具中的输出训练模型文件参数创建模型文件。

    对于由广义线性回归创建的模型,消息将显示所使用的模型类型(连续、二进制或计数)。 对于基于森林的增强分类与回归工具,消息将显示是否使用了基于森林或梯度增强模型进行回归或分类。 对于仅存在预测工具,消息将显示是否使用了背景点。

  • 以下是此工具的潜在应用:

参数

标注说明数据类型
输入模型文件

将要描述的空间统计模型文件。

File

派生输出

标注说明数据类型
解释训练变量

用于训练模型文件的解释训练变量列表。

String
解释训练距离要素

用于训练模型文件的解释训练距离要素列表。

String
解释训练栅格

用于训练模型文件的解释训练栅格列表。

String

arcpy.stats.DescribeSSMFile(input_model)
名称说明数据类型
input_model

将要描述的空间统计模型文件。

File

派生输出

名称说明数据类型
explanatory_variables

用于训练模型文件的解释训练变量列表。

String
explanatory_distance_features

用于训练模型文件的解释训练距离要素列表。

String
explanatory_rasters

用于训练模型文件的解释训练栅格列表。

String

代码示例

DescribeSSMFile 示例 1(Python 窗口)

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

import arcpy
arcpy.stats.DescribeSSMFile("C:/MyData/input_modelfile.ssm")
DescribeSSMFile 示例 2(独立脚本)

以下独立 Python 脚本演示了如何使用 DescribeSSMFile 函数。

# Print the properties of a spatial statistics model file
# Import modules
import arcpy

# Set the current workspace
arcpy.env.workspace = "C:/MyData"

# Run tool 
arcpy.stats.DescribeSSMFile("input_modelfile.ssm")

# Print geoprocessing messages
print(arcpy.GetMessages())

环境

此工具不使用任何地理处理环境。