生成栅格集合 (数据管理)

摘要

用于对镶嵌数据集中包含的影像集合执行批量分析或处理。可以单独或以组的形式处理输入镶嵌数据集中的影像。

可以通过集合构建器参数和栅格函数参数来定义处理规则。将生成已处理影像的新镶嵌数据集。您可以选择将已处理影像作为单独文件保存到磁盘。默认条件是将输入栅格函数追加到镶嵌数据集中现有影像的函数链,然后将其添加到输出镶嵌数据集。

使用情况

  • 此工具的输出是将栅格函数模板 (RFT) 应用于每个栅格项目的镶嵌数据集。由于可选参数会影响输出,因此,您需要正确定义参数,才能获得正确的输出。

  • 如果您希望生成已应用 RFT 的独立影像文件,则必须定义输出工作空间。可以使用栅格函数编辑器创建 RFT。

参数

标注说明数据类型
输出栅格集合

要创建的镶嵌数据集的完整路径。镶嵌数据集必须存储在地理数据库中。

Mosaic Dataset
采集构建器

输入影像集合。可将其视为一个模板,其中包含诸如源镶嵌数据集路径、用于从输入数据源中提取子集的过滤器等参数。

目前,此工具仅支持简单集合,可用于定义单个数据源以及数据源的查询过滤器。

  • 简单集合可用于定义数据源和查询过滤器。
String
采集构建器参数

用于创建镶嵌数据集的子集集合的参数。

此工具仅支持数据源以及用于查询镶嵌数据集子集的过滤器。数据源Where 子句值必须完整,否则无法执行此工具。

  • 数据源数据源的路径。
  • Where 子句用于查询镶嵌数据集子集的过滤器。
Value Table
输入栅格函数
(可选)

栅格函数模板文件(.rft.xml.rft.json)的路径。栅格函数模板将应用于输入镶嵌数据集中的每个项目。函数编辑器可用于创建模板。如果未定义 RFT,则此工具将基于集合构建器参数参数创建输出镶嵌。

String; File
栅格函数参数
(可选)

参数与函数链相关联。

例如,如果函数链应用 NDVI 函数,则设置可见红外 ID。RFT 的栅格变量名应为输入数据源中的 Tag 字段值。

Value Table
栅格集合属性
(可选)

输出镶嵌数据集关键属性。

可用关键元数据属性基于捕获影像的传感器类型。关键元数据属性的部分示例如下:

  • SensorName
  • ProductName
  • AcquisitionDate
  • CloudCover
  • SunAzimuth
  • SunElevation
  • SensorAzimuth
  • SensorElevation
  • Off-nadirAngle
  • BandName
  • MinimumWavelength
  • MaximumWavelength
  • RadianceGain
  • RadianceBias
  • SolarIrradiance
  • ReflectanceGain
  • ReflectanceBias

Value Table
生成栅格
(可选)

应用 RFT 后,生成镶嵌数据集项目的栅格数据集文件。

  • 未选中 - 由栅格函数模板定义的处理将追加到输入数据源中的影像项目,以在输出镶嵌数据集中生成影像项目。这是默认设置。
  • 选中 - 在磁盘上创建栅格数据集。您还需要指定输出栅格工作空间格式

Boolean
输出栅格工作空间
(可选)

如果选中生成栅格参数,则需要定义永久栅格数据集的输出位置。

输出栅格文件的命名约定为 oid_<oid#>_<Unique_GUID>

Folder; String
格式
(可选)

要生成的栅格的格式类型。

  • Tiff标记图像文件格式 (TIFF)
  • ERDAS IMAGINEERDAS IMAGINE 文件
  • CRF云栅格格式。这是默认设置。
  • MRF元栅格格式
String
输出基本名称
(可选)

如果选中生成栅格参数,则需要定义永久栅格数据集的输出基本名称。多个栅格数据集输出将在其基本名称后附加数字别名。

生成的镶嵌数据集将直接引用 CRF,而无需维护栅格函数链。

String

arcpy.management.GenerateRasterCollection(out_raster_collection, collection_builder, collection_builder_arguments, {raster_function}, {raster_function_arguments}, {collection_properties}, {generate_rasters}, {out_workspace}, {format}, {out_base_name})
名称说明数据类型
out_raster_collection

要创建的镶嵌数据集的完整路径。镶嵌数据集必须存储在地理数据库中。

Mosaic Dataset
collection_builder

输入影像集合。可将其视为一个模板,其中包含诸如源镶嵌数据集路径、用于从输入数据源中提取子集的过滤器等参数。

目前,此工具仅支持 SIMPLE_COLLECTION,可用于定义单个数据源以及数据源的查询过滤器。

  • SIMPLE_COLLECTION可用于定义数据源和查询过滤器。
String
collection_builder_arguments
[[Name, Value],...]

用于创建镶嵌数据集的子集集合的参数。

此工具仅支持数据源以及用于查询镶嵌数据集子集的过滤器。DataSourceWhereClause 值必须完整,否则无法执行此工具。

  • DataSource数据源的路径。
  • WhereClause用于查询镶嵌数据集子集的过滤器。
Value Table
raster_function
(可选)

栅格函数模板文件(.rft.xml.rft.json)的路径。栅格函数模板将应用于输入镶嵌数据集中的每个项目。函数编辑器可用于创建模板。如果未定义 RFT,则此工具将基于 collection_builder_arguments 参数创建输出镶嵌。

String; File
raster_function_arguments
[[Name, Value],...]
(可选)

参数与函数链相关联。

例如,如果函数链应用 NDVI 函数,则设置可见红外 ID。RFT 的栅格变量名应为输入数据源中的 Tag 字段值。

Value Table
collection_properties
[[Name, Value],...]
(可选)

输出镶嵌数据集关键属性。

可用关键元数据属性基于捕获影像的传感器类型。关键元数据属性的部分示例如下:

  • SensorName
  • ProductName
  • AcquisitionDate
  • CloudCover
  • SunAzimuth
  • SunElevation
  • SensorAzimuth
  • SensorElevation
  • Off-nadirAngle
  • BandName
  • MinimumWavelength
  • MaximumWavelength
  • RadianceGain
  • RadianceBias
  • SolarIrradiance
  • ReflectanceGain
  • ReflectanceBias

Value Table
generate_rasters
(可选)

应用 RFT 后,选择生成镶嵌数据集项目的栅格数据集文件。

  • NO_GENERATE_RASTERS由栅格函数模板定义的处理将追加到输入数据源中的影像项目,以在输出镶嵌数据集中生成影像项目。这是默认设置。
  • GENERATE_RASTERS在磁盘上创建栅格数据集。您还将需要指定 out_workspaceformat
Boolean
out_workspace
(可选)

如果将 generate_rasters 参数设置为 GENERATE_RASTERS,则需要定义永久栅格数据集的输出位置。

输出栅格文件的命名约定为 oid_<oid#>_<Unique_GUID>

Folder; String
format
(可选)

要生成的栅格的格式类型。

  • TIFF标记图像文件格式 (TIFF)
  • IMAGINE ImageERDAS IMAGINE 文件
  • CRF云栅格格式。这是默认设置。
  • MRF元栅格格式
String
out_base_name
(可选)

如果将 generate_rasters 参数设置为 GENERATE_RASTERS,则需要定义永久栅格数据集的输出基本名称。

String

代码示例

GenerateRasterCollection 示例(独立脚本)

这是 GenerateRasterCollection 工具的 Python 脚本。

import arcpy
arcpy.GenerateRasterCollection_management(
    out_raster_collection="c:/temp/FGDB.gdb/testgencollection", 
    collection_builder="Simple Collection", 
    collection_builder_arguments="# DataSource c:\temp\FGDB.gdb\qb_portland;# 
WhereClause 'Tag = 'MS''", 
    raster_function="C:/temp/NDVI_test.rft.json", 
    raster_function_arguments="# MS #;# VisibleBandID_20171019_7337_958 1;# 
InfraredBandID_20171019_7337_958 4", 
    collection_properties="", 
    generate_rasters="GENERATE_RASTERS", 
    out_workspace="c:/temp/persistedoutput", 
    format="CRF"
)