创建特征 (空间分析)

摘要

创建由输入样本数据和一组栅格波段定义的类的 ASCII 特征文件。

了解有关“创建特征”工作原理的详细信息

用法

• 输出特征文件应使用扩展名 .gsg。

• 输入栅格波段和输入栅格或要素样本数据必须具有重叠范围。将仅为公共区域计算统计值。

• 样本数据中的最小有效类样本数为两个。不存在最大类样本数。

• 如果特征文件将用于使用协方差矩阵的其他多元分析工具（如最大似然法分类和类别概率），则必须存在协方差矩阵。启用对话框中的计算协方差矩阵选项或在脚本中指定 COVARIANCE 选项时会生成此信息。注意这是默认设置。要对比特征文件在生成了协方差矩阵和只有平均值时的区别，请参阅“创建特征”的工作原理。

• 除了输入类名称之外，不应更改特征文件中的任何内容。文件中的统计值应仅通过“多元分析”工具来创建和更改。

• 输出特征文件中的类名称是可选的。它们将仅作参考之用。可以通过样本字段输入类名称，或者可以对生成的特征文件使用任何文本编辑器来输入名称。类名称必须由单个字符串组成，并且长度不得超过 31 个字母数字字符。

• 如果输入为创建自多波段栅格（超过三个波段）的图层，则操作将会考虑与源数据集相关联的所有波段，而不仅仅是由图层加载（符号化）的三个波段。

• 您可以使用多种方式将多波段栅格的波段子集指定为工具的输入。

  • 如果要使用工具对话框，则通过输入栅格波段旁边的 按钮导航至多波段栅格，打开栅格并选择所需波段。
  • 如果多波段栅格是内容列表中的图层，则可以使用创建栅格图层工具来创建一个新的只包含所需波段的多波段图层。
  • 您还可以用波段合成来创建一个只包含所需波段的新数据集，并将生成的数据集用作工具的输入。
  • 在 Python 中，可以在工具参数中以列表形式直接指定所需波段。

语法

CreateSignatures (in_raster_bands, in_sample_data, out_signature_file, {compute_covariance}, {sample_field})

参数	说明	数据类型
in_raster_bands [in_raster_band,...]	要创建特征的输入栅格波段。	Raster Layer
in_sample_data	描绘类样本集的输入。 该输入可以是整型栅格，或要素数据集。	Raster Layer | Feature Layer
out_signature_file	输出特征文件。 必须指定一个 .gsg 扩展名。	File
compute_covariance （可选）	指定除计算平均值以外是否还要计算协方差矩阵。 COVARIANCE — 将为 in_sample_data 的所有类计算协方差矩阵和平均值。这是默认设置。 MEAN_ONLY — 只计算 in_sample_data 的所有类的平均值。	Boolean
sample_field （可选）	用来向采样位置（类）分配值的输入栅格或要素样本数据的字段。 只有整型或字符串字段是有效字段。指定的数字或字符串将在输出特征文件中用作类名。	Field

代码示例

CreateSignatures 示例 1（Python 窗口）

本例将为由采样训练区域和一组输入栅格波段定义的类创建特征文件。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
CreateSignatures("sb", "sbtrain", "c:/sapyexamples/output/rbsig.gsg", 
                 "COVARIANCE", "")

CreateSignatures 示例 2（独立脚本）

本例将为由采样训练区域和一组输入栅格波段定义的类创建特征文件。

# Name: CreateSignatures_Ex_02.py
# Description: Creates an ASCII signature file of classes defined by input 
#    sample data and a set of raster bands.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster = "sb"
inSamples = "sbtrain"
outSig = "c:/sapyexamples/output/rbsig02.gsg"
sampField = ""

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute CreateSignatures
CreateSignatures(inRaster, inSamples, outSig, "COVARIANCE", sampField)

环境

像元大小, 当前工作空间, 输出坐标系, 范围, 临时工作空间

许可信息

ArcView: 需要 Spatial Analyst

ArcEditor: 需要 Spatial Analyst

ArcInfo: 需要 Spatial Analyst