概要
ジオデータベースに空のラスター カタログを作成します。
使用法
ラスター カタログが作成されると、そのカタログにラスター データセットを読み込むことができます。
ラスター カタログは、どのタイプのジオデータベースでも作成できます。
ラスター カタログを作成後、ラスター データセットをカタログに読み込むには、ラスター カタログを右クリックして [データの読み込み] を選択します。また、[ワークスペース → ラスター カタログ (Workspace To Raster Catalog)] ツールを使用してラスター データセットをラスター カタログに読み込むこともできます。
ラスター カタログはジオデータベースの管理下にある場合と、非管理下にある場合があります。ラスター カタログがジオデータベースの中で管理されている場合は、そのラスター カタログ内のラスター データセットが物理的にジオデータベース内に格納されます。カタログからロウまたはラスターを削除すると、そのロウまたはラスターがジオデータベースから削除されます。ラスター カタログが非管理である場合、そのラスター カタログには、ラスター カタログのロウをジオデータベース外部に保存されているラスター データセットに結び付けるリンクまたはポインターのみが含まれることになります。これらのラスター データセットはジオデータベース外部に格納されます。非管理 (Unmanaged) ラスター カタログに読み込まれるラスター データセットはすべてディスク上のファイルでなければなりません。ジオデータベース ラスター データセットは、管理 (Managed) ラスター カタログのみに読み込むことができます。エンタープライズ ジオデータベースに格納されているラスター カタログは常に管理ラスター カタログになります。
空間グリッドサイズが自動的に計算されるように、[ワークスペース → ラスター カタログ (Workspace To Raster Catalog)] ツールを使用してラスター カタログ内のデータを読み込むことをお勧めします。
エンタープライズ ジオデータベースにラスター カタログを作成するときは、ラスター データセットの名前にスペースを使用できません。ラスター データセットの名前内の単語を区切るにはアンダースコアを使用してください。
構文
arcpy.management.CreateRasterCatalog(out_path, out_name, {raster_spatial_reference}, {spatial_reference}, {config_keyword}, {spatial_grid_1}, {spatial_grid_2}, {spatial_grid_3}, {raster_management_type}, {template_raster_catalog})| パラメーター | 説明 | データ タイプ |
out_path | ラスター カタログを格納するジオデータベース。これは任意のタイプのジオデータベースです。 | Workspace |
out_name | 作成するラスター カタログの名前。 | String |
raster_spatial_reference (オプション) | ラスター カタログのラスター列の座標系。 ラスター列の空間参照はデータの読み込みの間に、次のような目的で使用されます。
デフォルト値は、ジオプロセシング環境に設定された座標系です。 | Coordinate System |
spatial_reference (オプション) | ジオメトリ列の座標系。 ジオメトリ列の空間参照は、ラスター データセットのフットプリントの空間参照を指定します。 デフォルト値は、ジオプロセシング環境に設定された座標系です。 | Spatial Reference |
config_keyword (オプション) | ジオデータベースの格納パラメーター (コンフィグレーション) を指定します。コンフィグレーション キーワードは、データベース管理者によって設定されます。 | String |
spatial_grid_1 (オプション) | spatial_grid_1、spatial_grid_2、およびspatial_grid_3 パラメーターは、空間インデックスを計算し、ファイル ジオデータベースとエンタープライズ ジオデータベースのみに適用するために使用します。グリッド サイズの設定について詳しく知らない場合は、これらのオプションの値を 0,0,0 のままにしておくと、最適なグリッド サイズが ArcGIS によって自動的に計算されます。 デフォルトの空間グリッド インデックス (0) を使用する場合は、[ワークスペース → ラスター カタログ (Workspace To Raster Catalog)] ツールを使用してデータを読み込むことをお勧めします。このツールを使用してラスター データセットを読み込むと、空間グリッド サイズが自動的に計算されます。別のツールを使用してラスター データセットをラスター カタログに読み込む場合は、読み込み完了後に [デフォルト空間グリッド インデックスを計算 (Calculate Default Spatial Grid Index)] ツールを使用する必要があります。 このパラメーターの詳細については、[空間インデックスの追加 (Add Spatial Index)] ツールのドキュメントをご参照ください。 | Double |
spatial_grid_2 (オプション) | 2 つ目の空間グリッドのセル サイズ。1 グリッドだけ必要な場合は、このサイズを 0 のままにしておきます。それ以外の場合は、[空間グリッド 1] の 3 倍以上のサイズを設定します。 | Double |
spatial_grid_3 (オプション) | 3 つ目の空間グリッドのセル サイズ。2 グリッドだけ必要な場合は、このサイズを 0 のままにしておきます。それ以外の場合は、[空間グリッド 2] の 3 倍以上のサイズを設定します。 | Double |
raster_management_type (オプション) | ラスター カタログ内のラスター データセットは、(ジオデータベースで) 管理する方法と管理しない方法の 2 通りの方法で管理できます。
| String |
template_raster_catalog [template_raster_catalog,...] (オプション) | テンプレートに基づいて新しいラスター カタログを作成する場合は、テンプレート ラスター カタログを指定することができます。新しいラスター カタログはテンプレート ラスター カタログと同じフィールドで構成されます。 | Raster Catalog Layer |
コードのサンプル
CreateRasterCatalog (ラスター カタログの作成) の例 1 (Python ウィンドウ)
以下は、CreateRasterCatalog ツールを実行する Python サンプルです。
import arcpy
arcpy.CreateRasterCatalog_management("c:/data/CreateRC.gdb", "fgdb_unman",
"Albers_Conical.prj", "Albers_Conical.prj",
"MAX_FILE_SIZE_4GB", "1000", "3000", "9000",
"UNMANAGED", "")
CreateRasterCatalog (ラスター カタログの作成) の例 2 (スタンドアロン スクリプト)
以下は、CreateRasterCatalog ツールを実行する Python スクリプト サンプルです。
##========================
##Create Raster Catalog
##Usage: CreateRasterCatalog_management out_path out_name {raster_spatial_reference} {spatial_reference} {config_keyword}
## {spatial_grid_1} {spatial_grid_2} {spatial_grid_3} {MANAGED | UNMANAGED}
## {template_raster_catalog;template_raster_catalog...}
try:
import arcpy
arcpy.env.workspace = r"C:\PrjWorkspace"
##Create PGDB Unmanaged Raster Catalog
arcpy.CreateRasterCatalog_management("CreateRC.mdb", "Unmanaged", "Albers_Conical.prj", "Albers_Conical.prj", "", "12000", "", "", \
"UNMANAGED", "")
##Create FGDB Unmanaged Raster Catalog
arcpy.CreateRasterCatalog_management("CreateRC.gdb", "Unmanaged", "Albers_Conical.prj", "Albers_Conical.prj", "MAX_FILE_SIZE_4GB", \
"1000", "3000", "9000", "UNMANAGED", "")
##Create Managed Enterprise Raster Catalog with FGDB template
arcpy.CreateRasterCatalog_management("SDE94.sde", "Managed", "Albers_Conical.prj", "Albers_Conical.prj", "DEFAULTS","2000", "6000", \
"18000", "MANAGED", "CreateRC.mdb\\Unmanaged;CreateRC.gdb\\Unmanaged")
except:
print "Create Raster Catalog example failed."
print arcpy.GetMessages()
環境
ライセンス情報
- Basic: はい
- Standard: はい
- Advanced: はい