モザイク データセットからラスタを削除(Remove Rasters From Mosaic Dataset) (データの管理)
サマリ
モザイク データセットから選択したラスタ(アイテム)を削除します。
使用法
必ず選択を行うか、クエリを指定してください。そうしないと、ツールが実行されません。モザイク データセットからすべてのレコードを削除したい場合、すべてのラスタを選択するクエリを"OBJECTID>=0"のように指定してください。
-
オーバービューを、モザイク データセットからは削除し、ディスクからは削除しないでおくことも可能です。モザイク データセット内に生成されたオーバービューは、モザイク データセットによって管理されているため、削除操作を実行すると、ディスクからも削除されます。オーバービューをフォルダ内またはデフォルト以外の場所に作成した場合、モザイク データセットによって完全には管理されません。そのため、オーバービューをモザイク データセットからは削除しつつも、作成した場所には残しておく、ということが可能になります。オーバービューをどこか他の場所で使用している場合は、このようにしてオーバービューを保持しておくとよいでしょう。
影響を受けるオーバービューをマークして、削除はしないでおく場合は、[オーバービューの構築(Build Overviews)] ツールを使用して、影響を受けるオーバービューを再生成するとよいでしょう。
このツールは、モザイク データセットのアイテムごとに作成されたキャッシュも削除します。ラスタ キャッシュと LAS キャッシュの両方が削除されます。これらのデータセットのキャッシュのプロパティは、データセットの関数で定義されます。
このツールはモザイク データセットの範囲を再計算しません。範囲を再計算するには、[モザイク データセット プロパティ] ウィンドウでフィーチャの範囲を再計算する必要があります。
構文
パラメータ | 説明 | データ タイプ |
in_mosaic_dataset |
モザイク データセットのパスと名前 | Mosaic Layer |
where_clause (オプション) |
SQL を使用してクエリを定義することも、あるいは [検索条件設定] を使用して、モザイク データセットから削除されるラスタ データセットを定義するためのクエリを構築することもできます。 必ず選択を行うか、クエリを指定してください。そうしないと、ツールが実行されません。モザイク データセットからすべてのレコードを削除したい場合、すべてのラスタを選択するクエリを"OBJECTID>=0"のように指定してください。 | SQL Expression |
update_boundary (オプション) |
モザイク データセットの境界線ポリゴンを更新します。デフォルトでは、すべてのフットプリント ポリゴンが境界線にマージされ、有効なピクセル範囲を表す 1 つの境界が作成されます。
| Boolean |
mark_overviews_items (オプション) |
モザイク カタログ内のラスタを削除してしまうと、ラスタを使用して作成されたオーバー ビューは、正確でなくなることがあります。そのため、不要になったオーバー ビューの更新または削除が可能かどうかを識別できるようになっています。
| Boolean |
delete_overview_images (オプション) |
ソース ラスタが削除された結果として不要になったオーバービューは、モザイク データセットから削除することもできます。オーバービューは、オーバービュー アイテムが選択されている場合のみ削除されます。
| Boolean |
delete_item_cache (オプション) | 削除するモザイク データセット アイテムに関連付けられているキャッシュを削除するかどうかを選択します。
| Boolean |
remove_items (オプション) | モザイク データセットからラスタ データセットなどのアイテムを削除するか、関連付けられたオーバービューまたはキャッシュだけを削除するかを選択します。
| Boolean |
update_cellsize_ranges (オプション) | モザイク データセットのセル サイズ範囲を更新するかどうかを選択します。
| Boolean |
コードのサンプル
以下は、RemoveRastersFromMosaicDataset(モザイク データセットからラスタを削除)を実行するための Python サンプルです。
import arcpy
arcpy.RemoveRastersFromMosaicDataset_management(
"C:/Workspace/remove.gdb/md", "YEAR<1999", "UPDATE_BOUNDARY",
"MARK_OVERVIEW_ITEMS", "#", "#", "#", "#")
以下は、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)