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

摘要

创建空的栅格数据集。

使用情况

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

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

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

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

  • 以 CRF 格式创建的栅格数据集可扩展。 CRF 数据集的可扩展范围可根据接受 CRF 作为输入的其他工具进行自动调整,例如镶嵌复制栅格裁剪栅格重新采样工具。

  • 可扩展 CRF 数据集支持多维栅格。 使用镶嵌工具将多维数据添加到空栅格数据集时,系统会创建可扩展的多维栅格数据集。 您还可以使用 ArcPy 为空栅格数据集定义多维信息,如以下示例所示:

    有关如何为空栅格数据集定义多维信息的示例。 多维栅格数据集的定义基于现有的多维栅格,在下面的示例中由 template.crf 表示。

    import arcpy
    arcpy.CheckOutExtension("ImageAnalyst")
    r = arcpy.Raster(r"\\location_to_a_mdim_raster\template.crf", True)
    r2 = arcpy.Raster(r"C:\Temp\expandable_mdim.crf")
    r2.mdinfo = r.mdinfo
    r2.mdinfo

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

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

参数

标注说明数据类型
输出位置

存储栅格数据集的文件夹以及地理数据库。

Workspace
具有扩展名的栅格数据集名称

新创建的数据集的名称、位置和格式。

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

  • 对于 Esri BIL,为 .bil
  • 对于 Esri BIP,为 .bip
  • 对于 BMP,为 .bmp
  • 对于 Esri BSQ,为 .bsq
  • 对于 CRF,为 .crf
  • 对于 ENVI DAT,为 .dat
  • 对于 GIF,为 .gif
  • 对于 ERDAS IMAGINE,为 .img
  • 对于 JPEG,为 .jpg
  • 对于 JPEG 2000,为 .jp2
  • 对于 PNG,为 .png
  • 对于 TIFF,为 .tif
  • Esri Grid 无扩展名

将栅格数据集存储到地理数据库时,请勿向栅格数据集的名称添加文件扩展名。

将栅格数据集存储为 JPEG 格式文件、JPEG 2000 格式文件、TIFF 格式文件或地理数据库时,可在地理处理环境中指定压缩类型压缩质量值。

String
像元大小
(可选)

将用于新建栅格数据集的像素大小。

Double
像素类型

输出栅格数据集的位深度(辐射分辨率)。 如果未指定,则将使用 8 位无符号整数的默认像素类型创建栅格数据集。

并非所有栅格格式都支持全部数据类型。 请参阅受支持的传感器列表帮助主题确定所用格式是否支持所需数据类型。

  • 1 位像素类型为 1 位无符号整数。 值可以为 0 或 1。
  • 2 位像素类型为 2 位无符号整数。 受支持的值范围为 0 到 3。
  • 4 位像素类型为 4 位无符号整数。 受支持的值范围为 0 到 15。
  • 8 位无符号像素类型为 8 位无符号数据类型。 受支持的值范围为 0 到 255。
  • 8 位带符号像素类型为 8 位有符号数据类型。 受支持的值范围为 -128 到 127。
  • 16 位无符号像素类型为 16 位无符号数据类型。 取值范围为 0 到 65,535。
  • 16 位带符号像素类型为 16 位有符号数据类型。 取值范围为 -32,768 到 32,767。
  • 32 位无符号像素类型为 32 位无符号数据类型。 取值范围为 0 到 4,294,967,295。
  • 32 位带符号像素类型为 32 位有符号数据类型。 取值范围为 -2,147,483,648 到 2,147,483,647。
  • 32 位浮点像素类型为支持小数的 32 位数据类型。
  • 64 位像素类型为支持小数的 64 位数据类型。
String
栅格数据的空间参考
(可选)

输出栅格数据集的坐标系。

若未指定坐标系,则将使用环境设置中设置的坐标系。

Coordinate System
波段数

输出栅格数据集的波段数。

Long
配置关键字
(可选)

文件或企业级地理数据库的存储参数(配置)。 配置关键字由数据库管理员进行设置。

String
创建金字塔
(可选)

创建金字塔。

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

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

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

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

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

块大小。

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

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

只有地理数据库和企业级地理数据库使用切片大小。

Tile Size
压缩
(可选)

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

  • 不使用压缩。 这是默认设置。
  • LZ77使用保留所有栅格像元值的无损压缩。
  • Jpeg使用公共 JPEG 压缩算法的有损压缩。 如果选择 JPEG,还可以指定压缩质量。 压缩质量的有效值范围是 0 到 100。 这种压缩方式可用于 .jpg 文件和 .tif 文件。
  • Jpeg 2000使用有损压缩。
  • Lzw使用保留所有栅格像元值的无损压缩。
  • PackbitsPackBits 压缩将用于 .tif 文件。
  • Rle游程编码将用于 .img 文件。
  • Ccitt Group 3用于 1 位数据的无损压缩。
  • Ccitt Group 4用于 1 位数据的无损压缩。
  • Ccitt 1D用于 1 位数据的无损压缩。
Compression
原点/金字塔参考点
(可选)

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

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

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

Point

派生输出

标注说明数据类型
输出栅格数据集

输出栅格数据集。

Raster Dataset

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
  • 对于 CRF,为 .crf
  • 对于 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。 这种压缩方式可用于 .jpg 文件和 .tif 文件。
  • JPEG 2000使用有损压缩。
  • PACKBITSPackBits 压缩将用于 .tif 文件。
  • LZW使用保留所有栅格像元值的无损压缩。
  • RLE游程编码将用于 .img 文件。
  • CCITT GROUP 3用于 1 位数据的无损压缩。
  • CCITT GROUP 4用于 1 位数据的无损压缩。
  • CCITT_1D用于 1 位数据的无损压缩。
  • NONE不使用压缩。 这是默认设置。
Compression
pyramid_origin
(可选)

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

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

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

Point

派生输出

名称说明数据类型
out_raster_dataset

输出栅格数据集。

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: 是

相关主题