モザイクデータセットアイテムキャッシュの構築 (Build Mosaic Dataset Item Cache) (データ管理)—ArcGIS Pro

サマリー

モザイクデータセット内にあるすべての関数チェーンの最終ステップとして、ラスターキャッシュ関数を挿入します。

使用法

ラスターキャッシュ関数は、すべての関数チェーンの一番上に挿入されます。そのため、この関数はチェーン内で実装される最後の関数になります。
[キャッシュを作成] パラメーターをオフ (Python では generate_cache を GENERATE_CACHE に設定) にしてキャッシュを生成する場合、[モザイクデータセットの同期 (Synchronize Mosaic Dataset)] ツールを使用してキャッシュを生成することができます。
モザイクデータセットがサーバーで共有 (公開) される場合、キャッシュはモザイクデータセットと一緒に移動することはできません。イメージサービスとして公開するモザイクデータセットに対してキャッシュを構築する場合は、モザイクデータセットを共有した後で、このツールを実行します。また、キャッシュへのパスにサーバーからアクセスできることを確認します。モザイクデータセットを公開する前にキャッシュを構築してある場合、キャッシュをサーバーに移動して、モザイクデータセット内に格納されているキャッシュパスを更新することができます。

パラメーター

ラベル	説明	データタイプ
モザイクデータセット	キャッシュ関数を適用するモザイクデータセット。	Mosaic Layer
クエリ定義 (オプション)	アイテムキャッシュを構築する、モザイクデータセット内の特定のラスターデータセットを選択する SQL 式。	SQL Expression
キャッシュを定義 (オプション)	[キャッシュ] プロパティの編集を有効化しますオン - ラスターキャッシュ関数を選択したアイテムに追加します。アイテムにラスターキャッシュ関数がすでに存在する場合は、追加されません。これがデフォルト設定。オフ - ラスターキャッシュは定義されません。	Boolean
キャッシュの生成 (オプション)	キャッシュの場所や圧縮など、ラスターキャッシュ関数内で定義されるプロパティに基づいてキャッシュファイルを生成します。オン - キャッシュが生成されます。これがデフォルト設定。オフ - キャッシュは生成されません。	Boolean
キャッシュパス (オプション)	選択すると、キャッシュを保存するデフォルトの場所を上書きします。モザイクデータセットがファイルジオデータベース内にある場合、デフォルトでは、キャッシュはジオデータベースと同じ名前のフォルダー内に保存され、拡張子が .cache になります。モザイクデータセットがエンタープライズジオデータベース内にある場合、デフォルトでは、キャッシュはそのジオデータベース内に保存されます。一度作成すると、そのキャッシュは常に同じ場所に保存されます。キャッシュを別の場所に保存するには、最初に [モザイクデータセットの修正 (Repair Mosaic Dataset)] ツールを使用して新しい場所を指定してから、このツールをもう一度実行します。アイテムキャッシュが作成された後は、異なるキャッシュパスを指定してこのツールを再実行しても、別の場所にアイテムキャッシュを再生成することはできません。アイテムキャッシュは、最初に生成された場所に生成されます。ただし、この関数を削除してから新しいパスを使用して関数を新たに挿入したり、[モザイクデータセットの修正 (Repair Mosaic Dataset)] ツールを使用してキャッシュのパスを変更したりしてから、このツールを実行して別の場所にアイテムキャッシュを生成することはできます。	Workspace
圧縮方法 (オプション)	送信速度を上げるために、データの圧縮方法を選択します。可逆圧縮— キャッシュの生成時に各ピクセルの値を維持します。可逆の圧縮率は、約 2:1 です。非可逆圧縮— 画像を背景としてのみ使用する場合に適しています。不可逆の圧縮率は高いですが (20:1)、圧縮率を高めるために似たピクセル値はグループ化されます。圧縮なし— 画像を圧縮しません。この場合、画像の送信速度は遅くなりますが、表示するときに圧縮解除する必要がないため、描画は高速になります。	String
圧縮品質 (オプション)	非可逆方法を使用するときは、圧縮品質を設定します。圧縮品質の値は、1 ～ 100 パーセントで、100 パーセントが最も圧縮率が低くなります。	Long
ロウ数の上限 (オプション)	キャッシュデータセットのサイズをロウ数で制限します。値がデータセット内のロウ数より多い場合、キャッシュは生成されません。	Long
カラム数の上限 (オプション)	キャッシュデータセットのサイズをカラム数で制限します。値がデータセット内のカラム数より多い場合、キャッシュは生成されません。	Long
サイズタイプの要求 (オプション)	次のいずれかの方法を使用して、キャッシュをリサンプリングします。ピクセルサイズファクター— ピクセルサイズを基準に縮尺係数を設定します。キャッシュをリサンプリングしない場合は、[ピクセルサイズファクター] を選択して、[リクエストサイズ] パラメーターを「1」に設定します。ピクセルサイズ— キャッシュラスターのピクセルサイズを指定します。	String
リクエストサイズ (オプション)	[サイズタイプの要求] に適用する値を設定します。	Double

派生した出力

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

arcpy.management.BuildMosaicDatasetItemCache(in_mosaic_dataset, {where_clause}, {define_cache}, {generate_cache}, {item_cache_folder}, {compression_method}, {compression_quality}, {max_allowed_rows}, {max_allowed_columns}, {request_size_type}, {request_size})

名前	説明	データタイプ
in_mosaic_dataset	キャッシュ関数を適用するモザイクデータセット。	Mosaic Layer
where_clause (オプション)	アイテムキャッシュを構築する、モザイクデータセット内の特定のラスターデータセットを選択する SQL 式。	SQL Expression
define_cache (オプション)	モザイクデータセットのキャッシュを定義するかどうかを選択します。ラスターキャッシュ関数が選択したアイテムに挿入されます。アイテムにラスターキャッシュ関数がすでに存在する場合は、追加されません。 DEFINE_CACHE—ラスターキャッシュ関数が選択したアイテムに追加されます。アイテムにラスターキャッシュ関数がすでに存在する場合は、追加されません。これがデフォルト設定。 NO_DEFINE_CACHE—ラスターキャッシュは定義されません。	Boolean
generate_cache (オプション)	キャッシュの場所や圧縮など、ラスターキャッシュ関数内で定義されるプロパティに基づいてキャッシュファイルを生成します。 GENERATE_CACHE—キャッシュが生成されます。これがデフォルト設定。 NO_GENERATE_CACHE—キャッシュは生成されません。	Boolean
item_cache_folder (オプション)	選択すると、キャッシュを保存するデフォルトの場所を上書きします。モザイクデータセットがファイルジオデータベース内にある場合、デフォルトでは、キャッシュはジオデータベースと同じ名前のフォルダー内に保存され、拡張子が .cache になります。モザイクデータセットがエンタープライズジオデータベース内にある場合、デフォルトでは、キャッシュはそのジオデータベース内に保存されます。一度作成すると、そのキャッシュは常に同じ場所に保存されます。キャッシュを別の場所に保存するには、最初に [モザイクデータセットの修正 (Repair Mosaic Dataset)] ツールを使用して新しい場所を指定してから、このツールをもう一度実行します。アイテムキャッシュが作成された後は、異なるキャッシュパスを指定してこのツールを再実行しても、別の場所にアイテムキャッシュを再生成することはできません。アイテムキャッシュは、最初に生成された場所に生成されます。ただし、この関数を削除してから新しいパスを使用して関数を新たに挿入したり、[モザイクデータセットの修正 (Repair Mosaic Dataset)] ツールを使用してキャッシュのパスを変更したりしてから、このツールを実行して別の場所にアイテムキャッシュを生成することはできます。	Workspace
compression_method (オプション)	送信速度を上げるために、データの圧縮方法を選択します。 LOSSLESS— キャッシュの生成時に各ピクセルの値を維持します。可逆の圧縮率は、約 2:1 です。 LOSSY— 画像を背景としてのみ使用する場合に適しています。不可逆の圧縮率は高いですが (20:1)、圧縮率を高めるために似たピクセル値はグループ化されます。 NONE— 画像を圧縮しません。この場合、画像の送信速度は遅くなりますが、表示するときに圧縮解除する必要がないため、描画は高速になります。	String
compression_quality (オプション)	非可逆方法を使用するときは、圧縮品質を設定します。圧縮品質の値は、1 ～ 100 パーセントで、100 パーセントが最も圧縮率が低くなります。	Long
max_allowed_rows (オプション)	キャッシュデータセットのサイズをロウ数で制限します。値がデータセット内のロウ数より多い場合、キャッシュは生成されません。	Long
max_allowed_columns (オプション)	キャッシュデータセットのサイズをカラム数で制限します。値がデータセット内のカラム数より多い場合、キャッシュは生成されません。	Long
request_size_type (オプション)	次のいずれかの方法を使用して、キャッシュをリサンプリングします。 PIXEL_SIZE_FACTOR— ピクセルサイズを基準に縮尺係数を設定します。キャッシュをリサンプリングしない場合は、PIXEL_SIZE_FACTOR を選択して、request_size パラメーターを「1」に設定します。 PIXEL_SIZE— キャッシュラスターのピクセルサイズを指定します。	String
request_size (オプション)	request_size_type に適用する値を設定します。	Double

派生した出力

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

コードのサンプル

BuildMosaicDatasetItemCache (モザイクデータセットアイテムキャッシュの構築) の例 1 (Python ウィンドウ)

以下は、BuildMosaicDatasetItemCache を実行する Python のサンプルです。

import arcpy
arcpy.BuildMosaicDatasetItemCache_management(
     "C:/Workspace/itemcache.gdb/md",  "#", "DEFINE_CACHE", 
     "NO_GENERATE_CACHE", "C:/workspace/itemcache", "LOSSY", 
     "80", "#", "#")

BuildMosaicDatasetItemCache (モザイクデータセットアイテムキャッシュの構築) の例 2 (スタンドアロンスクリプト)

以下は、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)

サマリー

使用法

パラメーター

派生した出力

派生した出力

コードのサンプル

環境

特殊なケース

ライセンス情報

関連トピック

このトピックの内容