概要
モザイク データセットを最新の状態に維持します。データの同期だけでなく、元になる画像が変更された場合のオーバービューの更新、新しいオーバービューとキャッシュの生成、モザイク データセット アイテムの元の構成の復元が可能です。このツールでソース データのパスを削除することもできます。パスを修正するには、[モザイク データセット パスの修正 (Repair Mosaic Dataset Paths)] ツールを使用する必要があります。
同期は一方向の操作で、ソース データの変更をモザイク データセットの属性テーブルに同期させ、モザイク データセットの属性テーブルを更新することができます。モザイク データセットの属性テーブルの変更は、ソース データには影響を与えません。
注意:
同期により加えられる変更は、元に戻すことができません。上書きされる可能性のあるモザイク データに変更を加える場合は、バックアップ コピーを作成しておくことをお勧めします。
使用法
このツールと一緒に選択セットを使用して、更新されるラスター アイテムを制限することができます。選択セットまたはクエリがある場合、それらのアイテムだけが処理されます。
同期では、新しいアイテムの追加、既存アイテムの更新、アイテムの削除ができます。
古くなったアイテムとは、モザイク データセットが作成されてから、またはモザイク データセットが最後に同期されてから変更されたソース ラスターを指します。たとえば、ジオリファレンスが更新されたり、ピラミッドが構築されたりする可能性があります。
ラスター アイテムは再構築されるため、最後に構築されてから加えられたこれらのアイテムに対する変更 (属性テーブル内の関数やコンテンツの編集など) は失われます。
リンクの切れたデータ ソースを持つアイテムを削除する場合は、すべてのネットワーク接続が正しく動作していることを確認してください。このツールは、アクセスできないすべてのアイテムを削除します。
また、このツールを使用して、ピラミッドの構築、ソース ラスターの統計情報の計算、ラスター アイテムのサムネイルとラスター キャッシュの作成もできます。
このツールは、モザイク データセットを最新の状態に保つ場合に、特に便利です。そのモザイク データセットがアクセスするワークスペースに新しいラスター データセットが追加された場合、その新しいラスター データセットをモザイク データセットに追加できます。外部管理のデータベースにあるテーブルを使って設定されたモザイク データセットを、このツールを使って更新することもできます。
同期が完了すると、操作が [モザイク データセット オプション] にリストされます。
[集約情報の更新] パラメーターを使用するには、[既存のアイテムの更新] パラメーターをオフにします。多次元モザイク データセットでは、このパラメーターにより、モザイク データセットの属性テーブルの内容に基づいて、モザイクの多次元プロパティが更新されます。
データベースの断片化や頻繁なデータ操作によって、モザイク データセットのサイズが急激に増加する場合があります。データベースのサイズが、絶え間ないトランザクションによって肥大化した場合、[データベースの最適化 (Compact)] ツールを実行してください。
構文
arcpy.management.SynchronizeMosaicDataset(in_mosaic_dataset, {where_clause}, {new_items}, {sync_only_stale}, {update_cellsize_ranges}, {update_boundary}, {update_overviews}, {build_pyramids}, {calculate_statistics}, {build_thumbnails}, {build_item_cache}, {rebuild_raster}, {update_fields}, {fields_to_update}, {existing_items}, {broken_items}, {skip_existing_items}, {refresh_aggregate_info}, estimate_statistics)| パラメーター | 説明 | データ タイプ |
in_mosaic_dataset | 同期するモザイク データセット。 | Mosaic Layer |
where_clause (オプション) | どのモザイク データセット アイテムを同期するかを選択する SQL 式。式が指定されていない場合は、すべてのデータセット アイテムが更新されます。 | SQL Expression |
new_items (オプション) | 同期の際に新しいアイテムを含めるかどうかを選択して、新しいアイテムを更新するオプションを指定します。 このオプションを選択した場合、アイテムのワークスペースから新しいデータを検索します。データがモザイク データセットに追加されると、そのモザイク データセットは、同じワークスペース内の他のアイテムと同じラスター タイプを使用します。
| Boolean |
sync_only_stale (オプション) | 同期によって元になるラスター データセットが変更されたモザイク データセット アイテムを更新するかどうかを選択します。たとえば、ピラミッドの構築やラスターのジオリファレンスの更新は、オーバービューのレンダリングの方法に影響を与えます。
| Boolean |
update_cellsize_ranges (オプション) | セル サイズ範囲を更新するかどうかを選択します。
| Boolean |
update_boundary (オプション) | 境界線を更新するかどうかを選択します。
| Boolean |
update_overviews (オプション) | 古くなったオーバービューを更新するかどうかを選択します。同期によって元になるラスターが変更された場合、オーバービューは古くなります。
| Boolean |
build_pyramids (オプション) | 指定されたモザイク データセット アイテムのピラミッドを構築するかどうかを選択します。モザイク データセットのラスター アイテムごとにピラミッドを構築できます。ピラミッドは、各ラスターが表示される速度を向上します。
同期によって追加されたアイテムのピラミッドは構築しません。 | Boolean |
calculate_statistics (オプション) | 指定されたモザイク データセット アイテムの統計情報を計算するかどうかを選択します。コントラスト ストレッチの適用などの特定のタスクを実行するには、モザイク データセットに統計情報が必要です。
同期によって追加されたアイテムの統計情報は計算しません。 | Boolean |
build_thumbnails (オプション) | 指定されたモザイク データセット アイテムのサムネイルを構築するかどうかを選択します。サムネイルは小さなサイズにリサンプリングされた画像で、モザイク定義に含まれるラスター アイテムごとに作成できます。サムネイルは、モザイク データセットがイメージ サービスとしてアクセスされた場合にアクセス可能で、アイテム説明の一部として表示されます。
同期によって追加されたアイテムのサムネイルは構築されません。 | Boolean |
build_item_cache (オプション) | 指定されたモザイク データセット アイテムのキャッシュを構築するかどうかを選択します。キャッシュは、LAS、テレイン、LAS データセットの各ラスター タイプを使用してデータを追加したときに作成できます。また、ラスター キャッシュ関数を使用してアイテムをキャッシュすることもできます。
同期によって追加されたアイテムのキャッシュは構築されません。 | Boolean |
rebuild_raster (オプション) | 元のラスター タイプを使用してラスター アイテムをデータ ソースから再構築するかどうかを選択します。
これは、同期されるアイテムだけに影響します。new_items パラメーターが UPDATE_WITH_NEW_ITEMS に設定されている場合、このパラメーターは適用されません。 | Boolean |
update_fields (オプション) | テーブル内のフィールドを更新するかどうかを選択します。これは、同期されるアイテムだけに影響します。
フィールドの更新を選択する場合、fields_to_update パラメーターでフィールドを指定することで、どのフィールドを更新するかを制御することができます。いくつかのフィールドを編集した場合、fields_to_update パラメーターでそれらの選択を解除することもできます。 | Boolean |
fields_to_update [field_to_update,...] (オプション) | 更新するフィールドを指定します。 このパラメーターは、update_fields パラメーターのオプションが UPDATE_FIELDS に設定された場合にのみ有効になります。 いくつかのフィールドを編集した場合、それらがリストされていないことを確認します。 RASTER フィールドは、REBUILD_RASTER が指定されていない場合でも更新できます。ただし、REBUILD_RASTER が指定されている場合、RASTER フィールドは、このフィールドが指定されていない場合でも再構築されます。 | String |
existing_items (オプション) | モザイク データセット内の既存のアイテムを更新するかどうかを選択します。 このオプションを選択した場合、既存のどのパラメーターを更新するか次のうちから選択できます。sync_only_stale、build_pyramids、calculate_statistics、build_thumbnails、build_item_cache、update_fields、fields_to_update。
| Boolean |
broken_items (オプション) | 切れたリンクを削除するかどうかを選択します。 すべてのネットワーク接続が正しく動作していることを確認してください。このツールは、アクセスできないすべてのアイテムを削除します。
| Boolean |
skip_existing_items (オプション) | UPDATE_WITH_NEW_ITEMS パラメーターで new_items を指定すると、既存のモザイク データセット アイテムをスキップするか、またはディスクの変更されたファイルで更新するかを選択できます。
| Boolean |
refresh_aggregate_info (オプション) | モザイク データセットから削除された可能性のあるデータを追加するかどうかを選択します。
| Boolean |
estimate_statistics | モザイク データセットの統計情報を推定するかどうかを選択します。
| Boolean |
派生した出力
| 名前 | 説明 | データ タイプ |
| out_mosaic_dataset | 更新されたモザイク データセット。 | モザイク レイヤー |
コードのサンプル
以下は、SynchronizeMosaicDataset ツールを実行する Python サンプルです。
import arcpy
arcpy.SynchronizeMosaicDataset_management(
"c:/data/syncmd.gdb/md", "Year>1999", "NO_NEW_ITEMS", "SYNC_STALE",
"#", "#", "#", "NO_PYRAMIDS", "NO_STATISTICS", "NO_THUMBNAILS",
"NO_ITEM_CACHE", "NO_RASTER", "NO_FIELDS", "#", "#")以下は、SynchronizeMosaicDataset ツールを実行する Python スクリプト サンプルです。
# Synchronize source and add new data
import arcpy
arcpy.env.workspace = "C:/Workspace"
mdname = "syncmd.gdb/mdnew"
query = "#"
updatenew = "UPDATE_WITH_NEW_ITEMS"
syncstale = "SYNC_STALE"
updatecs = "#"
updatebnd = "#"
updateovr = "#"
buildpy = "NO_PYRAMIDS"
calcstats = "NO_STATISTICS"
buildthumb = "NO_THUMBNAILS"
buildcache = "NO_ITEM_CACHE"
updateras = "NO_RASTER"
updatefield = "NO_FIELDS"
fields = "#"
arcpy.SynchronizeMosaicDataset_management(
mdname, query, updatenew, syncstale, updatecs, updatebnd,
updateovr, buildpy, calcstats, buildthumb, buildcache,
updateras, updatefield, fields)ライセンス情報
- Basic: いいえ
- Standard: はい
- Advanced: はい