ピラミッドと統計情報の構築（Build Pyramids And Statistics） (データ管理)
サマリ
フォルダ構造を横断して、その中に含まれるすべてのラスタ データセットのピラミッドを構築し、統計情報を計算します。ラスタ カタログやモザイク データセットに含まれるすべてのアイテムのピラミッド構築および統計情報の計算にも使用することができます。
使用法
-
ピラミッドを構築すると、ラスタ データセットの表示パフォーマンスが向上します。
-
ArcGIS アプリケーションでは、統計情報の計算によって、ラスタ データを適切なサイズに伸縮させたりシンボル化したりして最適に表示することができます。
-
サポートされているすべてのラスタ形式が処理されます。
-
ラスタ カタログおよびモザイク データセットを入力ワークスペースとして指定しなければなりません。ワークスペースがラスタ カタログまたはモザイク データセットを含む場合、ツールの実行時にはそれらのアイテムは含められません。
-
ECW や MrSID などのウェーブレット圧縮ラスタ データセットは、ピラミッド構築の必要がありません。そのような形式のものには、エンコーディング時に作成される内部ピラミッドが含まれています。
構文
| パラメータ | 説明 | データ タイプ |
in_workspace |
処理対象となるすべてのラスタ データセット、およびモザイク データセットまたはラスタ カタログが含まれているワークスペース。 ワークスペースがラスタ カタログまたはモザイク データセットを含む場合、ツールの実行時にはそれらのアイテムは含められません。 | Mosaic Dataset; Mosaic Layer; Raster Catalog Layer; Raster Dataset; Text File; Workspace |
include_subdirectories (オプション) |
サブディレクトリを含めるかどうかを指定します。
ラスタ カタログおよびモザイク データセットを入力ワークスペースとして指定しなければなりません。ワークスペースがラスタ カタログまたはモザイク データセットを含む場合、ツールの実行時にはそれらのアイテムは含められません。 | Boolean |
build_pyramids (オプション) |
ピラミッドを構築するかどうかを指定します。
| Boolean |
calculate_statistics (オプション) |
統計情報を計算するかどうかを指定します。
| Boolean |
BUILD_ON_SOURCE (オプション) | ピラミッドを構築してソース ラスタ データセットの統計情報を計算するか、モザイク データセットのラスタ アイテムの統計情報を計算するかを指定します。このオプションの適用対象となるのは、モザイク データセットだけです。
| Boolean |
block_field (オプション) |
計算または操作の実行時に 1 つのアイテムとみなす必要があるアイテムを識別するための、モザイク データセットの属性テーブル内のフィールド名。 | String |
estimate_statistics (オプション) | （モザイク データセット内のラスタではなく）モザイク データセットの統計情報を計算するかどうかを指定します。統計情報は、モザイク データセット内の各ラスタについて計算された既存の統計情報から得られます。
| Boolean |
x_skip_factor (オプション) |
サンプル間の水平方向のピクセル数。 この値は、ゼロより大きく、ラスタ内の列数以下でなければなりません。デフォルトは 1、または最後に使用したスキップ ファクタです。 | Long |
y_skip_factor (オプション) |
サンプル間の垂直方向のピクセル数。 この値は、ゼロより大きく、ラスタの行数以下でなければなりません。デフォルトは 1、または最後に使用した Y スキップ ファクタです。 | Long |
ignore_values [ignore_value,...] (オプション) |
統計情報の計算に含まれないピクセル値。 デフォルトは値なしです。 | Long |
pyramid_level (オプション) | 構築する低解像度データセット レイヤの数を選択します。デフォルト値は -1 で、完全なピラミッドを構築します。値を 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 |
コードのサンプル
これは BuildPyramidsAndStatistics（ピラミッドと統計情報の構築）ツールのための Python サンプルです。
import arcpy
arcpy.BuildPyramidsAndStatistics_management(
"C:/Workspace", "INCLUDE_SUBDIRECTORIES", "BUILD_PYRAMIDS",
"CALCULATE_STATISTICS","BUILD_ON_SOURCE", "BlockField",
"ESTIMATE_STATISTICS", "10", "10", "0;255", "-1", "NONE",
"BILINEAR", "JPEG", "50", "OVERWRITE")
これは BuildPyramidsAndStatistics（ピラミッドと統計情報の構築）ツールのための Python スクリプト サンプルです。
#Build pyramids and calculate statistics for all raster in a folder
import arcpy
arcpy.env.workspace = "C:/Workspace"
inws = "folder"
includedir = "INCLUDE_SUBDIRECTORIES"
buildpy = "BUILD_PYRAMIDS"
calcstats = "CALCULATE_STATISTICS"
buildsource = "NONE"
blockfield = "#"
estimatemd = "#"
skipx = "4"
skipy = "6"
ignoreval = "0;255"
pylevel = "3"
skipfirst = "NONE"
resample = "BILINEAR"
compress = "JPEG"
quality = "80"
skipexist = "SKIP_EXISTING"
arcpy.BuildPyramidsAndStatistics_management(
inws, includedir, buildpy, calcstats, buildsource, blockfield,
estimatemd, skipx, skipy, ignoreval, pylevel, skipfirst,
resample, compress, quality, skipexist)