モザイク データセットのアイテム キャッシュの構築（Build Mosaic Dataset Item Cache） (データの管理)
サマリ
モザイク データセット内にあるアイテムの関数チェーンにキャッシュ ラスタ関数を挿入します。
使用法
キャッシュ ラスタ関数は、すべての関数チェーンの一番上に挿入されます。そのため、この関数はチェーン内で実装される最後の関数になります。
-
このツールでキャッシュを生成するのに [キャッシュ作成] オプションを使用しない場合は、[モザイク データセットの同期（Synchronize Mosaic Dataset）] ツールを使用してキャッシュを生成することができます。
モザイク データセットがサーバで共有（公開）される場合、キャッシュはモザイク データセットと一緒に移動することはできません。イメージ サービスとして公開するモザイク データセットに対してキャッシュを構築する場合は、モザイク データセットをサーバで共有した後で、このツールを実行します。また、キャッシュへのパスにサーバからアクセスできることを確認します。モザイク データセットを公開する前にキャッシュを構築してある場合、キャッシュをサーバに移動して、モザイク データセット内に格納されているキャッシュ パスを更新することができます。
構文
| パラメータ | 説明 | データ タイプ |
in_mosaic_dataset |
モザイク データセットのパスおよび名前。 | Mosaic Layer |
where_clause (オプション) |
SQL を使用して、クエリを定義するか、[検索条件設定] でクエリを作成することができます。 | SQL Expression |
define_cache (オプション) |
モザイク データセットのキャッシュを定義するかどうかを選択します。キャッシュ ラスタ関数が選択したアイテムに挿入されます。アイテムにキャッシュ ラスタ関数がすでに存在する場合は、追加されません。
| Boolean |
generate_cache (オプション) |
キャッシュの場所や圧縮など、キャッシュ ラスタ関数内で定義されるプロパティに基づいてキャッシュ ファイルを生成します。
| Boolean |
item_cache_folder (オプション) |
キャッシュされたデータセットを格納する場所。 デフォルトでは、モザイク データセットが保存されているフォルダと同じディレクトリに、キャッシュが生成、格納されます。このフォルダにはジオデータベースと同じ名前が付けられ、末尾に「.cache」という拡張子が付加されます。ただし、モザイク データセットが ArcSDE ジオデータベース内に作成された場合は、対象のジオデータベース内にキャッシュが作成されます。 アイテム キャッシュが作成された後は、異なるキャッシュ パスを指定してこのツールを再実行しても、別の場所にアイテム キャッシュを再生成することはできません。アイテム キャッシュは、最初に生成された場所に生成されます。ただし、この関数を削除してから新しいパスを使用して関数を新たに挿入したり、[モザイク データセットの修正（Repair Mosaic Dataset）] ツールを使用してキャッシュのパスを変更したりしてから、このツールを実行して別の場所にアイテム キャッシュを生成することはできます。 | Workspace |
compression_method (オプション) |
キャッシュを生成するときに使用される圧縮のタイプ。
| String |
compression_quality (オプション) |
非可逆圧縮方法を使用する場合に使用する圧縮品質。圧縮品質の値は、1 ～ 100 パーセントです。 | Long |
max_allowed_rows (オプション) |
キャッシュ データセットのサイズを行内のピクセル数で制限します。 寸法がこの制限より大きい場合、キャッシュ ラスタは生成されません。 | Long |
max_allowed_columns (オプション) |
キャッシュ データセットのサイズを列内のピクセル数で制限します。 寸法がこの制限より大きい場合、キャッシュ ラスタは生成されません。 | Long |
request_size_type (オプション) |
アイテム キャッシュのリサンプリング中に、ピクセル サイズ ファクタとピクセル サイズのどちらを指定するかを選択します。
| String |
request_size (オプション) |
リクエスト サイズを指定します。入力する値は、request_size_type オプションによって変わります。PIXEL_SIZE_FACTOR を選択した場合、値は縮尺係数になります。PIXEL_SIZE を選択した場合、値はリサンプリングされるピクセル サイズになります。 | Double |
コードのサンプル
以下は、BuildMosaicDatasetItemCache（モザイク データセットのアイテム キャッシュの構築）を実行する Python サンプルです。
import arcpy
arcpy.BuildMosaicDatasetItemCache_management(
"C:/Workspace/itemcache.gdb/md", "#", "DEFINE_CACHE",
"NO_GENERATE_CACHE", "C:/workspace/itemcache", "LOSSY",
"80", "#", "#")
以下は、BuildMosaicDatasetItemCache（モザイク データセットのアイテム キャッシュの構築）を実行する Python スクリプトのサンプルです。
#Define mosaic dataset item cache without generating the cache file
import arcpy
arcpy.env.workspace = "C:/Workspace"
mdname = "itemcache.gdb/md"
query = "#"
definecache = "DEFINE_CACHE"
generatecache = "NO_GENERATE_CACHE"
cachepath = "C:/workspace/itemcache"
compression = "LOSSY"
compquality = "80"
maxrow = "#"
maxcolumn = "#"
arcpy.BuildMosaicDatasetItemCache_management(
mdname, query, definecache, generatecache, cachepath, compression,
compquality, maxrow, maxcolumn)