设置空间统计模型文件属性 (空间统计)

摘要

可将描述和单位添加到存储在空间统计模型文件中的变量。

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

使用情况

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

  • 设置变量描述以提供模型文件中存储的变量的背景和信息。
  • 向变量添加单位，以便在使用空间统计模型文件预测工具中的模型文件进行预测时可以匹配。

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

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

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

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

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

• 该工具无法编辑解释训练距离要素的单位。 工具对话框中显示的距离单位由用于训练模型的距离单位决定。

  注：

  建议您在共享模型文件以使用不同数据进行预测之前设置变量的单位。 无意中的单位不匹配会导致不正确的分析结果，因此记录每个变量的单位很重要。 例如，如果使用美元收入训练模型，而预测时使用印度卢比收入，那么系数的取值范围和意义就会不一致，从而导致预测错误。

参数

对话框

标注	说明	数据类型
输入模型文件	空间统计模型文件。	File
预测变量 (可选)	将在新位置预测的变量的名称、描述和单位。	Value Table
解释训练变量 (可选)	将用于训练输入模型的解释变量的名称、描述和单位。	Value Table
解释训练距离要素 (可选)	将用于训练输入模型的解释训练距离要素的名称、描述和单位。	Value Table
解释训练栅格 (可选)	将用于训练输入模型的解释训练栅格的名称、描述和单位。	Value Table

派生输出

标注	说明	数据类型
更新的模型文件	空间统计模型文件更新了变量描述和单位。	File

Python

arcpy.stats.SetSSMFileProperties(input_model, {variable_predict}, {explanatory_variables}, {distance_features}, {explanatory_rasters})

名称	说明	数据类型
input_model	空间统计模型文件。	File
variable_predict [[var1, desc1, unit1], [var2, desc2, unit2],...] (可选)	将在新位置预测的变量的名称、描述和单位。	Value Table
explanatory_variables [[var1, desc1, unit1], [var2, desc2, unit2],...] (可选)	将用于训练输入模型的解释变量的名称、描述和单位。	Value Table
distance_features [[var1, desc1, unit1], [var2, desc2, unit2],...] (可选)	将用于训练输入模型的解释训练距离要素的名称、描述和单位。	Value Table
explanatory_rasters [[var1, desc1, unit1], [var2, desc2, unit2],...] (可选)	将用于训练输入模型的解释训练栅格的名称、描述和单位。	Value Table

派生输出

名称	说明	数据类型
updated_model_file	空间统计模型文件更新了变量描述和单位。	File

代码示例

SetSSMFileProperties 示例 1（Python 窗口）

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

arcpy.stats.SetSSMFileProperties ("C:/MyData/input_modelfile.ssm", 
      [["CORN", "Presence of Corn Prediction", "No Units"]], 
      [["RASTER1", "Rainfall", "millimeter"], ["RASTER2", "Temperature", "Celsius"], 
       ["RASTER3", "Crop Type", "No units']])

SetSSMFileProperties 示例 2（独立脚本）

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

# Set the properties of a spatial statistics model file 

# Import modules 
import arcpy 

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

# Set Variable Description and units 
var_predict = [["FatalityPresence", "Binary value to show presence of fatality", "No Units"]]
var_exp = [["ALCOHOL_RELATED", "Number of accidents related to alcohol usage", "Count"], 
           ["SPEED", "Speed of the vehicle", "Miles per hour"]]
var_distance = [["INTERSECTION", "Distance to a road intersection", "Miles"]]

# Run tool  
arcpy.stats.SetSSMFileProperties("input_modelfile.ssm", var_predict, var_exp, 
          var_distance) 

# Print geoprocessing messages 
print(arcpy.GetMessages)

环境

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