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

サマリー

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

使用法

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

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

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

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

  • ピラミッドを構築すると、ラスター データセットの表示パフォーマンスが向上します。

  • ArcGIS アプリケーションでは、統計情報の計算によって、ラスター データを適切なサイズに伸縮させたりシンボル化したりして最適に表示することができます。

パラメーター

ラベル説明データ タイプ
出力場所

ラスター データセットが格納されるフォルダーまたはジオデータベース。

Workspace
ラスター データセット名 (拡張子)

作成するデータセットの名前、場所、および形式。

ラスター データセットをファイル形式で格納する場合は、ファイル拡張子を指定する必要があります。

  • 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
セル サイズ
(オプション)

新規ラスター データセットのセル サイズ。

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 のときは、作成されるピラミッド レイヤーの適正数が自動的に決定されます。

[ピラミッド リサンプリング手法] では、ピラミッドの構築時にデータをどのようにリサンプルするかを定義します。

  • 最近隣内挿法 - 最近隣内挿法は、土地利用などの不連続データや疑似カラー画像などのカラーマップ付きのラスター データセットに使用します。
  • 共一次内挿法 - 共一次内挿法は、衛星画像や航空写真などの連続データに使用するのが最も効果的です。
  • 三次たたみ込み内挿法 - 三次たたみ込み内挿法は、衛星画像や航空写真などの連続データに使用するのが最も効果的です。 三次たたみ込み内挿法は、共一次内挿法とほぼ同じですが、データのリサンプリングにはより大型のマトリックスが使用されます。

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

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

タイルのサイズを指定します。

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

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

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

Tile Size
圧縮
(オプション)

ラスター データセットを格納する際の圧縮タイプを指定します。

  • None圧縮は行われません。 これがデフォルトです。
  • LZ77すべてのラスター セル値を維持する可逆圧縮。
  • JPEG公開されている JPEG 圧縮アルゴリズムを使用する非可逆圧縮方式。 JPEG を選択した場合は、圧縮品質も指定できます。 有効な圧縮品質の値の範囲は 0 〜 100 です。 この圧縮方式は、JPEG ファイルおよび TIFF ファイルに使用できます。
  • JPEG 2000非可逆圧縮。
  • LZWすべてのラスター セル値を維持する可逆圧縮。
  • PackbitsTIFF ファイル用の PackBits 圧縮。
  • RLEIMG ファイル用のランレングス エンコーディング。
  • 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
  • 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_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
(オプション)

ファイル ジオデータベースおよびエンタープライズ ジオデータベースの格納パラメーター (コンフィグレーション) を指定します。 コンフィグレーション キーワードは、データベース管理者によって設定されます。

String
pyramids
(オプション)

ピラミッドを作成します。

[ピラミッド レベル] で、-1 以上の数値を指定します。 値が 0 のときは、ピラミッドを構築しません。値が -1 のときは、作成されるピラミッド レイヤーの適正数が自動的に決定されます。

[ピラミッド リサンプリング手法] では、ピラミッドの構築時にデータをどのようにリサンプルするかを定義します。

  • 最近隣内挿法 - 最近隣内挿法は、土地利用などの不連続データや疑似カラー画像などのカラーマップ付きのラスター データセットに使用します。
  • 共一次内挿法 - 共一次内挿法は、衛星画像や航空写真などの連続データに使用するのが最も効果的です。
  • 三次たたみ込み内挿法 - 三次たたみ込み内挿法は、衛星画像や航空写真などの連続データに使用するのが最も効果的です。 三次たたみ込み内挿法は、共一次内挿法とほぼ同じですが、データのリサンプリングにはより大型のマトリックスが使用されます。

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

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

タイルのサイズを指定します。

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

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

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

Tile Size
compression
(オプション)

ラスター データセットを格納する際の圧縮タイプを指定します。

  • LZ77すべてのラスター セル値を維持する可逆圧縮。
  • JPEG公開されている JPEG 圧縮アルゴリズムを使用する非可逆圧縮方式。 JPEG を選択した場合は、圧縮品質も指定できます。 有効な圧縮品質の値の範囲は 0 〜 100 です。 この圧縮方式は、JPEG ファイルおよび TIFF ファイルに使用できます。
  • JPEG 2000非可逆圧縮。
  • PACKBITSTIFF ファイル用の PackBits 圧縮。
  • LZWすべてのラスター セル値を維持する可逆圧縮。
  • RLEIMG ファイル用のランレングス エンコーディング。
  • 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")

ライセンス情報

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

関連トピック