ラスタ データセットの作成（Create Raster Dataset） (データの管理)
サマリ
ファイルとして、またはジオデータベース内にラスタ データセットを作成します。
使用法
-
ラスタ データセットの作成では、単一のラスタ データセットを保持するための空のロケーションを作成することになります。次に、このロケーションへラスタ データセットをモザイク化するか、読み込むことができます。
-
出力は、BIL、BIP、BMP、BSQ、DAT、GIF、GRID、IMG、JPEG、JPEG 2000、PNG、TIFF、または任意のジオデータベース ラスタ データセットに保存することができます。
-
ラスタ データセットを JPEG ファイル、JPEG 2000 ファイル、またはジオデータベースに格納するときに、環境設定で [圧縮] タイプと [圧縮品質] を指定できます。
-
GIF 形式がサポートするのは、シングルバンド ラスタ データセットのみです。
-
ピラミッドを構築すると、ラスタ データセットの表示パフォーマンスが向上します。
-
ArcGIS アプリケーションでは、統計情報の計算によって、ラスタ データを適切なサイズに伸縮させたりシンボル化したりして最適に表示することができます。
構文
| パラメータ | 説明 | データ タイプ |
out_path |
ラスタ データセットが格納される出力先。 | Workspace; Raster Catalog |
out_name |
作成するラスタ データセットの名前。 ラスタ データセットをファイル形式で格納する場合は、ファイル拡張子を指定する必要があります。
ジオデータベースにラスタ データセットを格納する場合、ラスタ データセットの名前にファイル拡張子は付けません。 ラスタ データセットを JPEG ファイル、JPEG 2000 ファイル、TIFF ファイル、またはジオデータベースに格納するときに、圧縮タイプと圧縮品質を指定できます。 | String |
cellsize （オプション） |
新規ラスタ データセットのセル サイズ。 | Double |
pixel_type （オプション） |
セル値のデータ タイプを指定します。デフォルト値は 8 ビット符号なし整数です。 すべてのラスタ形式ですべてのデータ タイプがサポートされるわけではありません。使用する形式が必要なデータ タイプをサポートしているかどうかを確認するには、ヘルプ トピック「サポートされているラスタ データセット ファイル形式」をご参照ください。
| String |
raster_spatial_reference （オプション） |
ラスタ データセットの座標系。 指定されない場合は、環境設定で設定された座標系が使用されます。 | Coordinate system |
number_of_bands （オプション） |
ラスタ データセットに含まれているバンドの数。 | Long |
config_keyword （オプション） |
ファイル ジオデータベースおよび ArcSDE ジオデータベースの格納パラメータ（コンフィグレーション）を指定します。パーソナル ジオデータベースは、コンフィグレーション キーワードを使用しません。 ArcSDE コンフィグレーション キーワードは、データベース管理者によって設定されます。 | String |
pyramids （オプション） |
ピラミッドを作成するには、このオプションを使用します。 [ピラミッド レベル] で、-1 以上の数値を選択します。値が 0 のときは、ピラミッドを構築しません。値が -1 のときは、作成されるピラミッド レイヤの適正数が自動的に選択されます。 [ピラミッド リサンプリング手法] では、ピラミッドの構築時にデータをどのようにリサンプリングするかを定義します。
[ピラミッドの圧縮タイプ] には、ピラミッドの圧縮に使用する方法を定義します。
| Pyramid |
tile_size （オプション） |
タイルの幅は、各タイルに格納できるピクセルの数を制御します。これは、X のピクセル数として指定します。デフォルトのタイル幅は 128 です。 タイルの高さは、各タイルに格納できるピクセルの数を制御します。これは、Y のピクセル数として指定します。デフォルトのタイルの高さは 128 です。 ファイル ジオデータベースと ArcSDE ジオデータベースだけがタイル サイズを使用します。 | Tile Size |
compression （オプション） |
これは、ラスタ データセットを格納するときに使用するデータ圧縮のタイプを指定します。
JPEG および JPEG 2000 圧縮品質は、1 ～ 100 の範囲です。値が大きいほど画像品質が高いことを意味しますが、圧縮度は低くなります。 | Compression |
pyramid_origin （オプション） |
これは、ラスタ ピラミッドの元の位置です。ファイル ジオデータベースまたは ArcSDE ジオデータベース内に大型モザイクを構築する予定がある場合（たとえば、更新の目的で大型モザイクにモザイク化を実行する予定がある場合は特に）、このポイントを指定することをお勧めします。 ピラミッド リファレンス ポイントは、ラスタ データセットの左上隅に設定してください。 このポイントをファイル ジオデータベースまたは ArcSDE ジオデータベース用に設定した場合、新しくモザイクされたラスタ データセットで更新するときに、部分ピラミッド構築が使用されます。 部分ピラミッド構築では、新規にデータセットがモザイク化されたためにピラミッドが存在しない部分に対して更新が行われます。 そのため、ラスタ モザイク全体がこのポイントよりも右下に位置するように、ピラミッド リファレンス ポイントを設定することを推奨します。ただし、ピラミッド リファレンス ポイントを過大なサイズに設定すべきでないことにも注意してください。 | Point |
コードのサンプル
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（ラスタ データセットの作成）ツールの 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()