创建栅格数据集 (Data Management)
摘要
将栅格数据集创建为文件或创建到地理数据库中。
用法
语法
| 参数 | 说明 | 数据类型 |
out_path |
用于存放栅格数据集的输出位置。 | Workspace; Raster Catalog |
out_name |
要创建的栅格数据集的名称。 以文件格式存储栅格数据集时，需要指定文件扩展名，具体如下：
以地理数据库形式存储栅格数据集时，不应向栅格数据集的名称添加文件扩展名。 将栅格数据集存储到 JPEG 文件、JPEG 2000 文件、TIFF 文件或地理数据库时，可以指定压缩类型和压缩质量。 | String |
cellsize (可选) |
新栅格数据集的像元大小。 | Double |
pixel_type |
指定像元值的数据类型。该参数的默认值为 8 位无符号整数。 并非所有栅格格式都支持全部数据类型。参阅受支持的栅格数据集文件格式帮助主题可确定所用格式是否支持所需数据类型。
| String |
raster_spatial_reference (可选) |
栅格数据集的坐标系。 若未指定坐标系，则将使用环境设置中设置的坐标系。 | Coordinate System |
number_of_bands |
栅格数据集中包含的波段数。 | Long |
config_keyword (可选) |
可用于指定文件地理数据库和 ArcSDE 地理数据库的存储参数（配置）。个人地理数据库不使用配置关键字。 ArcSDE 配置关键字由数据库管理员进行设置。 | String |
pyramids (可选) |
使用此选项创建金字塔。 对于金字塔等级，可选择 -1 或更高等级的数字。值为 0 时将不构建任何金字塔，值为 -1 时将自动选择要创建的金字塔图层的正确数量。 “金字塔重采样技术”用于定义在构建金字塔时如何对数据进行重采样。
“金字塔压缩类型”用于定义压缩金字塔时使用的方法。
| Pyramid |
tile_size (可选) |
切片宽度决定了您可以在各切片中存储的像素数目。切片宽度以 x 像素数指定。默认切片宽度为 128。 切片高度决定了您可以在各切片中存储的像素数目。切片高度以 y 像素数指定。默认切片高度为 128。 只有文件地理数据库和 ArcSDE 地理数据库使用切片大小。 | Tile Size |
compression (可选) |
此参数用于定义存储栅格数据集时使用的数据压缩类型。
JPEG 和 JPEG 2000 压缩质量的变化范围是 1 到 100。数字较大，意味着图像的质量较高，但压缩程度较低。 | Compression |
pyramid_origin (可选) |
这是栅格金字塔的初始位置。如果计划在文件地理数据库或 ArcSDE 地理数据库中构建大的镶嵌数据集，尤其要计划随着时间的推移对这些镶嵌数据进行镶嵌处理时（例如，更新），建议您指定此项。 金字塔参考点应设置在栅格数据集的左上角。 为文件地理数据库或 ArcSDE 地理数据库设置此点时，如果使用新的镶嵌栅格数据集进行更新，将使用部分构建金字塔。部分构建金字塔更新了由于新的镶嵌数据集导致的金字塔的不存在部分。因此，最好设置金字塔参考点，以便整个栅格镶嵌都位于此点的右下方。不过，金字塔参考点不应设置得过大。 | Point |
代码实例
这是 CreateRasterDataset 工具的 Python 实例。
import arcpy
arcpy.CreateRasterDataset_management("c:/data", "EmptyTIFF.tif", "2",
"8_BIT_UNSIGNED", "World_Mercator.prj",
"3", "", "PYRAMIDS -1 NEAREST JPEG",
"128 128", "NONE", "")
这是 CreateRasterDataset 工具的 Python 脚本实例。
##==================================
##Create Raster Dataset
##Usage: CreateRasterDataset_management out_path out_name {cellsize} 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 {raster_spatial_reference} number_of_bands {config_keyword} {pyramids} {tile_size}
## {compression} {pyramid_origin}
try:
import arcpy
arcpy.env.workspace = r"\\workspace\PrjWorkspace\RasGP"
##Create a empty TIFF format Raster Dataset with the following parameters
##Cellsize: 2
##Pixel type: 8 Bit Unsigned Integer
##Number of Bands: 3
##Pyramid: Build full pyramids with NEAREST interpolation and JPEG compression
##Compression: NONE
##Projection: World_Mercator
##Tile size: 128 128
arcpy.CreateRasterDataset_management("CreateRD","EmptyTIFF.tif","2","8_BIT_UNSIGNED",\
"World_Mercator.prj", "3", "", "PYRAMIDS -1 NEAREST JPEG",\
"128 128", "NONE", "")
##Create a SDE Raster Dataset
##No Spatial Reference, with Pyramid Origin
arcpy.CreateRasterDataset_management("CreateRD\\CreateRD.gdb","NewRD","10","16_BIT_UNSIGNED",\
"", "1", "MAX_FILE_SIZE_4GB", "PYRAMIDS 3 BILINEAR DEFAULT",\
"128 128", "JPEG2000 80", "-20037508.34278775 30198185.16987658")
except:
print "Create Raster Dataset example failed."
print arcpy.GetMessages()