ピラミッド構築（Build Pyramids） (データ管理)
サマリ
単一のラスタ データセットのラスタ ピラミッドを構築します。
このツールは、ピラミッドの削除にも使用することができます。ピラミッドを削除するには、[ピラミッド レベル] パラメータを 0 に設定します。
図
 |
使用法
-
ピラミッドを構築すると、ラスタ データセットの表示パフォーマンスが向上します。
-
ピラミッド構築は、データセットごとに 1 回実行するだけで済みます。ラスタ データセットを表示するたびに、構築したピラミッドがアクセスされます。
-
行内または列内のピクセル数が 1,024 未満のラスタ データセットに対しては、ピラミッドが構築されません。ラスタ データセットが極めて小さいことから、ピラミッドを構築してもパフォーマンス向上の効果がないため、ピラミッドは必要ありません。
-
ECW や MrSID などのウェーブレット圧縮ラスタ データセットは、ピラミッド構築の必要がありません。そのような形式のものには、エンコーディング時に作成される内部ピラミッドが含まれています。
-
[ラスタ格納] の環境設定で、ピラミッドファイルの圧縮タイプを選択することができます。 圧縮を選択すると、*.ovr ファイルのサイズが小さくなります。IMAGINE 形式および古いバージョンの ArcGIS では低解像度データセット（*.rrd）ファイルが作成されます。この種類のファイルは圧縮できません。
-
デフォルトのピラミッド圧縮では、データのタイプに応じて、最適な圧縮タイプが使用されます。LZ77、JPEG、または圧縮なしを手動で選択することもできます。
-
JPEG 圧縮は、JPEG の仕様に従ってデータを格納できるファイル形式でのみ使用できます。「サポートされているラスタ データセット ファイル形式」のトピックに、JPEG 形式がサポートできる仕様が示されています。
構文
| パラメータ | 説明 | データ タイプ |
in_raster_dataset |
入力ラスタ データセット。 入力には、縦横（ロウ、カラム）それぞれ 1024 ピクセル以上が必要です。 | Raster Dataset; Raster Layer |
pyramid_level (オプション) | 構築する低解像度データセット レイヤの数を選択します。デフォルト値は -1 で、完全なピラミッドを構築します。値を 0 にすると、ピラミッド レベルなしになります。 ピラミッドを削除するには、レベルの数値を 0 に設定します。 指定できるピラミッド レベルの最大数は 29 です。30 以上の値を指定した場合、値は -1 に戻され、ピラミッドの完全なセットが作成されます。 | Long |
SKIP_FIRST (オプション) | 最初のピラミッド レベルをスキップするかどうか選択します。第 1 レベルをスキップすると使用するディスク スペースが若干少なくなりますが、その縮尺でのパフォーマンスも低下します。
| Boolean |
resample_technique (オプション) |
ピラミッドの構築に使用するリサンプリング手法。
| String |
compression_type (オプション) |
ラスタ ピラミッドを構築するときに使用する圧縮タイプ:
| String |
compression_quality (オプション) | JPEG 圧縮法でピラミッドを構築するときに使用する圧縮品質。指定する値は、0 ～ 100 の間の値でなければなりません。100 に近い数は高品質な画像を生成しますが、圧縮比は低くなります。 | Long |
skip_existing (オプション) | 不足している箇所のピラミッドだけを構築するか、存在していてもピラミッドも再生成するかを指定します。
| Boolean |
コードのサンプル
これは BuildPyramids（ピラミッド構築）のための Python サンプルです。
import arcpy
arcpy.BuildPyramids_management(
"C:/data/image.tif", "3", "NONE",
"BILINEAR", "JPEG", "50", "SKIP_EXISTING")
これは BuildPyramids（ピラミッド構築）のための Python スクリプト サンプルです。
#Build Pyramids for single Raster Dataset
#Define the type and compression of pyramids in the tool
#Skip if dataset already has pyramids
import arcpy
arcpy.env.workspace = "C:/Workspace"
inras = "image.tif"
pylevel = "3"
skipfirst = "NONE"
resample = "BILINEAR"
compress = "JPEG"
quality = "80"
skipexist = "SKIP_EXISTING"
arcpy.BuildPyramids_management(inras, pylevel, skipfirst, resample,
compress, quality, skipexist)