描述
用于对镶嵌数据集中包含的影像集合执行批量分析或处理。可以单独或以组的形式处理输入镶嵌数据集中的影像。
可以通过集合构建器参数和栅格函数参数来定义处理规则。将生成已处理影像的新镶嵌数据集。您可以选择将已处理影像作为单独文件保存到磁盘。默认条件是将输入栅格函数追加到镶嵌数据集中现有影像的函数链,然后将其添加到输出镶嵌数据集。
使用方法
此工具的输出是将栅格函数模板 (RFT) 应用于每个栅格项目的镶嵌数据集。由于可选参数会影响输出,因此,您需要正确定义参数,才能获得正确的输出。
如果您希望生成已应用 RFT 的独立影像文件,则必须定义输出工作空间。可以使用栅格函数编辑器创建 RFT。
语法
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,可用于定义单个数据源以及数据源的查询过滤器。
| String |
collection_builder_arguments [[Name, Value],...] | 用于创建镶嵌数据集的子集集合的参数。 此工具仅支持数据源以及用于查询镶嵌数据集子集的过滤器。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],...] (可选) | 输出镶嵌数据集关键属性。 可用关键元数据属性基于捕获影像的传感器类型。关键元数据属性的部分示例如下:
| Value Table |
generate_rasters (可选) | 应用 RFT 后,选择生成镶嵌数据集项目的栅格数据集文件。
| Boolean |
out_workspace (可选) | 如果将 generate_rasters 参数设置为 GENERATE_RASTERS,则需要定义永久栅格数据集的输出位置。 输出栅格文件的命名约定为 oid_<oid#>_<Unique_GUID>。 | Folder; String |
format (可选) | 要生成的栅格的格式类型。
| String |
out_base_name (可选) | 如果将 generate_rasters 参数设置为 GENERATE_RASTERS,则需要定义永久栅格数据集的输出基本名称。 | String |
代码示例
这是 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"
)
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是