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

サマリー

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

使用法

  • サポートされているすべてのラスター形式が処理されます。

  • ECW、JPEG2000、MrSID などのウェーブレット圧縮ラスター データセットは、ピラミッド構築の必要がありません。 そのような形式のものには、エンコーディング時に作成される内部ピラミッドが含まれています。

パラメーター

ラベル説明データ タイプ
サブディレクトリを含む
(オプション)

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

  • オフ - サブディレクトリを含めません。
  • オン - 読み込むときに、サブディレクトリ内のすべてのラスター データセットを含めます。 これがデフォルトです。
Boolean
ピラミッドの構築
(オプション)

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

  • オフ - ピラミッドを構築しません。
  • オン - ピラミッドを構築します。 これがデフォルトです。
Boolean
統計情報の計算
(オプション)

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

  • オフ - 統計情報を計算しません。
  • オン - 統計情報を計算します。これがデフォルトです。
Boolean
ソース データセットを含む
(オプション)

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

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

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

String
モザイク データセット統計情報の推定
(オプション)

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

  • オフ - モザイク データセットの統計情報を計算しません。 これがデフォルトです。
  • オン - モザイク データセットの統計情報を計算します。
Boolean
X スキップ ファクター
(オプション)

サンプル間の水平方向のピクセル数。

統計情報の計算に使用されるラスター部分は、スキップ ファクターによって制御されます。水平方向または垂直方向のスキップ ファクターは、入力値で示されます。値が 1 のときは各ピクセルを使用し、値が 2 のときはピクセルを 1 つおきに使用します。スキップ ファクターの範囲は、1 からラスター内のカラム数またはロウ数までに限定されます。

この値は、ゼロより大きく、ラスター内のカラム数以下でなければなりません。デフォルトは 1、または最後に使用したスキップ ファクターです。

Long
Y スキップ ファクター
(オプション)

サンプル間の垂直方向のピクセル数。

統計情報の計算に使用されるラスター部分は、スキップ ファクターによって制御されます。水平方向または垂直方向のスキップ ファクターは、入力値で示されます。値が 1 のときは各ピクセルを使用し、値が 2 のときはピクセルを 1 つおきに使用します。スキップ ファクターの範囲は、1 からラスター内のカラム数またはロウ数までに限定されます。

この値は、ゼロより大きく、ラスターのロウ数以下でなければなりません。デフォルトは 1、または最後に使用した Y スキップ ファクターです。

Long
除外値
(オプション)

統計情報の計算に含まれないピクセル値。

デフォルトは値なしです。

Long
ピラミッド レベル
(オプション)

構築する低解像度データセット レイヤーの数。 デフォルト値は -1 で、完全なピラミッドを構築します。 値を 0 にすると、ピラミッド レベルなしになります。

指定できるピラミッド レベルの最大数は 29 です。 30 以上の値の場合、ピラミッドの完全なセットが作成されます。

Long
第 1 レベルをスキップ
(オプション)

最初のピラミッド レベルをスキップするかどうかを指定します。 第 1 レベルをスキップすると使用するディスク スペースが若干少なくなりますが、その縮尺でのパフォーマンスも低下します。

  • オフ - 最初のピラミッド レベルはスキップされず、構築されます。 これがデフォルトです。
  • オン - 最初のピラミッド レベルはスキップされ、構築されません。

Boolean
ピラミッド リサンプリング手法
(オプション)

ピラミッドの構築に使用されるリサンプリング手法を指定します。

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

ラスター ピラミッドを構築するときに使用する圧縮タイプを指定します。

  • デフォルトウェーブレット圧縮を使用してソース データを圧縮した場合は、JPEG 圧縮タイプでピラミッドが構築されます。それ以外の場合は、LZ77 が使用されます。 これがデフォルトです。
  • LZ77 圧縮LZ77 圧縮アルゴリズムを使用してピラミッドが構築されます。 この圧縮タイプはすべてのデータ タイプに使用できます。
  • JPEG 圧縮JPEG 圧縮アルゴリズムを使用してピラミッドが構築されます。 JPEG 圧縮仕様に準拠したデータだけが、この圧縮タイプを使用できます。 この圧縮タイプを指定した場合は、[圧縮品質] パラメーターの値を設定できます。
  • JPEG の輝度と彩度Luma (Y) と chroma (Cb と Cr) 色空間成分を使用する不可逆圧縮が使用されます。
  • 圧縮なしピラミッドを構築するときに、圧縮を行いません。
String
圧縮品質 (1-100)
(オプション)

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

Long
既存をスキップ
(オプション)

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

  • オン - 存在していない統計情報だけを計算します。 これがデフォルトです。
  • オフ - すでに存在している場合でも、統計情報を計算します。つまり、既存の統計情報は上書きされます。
Boolean
クエリ定義
(オプション)

処理されるラスター データセットを選択する SQL 式。

SQL Expression

派生した出力

ラベル説明データ タイプ
更新された入力データ

更新された出力ワークスペース。

Text File; Workspace; Raster Layer; Mosaic Layer

arcpy.management.BuildPyramidsandStatistics({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})
名前説明データ タイプ
include_subdirectories
(オプション)

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

  • NONEサブディレクトリを含めません。
  • INCLUDE_SUBDIRECTORIES読み込むときに、サブディレクトリ内のすべてのラスター データセットを含めます。 これがデフォルトです。
Boolean
build_pyramids
(オプション)

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

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

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

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

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

ピラミッドの構築に使用されるリサンプリング手法を指定します。

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

ラスター ピラミッドを構築するときに使用する圧縮タイプを指定します。

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

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

Long
skip_existing
(オプション)

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

  • SKIP_EXISTING存在していない統計情報だけを計算します。 これがデフォルトです。
  • OVERWRITEすでに存在している場合でも、統計情報を計算します。つまり、既存の統計情報は上書きされます。
Boolean
where_clause
(オプション)

処理されるラスター データセットを選択する SQL 式。

SQL Expression

派生した出力

名前説明データ タイプ
out_workspace

更新された出力ワークスペース。

Text File; Workspace; Raster Layer; Mosaic Layer

コードのサンプル

BuildPyramidsAndStatistics の例 1 (Python ウィンドウ)

以下は、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 の例 2 (スタンドアロン スクリプト)

以下は、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()

関連トピック