概要
フォルダー構造を横断して、その中に含まれるすべてのラスター データセットのピラミッドを構築し、統計情報を計算します。 モザイク データセットに含まれるすべてのアイテムのピラミッド構築および統計情報の計算にも使用することができます。
使用法
ピラミッドを構築すると、ラスター データセットの表示パフォーマンスが向上します。
ArcGIS アプリケーションでは、統計情報の計算によって、ラスター データを適切なサイズに伸縮させたりシンボル化したりして最適に表示することができます。
サポートされているすべてのラスター形式が処理されます。
ラスター カタログおよびモザイク データセットを入力ワークスペースとして指定しなければなりません。 ワークスペースがラスター カタログまたはモザイク データセットを含む場合、ツールの実行時にはそれらのアイテムは含められません。
ECW や MrSID などのウェーブレット圧縮ラスター データセットは、ピラミッド構築の必要がありません。そのような形式のものには、エンコーディング時に作成される内部ピラミッドが含まれています。
構文
arcpy.management.BuildPyramidsandStatistics(in_workspace, {include_subdirectories}, {build_pyramids}, {calculate_statistics}, {BUILD_ON_SOURCE}, {block_field}, {estimate_statistics}, {x_skip_factor}, {y_skip_factor}, {ignore_values}, {pyramid_level}, {SKIP_FIRST}, {resample_technique}, {compression_type}, {compression_quality}, {skip_existing}, {where_clause})| パラメーター | 説明 | データ タイプ |
in_workspace | 処理対象となるすべてのラスター データセット、およびモザイク データセットまたはラスター カタログが含まれているワークスペース。 ワークスペースがラスター カタログまたはモザイク データセットを含む場合、ツールの実行時にはそれらのアイテムは含められません。 | Text File; Mosaic Dataset; Workspace; Raster Catalog Layer; Raster Dataset; Mosaic Layer |
include_subdirectories (オプション) | サブディレクトリを含めるかどうかを指定します。
ラスター カタログおよびモザイク データセットを入力ワークスペースとして指定しなければなりません。 ワークスペースがラスター カタログまたはモザイク データセットを含む場合、ツールの実行時にはそれらのアイテムは含められません。 | Boolean |
build_pyramids (オプション) | ピラミッドを構築するかどうかを指定します。
| Boolean |
calculate_statistics (オプション) | 統計情報を計算するかどうかを指定します。
| Boolean |
BUILD_ON_SOURCE (オプション) | ピラミッドを構築してソース ラスター データセットの統計情報を計算するか、モザイク データセットのラスター アイテムの統計情報を計算するかを指定します。 このオプションの適用対象となるのは、モザイク データセットだけです。
| Boolean |
block_field (オプション) | 計算または操作の実行時に 1 つのアイテムと見なす必要があるアイテムを識別するための、モザイク データセットの属性テーブル内のフィールド名。 | String |
estimate_statistics (オプション) | (モザイク データセット内のラスターではなく) モザイク データセットの統計情報を計算するかどうかを指定します。 統計情報は、モザイク データセット内の各ラスターについて計算された既存の統計情報から得られます。
| Boolean |
x_skip_factor (オプション) |
サンプル間の水平方向のピクセル数。 統計情報の計算に使用されるラスター部分は、スキップ ファクターによって制御されます。水平方向または垂直方向のスキップ ファクターは、入力値で示されます。値が 1 のときは各ピクセルを使用し、値が 2 のときはピクセルを 1 つおきに使用します。スキップ ファクターの範囲は、1 からラスター内のカラム数またはロウ数までに限定されます。 この値は、ゼロより大きく、ラスター内のカラム数以下でなければなりません。デフォルトは 1、または最後に使用したスキップ ファクターです。 | Long |
y_skip_factor (オプション) | サンプル間の垂直方向のピクセル数。 統計情報の計算に使用されるラスター部分は、スキップ ファクターによって制御されます。水平方向または垂直方向のスキップ ファクターは、入力値で示されます。値が 1 のときは各ピクセルを使用し、値が 2 のときはピクセルを 1 つおきに使用します。スキップ ファクターの範囲は、1 からラスター内のカラム数またはロウ数までに限定されます。 この値は、ゼロより大きく、ラスターのロウ数以下でなければなりません。デフォルトは 1、または最後に使用した Y スキップ ファクターです。 | Long |
ignore_values [ignore_value,...] (オプション) |
統計情報の計算に含まれないピクセル値。 デフォルトは値なしです。 | Long |
pyramid_level (オプション) | 構築する低解像度データセット レイヤーの数を選択します。デフォルト値は -1 で、完全なピラミッドを構築します。値を 0 にすると、ピラミッド レベルなしになります。 指定できるピラミッド レベルの最大数は 29 です。 30 以上の値の場合、ピラミッドの完全なセットが作成されます。 | Long |
SKIP_FIRST (オプション) | 最初のピラミッド レベルをスキップするかどうか選択します。第 1 レベルをスキップすると使用するディスク スペースが若干少なくなりますが、その縮尺でのパフォーマンスも低下します。
| Boolean |
resample_technique (オプション) | ピラミッドの構築に使用するリサンプリング手法。
| String |
compression_type (オプション) | ラスター ピラミッドを構築するときに使用する圧縮タイプ:
| String |
compression_quality (オプション) | JPEG 圧縮方法でピラミッドを構築するときに使用する圧縮品質。指定する値は、0 ～ 100 の間の値でなければなりません。100 に近い数は高品質な画像を生成しますが、圧縮比は低くなります。 | Long |
skip_existing (オプション) | 不足している箇所だけの統計情報を計算するか、存在している箇所のピラミッドも再生成するかを指定します。
| Boolean |
where_clause (オプション) | 処理されるラスター データセットを選択する SQL 式。 | SQL Expression |
派生した出力
| 名前 | 説明 | データ タイプ |
| out_workspace | 更新された出力ワークスペース。 | Text File; Workspace; Raster Layer; Mosaic Layer |
コードのサンプル
BuildPyramidsAndStatistics (ピラミッドと統計情報の構築) の例 1 (Python ウィンドウ)
以下は、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 (ピラミッドと統計情報の構築) の例 2 (スタンドアロン スクリプト)
以下は、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)
環境
ライセンス情報
- Basic: はい
- Standard: はい
- Advanced: はい