サマリ
ラスター データセットのラスター ピラミッドを構築します。
このツールは、ピラミッドの削除にも使用することができます。ピラミッドを削除するには、[ピラミッド レベル] パラメーターを 0 に設定します。
図
使用法
ピラミッドを構築すると、ラスター データセットの表示パフォーマンスが向上します。
ピラミッド構築は、データセットごとに 1 回実行するだけで済みます。ラスター データセットを表示するたびに、構築したピラミッドがアクセスされます。
-
行内または列内のピクセル数が 1,024 未満のラスター データセットに対しては、ピラミッドが構築されません。ラスター データセットが極めて小さいことから、ピラミッドを構築してもパフォーマンス向上の効果がないため、ピラミッドは必要ありません。
ECW や MrSID などのウェーブレット圧縮ラスター データセットは、ピラミッド構築の必要がありません。そのような形式のものには、エンコーディング時に作成される内部ピラミッドが含まれています。
[ラスター格納] の環境設定で、ピラミッドファイルの圧縮タイプを選択することができます。 圧縮を選択すると、*.ovr ファイルのサイズが小さくなります。IMAGINE 形式および古いバージョンの ArcGIS では低解像度データセット (*.rrd) ファイルが作成されます。この種類のファイルは圧縮できません。
デフォルトのピラミッド圧縮では、データのタイプに応じて、最適な圧縮タイプが使用されます。LZ77、JPEG、または圧縮なしを手動で選択することもできます。
JPEG 圧縮は、JPEG の仕様に従ってデータを格納できるファイル形式でのみ使用できます。「サポートされているラスター データセット ファイル形式」のトピックに、JPEG 形式がサポートできる仕様が示されています。
構文
BuildPyramids_management (in_raster_dataset, {pyramid_level}, {SKIP_FIRST}, {resample_technique}, {compression_type}, {compression_quality}, {skip_existing})| パラメータ | 説明 | データ タイプ |
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 (ピラミッド構築) の例 1 (Python ウィンドウ)
これは BuildPyramids (ピラミッド構築) のための Python サンプルです。
import arcpy
arcpy.BuildPyramids_management(
"C:/data/image.tif", "3", "NONE",
"BILINEAR", "JPEG", "50", "SKIP_EXISTING")
BuildPyramids (ピラミッド構築) の例 2 (スタンドアロン スクリプト)
これは 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)
環境
ライセンス情報
- ArcGIS for Desktop Basic: ○
- ArcGIS for Desktop Standard: ○
- ArcGIS for Desktop Advanced: ○