栅格目录转栅格数据集 (Data Management)

许可等级:BasicStandardAdvanced

摘要

将栅格目录的内容镶嵌到新的栅格数据集中。

用法

语法

RasterCatalogToRasterDataset_management (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

待输出的栅格数据集镶嵌的名称和扩展名。

以文件格式存储栅格数据集时,需要指定文件扩展名,具体如下:

  • .bil—Esri BIL
  • .bip—Esri BIP
  • .bmp—BMP
  • .bsq—Esri BSQ
  • .dat—ENVI DAT
  • .gif—GIF
  • .img—ERDAS IMAGINE
  • .jpg—JPEG
  • .jp2—JPEG 2000
  • .png—PNG
  • .tif—TIFF
  • 无扩展名 Esri Grid

以地理数据库形式存储栅格数据集时,不应向栅格数据集的名称添加文件扩展名。

将栅格数据集存储到 JPEG 文件、JPEG 2000 文件、TIFF 文件或地理数据库时,可以指定压缩类型和压缩质量。

Raster Dataset
where_clause
(可选)

输入适当的 SQL 语句以选择栅格目录中的特定行。

SQL Expression
mosaic_type
(可选)

用于镶嵌重叠的方法。

  • FIRST叠置区域的输出像元值为镶嵌到该位置的第一个栅格数据集中的值。
  • LAST叠置区域的输出像元值为镶嵌到该位置的最后一个栅格数据集中的值。这是默认设置。
  • BLEND叠置区域的输出像元值为叠置区域中各像元值的水平加权计算结果。
  • MEAN重叠区域的输出像元值为叠置像元的平均值。
  • MINIMUM重叠区域的输出像元值为叠置像元的最小值。
  • MAXIMUM重叠区域的输出像元值为叠置像元的最大值。

有关各镶嵌运算符的详细信息,请参阅镶嵌运算符

String
colormap
(可选)

对输入栅格中应用于镶嵌输出的色彩映射表进行选择的方法。

  • FIRST列表中第一个栅格数据集中的色彩映射表将应用于输出栅格镶嵌。这是默认设置。
  • LAST列表中最后一个栅格数据集中的色彩映射表将应用于输出栅格镶嵌。
  • MATCH镶嵌时会考虑所有色彩映射表。如果已经使用了所有可能的值(对于位深度),则会尝试与具有最接近的可用色彩的值进行匹配。
  • REJECT仅对那些不包含关联色彩映射表的栅格数据集进行镶嵌。

有关各色彩映射表模式的详细信息,请参阅镶嵌色彩映射表模式

String
order_by_field
(可选)

定义对栅格目录项进行排序所依据的字段。

String
ascending
(可选)

选择是否使用“排序方式”字段的升序值。如果不使用“升序”选项,则将使用降序。

  • 升序镶嵌过程按照行的升序进行。这是默认设置。
  • 镶嵌过程按照行的降序进行。
Boolean
pixel_type
(可选)

确定输出栅格数据集的位深度。如果未指定,则输出位深度将与输入位深度相同。

当选择不同像素类型时,不会重设栅格值的比例。如果像素类型的范围被降级(降低),则在此像素深度的有效范围外的栅格值将被截断并丢失。

  • 1_BIT1 位无符号整数。值可以为 0 或 1。
  • 2_BIT2 位无符号整数。支持的值为 0 到 3。
  • 4_BIT4 位无符号整数。支持的值为 0 到 15。
  • 8_BIT_UNSIGNED8 位无符号数据类型。支持的值为 0 到 255。
  • 8_BIT_SIGNED8 位有符号数据类型。支持的值为 -128 到 127。
  • 16_BIT_UNSIGNED16 位无符号数据类型。取值范围为 0 到 65,535。
  • 16_BIT_SIGNED16 位有符号数据类型。取值范围为 -32,768 到 32,767。
  • 32_BIT_UNSIGNED32 位无符号数据类型。取值范围为 0 到 4,294,967,295。
  • 32_BIT_SIGNED32 位有符号数据类型。取值范围为 -2,147,483,648 到 2,147,483,647。
  • 32_BIT_FLOAT支持小数的 32 位数据类型。
  • 64_BIT支持小数的 64 位数据类型。
String
ColorBalancing
(可选)

选择是否使用匀光技术对栅格目录项进行色彩校正。栅格目录中的所有像素都将用于确定色彩平衡算法的 gamma 和对比度值。

  • NONE镶嵌过程不执行色彩平衡。这是默认设置。
  • ColorBalancing镶嵌过程执行色彩平衡。
Boolean
MatchingMethod
(可选)

选择应用于栅格的色彩匹配方法。

  • NONE当镶嵌栅格数据集时,此选项不会使用色彩匹配操作。
  • STATISTICS_MATCHING对参考重叠区域与源重叠区域间的统计差异(最小值、最大值和平均值)进行匹配;然后将变换应用于整个目标数据集。
  • HISTOGRAM_MATCHING此方法会将参考重叠区域中的直方图与源重叠区域进行匹配;然后将变换应用于整个目标数据集。
  • LINEARCORRELATION_MATCHING此方法是对重叠像素进行匹配,然后插值到源数据集的其余部分;不具有一对一关系的像素将使用加权平均值。
String
ReferenceRaster
(可选)

如果应用色彩匹配,则选择如何指定参考栅格。

  • CALCULATE_FROM_ALL系统将根据所有栅格目录项计算最佳可用栅格数据集。
  • SPECIFY_OID用户将输入作为参考栅格的栅格目录项的对象 ID (OID)。
  • DEFINE_FROM_SELECTION系统将根据所选栅格目录项计算最佳可用栅格数据集。
法律声明法律声明:

较旧的脚本和模型可能仍使用旧关键字。在 ArcGIS 10.1 版本中,此关键字被替换为“CALCULATE_FROM_ALL”。这两个关键字都可继续使用,但为了清楚起见,最好将其更新为新的关键字。

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}
try:
    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")
except:
    print "Raster Catalog To Raster Dataset example failed."
    print arcpy.GetMessages()

环境

相关主题

许可信息

ArcGIS for Desktop Basic:是
ArcGIS for Desktop Standard:是
ArcGIS for Desktop Advanced:是
9/15/2013