概要
複数のラスター データセットのピラミッドを構築します。
使用法
ピラミッドを構築すると、ラスター データセットの表示パフォーマンスが向上します。
ピラミッド構築のバッチ処理は、ピラミッドのない複数のラスター データセットの大きなディレクトリがある場合や、モザイク データセットの複数のアイテムにピラミッドを構築 (ダイアログ ボックスにアイテムをドラッグ) する場合に便利です。
ECW や MrSID などのウェーブレット圧縮ラスター データセットは、ピラミッド構築の必要がありません。そのような形式のものには、エンコーディング時に作成される内部ピラミッドが含まれています。
行内または列内のピクセル数が 1,024 未満のラスター データセットに対しては、ピラミッドが構築されません。ラスター データセットが極めて小さいことから、ピラミッドを構築してもパフォーマンス向上の効果がないため、ピラミッドは必要ありません。
ラスター カタログ用にピラミッドを構築できませんが、各ラスター カタログ アイテム用には構築できます。
[ラスター格納] 環境で、ピラミッド ファイルの圧縮タイプを選択することができます。圧縮を選択すると、*.ovr ファイルのサイズが小さくなります。IMAGINE 形式および古いバージョンの ArcGIS では低解像度データセット (*.rrd) ファイルが作成されます。この種類のファイルは圧縮できません。
デフォルトのピラミッド圧縮では、データのタイプに応じて、最適な圧縮タイプが使用されます。[LZ77]、[JPEG]、または圧縮なしを手動で選択することもできます。
構文
arcpy.management.BatchBuildPyramids(Input_Raster_Datasets, {Pyramid_levels}, {Skip_first_level}, {Pyramid_resampling_technique}, {Pyramid_compression_type}, {Compression_quality}, {Skip_Existing})| パラメーター | 説明 | データ タイプ |
Input_Raster_Datasets [input_raster_dataset,...] | ラスター ピラミッドを構築する対象となるラスター データセット。 各入力には、それぞれ 1024 を超えるロウとカラムが必要です。 | Raster Dataset |
Pyramid_levels (オプション) | 構築する低解像度データセット レイヤーの数を選択します。デフォルト値は -1 で、完全なピラミッドを構築します。値を 0 にすると、ピラミッド レベルなしになります。 | Long |
Skip_first_level (オプション) | 最初のピラミッド レベルをスキップするかどうか選択します。第 1 レベルをスキップすると使用するディスク スペースが若干少なくなりますが、その縮尺でのパフォーマンスも低下します。
| Boolean |
Pyramid_resampling_technique (オプション) | ピラミッドの構築に使用するリサンプリング手法。
| String |
Pyramid_compression_type (オプション) | ラスター ピラミッドを構築するときに使用する圧縮タイプ:
| String |
Compression_quality (オプション) | JPEG 圧縮方法でピラミッドを構築するときに使用する圧縮品質。指定する値は、0 ～ 100 の間の値でなければなりません。100 に近い数は高品質な画像を生成しますが、圧縮比は低くなります。 | Long |
Skip_Existing (オプション) | 不足している箇所のピラミッドだけを構築するか、存在している箇所のピラミッドも再生成するかを指定します。
| Boolean |
派生した出力
| 名前 | 説明 | データ タイプ |
| Batch_Build_Pyramids_Succeeded | ツールが正常に実行されたかどうかを返します。 | ブール型 |
コードのサンプル
BatchBuildPyramids (ピラミッド構築のバッチ処理) の例 1 (Python ウィンドウ)
以下は、BatchBuildPyramids ツールを実行する Python サンプルです。
import arcpy
arcpy.BatchBuildPyramids_management(
"C:/data/img1.tif;C:/data/img2.img", "6", "SKIP_FIRST",
"BILINEAR", "JPEG", "50", "SKIP_EXISTING")
BatchBuildPyramids (ピラミッド構築のバッチ処理) の例 2 (スタンドアロン スクリプト)
以下は、BatchBuildPyramids ツールを実行する Python スクリプト サンプルです。
#Build Pyramids for multiple raster datasets in the workspace
#Skip the dataset that already has pyramid
#Build pyramids with compression and level setting
import arcpy
arcpy.env.workspace = "C:/Workspace"
inras = "image1.tif;image2.img;fgdb.gdb/image3"
pylevels = "6"
skipfirst = "SKIP_FIRST"
resample = "BILINEAR"
compress = "JPEG"
quality = "80"
skipexist = "SKIP_EXISTING"
arcpy.BatchBuildPyramids_management(
inras, pylevels, skipfirst, resample, compress,
quality, skipexist)
環境
ライセンス情報
- Basic: はい
- Standard: はい
- Advanced: はい