复制栅格 (Data Management)

许可等级:BasicStandardAdvanced

摘要

生成栅格数据集副本、将栅格数据集加载到栅格目录中或将镶嵌数据集转换为栅格数据集。

用法

语法

CopyRaster_management (in_raster, out_rasterdataset, {config_keyword}, {background_value}, {nodata_value}, {onebit_to_eightbit}, {colormap_to_RGB}, {pixel_type}, {scale_pixel_value}, {RGB_to_Colormap})
参数说明数据类型
in_raster

要复制的栅格数据集的名称和位置。

Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster Layer
out_rasterdataset

要创建的栅格数据集的名称和位置。

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

  • .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; Raster Catalog
config_keyword
(可选)

可用于指定文件地理数据库和 ArcSDE 地理数据库的存储参数(配置)。个人地理数据库不使用配置关键字。

ArcSDE 配置关键字由数据库管理员进行设置。

String
background_value
(可选)

使用此选项移除在栅格数据周围创建的不需要的值。指定的值与栅格数据集中的其他有用数据不同。例如,栅格边界上为零的值不同于栅格数据集内的零值。

指定的像素值在输出栅格数据集中将被设置为 NoData。

对于基于文件的栅格和个人地理数据库栅格,为了忽略背景值,“忽略背景值”必须设置为与 NoData 相同的值。ArcSDE 和文件地理数据库栅格无需经过此额外步骤即可忽略背景值。

Double
nodata_value
(可选)

具有指定值的所有像素将在输出栅格数据集中被设置为 NoData。

String
onebit_to_eightbit
(可选)

选择是否将输入 1 位栅格数据集转换为 8 位栅格数据集。使用这种转换方法时,输入栅格数据集中的值 1 将在输出栅格数据集中更改为 255。这在将 1 位栅格数据集导入 ArcSDE 时很有帮助。1 位栅格数据集存储在文件系统中时包含 8 位金字塔图层,但在 ArcSDE 中,1 位栅格数据集只能包含 1 位金字塔图层,这使得显示画面看起来没有吸引力。通过在 ArcSDE 中将数据转换为 8 位,可将金字塔图层构建为 8 位而非 1 位,从而在显示画面中生成适合的栅格数据集。

  • NONE不执行任何转换。这是默认设置。
  • OneBitTo8Bit将转换输入栅格。
Boolean
colormap_to_RGB
(可选)

如果输入栅格数据集具有色彩映射表,则可将输出栅格数据集转换为三波段输出栅格数据集。这在镶嵌包含不同色彩映射表的栅格时很有用。

  • NONE不发生任何转换。这是默认设置。
  • ColormapToRGB将转换输入数据集。
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
scale_pixel_value
(可选)

当输出的像素类型不同于输入像素类型时(如从 16 位到 8 位),可选择将值缩放到符合新的范围;否则,会丢弃不符合新的像素范围的值。

如果进行放大(如从 8 位到 16 位),8 位值的最小值和最大值会放大到 16 位范围中的最小值和最大值。如果进行缩小(如从 16 位到 8 位),16 位值的最小值和最大值会缩小到 8 位范围中的最小值和最大值。

  • NONE像素值保持不变且不会缩放。任何不符合值范围的值都会被丢弃。这是默认设置。
  • ScalePixelValue像素值会缩放到新的像素类型。缩放像素深度时,栅格会显示相同的位深度,而值却缩放到指定的新的位深度。
Boolean
RGB_to_Colormap
(可选)

可将 8 位 3 波段 (RGB) 栅格数据集转换为带色彩映射表的单波段栅格数据集。

此操作通过检查栅格数据集的统计数据并将值分类为 255 个分位数,抑制经常出现在扫描图像中的噪声点。

这非常适用于屏幕捕获、扫描的地图或扫描的文档。但并不建议将其用于卫星、航空影像或专题栅格数据。

  • NONE输出会保持为 3 波段 (RGB) 栅格数据集。不会转换为色彩映射表。这是默认设置。
  • RGBToColormap会创建带色彩映射表(使用 255 种颜色)的单波段栅格数据集。
Boolean

代码实例

复制栅格 (CopyRaster) 示例 1(Python 窗口)

这是复制栅格 (CopyRaster) 工具的 Python 示例。

import arcpy
arcpy.CopyRaster_management("c:/data/background.tif",
                           "c:/fdgb/CpRaster.gdb/fgdbRD","DEFAULTS",
                           "0","9","","","8_BIT_UNSIGNED")
复制栅格 (CopyRaster) 示例 2(独立脚本)

这是复制栅格 (CopyRaster) 工具的 Python 脚本示例。

##====================================
##Copy Raster
##Usage: CopyRaster_management in_raster out_rasterdataset {config_keyword} {background_value} {nodata_value} {NONE | OneBitTo8Bit} 
##                             {NONE | ColormapToRGB} {1_BIT | 2_BIT | 4_BIT | 8_BIT_UNSIGNED | 8_BIT_SIGNED | 16_BIT_UNSIGNED 
##                             | 16_BIT_SIGNED | 32_BIT_UNSIGNED | 32_BIT_SIGNED | 32_BIT_FLOAT | 64_BIT}
try:
    import arcpy
    arcpy.env.workspace = r"C:\PrjWorkspace"
    ##Copy File RasterDataset to GDB Dataset with Background and Nodata setting
    arcpy.CopyRaster_management("background.tif","CpRaster.gdb\\background","DEFAULTS","0","9","","","8_BIT_UNSIGNED")
    ##Copy 1 BIT 
    arcpy.CopyRaster_management("1bit.tif","SDE94.sde\\bit8","DEFAULTS","","","OneBitTo8Bit","","")
except:
    print "Copy Raster example failed."
    print arcpy.GetMessages()

环境

相关主题

许可信息

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