描述
将栅格目录的内容镶嵌到新的栅格数据集中。
使用
此工具允许将地理数据库栅格目录转换为栅格数据集；输入是栅格目录，输出是新的栅格数据集。此工具无法将数据镶嵌到现有栅格数据集中。
使用镶嵌栅格数据集有多种优势：它通常可以任意比例快速显示，由于不存在重叠数据而节省空间，而且数据在显示时接缝更少。
必须设置像素类型使其与现有输入栅格数据集相匹配。如果不设置像素类型，则将使用默认值 8 位，从而导致输出的结果可能会不正确。
可将输出结果保存为 BIL、BIP、BMP、BSQ、DAT、Esri Grid、GIF、IMG、JPEG、JPEG 2000、PNG、TIFF、MRF、CRF 格式或任意地理数据库栅格数据集。
将栅格数据集存储到 JPEG 文件、JPEG 2000 文件或地理数据库时，可在环境中指定压缩类型和压缩质量。
GIF 格式仅支持单波段栅格数据集。
镶嵌的叠置区域可采用多种方式处理；例如，您可以对该工具进行设置，以仅保留第一个栅格数据集的数据，也可以混合叠置像元值。另外，如果栅格数据集使用色彩映射表，还有多个用于确定如何处理此表的选项供您选择。例如，可以保留用于镶嵌的最后一个栅格数据集的色彩映射表。
对于镶嵌离散数据，镶嵌运算符的“第一个值”、“最小值”和“最大值”选项会提供最有意义的结果。镶嵌运算符的“混合”和“平均值”选项最适合连续数据。
尽可能使用最后一个镶嵌运算符，将这些栅格数据集镶嵌到文件地理数据库或企业级地理数据库中的现有栅格数据集内；这是目前为止最有效的镶嵌方式。
如果使用包含色彩映射表的栅格数据集进行镶嵌，应特别注意选择要镶嵌的各栅格数据集的色彩映射表之间的差异。在此情况下，可针对包含不同色彩映射表的栅格使用镶嵌工具；但必须选择正确的镶嵌色彩映射表模式运算符。如果选择了错误的色彩映射模式，则可能会返回意外的输出结果。
对于不同分辨率的浮点型输入栅格数据集或像元不对齐的情况，建议在运行镶嵌之前，使用双线性插值法或三次卷积插值法对所有数据进行重采样；否则，镶嵌将会使用最邻近重采样法自动对栅格数据集进行重采样（该方法不适用于连续数据类型）。
可使用色彩匹配和色彩校正来增强栅格镶嵌的无缝效果。
语法
RasterCatalogToRasterDataset(in_raster_catalog, out_raster_dataset, {where_clause}, {mosaic_type}, {colormap}, {order_by_field}, {ascending}, {pixel_type}, {ColorBalancing}, {MatchingMethod}, {ReferenceRaster}, {OID})| 参数 | 说明 | 数据类型 |
in_raster_catalog | 要镶嵌到栅格数据集中的栅格目录。 | Raster Catalog Layer |
out_raster_dataset | 待输出的栅格数据集镶嵌的名称和扩展名。 以文件格式存储栅格数据集时，需要指定文件扩展名，具体如下：
以地理数据库形式存储栅格数据集时，不应向栅格数据集的名称添加文件扩展名。 将栅格数据集存储到 JPEG 文件、JPEG 2000 文件、TIFF 文件或地理数据库时，可在地理处理环境中指定压缩类型和压缩质量。 | Raster Dataset |
where_clause （可选） | 输入适当的 SQL 语句以选择栅格目录中的特定行。 | SQL Expression |
mosaic_type （可选） | 用于镶嵌重叠的方法。
有关各镶嵌运算符的详细信息，请参阅镶嵌运算符。 | String |
colormap （可选） | 对输入栅格中应用于镶嵌输出的色彩映射表进行选择的方法。
有关各色彩映射表模式的详细信息，请参阅镶嵌色彩映射表模式。 | String |
order_by_field （可选） | 定义对栅格目录项进行排序所依据的字段。 | String |
ascending （可选） | 选择是否使用 order_by_field 的升序值。如果不使用升序选项，则将使用降序。
| Boolean |
pixel_type （可选） | 确定输出栅格数据集的位深度。如果未指定，则输出位深度将与输入位深度相同。 当选择不同像素类型时，不会重设栅格值的比例。如果像素类型的范围被降级（降低），则在此像素深度的有效范围外的栅格值将被截断并丢失。
| String |
ColorBalancing （可选） | 选择是否使用匀光技术对栅格目录项进行色彩校正。栅格目录中的所有像素都将用于确定色彩平衡算法的 gamma 和对比度值。
| Boolean |
MatchingMethod （可选） | 选择应用于栅格的色彩匹配方法。
| String |
ReferenceRaster （可选） | 如果应用色彩匹配，则选择如何指定参考栅格。
| String |
OID （可选） | 参考栅格的对象 ID (OID)。OID 是栅格目录中的唯一键字段。 | Long |
代码示例
RasterCatalogToRasterDataset 示例 1（Python 窗口）
这是 RasterCatalogToRasterDataset 工具的 Python 示例。
import arcpy
arcpy.RasterCatalogToRasterDataset_management("c:/data/fgdb.gdb/catalog1",
"c:/data/dataset.tif",
"OBJECTID>1", "LAST", "FIRST",
"", "", "8_BIT_UNSIGNED",
"COLOR_BALANCING",
"HISTOGRAM_MATCHING",
"CALCULATE_FROM_ALL", "")
RasterCatalogToRasterDataset 示例 2（独立脚本）
这是 RasterCatalogToRasterDataset 工具的 Python 脚本示例。
##==================================
##Raster Catalog To Raster Dataset
##Usage: RasterCatalogToRasterDataset_management in_raster_catalog out_raster_dataset {where_clause} {LAST | FIRST | MINIMUM | MAXIMUM
## | MEAN | BLEND} {FIRST | REJECT | LAST | MATCH} {order_by_field} {NONE | ASCENDING}
## {8_BIT_UNSIGNED | 1_BIT | 2_BIT | 4_BIT | 8_BIT_SIGNED | 16_BIT_UNSIGNED |
## 16_BIT_SIGNED | 32_BIT_UNSIGNED | 32_BIT_SIGNED | 32_BIT_FLOAT | 64_BIT}
## {NONE | COLOR_BALANCING} {NONE | STATISTIC_MATCHING | HISTOGRAM_MATCHING
## | LINEARCORRELATION_MATCHING} {CACULATE_FROM_ALL | SPECIFY_OID | DEFINE_FROM_SELECTION}
## {OID}
import arcpy
arcpy.env.workspace = r"\\MyMachine\PrjWorkspace\RasGP"
##Mosaic a Unmanaged Raster Catalog to a TIFF format Raster Dataset with Color Correction
arcpy.RasterCatalogToRasterDataset_management("RC2RD\\fgdb.gdb\\catalog1","RC2RD\\dataset1.tif", "OBJECTID>1", "LAST", "FIRST", "", "",\
"8_BIT_UNSIGNED", "COLOR_BALANCING", "HISTOGRAM_MATCHING", "CALCULATE_FROM_ALL", "")
##Mosaic using the According Order of cretain Field
arcpy.RasterCatalogToRasterDataset_management("RC2RD\\fgdb.gdb\\catalog2","RC2RD\\dataset2.tif", "", "LAST", "FIRST", "POPULATION", \
"ASCENDING", "8_BIT_UNSIGNED", "COLOR_BALANCING", "HISTOGRAM_MATCHING", "SPECIFY_OID", "2")
环境
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是