摘要
创建空的栅格数据集。
用法
语法
CreateRasterDataset_management (out_path, out_name, {cellsize}, pixel_type, {raster_spatial_reference}, number_of_bands, {config_keyword}, {pyramids}, {tile_size}, {compression}, {pyramid_origin})
参数 | 说明 | 数据类型 |
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 (可选) | 指定文件或企业级地理数据库的存储参数(配置)。配置关键字由数据库管理员进行设置。 | String |
pyramids (可选) | 使用此选项创建金字塔。 对于金字塔等级,可选择 -1 或更高等级的数字。值为 0 时将不构建任何金字塔,值为 -1 时将自动选择要创建的金字塔图层的正确数量。 “金字塔重采样技术”用于定义在构建金字塔时如何对数据进行重采样。
“金字塔压缩类型”用于定义压缩金字塔时使用的方法。
| Pyramid |
tile_size (可选) | 切片宽度决定了您可以在各切片中存储的像素数目。切片宽度以 x 像素数指定。默认切片宽度为 128。 切片高度决定了您可以在各切片中存储的像素数目。切片高度以 y 像素数指定。默认切片高度为 128。 只有地理数据库和企业级地理数据库可使用切片大小。 | Tile Size |
compression (可选) | 定义用于存储栅格数据集的压缩类型。
| String |
pyramid_origin (可选) | 这是栅格金字塔的初始位置。如果计划在文件地理数据库或企业级地理数据库中构建大的镶嵌数据集,尤其要计划随着时间的推移对这些镶嵌数据进行镶嵌处理时(例如,更新),建议您指定此项。 金字塔参考点应设置在栅格数据集的左上角。 为文件地理数据库或企业级地理数据库设置此点时,如果使用新的镶嵌栅格数据集进行更新,将使用部分构建金字塔。部分构建金字塔更新了由于新的镶嵌数据集导致的金字塔的不存在部分。因此,最好设置金字塔参考点,以便整个栅格镶嵌都位于此点的右下方。不过,金字塔参考点不应设置得过大。 | Point |
代码示例
CreateRasterDataset 示例 1(Python 窗口)
这是 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 示例 2(独立脚本)
这是 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}
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")
环境
许可信息
- ArcGIS Desktop Basic: 是
- ArcGIS Desktop Standard: 是
- ArcGIS Desktop Advanced: 是