ピラミッドと統計情報の構築（Build Pyramids And Statistics） (データの管理)
サマリ
フォルダ構造を横断して、その中に含まれるすべてのラスタ データセットのピラミッドを構築し、統計情報を計算します。ラスタ カタログやモザイク データセットに含まれるすべてのアイテムのピラミッド構築および統計情報の計算にも使用することができます。
使用法
-
ピラミッドを構築すると、ラスタ データセットの表示パフォーマンスが向上します。
-
ArcGIS アプリケーションでは、統計情報の計算によって、ラスタ データを適切なサイズに伸縮させたりシンボル化したりして最適に表示することができます。
-
サポートされているすべてのラスタ形式が処理されます。
-
ラスタ カタログおよびモザイク データセットを入力ワークスペースとして指定しなければなりません。ワークスペースがラスタ カタログまたはモザイク データセットを含む場合、ツールの実行時にはそれらのアイテムは含められません。
-
モザイク データセット自体の統計情報ではなく、モザイク データセットに含まれるラスタの統計情報だけが計算されます。モザイク データセットの統計情報を計算するには、[統計情報の計算（Calculate Statistics）] ツールを使用します。
-
ECW や MrSID などのウェーブレット圧縮ラスタ データセットは、ピラミッド構築の必要がありません。そのような形式のものには、エンコーディング時に作成される内部ピラミッドが含まれています。
-
スキップ ファクタおよびピラミッドのリサンプリングは、ジオプロセシング環境の [ラスタ格納] で設定できます。
構文
| パラメータ | 説明 | データ タイプ |
in_workspace |
処理対象となるすべてのラスタ データセットが含まれているワークスペース ラスタ カタログおよびモザイク データセットを入力ワークスペースとして指定しなければなりません。ワークスペースがラスタ カタログまたはモザイク データセットを含む場合、ツールの実行時にはそれらのアイテムは含められません。 | Mosaic Dataset; Raster Catalog Layer; Raster Dataset; Workspace |
include_subdirectories （オプション） |
サブディレクトリを含めるかどうかを指定します。
ラスタ カタログおよびモザイク データセットを入力ワークスペースとして指定しなければなりません。ワークスペースがラスタ カタログまたはモザイク データセットを含む場合、ツールの実行時にはそれらのアイテムは含められません。 | Boolean |
build_pyramids （オプション） |
ピラミッドを構築するかどうかを指定します。
| Boolean |
calculate_statistics （オプション） |
統計情報を計算するかどうかを指定します。
| Boolean |
build_on_source （オプション） | ピラミッドを構築してソース ラスタ データセットの統計情報を計算するか、モザイク データセットのラスタ アイテムの統計情報を計算するかを指定します。このオプションの適用対象となるのは、モザイク データセットだけです。
| Boolean |
コードのサンプル
これは BuildPyramidsandStatistics（ピラミッドと統計情報の構築）ツールのための Python サンプルです。
import arcpy
from arcpy import env
env.workspace = "c:/data"
arcpy.env.pyramid = "PYRAMIDS 3 BILINEAR JPEG"
arcpy.env.rasterStatistics = "STATISTICS 4 6 (0)"
arcpy.BuildPyramidsAndStatistics_management("folder", "INCLUDE_SUBDIRECTORIES",
"BUILD_PYRAMIDS", "CALCULATE_STATISTICS")
これは BuildPyramidsandStatistics（ピラミッドと統計情報の構築）ツールのための Python スクリプト サンプルです。
##====================================
##Build Pyramids and Statistics
##Usage: BuildPyramidsAndStatistics_management in_workspace {INCLUDE_SUBDIRECTORIES
## | NONE} {BUILD_PYRAMIDS | NONE}
## {CALCULATE_STATISTICS | NONE}
try:
import arcpy
arcpy.env.workspace = r"C:/Workspace"
##Define parameters for build pyramids and calculate statitics in environment setting
arcpy.env.pyramid = "PYRAMIDS 3 BILINEAR JPEG"
arcpy.env.rasterStatistics = "STATISTICS 4 6 (0)"
##Build pyramids and calculate statistics for all raster in a folder
arcpy.BuildPyramidsAndStatistics_management("folder", "INCLUDE_SUBDIRECTORIES",
"BUILD_PYRAMIDS", "CALCULATE_STATISTICS")
##Build pyramids and calculate statistics for all raster in a GDB
arcpy.BuildPyramidsAndStatistics_management("fgdb.gdb", "INCLUDE_SUBDIRECTORIES",
"BUILD_PYRAMIDS", "CALCULATE_STATISTICS")
##Build pyramids and calculate statistics for all raster in a Mosaic Dataset
arcpy.BuildPyramidsAndStatistics_management("fgdb.gdb/md", "INCLUDE_SUBDIRECTORIES",
"BUILD_PYRAMIDS", "CALCULATE_STATISTICS")
except:
print "Build Pyramids and Statistics example failed."
print arcpy.GetMessages()