创建栅格数据集 (Data Management)

许可等级:BasicStandardAdvanced

摘要

将栅格数据集创建为文件或创建到地理数据库中。

用法

语法

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

要创建的栅格数据集的名称。

以文件格式存储栅格数据集时,需要指定文件扩展名,具体如下:

  • .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
  • 无扩展名 Esri Grid

以地理数据库形式存储栅格数据集时,不应向栅格数据集的名称添加文件扩展名。

将栅格数据集存储到 JPEG 文件、JPEG 2000 文件、TIFF 文件或地理数据库时,可以指定压缩类型和压缩质量。

String
cellsize
(可选)

新栅格数据集的像元大小。

Double
pixel_type

指定像元值的数据类型。该参数的默认值为 8 位无符号整数。

并非所有栅格格式都支持全部数据类型。参阅受支持的栅格数据集文件格式帮助主题可确定所用格式是否支持所需数据类型。

  • 1_BIT1 位无符号整数。值可以为 0 或 1。
  • 2_BIT2 位无符号整数。支持的值为 0 到 3。
  • 4_BIT4 位无符号整数。支持的值为 0 到 15。
  • 8_BIT_UNSIGNED8 位无符号数据类型。支持的值为 0 到 255。
  • 8_BIT_SIGNED8 位有符号数据类型。支持的值为 -128 到 127。
  • 16_BIT_UNSIGNED16 位无符号数据类型。取值范围为 0 到 65,535。
  • 16_BIT_SIGNED16 位有符号数据类型。取值范围为 -32,768 到 32,767。
  • 32_BIT_UNSIGNED32 位无符号数据类型。取值范围为 0 到 4,294,967,295。
  • 32_BIT_SIGNED32 位有符号数据类型。取值范围为 -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
(可选)

可用于指定文件地理数据库和 ArcSDE 地理数据库的存储参数(配置)。个人地理数据库不使用配置关键字。

ArcSDE 配置关键字由数据库管理员进行设置。

String
pyramids
(可选)

使用此选项创建金字塔。

对于金字塔等级,可选择 -1 或更高等级的数字。值为 0 时将不构建任何金字塔,值为 -1 时将自动选择要创建的金字塔图层的正确数量。

“金字塔重采样技术”用于定义在构建金字塔时如何对数据进行重采样。

  • NEAREST - 对于具有色彩映射表(如土地利用或伪彩色图像)的标称数据或栅格数据集,应使用最邻近法。
  • BILINEAR - 双线性插值法最适用于诸如卫星影像或航空摄影这样的连续数据。
  • CUBIC - 三次卷积插值法最适用于诸如卫星影像或航空摄影这样的连续数据。它与双线性插值法类似;不过,它使用较大的矩阵对数据进行重采样。

“金字塔压缩类型”用于定义压缩金字塔时使用的方法。

  • DEFAULT - 将使用通常由栅格数据集格式使用的压缩类型。
  • LZ77 - 无损压缩。将不会更改栅格中的单元值。
  • JPEG - 有损压缩。
  • NONE - 无数据压缩。
Pyramid
tile_size
(可选)

切片宽度决定了您可以在各切片中存储的像素数目。切片宽度以 x 像素数指定。默认切片宽度为 128。

切片高度决定了您可以在各切片中存储的像素数目。切片高度以 y 像素数指定。默认切片高度为 128。

只有文件地理数据库和 ArcSDE 地理数据库使用切片大小。

Tile Size
compression
(可选)

此参数用于定义存储栅格数据集时使用的数据压缩类型。

  • LZ77无损。
  • JPEG有损。使用压缩质量。
  • JPEG 2000有损。使用压缩质量。
  • PackBits无损。仅限于 TIFF 格式。
  • LZW无损。
  • RLE无损。
  • CCITT GROUP 3无损。仅限于 TIFF 格式。
  • CCITT GROUP 4无损。仅限于 TIFF 格式。
  • CCITT (1D)无损。仅限于 TIFF 格式。
  • NONE无数据压缩。

JPEG 和 JPEG 2000 压缩质量的变化范围是 1 到 100。数字较大,意味着图像的质量较高,但压缩程度较低。

Compression
pyramid_origin
(可选)

这是栅格金字塔的初始位置。如果计划在文件地理数据库或 ArcSDE 地理数据库中构建大的镶嵌数据集,尤其要计划随着时间的推移对这些镶嵌数据进行镶嵌处理时(例如,更新),建议您指定此项。

金字塔参考点应设置在栅格数据集的左上角。

为文件地理数据库或 ArcSDE 地理数据库设置此点时,如果使用新的镶嵌栅格数据集进行更新,将使用部分构建金字塔。部分构建金字塔更新了由于新的镶嵌数据集导致的金字塔的不存在部分。因此,最好设置金字塔参考点,以便整个栅格镶嵌都位于此点的下方和右侧。不过,金字塔参考点不应设置得过大。

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}
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()

环境

相关主题

许可信息

ArcGIS for Desktop Basic:是
ArcGIS for Desktop Standard:是
ArcGIS for Desktop Advanced:是
9/15/2013