ラスタ データセットの作成(Create Raster Dataset) (データ管理)

ライセンス レベル: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 - 三次たたみ込み内挿法は、衛星画像や航空写真などの連続データに使用するのが最も効果的です。三次たたみ込み内挿法は、共一次内挿法とほぼ同じですが、データのリサンプリングにはより大型のマトリックスが使用されます。

[ピラミッドの圧縮タイプ] には、ピラミッドの圧縮に使用する方法を定義します。

  • デフォルト - ラスタ データセット形式に通常使用される圧縮を使用します。
  • LZ77 - 可逆圧縮。ラスタ内のセルの値は変更されません。
  • JPEG - 非可逆圧縮。
  • なし - データ圧縮なし。
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: ○
7/28/2014