复制栅格 (数据管理)
摘要
生成栅格数据集的副本或将栅格数据集加载到栅格目录中。
用法
-
可将输出保存为 BIL、BIP、BMP、BSQ、DAT、GIF、GRID、IMG、JPEG、JPEG 2000、PNG、TIFF 格式或任意地理数据库栅格数据集。
-
以地理数据库形式存储栅格数据集时，不应向栅格数据集的名称添加文件扩展名。以文件格式存储栅格数据集时，需要指定文件扩展名，具体如下：
- .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
- 无扩展名适用于 GRID
-
即使正在将栅格数据集加载到栅格目录中，该工具的输出也始终是栅格数据集。该工具将接受镶嵌数据集作为输入，但输出仍为栅格数据集 - 镶嵌数据集的内容将被镶嵌以创建栅格数据集。
-
此工具可将栅格数据集加载到栅格目录中。如果希望将栅格数据集加载到栅格目录中，则需要打出栅格目录的完整路径作为输出位置，或者将栅格目录拖放到输出文本框中。
-
如果将此工具用于将栅格数据集加载到栅格目录中，则在加载完成后需要运行计算默认空间格网索引工具。
-
对于基于文件的栅格和个人地理数据库栅格，为了忽略背景值，忽略背景值必须设置为与 NoData 相同的值。文件地理数据库栅格和 ArcSDE 栅格无需经过此额外步骤即可忽略背景值。
-
将栅格数据集存储到 JPEG 文件、JPEG 2000 文件或地理数据库时，可在“环境设置”中指定压缩类型和压缩质量。
-
GIF 格式仅支持单波段栅格数据集。
-
像素类型参数将决定输出栅格数据集的位深度。当选择不同像素类型时，会重设栅格值的比例。如果像素类型的范围被降级（降低），则在此像素深度的有效范围外的栅格值将被截断并丢失。要了解有关支持的导出格式的位深度容量的信息，请参阅栅格数据集格式的技术规范
语法
| 参数 | 说明 | 数据类型 |
in_raster |
要复制的栅格数据集的名称和位置。 | Raster layer |
out_rasterdataset |
要创建的栅格数据集的名称和位置。 以文件格式存储栅格数据集时，需要指定文件扩展名，具体如下：
以地理数据库形式存储栅格数据集时，不应向栅格数据集的名称添加文件扩展名。 将栅格数据集存储到 JPEG 文件、JPEG 2000 文件、TIFF 文件或地理数据库时，可以指定压缩类型和压缩质量。 | Raster Dataset ; Raster Catalog |
config_keyword （可选） |
可用于指定文件地理数据库和 ArcSDE 地理数据库的存储参数（配置）。个人地理数据库不使用配置关键字。 ArcSDE 配置关键字由数据库管理员进行设置。 | String |
background_value （可选） |
使用此选项移除在栅格数据周围创建的不需要的值。指定的值与栅格数据集中的其他有用数据不同。例如，栅格边界上为零的值不同于栅格数据集内的零值。 指定的像素值在输出栅格数据集中将被设置为 NoData。 对于基于文件的栅格和个人地理数据库栅格，为了忽略背景值，“忽略背景值”必须设置为与 NoData 相同的值。ArcSDE 和文件地理数据库栅格无需经过此额外步骤即可忽略背景值。 | Double |
nodata_value （可选） |
具有指定值的所有像素将在输出栅格数据集中被设置为 NoData。 | Double |
onebit_to_eightbit （可选） |
选择是否将输入 1 位栅格数据集转换为 8 位栅格数据集。使用这种转换方法时，输入栅格数据集中的值 1 将在输出栅格数据集中更改为 255。这在将 1 位栅格数据集导入 ArcSDE 时很有帮助。1 位栅格数据集存储在文件系统中时包含 8 位金字塔图层，但在 ArcSDE 中，1 位栅格数据集只能包含 1 位金字塔图层，这使得显示画面看起来没有吸引力。通过在 ArcSDE 中将数据转换为 8 位，可将金字塔图层构建为 8 位而非 1 位，从而在显示画面中生成独特的栅格数据集。
| Boolean |
colormap_to_RGB （可选） |
如果输入栅格数据集具有色彩映射表，则可将输出栅格数据集转换为三波段输出栅格数据集。这在镶嵌包含不同色彩映射表的栅格时很有用。
| Boolean |
pixel_type （可选） |
确定输出栅格数据集的位深度。如果未指定，则输出位深度将与输入位深度相同。 当选择不同像素类型时，不会重设栅格值的比例。如果像素类型的范围被降级（降低），则在此像素深度的有效范围外的栅格值将被截断并丢失。
| String |
代码示例
这是 CopyRaster 工具的 Python 示例。
import arcpy
arcpy.CopyRaster_management("c:/data/background.tif",
"c:/fdgb/CpRaster.gdb/fgdbRD","DEFAULTS",
"0","9","","","8_BIT_UNSIGNED")这是 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()