概要
ファイル、フォルダー、テーブル、または Web サービスなど多数のソースからモザイク データセットにラスター データセットを追加します。
使用法
追加されたラスター データは管理されません。ラスター データを削除または移動すると、モザイク データセットが影響を受けます。
ラスターを追加できる対象は、ジオデータベース内に格納されているモザイク データセットのみです。ジオデータベースの外部で作成されたモザイク データセットには、コンテンツまたは以前に作成したモザイク データセットしか格納できません。
[ラスター タイプ] パラメーターは、データをモザイク データセットに読み込むために必要なメタデータを識別します。
ラスター タイプは画像プロダクトに固有のタイプです。ラスター タイプにより、ジオリファレンス、取得日、センサー タイプなどのメタデータが、ラスター フォーマットとともに識別されます。
[処理テンプレート] オプションには、モザイク データセットに追加されるアイテムに適用する関数と、これらの関数の適用方法および適用順序が含まれています。
表示速度と処理速度を上げるために、[ピクセル キャッシュの有効化] オプションを選択した場合にモザイク データセットのピクセル キャッシュを生成できます。
構文
arcpy.management.AddRastersToMosaicDataset(in_mosaic_dataset, raster_type, input_path, {update_cellsize_ranges}, {update_boundary}, {update_overviews}, {maximum_pyramid_levels}, {maximum_cell_size}, {minimum_dimension}, {spatial_reference}, {filter}, {sub_folder}, {duplicate_items_action}, {build_pyramids}, {calculate_statistics}, {build_thumbnails}, {operation_description}, {force_spatial_reference}, {estimate_statistics}, {aux_inputs}, {enable_pixel_cache}, {cache_location})| パラメーター | 説明 | データ タイプ |
in_mosaic_dataset | ラスター データを追加する対象となるモザイク データセットのパスと名前 | Mosaic Layer |
raster_type | ラスター タイプは画像プロダクトに固有のタイプです。ラスター タイプにより、ジオリファレンス、取得日、センサー タイプなどのメタデータが、ラスター フォーマットとともに識別されます。 サポートされるセンサーとラスター タイプのリストについては、「サポートされているセンサーのリスト」をご参照ください。 LAS、LAS データセット、またはテレインのラスター タイプを使用している場合は、セル サイズを指定するときに *.art ファイルを使用する必要があります。 | Raster Type |
input_path [input_path,...] | 入力ファイル、フォルダー、ラスター データセット、モザイク データセット、テーブル、またはサービスのパスと名前を指定します。 すべての入力オプションを選択できるとは限りません。利用可能なオプションは選択されたラスター タイプによって決まります。
| File; Image Service; LAS Dataset Layer; Layer File; MapServer; Mosaic Layer; Raster Layer; Table View; Terrain Layer; WCS Coverage; WMS Map; Workspace |
update_cellsize_ranges (オプション) | モザイク データセット内の各ラスターのセル サイズ範囲を計算するかどうかを指定します。この値は、属性テーブルの minPS フィールドと maxPS フィールドに書き込まれます。
| Boolean |
update_boundary (オプション) | モザイク データセットの境界ポリゴンを生成または更新するかどうかを指定します。デフォルトで、すべてのフットプリント ポリゴンが結合され、有効なピクセル範囲を表す単一の境界線が形成されます。
| Boolean |
update_overviews (オプション) | モザイク データセットのオーバービューを定義して生成するかどうかを指定します。
| Boolean |
maximum_pyramid_levels (オプション) | モザイク データセットで使用するピラミッド レベルの最大数。たとえば、値 2 を入力すると、ソース ラスターの最初の 2 つのピラミッド レベルのみが使用されます。このパラメーターを空白のままにするか、値 -1 を入力すると、すべてのレベルのピラミッドが構築されます。 この値によって、表示だけでなく、生成されるオーバービューの数も影響を受けることがあります。 | Long |
maximum_cell_size (オプション) | モザイク データセットで使用するピラミッド セルの最大サイズ。 | Double |
minimum_dimension (オプション) | モザイク データセットで使用するラスター ピラミッドの最小ディメンション。 | Long |
spatial_reference (オプション) | 入力データの空間参照系。 データに座標系が含まれていない場合は指定する必要があります。指定がない場合は、モザイク データセットの座標系が使用されます。入力データの座標系を上書きする目的でも使用できます。 | Spatial Reference |
filter (オプション) | モザイク データセットに追加するデータのフィルター。SQL 式を使用して、データ フィルターを作成できます。フィルターのワイルドカードは、入力データの絶対パスに対して機能します。 次の SQL ステートメントは、次のオブジェクト ID に一致する行を選択します。
TIFF 画像のみを追加する場合は、ファイル拡張子の前にアスタリスクを追加します。
ファイル パスまたはファイル名に「sensor」という語を含む任意の画像を追加する場合は、「sensor」という語の前後にアスタリスクを付けます。
また、PERL 構文を使用してデータ フィルターを作成することもできます。
複数の語彙グループを持つ次のような PERL 構文は、式の一部としてサポートされていません。
代わりに、次のような構文を使用できます。
| String |
sub_folder (オプション) | サブフォルダーを再帰的に検索するかどうかを指定します。
| Boolean |
duplicate_items_action (オプション) | 重複するラスターの処理方法を指定します。本来のパスとファイル名を使用して、各ラスターがすでに追加されていないかを確認するチェックを実行します。パスやファイル名の重複が見つかった場合に実行するアクションを選択します。
| String |
build_pyramids (オプション) | 各ソース ラスターのピラミッドを構築します。
| Boolean |
calculate_statistics (オプション) | ソース ラスターごとに統計情報を計算するかどうかを指定します。
| Boolean |
build_thumbnails (オプション) | ソース ラスターごとにサムネイルを構築するかどうかを指定します。
| Boolean |
operation_description (オプション) | ラスター データを追加する操作を表す説明。説明はラスター タイプのテーブルに追加され、後で検索や参照を行うときに利用できます。 | String |
force_spatial_reference (オプション) | 座標系を指定します。データをモザイク データセットに読み込むときに、すべてのラスターに対して、spatial_reference パラメーターで指定された座標系を使用します。
| Boolean |
estimate_statistics (オプション) | モザイク データセット レベルでレンダリング速度と処理速度を上げるために、モザイク データセットの統計情報を推定するかどうかを指定します。
| Boolean |
aux_inputs [aux_inputs,...] (オプション) | [ラスター タイプ プロパティ] ページで定義するラスター タイプ設定。このパラメーターで定義された設定は、[ラスター タイプ プロパティ] ページで定義された設定に優先します。 | Value Table |
enable_pixel_cache (オプション) | モザイク データセットの表示速度と処理速度を上げるために、ピクセル キャッシュを生成するかどうかを指定します。
| Boolean |
cache_location (オプション) | ピクセル キャッシュが格納される場所。格納先を定義しないと、キャッシュが C:\Users\<Username>\AppData\Local\ESRI\rasterproxies\ に書き込まれます。 格納先を定義しておくと、新しいラスターをモザイク データセットに追加する際にパスを再定義する必要がなくなります。新しいデータを追加する際に [ピクセル キャッシュの有効化] パラメーター (Python では enable_pixel_cache = "USE_PIXEL_CACHE") を確認するだけで済みます。 | Folder; String |
派生した出力
| 名前 | 説明 | データ タイプ |
| out_mosaic_dataset | 更新されたモザイク データセット。 | モザイク レイヤー |
コードのサンプル
以下は、AddRastersToMosaicDataset ツールを実行する Python サンプルです。
import arcpy
arcpy.AddRastersToMosaicDataset_management(
"c:/data/AddMD.gdb/md_landsat", "Landsat 7 ETM+",
"c:/data/landsat7etm", "UPDATE_CELL_SIZES", "UPDATE_BOUNDARY",
"UPDATE_OVERVIEWS", "2", "#", "#", "GCS_WGS_1984.prj",
"*.tif", "SUBFOLDERS", "EXCLUDE_DUPLICATES",
"NO_PYRAMIDS", "NO_STATISTICS", "BUILD_THUMBNAILS",
"Add Landsat L1G", "FORCE_SPATIAL_REFERENCE",
"NO_STATISTICS", "", "USE_PIXEL_CACHE",
r"C:\test\cachelocation")以下は、AddRastersToMosaicDataset ツールを実行する Python スクリプト サンプルです。
#Add Raster Dataset type Raster to FGDB Mosaic Dataset
#Calculate Cell Size Ranges and Build Boundary
#Build Overviews for Mosaic Dataset upon the 3rd level Raster Dataset pyramid
#Apply TIFF file filter
#Build Pyramids for the source datasets
import arcpy
arcpy.env.workspace = "C:/Workspace"
mdname = "AddMD.gdb/md_rasds"
rastype = "Raster Dataset"
inpath = "c:/data/rasds"
updatecs = "UPDATE_CELL_SIZES"
updatebnd = "UPDATE_BOUNDARY"
updateovr = "UPDATE_OVERVIEWS"
maxlevel = "2"
maxcs = "#"
maxdim = "#"
spatialref = "#"
inputdatafilter = "*.tif"
subfolder = "NO_SUBFOLDERS"
duplicate = "EXCLUDE_DUPLICATES"
buildpy = "BUILD_PYRAMIDS"
calcstats = "CALCULATE_STATISTICS"
buildthumb = "NO_THUMBNAILS"
comments = "Add Raster Datasets"
forcesr = "#"
estimatestats = "ESTIMATE_STATISTICS"
auxilaryinput = ""
enablepixcache = "USE_PIXEL_CACHE"
cachelocation = "c:\\test\\cachelocation"
arcpy.AddRastersToMosaicDataset_management(
mdname, rastype, inpath, updatecs, updatebnd, updateovr,
maxlevel, maxcs, maxdim, spatialref, inputdatafilter,
subfolder, duplicate, buildpy, calcstats,
buildthumb, comments, forcesr, estimatestats
auxilaryinput, enablepixcache, cachelocation)環境
ライセンス情報
- Basic: いいえ
- Standard: はい
- Advanced: はい