モザイク データセットからラスターを削除 (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

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)

関連トピック