概要
空のラスター データセットを作成します。
使用法
ラスター データセットの作成では、単一のラスター データセットを保持するための空のロケーションを作成することになります。次に、このロケーションへラスター データセットをモザイク化するか、読み込むことができます。
出力は、BIL、BIP、BMP、BSQ、DAT、Esri Grid、GIF、IMG、JPEG、JPEG 2000、PNG、TIFF、MRF、CRF、または任意のジオデータベース ラスター データセットに保存することができます。
ラスター データセットを JPEG ファイル、JPEG 2000 ファイル、またはジオデータベースに格納するときに、[環境] 内で [圧縮タイプ] と [圧縮品質] を指定できます。
GIF 形式がサポートするのは、シングルバンド ラスター データセットのみです。
ピラミッドを構築すると、ラスター データセットの表示パフォーマンスが向上します。
ArcGIS アプリケーションでは、統計情報の計算によって、ラスター データを適切なサイズに伸縮させたりシンボル化したりして最適に表示することができます。
構文
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; 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 (オプション) | ファイル ジオデータベースおよびエンタープライズ ジオデータベースの格納パラメーター (コンフィグレーション) を指定します。コンフィグレーション キーワードは、データベース管理者によって設定されます。 | String |
pyramids (オプション) | ピラミッドを作成します。 [ピラミッド レベル] で、-1 以上の数値を指定します。値が 0 のときは、ピラミッドを構築しません。値が -1 のときは、作成されるピラミッド レイヤーの適正数が自動的に決定されます。 [ピラミッド リサンプリング手法] では、ピラミッドの構築時にデータをどのようにリサンプルするかを定義します。
[ピラミッドの圧縮タイプ] には、ピラミッドの圧縮に使用する方法を定義します。
| Pyramid |
tile_size (オプション) | タイルのサイズを指定します。 タイルの幅は、各タイルに格納できるピクセルの数を制御します。これは、X 方向のピクセル数として指定します。デフォルトのタイル幅は 128 です。 タイルの高さは、各タイルに格納できるピクセルの数を制御します。これは、Y のピクセル数として指定します。デフォルトのタイルの高さは 128 です。 ジオデータベースとエンタープライズ ジオデータベースだけがタイル サイズを使用します。 | Tile Size |
compression (オプション) | ラスター データセットを格納する際の圧縮タイプを定義します。
| Compression |
pyramid_origin (オプション) | ラスター ピラミッドの元の位置。ファイル ジオデータベースまたはエンタープライズ ジオデータベース内に大規模なモザイクを構築する場合、特にそれらにモザイクを実行する (データ更新の場合など) ことを想定している場合は、このポイントを指定することをお勧めします。 ピラミッド リファレンス ポイントは、ラスター データセットの左上隅に設定してください。 このポイントをファイル ジオデータベースまたはエンタープライズ ジオデータベース用に設定した場合、新しくモザイクされたラスター データセットで更新するときに、部分ピラミッド構築が使用されます。部分ピラミッド構築では、新規にデータセットがモザイクされたことによりピラミッドが欠損している部分に対して更新が行われます。そのため、ラスター モザイク全体がこのポイントよりも右下に位置するように、ピラミッド リファレンス ポイントを設定することを推奨します。ただし、ピラミッド リファレンス ポイントを過大なサイズに設定すべきでないことにも注意してください。 | Point |
派生した出力
名前 | 説明 | データ タイプ |
out_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: はい