复制栅格—帮助

描述
使用
语法
代码示例
环境
许可信息

描述

保存栅格数据集的副本或将镶嵌数据集转换成单个栅格数据集。

使用

可将输出结果保存为 BIL、BIP、BMP、BSQ、CRF、DAT、Esri Grid、GIF、IMG、JPEG、JPEG 2000、MRF、PNG、TIFF 格式或任意地理数据库栅格数据集。
以地理数据库形式存储栅格数据集时，不应向栅格数据集的名称添加文件扩展名。以文件格式存储栅格数据集时，需要指定文件扩展名，具体如下：
- Esri BIL 为 .bil
- Esri BIP 为 .bip
- BMP 为 .bmp
- Esri BSQ 为 .bsq
- ENVI DAT 为 .dat
- GIF 为 .gif
- ERDAS IMAGINE 为 .img
- JPEG 为 .jpg
- JPEG 2000 为 .jp2
- PNG 为 .png
- TIFF 为 .tif
- MRF 为 .mrf
- CRF 为 .crf
- Esri Grid 无扩展名
此工具可用于将像素类型从一个位深度缩放到另一个位深度。缩放像素深度时，栅格会显示相同的位深度，而值却缩放到指定的新的位深度。
此工具的输出始终是栅格数据集。该工具将接受镶嵌数据集作为输入，但输出仍为栅格数据集 - 镶嵌数据集的内容将被镶嵌以创建栅格数据集。
如果已选中 ArcMap 选项中的使用坐标定位文件定义栅格坐标选项，将写出一个坐标定位文件。如果已存在相应的坐标定位文件，则会覆盖该文件。也可能在输出空间参考中偏移半个像素。
对于基于文件的栅格和个人地理数据库栅格，要忽略背景值，必须将忽略背景值设置为与 NoData 相同的值。文件地理数据库栅格和企业级地理数据库栅格无需经过此额外步骤即可忽略背景值。
将栅格数据集存储到 JPEG 文件、JPEG 2000 文件或地理数据库时，可在环境中指定压缩类型和压缩质量。
GIF 格式仅支持单波段栅格数据集。
像素类型参数将决定输出栅格数据集的位深度。当选择不同像素类型时，会重设栅格值的比例。如果像素类型的范围被降级（降低），则在此像素深度的有效范围外的栅格值将被截断并丢失。要了解有关支持的导出格式的位深度容量的信息，请参阅支持的栅格数据集文件格式。

语法

CopyRaster(in_raster, out_rasterdataset, {config_keyword}, {background_value}, {nodata_value}, {onebit_to_eightbit}, {colormap_to_RGB}, {pixel_type}, {scale_pixel_value}, {RGB_to_Colormap}, {format}, {transform}, {}, {})

参数	说明	数据类型
in_raster	想要复制的栅格数据集或镶嵌数据集。	Raster Dataset; Mosaic Dataset; Mosaic Layer; Raster Layer; File; Image Service
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 .mrf - MRF .crf - CRF Esri Grid 无扩展名将栅格数据集存储到地理数据库时，请勿向栅格数据集的名称添加文件扩展名。将栅格数据集存储到 JPEG 文件、JPEG 2000 文件、TIFF 文件或地理数据库时，可以指定压缩类型和压缩质量。	Raster Dataset
config_keyword （可选）	指定地理数据库的存储参数（配置）。配置关键字由数据库管理员进行设置。	String
background_value （可选）	移除在栅格数据周围创建的不需要的值。指定的值与栅格数据集中的其他有用数据不同。例如，栅格边界上为零的值不同于栅格数据集内的零值。指定的像素值在输出栅格数据集中将被设置为 NoData。对于基于文件的栅格和地理数据库栅格，要忽略背景值，必须将其设置为与 NoData 相同的值。企业级和地理数据库栅格无需经过此额外步骤即可忽略背景值。	Double
nodata_value （可选）	具有指定值的所有像素将在输出栅格数据集中被设置为 NoData。	String
onebit_to_eightbit （可选）	选择是否将输入 1 位栅格数据集转换为 8 位栅格数据集。使用这种转换方法时，输入栅格数据集中的值 1 将在输出栅格数据集中更改为 255。这在将 1 位栅格数据集导入地理数据库时十分有用。1 位栅格数据集存储在文件系统中时包含 8 位金字塔图层，但在地理数据库中，1 位栅格数据集只能包含 1 位金字塔图层，这使得显示画面看起来没有吸引力。通过在地理数据库中将数据转换为 8 位，可将金字塔图层构建为 8 位而非 1 位，从而在显示画面中生成适合的栅格数据集。 NONE —不执行任何转换。这是默认设置。 OneBitTo8Bit —将转换输入栅格。	Boolean
colormap_to_RGB （可选）	如果输入栅格数据集具有色彩映射表，则可将输出栅格数据集转换为三波段输出栅格数据集。这在镶嵌包含不同色彩映射表的栅格时很有用。 NONE —不发生任何转换。这是默认设置。 ColormapToRGB —将转换输入数据集。	Boolean
pixel_type （可选）	设置栅格数据集或镶嵌数据集的位深度或辐射分辨率。如果未定义，此值将从第一个栅格数据集获取。 1_BIT —1 位无符号整数。值可以为 0 或 1。 2_BIT —2 位无符号整数。支持的值为 0 到 3。 4_BIT —4 位无符号整数。支持的值为 0 到 15。 8_BIT_UNSIGNED —8 位无符号数据类型。支持的值为 0 到 255。 8_BIT_SIGNED —8 位有符号数据类型。支持的值为 -128 到 127。 16_BIT_UNSIGNED —16 位无符号数据类型。取值范围为 0 到 65,535。 16_BIT_SIGNED —16 位有符号数据类型。取值范围为 -32,768 到 32,767。 32_BIT_UNSIGNED —32 位无符号数据类型。取值范围为 0 到 4,294,967,295。 32_BIT_SIGNED —32 位有符号数据类型。取值范围为 -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) 栅格数据集转换为带色彩映射表的单波段栅格数据集。此操作会抑制经常出现在扫描图像中的噪声，这非常适用于屏幕捕获、扫描的地图或扫描的文档。但并不建议将其用于卫星、航空影像或专题栅格数据。 NONE —不转换 RGB。 RGBToColormap —转换为色彩映射表。	Boolean
format （可选）	输出栅格格式。 TIFF —TIFF 格式 COG —Cloud Optimized GeoTIFF 格式 IMAGINE Image —ERDAS IMAGINE BMP —BMP 格式 GIF —GIF 格式 PNG —PNG 格式 JPEG —JPEG 格式 JP2 —JPEG 2000 格式 GRID —Esri Grid 格式 BIL —Esri BIL 格式 BSQ —Esri BSQ 格式 BIP —Esri BIP 格式 ENVI —ENVI 格式 CRF —CRF 格式 MRF —MRF 格式	String
transform （可选）	将与栅格相关联的变换应用到输出。输入栅格可以具有与其相关联的变换，该变换未实际保存在输入内，例如作为坐标定位文件或者作为几何函数。 NONE —不将任何相关联的变换应用到输出。 Transform —将相关联的变换应用到输出。	Boolean
（可选）
（可选）

代码示例

CopyRaster 示例 1（Python 窗口）

这是 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}, 
##			{NONE | ScalePixelValue}, {NONE | RGBToColormap}, {TIFF | IMAGINE Image | 
##			BMP | GIF | PNG | JPEG | JPEG2000 | Esri Grid | Esri BIL | Esri BSQ | 
##			Esri BIP | ENVI | CRF | MRF}, {NONE | Transform})

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","","")
    ##Copy to cloud raster format
    arcpy.CopyRaster_management("slope_elev.tif", "https://s3.amazonaws.com/S3Storage/slope_elev", format="CRF", transform="Transform")
except:
    print "Copy Raster example failed."
    print arcpy.GetMessages()

CopyRaster 示例 2（独立脚本）

这是 CopyRaster 工具的 Python 脚本示例。

##====================================
##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}, 
##			{NONE | ScalePixelValue}, {NONE | RGBToColormap}, {TIFF | IMAGINE Image | 
##			BMP | GIF | PNG | JPEG | JPEG2000 | Esri Grid | Esri BIL | Esri BSQ | 
##			Esri BIP | ENVI | CRF | MRF}, {NONE | Transform})

import arcpy
arcpy.env.workspace = r"C:\PrjWorkspace"

##Copy to cloud raster format
arcpy.CopyRaster_management(
	"slope_elev.tif", "https://s3.amazonaws.com/S3Storage/slope_elev", 
	format="CRF")

环境

许可信息

Basic: 是
Standard: 是
Advanced: 是

描述

使用

语法

代码示例

CopyRaster 示例 1（Python 窗口）

CopyRaster 示例 2（独立脚本）

环境

许可信息

相关主题