モザイク データセットからラスターを削除 (Remove Rasters From Mosaic Dataset) (データ管理)

サマリー

選択したラスターをモザイク データセットから削除します。

使用法

• 必ず選択を行うか、クエリを定義してください。そうしないと、ツールが実行されません。 モザイク データセットからすべてのレコードを削除するには、すべてのラスターを選択するクエリを "OBJECTID>=0" のように指定してください。

• モザイク データセット内に生成されたオーバービューは、モザイク データセットによって管理されているため、削除操作を実行すると、ディスクからも削除されます。 オーバービューをフォルダー内またはデフォルト以外の場所に作成した場合、モザイク データセットによって完全には管理されないため、オーバービューをモザイク データセットからは削除しつつも、作成した場所には残しておく、ということが可能になります。 オーバービューを他の場所で使用する場合に適しています。

• 影響を受けるオーバービューを識別して、削除はしないでおく場合は、[オーバービューの構築 (Build Overviews)] ツールを使用して、影響を受けるオーバービューを再生成することができます。

• このツールは、モザイク データセットのアイテムごとに作成されたキャッシュも削除します。 ラスター キャッシュと LAS キャッシュの両方が削除されます。 これらのデータセットのキャッシュのプロパティは、データセットの関数で定義されます。

• データベースの断片化や頻繁なデータ操作によって、モザイク データセットのサイズが大幅に増加する場合があります。 データベースのサイズが、絶え間ないトランザクションによって大きくなった場合、[コンパクト (Compact)] ツールを実行してください。

パラメーター

ダイアログ

ラベル	説明	データ タイプ
モザイク データセット	削除するラスターが含まれるモザイク データセット。	Mosaic Layer
クエリ定義 (オプション)	モザイク データセットから削除するラスター データセットを選択する SQL 式。 必ず選択を行うか、クエリを指定してください。そうしないと、ツールが実行されません。 モザイク データセットからすべてのレコードを削除するには、すべてのラスターを選択するクエリを "OBJECTID>=0" のように指定してください。	SQL Expression
境界線の更新 (オプション)	モザイク データセットの境界ポリゴンを更新するかどうかを指定します。 デフォルトで、すべてのフットプリント ポリゴンが結合され、有効なピクセル範囲を表す単一の境界線が形成されます。 オン - モザイク データセットの境界ポリゴンを更新します。 これがデフォルトです。 オフ - モザイク データセットの境界ポリゴンを更新しません。	Boolean
影響されるオーバービューをマーク (オプション)	影響を受けるオーバービューを識別するかどうかを指定します。 モザイク データセット内のラスターを削除してしまうと、ラスターを使用して作成されたオーバービューは、正確でなくなることがあります。 このパラメーターを使用して影響を受けるオーバービューを識別することで、不要になったオーバービューを更新または削除できます。 オン - 影響を受けるオーバービューを識別します。 これがデフォルトです。 オフ - 影響を受けるオーバービューを識別しません。	Boolean
オーバービュー イメージを削除 (オプション)	選択したラスターに関連付けられているオーバービューを削除するかどうかを指定します。 オン - 選択したラスターに関連付けられているオーバービューを削除します。 これがデフォルトです。 オフ - 選択したラスターに関連付けられているオーバービューを削除しません。	Boolean
アイテム キャッシュを削除 (オプション)	モザイク データセットから削除されるソース ラスター データセットに基づくキャッシュも削除するかどうかを指定します。 オン - モザイク データセットから削除されるソース ラスター データセットに基づくキャッシュも削除します。 これがデフォルトです。 オフ - キャッシュは削除されず、モザイク データセットの一部として維持されます。	Boolean
モザイク データセット アイテムの削除 (オプション)	モザイク データセットのアイテムを削除するかどうかを指定します。 オン - モザイク データセットのアイテムを削除します。 これがデフォルトです。 オフ - モザイク データセットのアイテムを削除しません。	Boolean
セル サイズ範囲の更新 (オプション)	モザイク データセットのセル サイズ範囲を更新するかどうかを指定します。 オン - モザイク データセットのセル サイズ範囲を更新します。 これがデフォルトです。 オフ - モザイク データセットのセル サイズ範囲を更新しません。	Boolean

派生した出力

ラベル	説明	データ タイプ
更新されたモザイク データセット	更新されたモザイク データセット。	Mosaic Layer

Python

arcpy.management.RemoveRastersFromMosaicDataset(in_mosaic_dataset, {where_clause}, {update_boundary}, {mark_overviews_items}, {delete_overview_images}, {delete_item_cache}, {remove_items}, {update_cellsize_ranges})

名前	説明	データ タイプ
in_mosaic_dataset	削除するラスターが含まれるモザイク データセット。	Mosaic Layer
where_clause (オプション)	モザイク データセットから削除するラスター データセットを選択する SQL 式。 必ず選択を行うか、クエリを指定してください。そうしないと、ツールが実行されません。 モザイク データセットからすべてのレコードを削除するには、すべてのラスターを選択するクエリを "OBJECTID>=0" のように指定してください。	SQL Expression
update_boundary (オプション)	モザイク データセットの境界ポリゴンを更新するかどうかを指定します。 デフォルトで、すべてのフットプリント ポリゴンが結合され、有効なピクセル範囲を表す単一の境界線が形成されます。 UPDATE_BOUNDARY—モザイク データセットの境界ポリゴンを更新します。 これがデフォルトです。 NO_BOUNDARY—モザイク データセットの境界ポリゴンを更新しません。	Boolean
mark_overviews_items (オプション)	影響を受けるオーバービューを識別するかどうかを指定します。 モザイク データセット内のラスターを削除してしまうと、ラスターを使用して作成されたオーバービューは、正確でなくなることがあります。 このパラメーターを使用して影響を受けるオーバービューを識別することで、不要になったオーバービューを更新または削除できます。 MARK_OVERVIEW_ITEMS—影響を受けるオーバービューを識別します。 これがデフォルトです。 NO_MARK_OVERVIEW_ITEMS—影響を受けるオーバービューを識別しません。	Boolean
delete_overview_images (オプション)	選択したラスターに関連付けられているオーバービューを削除するかどうかを指定します。 DELETE_OVERVIEW_IMAGES—選択したラスターに関連付けられているオーバービューを削除します。 これがデフォルトです。 NO_DELETE_OVERVIEW_IMAGES—選択したラスターに関連付けられているオーバービューを削除しません。	Boolean
delete_item_cache (オプション)	モザイク データセットから削除されるソース ラスター データセットに基づくキャッシュも削除するかどうかを指定します。 DELETE_ITEM_CACHE—モザイク データセットから削除されるソース ラスター データセットに基づくキャッシュも削除します。 これがデフォルトです。 NO_DELETE_ITEM_CACHE—キャッシュは削除されず、モザイク データセットの一部として維持されます。	Boolean
remove_items (オプション)	モザイク データセットのアイテムを削除するかどうかを指定します。 REMOVE_MOSAICDATASET_ITEMS—モザイク データセットのアイテムを削除します。 これがデフォルトです。 NO_REMOVE_MOSAICDATASET_ITEMS—モザイク データセットのアイテムを削除しません。	Boolean
update_cellsize_ranges (オプション)	モザイク データセットのセル サイズ範囲を更新するかどうかを指定します。 UPDATE_CELL_SIZES—モザイク データセットのセル サイズ範囲を更新します。 特定のセル サイズですべての画像を削除する場合は、このオプションを使用します。 これがデフォルトです。 NO_CELL_SIZES—モザイク データセットのセル サイズ範囲を更新しません。	Boolean

派生した出力

名前	説明	データ タイプ
out_mosaic_dataset	更新されたモザイク データセット。	Mosaic Layer

コードのサンプル

RemoveRastersFromMosaicDataset の例 1 (Python ウィンドウ)

以下は、RemoveRastersFromMosaicDataset 関数を実行する Python サンプルです。

import arcpy
arcpy.RemoveRastersFromMosaicDataset_management(
     "C:/Workspace/remove.gdb/md", "YEAR<1999", "UPDATE_BOUNDARY", 
     "MARK_OVERVIEW_ITEMS",  "#", "#", "#", "#")

RemoveRastersFromMosaicDataset の例 2 (スタンドアロン スクリプト)

以下は、RemoveRastersFromMosaicDataset 関数を実行する Python スクリプト サンプルです。

#Delete Overviews with Query

import arcpy
arcpy.env.workspace = "C:/Workspace"

mdname = "remove.gdb/md2"
query = "#"
updatebnd = "#"
markovr = "#"
delovr = "DELETE_OVERVIEW_IMAGES"
delitemcache = "#"
removeitem = "NO_REMOVE_MOSAICDATASET_ITEMS"
updatecs = "UPDATE_CELL_SIZES"

arcpy.RemoveRastersFromMosaicDataset_management(
     mdname, query, updatebnd, markovr, delovr, delitemcache, 
     removeitem, updatecs)

環境

範囲, 並列処理ファクター