创建栅格数据集 (数据管理)

描述

创建空的栅格数据集。

使用方法

• 创建的栅格数据集为将要存放单个栅格数据集的空位置。然后您便可以将栅格数据集镶嵌或加载到该位置。

• 可将输出结果保存为 BIL、BIP、BMP、BSQ、DAT、Esri Grid、GIF、IMG、JPEG、JPEG 2000、PNG、TIFF 格式或任意地理数据库栅格数据集。

• 将栅格数据集存储到 JPEG 文件、JPEG 2000 文件或地理数据库时，可在环境中指定压缩类型和压缩质量。

• GIF 格式仅支持单波段栅格数据集。

• 构建金字塔可以改善栅格数据集的显示性能。

• 通过计算统计数据，ArcGIS 应用程序能够适当地拉伸和符号化栅格数据以便于显示。

语法

arcpy.management.CreateRasterDataset(out_path, out_name, {cellsize}, pixel_type, {raster_spatial_reference}, number_of_bands, {config_keyword}, {pyramids}, {tile_size}, {compression}, {pyramid_origin})

参数	说明	数据类型
out_path	用于存储栅格数据集的文件夹或地理数据库。	Workspace
out_name	要创建的数据集的名称、位置和格式。 以文件格式存储栅格数据集时，需要指定文件扩展名，具体如下： 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 Esri Grid 无扩展名 将栅格数据集存储到地理数据库时，请勿向栅格数据集的名称添加文件扩展名。 将栅格数据集存储到 JPEG 文件、JPEG 2000 文件、TIFF 文件或地理数据库时，可在地理处理环境中指定压缩类型和压缩质量。	String
cellsize （可选）	新栅格数据集的像元大小。	Double
pixel_type	输出栅格数据集的位深度（辐射分辨率）。如果未指定，则将使用 8 位无符号整数的默认像素类型创建栅格数据集。 并非所有栅格格式都支持全部数据类型。请参阅受支持的传感器列表帮助主题确定所用格式是否支持所需数据类型。 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
raster_spatial_reference （可选）	输出栅格数据集的坐标系。 若未指定坐标系，则将使用环境设置中设置的坐标系。	Coordinate System
number_of_bands	输出栅格数据集的波段数。	Long
config_keyword （可选）	指定文件或企业级地理数据库的存储参数（配置）。配置关键字由数据库管理员进行设置。	String
pyramids （可选）	创建金字塔。 对于金字塔等级，可指定 -1 或更高等级的数字。值为 0 时将不构建任何金字塔，值为 -1 时将自动确定要创建的金字塔图层的正确数量。 “金字塔重采样技术”用于定义在构建金字塔时如何对数据进行重采样。 NEAREST - 对于具有色彩映射表（如土地利用或伪彩色图像）的标称数据或栅格数据集，应使用最邻近法。 BILINEAR - 双线性插值法最适用于诸如卫星影像或航空摄影这样的连续数据。 CUBIC - 三次卷积插值法最适用于处理卫星影像或航空摄影等诸如此类的连续数据。它与双线性插值法类似；不过，它会使用更大的矩阵对数据进行重采样。 “金字塔压缩类型”用于定义压缩金字塔时使用的方法。 DEFAULT - 将使用通常由栅格数据集格式使用的压缩类型。 LZ77 - 无损压缩。将不会更改栅格中的单元值。 JPEG - 有损压缩。 NONE - 无数据压缩。	Pyramid
tile_size （可选）	指定分块的大小。 切片宽度决定了您可以在各切片中存储的像素数目。切片宽度以 x 像素数指定。默认切片宽度为 128。 切片高度决定了您可以在各切片中存储的像素数目。切片高度以 y 像素数指定。默认切片高度为 128。 只有地理数据库和企业级地理数据库使用切片大小。	Tile Size
compression （可选）	定义用于存储栅格数据集的压缩类型。 LZ77 —保留所有栅格像元值的无损压缩。 JPEG —使用公共 JPEG 压缩算法的有损压缩。如果选择 JPEG，还可以指定压缩质量。压缩质量的有效值范围是 0 到 100。这种压缩方式可用于 JPEG 文件和 TIFF 文件。 JPEG 2000 —有损压缩。 PACKBITS —用于 TIFF 文件的 PackBits 压缩。 LZW —保留所有栅格像元值的无损压缩。 RLE —用于 IMG 文件的游程编码。 CCITT GROUP 3 —用于 1 位数据的无损压缩。 CCITT GROUP 4 —用于 1 位数据的无损压缩。 CCITT (1D) —用于 1 位数据的无损压缩。 NONE —不会发生任何压缩。这是默认设置。	Compression
pyramid_origin （可选）	栅格金字塔的初始位置。如果计划在文件地理数据库或企业级地理数据库中构建大的镶嵌数据集，尤其要计划随着时间的推移对这些镶嵌数据进行镶嵌处理时（例如，更新），建议您指定此项。 金字塔参考点应设置在栅格数据集的左上角。 为文件地理数据库或企业级地理数据库设置此点时，如果使用新的镶嵌栅格数据集进行更新，将使用部分构建金字塔。部分构建金字塔已更新由于新的镶嵌数据集导致的金字塔的不存在部分。因此，最好设置金字塔参考点，以便整个栅格镶嵌都位于此点的右下方。不过，金字塔参考点不应设置得过大。	Point

派生输出

名称	说明	数据类型
out_raster_dataset	输出栅格数据集。	栅格数据集

代码示例

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")

环境

压缩, 输出配置关键字, 金字塔, 分块大小

许可信息

• Basic: 是
• Standard: 是
• Advanced: 是