ピラミッドと統計情報の構築(Build Pyramids And Statistics) (データ管理)

ライセンス レベル:BasicStandardAdvanced

サマリ

フォルダ構造を横断して、その中に含まれるすべてのラスタ データセットのピラミッドを構築し、統計情報を計算します。ラスタ カタログやモザイク データセットに含まれるすべてのアイテムのピラミッド構築および統計情報の計算にも使用することができます。

使用法

構文

BuildPyramidsAndStatistics_management (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})
パラメータ説明データ タイプ
in_workspace

処理対象となるすべてのラスタ データセット、およびモザイク データセットまたはラスタ カタログが含まれているワークスペース。

ワークスペースがラスタ カタログまたはモザイク データセットを含む場合、ツールの実行時にはそれらのアイテムは含められません。

Mosaic Dataset; Mosaic Layer; Raster Catalog Layer; Raster Dataset; Text File; Workspace
include_subdirectories
(オプション)

サブディレクトリを含めるかどうかを指定します。

  • NONEサブディレクトリを含めません。
  • INCLUDE_SUBDIRECTORIES読み込むときに、サブディレクトリ内のすべてのラスタ データセットを含めます。これはデフォルト設定です。

ラスタ カタログおよびモザイク データセットを入力ワークスペースとして指定しなければなりません。ワークスペースがラスタ カタログまたはモザイク データセットを含む場合、ツールの実行時にはそれらのアイテムは含められません。

Boolean
build_pyramids
(オプション)

ピラミッドを構築するかどうかを指定します。

  • NONEピラミッドを構築しません。
  • BUILD_PYRAMIDSピラミッドを構築します。これはデフォルト設定です。
Boolean
calculate_statistics
(オプション)

統計情報を計算するかどうかを指定します。

  • なし統計情報を計算しません。
  • CALCULATE_STATISTICS統計情報を計算します。これはデフォルト設定です。
Boolean
BUILD_ON_SOURCE
(オプション)

ピラミッドを構築してソース ラスタ データセットの統計情報を計算するか、モザイク データセットのラスタ アイテムの統計情報を計算するかを指定します。このオプションの適用対象となるのは、モザイク データセットだけです。

  • NONEモザイク データセットのラスタ アイテムごと(属性テーブルの行ごと)に統計情報が計算されますラスタ アイテムに追加された関数は、統計情報を生成する前に適用されます。これはデフォルト設定です。
  • BUILD_ON_SOURCEモザイク データセットのソース データのピラミッドを構築し、統計情報を計算します。
Boolean
block_field
(オプション)

計算または操作の実行時に 1 つのアイテムとみなす必要があるアイテムを識別するための、モザイク データセットの属性テーブル内のフィールド名。

String
estimate_statistics
(オプション)

(モザイク データセット内のラスタではなく)モザイク データセットの統計情報を計算するかどうかを指定します。統計情報は、モザイク データセット内の各ラスタについて計算された既存の統計情報から得られます。

  • NONEモザイク データセットの統計情報を計算しません。これはデフォルト設定です。
  • 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 レベルをスキップすると使用するディスク スペースが若干少なくなりますが、その縮尺でのパフォーマンスも低下します。

  • NONE最初のピラミッド レベルは構築されません。これはデフォルト設定です。
  • SKIP_FIRST最初のピラミッド レベルは構築されません。
Boolean
resample_technique
(オプション)

ピラミッドの構築に使用するリサンプリング手法。

  • NEAREST最近隣内挿法は、リサンプリング時に、最も近いセルの値を使用して出力セルに値を割り当てます。これはデフォルト設定です。
  • BILINEAR共一次内挿は、4 つの最近隣入力セルの中心の重み付けされた距離に基づいてセルの新しい値を決定します。
  • CUBIC三次たたみ込み内挿法は、16 の最近隣入力セルの中心を通る滑らかなカーブの適合に基づいて、セルの新しい値を算出します。
String
compression_type
(オプション)

ラスタ ピラミッドを構築するときに使用する圧縮タイプ:

  • DEFAULTウェーブレット圧縮を使用してソース データを圧縮すると、JPEG 圧縮タイプでピラミッドが構築されます。それ以外の場合は、LZ77 が使用されます。これがデフォルトの圧縮方法です。
  • LZ77LZ77 圧縮アルゴリズムがピラミッドの構築に使用されます。LZ77 はすべてのデータ タイプに使用できます。
  • JPEGJPEG 圧縮アルゴリズムがピラミッドの構築に使用されます。JPEG 圧縮仕様に準拠したデータだけが、この圧縮タイプを使用できます。JPEG を選択した場合は、圧縮品質を設定できます。
  • JPEG_YCbCrLuma(Y)と chroma(Cb と Cr)色空間成分を使用する不可逆圧縮
  • NONEピラミッドを構築するときに、圧縮を行いません。
String
compression_quality
(オプション)

JPEG 圧縮法でピラミッドを構築するときに使用する圧縮品質。指定する値は、0 ~ 100 の間の値でなければなりません。100 に近い数は高品質な画像を生成しますが、圧縮比は低くなります。

Long
skip_existing
(オプション)

不足している箇所だけの統計情報を計算するか、存在している箇所のピラミッドも再生成するかを指定します。

  • SKIP_EXISTING存在していない統計情報だけを計算します。これはデフォルト設定です。
  • OVERWRITEすでに存在している場合でも、統計情報を計算します。したがって、既存の統計情報は上書きされます。
Boolean

コードのサンプル

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)

環境

関連トピック

ライセンス情報

ArcGIS for Desktop Basic: ○
ArcGIS for Desktop Standard: ○
ArcGIS for Desktop Advanced: ○
7/28/2014