モザイク データセットにラスターを追加 (Add Rasters To Mosaic Dataset) (データ管理)

概要

ファイル、フォルダー、テーブル、または Web サービスなど多数のソースからモザイク データセットにラスター データセットを追加します。

使用法

  • 追加されたラスター データは管理されません。ラスター データを削除または移動すると、モザイク データセットが影響を受けます。

  • ラスターを追加できる対象は、ジオデータベース内に格納されているモザイク データセットのみです。ジオデータベースの外部で作成されたモザイク データセットには、コンテンツまたは以前に作成したモザイク データセットしか格納できません。

  • [ラスター タイプ] パラメーターは、データをモザイク データセットに読み込むために必要なメタデータを識別します。

    ラスター タイプの詳細

    ラスター タイプは画像プロダクトに固有のタイプです。ラスター タイプにより、ジオリファレンス、取得日、センサー タイプなどのメタデータが、ラスター フォーマットとともに識別されます。

  • [処理テンプレート] オプションには、モザイク データセットに追加されるアイテムに適用する関数と、これらの関数の適用方法および適用順序が含まれています。

  • 表示速度と処理速度を上げるために、[ピクセル キャッシュの有効化] オプションを選択した場合にモザイク データセットのピクセル キャッシュを生成できます。

構文

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,...]

入力ファイル、フォルダー、ラスター データセット、モザイク データセット、テーブル、またはサービスのパスと名前を指定します。

すべての入力オプションを選択できるとは限りません。利用可能なオプションは選択されたラスター タイプによって決まります。

  • DatasetArcGIS 地理データセット (ジオデータベース内のラスター、モザイク データセットなど) またはテーブルを選択します。
  • Folder複数のラスター データセットを入力として含むフォルダーを選択します。フォルダーにサブフォルダーを含めることができます。このオプションは、[サブフォルダーも含む] パラメーターと [入力データ フィルター] パラメーターの設定によって異なります。
  • Fileディスク上のフォルダー、イメージ サービス定義ファイル (*.ISDef)、ラスター プロセス定義ファイル (*.RPDef) に保存されている 1 つ以上のラスター データセットを入力として選択します。 ファイル リストは、追加されているラスター タイプに対応していないファイルを無視します。このオプションは、TIFF ファイルや MrSID ファイルなど、ラスター データセットのファイル形式で使用しないでください。代わりに、[データセット] 入力タイプを使用してください。
  • ServiceWCS、マップ、イメージ サービス、または Web サービスのレイヤー ファイルを入力として選択します。
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 フィールドに書き込まれます。

  • UPDATE_CELL_SIZESモザイク データセット内のすべてのラスターについてセル サイズ範囲を計算します。これがデフォルトです。
  • NO_CELL_SIZESセル サイズ範囲を計算しません。
Boolean
update_boundary
(オプション)

モザイク データセットの境界ポリゴンを生成または更新するかどうかを指定します。デフォルトで、すべてのフットプリント ポリゴンが結合され、有効なピクセル範囲を表す単一の境界線が形成されます。

  • UPDATE_BOUNDARY境界線が生成されるか、更新されます。これがデフォルトです。
  • NO_BOUNDARY境界線を作成または更新しません。
Boolean
update_overviews
(オプション)

モザイク データセットのオーバービューを定義して生成するかどうかを指定します。

  • UPDATE_OVERVIEWSオーバービューを定義して作成します。
  • NO_OVERVIEWSオーバービューの定義および作成を行いません。これがデフォルトです。
Boolean
maximum_pyramid_levels
(オプション)

モザイク データセットで使用するピラミッド レベルの最大数。たとえば、値 2 を入力すると、ソース ラスターの最初の 2 つのピラミッド レベルのみが使用されます。このパラメーターを空白のままにするか、値 -1 を入力すると、すべてのレベルのピラミッドが構築されます。

この値によって、表示だけでなく、生成されるオーバービューの数も影響を受けることがあります。

Long
maximum_cell_size
(オプション)

モザイク データセットで使用するピラミッド セルの最大サイズ。

Double
minimum_dimension
(オプション)

モザイク データセットで使用するラスター ピラミッドの最小ディメンション。

Long
spatial_reference
(オプション)

入力データの空間参照系。

データに座標系が含まれていない場合は指定する必要があります。指定がない場合は、モザイク データセットの座標系が使用されます。入力データの座標系を上書きする目的でも使用できます。

Spatial Reference
filter
(オプション)

モザイク データセットに追加するデータのフィルター。SQL 式を使用して、データ フィルターを作成できます。フィルターのワイルドカードは、入力データの絶対パスに対して機能します。

次の SQL ステートメントは、次のオブジェクト ID に一致する行を選択します。

  • OBJECTID IN (19745, 19680, 19681, 19744, 5932, 5931, 5889, 5890, 14551, 14552, 14590, 14591)

TIFF 画像のみを追加する場合は、ファイル拡張子の前にアスタリスクを追加します。

  • *.TIF

ファイル パスまたはファイル名に「sensor」という語を含む任意の画像を追加する場合は、「sensor」という語の前後にアスタリスクを付けます。

  • *sensor2009*

また、PERL 構文を使用してデータ フィルターを作成することもできます。

  • REGEX:.*1923.*|.*1922.*

  • REGEX:.*192[34567].*|.*194.*|.*195.*

複数の語彙グループを持つ次のような PERL 構文は、式の一部としてサポートされていません。

  • REGEX:.* map_mean_.*(?:(?:[a-z0-9]*)_pptPct_(?:[0-9]|1[0-2]*?)_2[0-9]_*\w*).img

代わりに、次のような構文を使用できます。

  • REGEX:.*map_mean_*[a-z0-9]*_pptPct_([0-9]|1[0-2])_2[0-9]*_\w*.img

String
sub_folder
(オプション)

サブフォルダーを再帰的に検索するかどうかを指定します。

  • SUBFOLDERSすべてのサブフォルダーでデータを探します。これがデフォルトです。
  • NO_SUBFOLDERSトップレベル フォルダーのみでデータを探します。
Boolean
duplicate_items_action
(オプション)

重複するラスターの処理方法を指定します。本来のパスとファイル名を使用して、各ラスターがすでに追加されていないかを確認するチェックを実行します。パスやファイル名の重複が見つかった場合に実行するアクションを選択します。

  • ALLOW_DUPLICATESモザイク データセットにすでに存在する場合でも、すべてのラスターを追加します。これがデフォルトです。
  • EXCLUDE_DUPLICATES重複するラスターは追加されません。
  • OVERWRITE_DUPLICATES重複するラスターで既存のラスターを上書きします。
String
build_pyramids
(オプション)

各ソース ラスターのピラミッドを構築します。

  • NO_PYRAMIDSピラミッドを構築しません。これがデフォルトです。
  • BUILD_PYRAMIDSピラミッドを構築します。
Boolean
calculate_statistics
(オプション)

ソース ラスターごとに統計情報を計算するかどうかを指定します。

  • NO_STATISTICS統計情報は計算されません。これがデフォルトです。
  • CALCULATE_STATISTICS統計情報を計算します。
Boolean
build_thumbnails
(オプション)

ソース ラスターごとにサムネイルを構築するかどうかを指定します。

  • NO_THUMBNAILSサムネイルを構築しません。これがデフォルトです。
  • BUILD_THUMBNAILSサムネイルを構築します。
Boolean
operation_description
(オプション)

ラスター データを追加する操作を表す説明。説明はラスター タイプのテーブルに追加され、後で検索や参照を行うときに利用できます。

String
force_spatial_reference
(オプション)

座標系を指定します。データをモザイク データセットに読み込むときに、すべてのラスターに対して、spatial_reference パラメーターで指定された座標系を使用します。

  • NO_FORCE_SPATIAL_REFERENCEデータを読み込むときに、各ラスター データの座標系を使用します。これがデフォルトです。
  • FORCE_SPATIAL_REFERENCEデータを読み込むときに、各ラスターに対して、spatial_reference パラメーターで指定された座標系を使用します。
Boolean
estimate_statistics
(オプション)

モザイク データセット レベルでレンダリング速度と処理速度を上げるために、モザイク データセットの統計情報を推定するかどうかを指定します。

  • NO_STATISTICS統計情報は推定されません。表示と処理に、モザイク データセット内の各アイテムから生成された統計情報を使用します。これがデフォルトです。
  • ESTIMATE_STATISTICSモザイク データセット レベルの統計情報を推定します。モザイク データセット内のソース アイテムの分布ではなく、モザイク データセットの表示に使用されるピクセルの分布が使用されます。
Boolean
aux_inputs
[aux_inputs,...]
(オプション)

[ラスター タイプ プロパティ] ページで定義するラスター タイプ設定。このパラメーターで定義された設定は、[ラスター タイプ プロパティ] ページで定義された設定に優先します。

Value Table
enable_pixel_cache
(オプション)

モザイク データセットの表示速度と処理速度を上げるために、ピクセル キャッシュを生成するかどうかを指定します。

  • NO_PIXEL_CACHEピクセル キャッシュを生成しません。これがデフォルトです。
  • USE_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 (モザイク データセットにラスターを追加) の例 1 (Python ウィンドウ)

以下は、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 (モザイク データセットにラスターを追加) の例 2 (スタンドアロン スクリプト)

以下は、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: はい

関連トピック