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

サマリー

空のラスター データセットを作成します。

使用法

  • ラスター データセットの作成では、単一のラスター データセットを保持するための空のロケーションを作成することになります。 次に、このロケーションへラスター データセットをモザイク化するか、読み込むことができます。

  • 出力は、BIL、BIP、BMP、BSQ、CRF、DAT、Esri Grid、GIF、IMG、JPEG、JPEG 2000、PNG、TIFF の各形式、または任意のジオデータベース ラスター データセットに保存することができます。

  • ラスター データセットを JPEG 形式のファイル、JPEG 2000 形式のファイル、またはジオデータベースに格納するときに、ジオプロセシング環境内で [圧縮タイプ] の値と [圧縮品質] の値を指定できます。

  • GIF 形式がサポートするのは、シングルバンド ラスター データセットのみです。

  • CRF 形式で作成されたラスター データセットは拡張可能です。 拡張可能な CRF データセットの範囲は、CRF を入力として使用できる他のツール ([モザイク (Mosaic)][ラスターのコピー (Copy Raster)][ラスターのクリップ (Clip Rasters)][リサンプル (Resample)] ツールなど) によって自動的に調整されます。

  • 拡張可能な CRF データセットは多次元ラスターをサポートしています。 [モザイク (Mosaic)] ツールを使用して多次元データを空のラスター データセットに追加すると、拡張可能な多次元ラスターが作成されます。 次の例に示すように、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] - 衛星画像や航空写真などの連続データには、三次たたみ込み内挿法を使用します。 三次たたみ込み内挿法は、共一次内挿法とほぼ同じですが、データのリサンプリングにはより大型のマトリックスが使用されます。

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

  • デフォルト - ラスター データセット形式に通常使用される圧縮が使用されます。
  • LZ77 - 可逆圧縮が使用されます。 ラスター内のセルの値は変更されません。
  • JPEG - 非可逆圧縮が使用されます。
  • なし - データ圧縮は使用されません。
Pyramid
タイル サイズ
(オプション)

タイルのサイズ。

タイルの幅は、各タイルに格納できるピクセルの数を制御します。 これは、X 方向のピクセル数として指定します。 デフォルトのタイルの幅は 128 です。

タイルの高さは、各タイルに格納できるピクセルの数を制御します。 これは、Y 方向のピクセル数として指定します。 デフォルトのタイルの高さは 128 です。

ジオデータベースとエンタープライズ ジオデータベースだけがタイル サイズを使用します。

Tile Size
圧縮
(オプション)

ラスター データセットを格納するときに使用する圧縮のタイプを指定します。

  • なし圧縮を使用しません。 これがデフォルトです。
  • LZ77すべてのラスター セル値を維持する可逆圧縮が使用されます。
  • JPEG公開されている JPEG 圧縮アルゴリズムを使用する非可逆圧縮が使用されます。 JPEG を選択した場合は、圧縮品質も指定できます。 有効な圧縮品質の値の範囲は 0 〜 100 です。 この圧縮方式は、*.jpg ファイルおよび *.tif ファイルに使用できます。
  • JPEG 2000非可逆圧縮が使用されます。
  • LZWすべてのラスター セル値を維持する可逆圧縮が使用されます。
  • PackbitsPackBits 圧縮方式が、*.tif ファイルに使用されます。
  • RLEランレングス エンコーディングが *.img ファイルに使用されます。
  • CCITT Group 31 ビット データ用の可逆圧縮が使用されます。
  • CCITT Group 41 ビット データ用の可逆圧縮が使用されます。
  • CCITT 1D1 ビット データ用の可逆圧縮が使用されます。
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 - 衛星画像や航空写真などの連続データには、三次たたみ込み内挿法を使用します。 三次たたみ込み内挿法は、共一次内挿法とほぼ同じですが、データのリサンプリングにはより大型のマトリックスが使用されます。

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

  • デフォルト - ラスター データセット形式に通常使用される圧縮が使用されます。
  • LZ77 - 可逆圧縮が使用されます。 ラスター内のセルの値は変更されません。
  • JPEG - 非可逆圧縮が使用されます。
  • なし - データ圧縮は使用されません。
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 31 ビット データ用の可逆圧縮が使用されます。
  • CCITT GROUP 41 ビット データ用の可逆圧縮が使用されます。
  • CCITT_1D1 ビット データ用の可逆圧縮が使用されます。
  • 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")

関連トピック