ポピュラリティー (Spatial Analyst ツール)

サマリー

引数リストの中で、特定のポピュラリティ レベルを持つ値をセルごとに判別します。 特定のポピュラリティ レベル (各値の発生数) は、最初の引数で指定します。

図

OutRas = Popularity(ValRas, [InRas1, InRas2, InRas3])

使用法

• The tool evaluates the number of occurrences of the input raster values for each location and ranks them on an ordinal scale—つまり、最も人気のあるもの、次に人気のあるもの、という具合です。 ポピュラリティ ラスター値で指定された n 番目に多い値が返されます。

• 入力ラスターのリストでは、順序は関係ありません。 ただし、ポピュラリティーの位置を定義するラスターはこれらの前に置く必要があります。

• 入力ラスター リストには任意の数のラスターを指定できます。

• いずれかのセル位置において入力値が同じ場合、指定したポピュラリティーにかかわらず、出力値はそのセル位置の入力値と同じになります。

• 入力ラスターに NoData を含むセル位置がある場合、その位置の出力は NoData になります。

• ある位置で n 番目にポピュラリティーが高い単一の値が見つからない場合、出力ラスターのその位置には NoData が割り当てられます。 この状況は、ある位置のすべての入力ラスター値が異なる場合、または 2 つ以上の入力ラスター値の出現回数が同じであり、その回数が n 番目にポピュラリティーが高い場合に発生します。 スキャン プロセスで最初に検出された値など、いずれかの入力ラスター値を返すことは誤解を招く可能性があります。 その値が本当に n 番目にポピュラリティーが高い値であるかどうかを確認することができないためです。

• ポピュラリティーの値が入力ラスターの数より大きい場合、出力の各セル位置には NoData が割り当てられます。

• ポピュラリティーの値として 0 を指定した場合、出力値は NoData になります。

• ポピュラリティー レベル 1 は最頻値であり、セル統計 ツールの最頻値オプションに似ています。

• 入力ラスターのいずれかが浮動小数点である場合、出力は浮動小数点になります。それ以外の場合、整数になります。

• マルチバンドとして処理 パラメーターがオフ (Python では process_as_multiband を SINGLE_BAND に設定) の場合、マルチバンドの 入力ポピュラリティー ラスター、または定数値 (Python では in_popularity_raster_or_constant) の最初のバンドのみが使用されます。 マルチバンドの 入力ラスター (Python では in_rasters) の各バンドは、シングルバンド ラスターとして個別に処理されます。

• マルチバンドとして処理 パラメーターがオンの場合 (Python で process_as_multiband が MULTI_BAND に設定されている場合)、マルチバンド ラスターの各入力はマルチバンド ラスターとして処理されます。

  出力のバンド数は、入力ポピュラリティー、または定数値 に依存します。 ポピュラリティー ラスターがシングル バンドの場合、出力ラスターのバンド数は、入力ラスターのすべてのマルチバンド ラスターの最大バンド数と同じになります。 ポピュラリティー ラスターがマルチバンドの場合、出力ラスターにはポピュラリティ ラスターと同じ数のバンドが含まれます。

  入力ラスター のいずれかが出力ラスターよりもバンド数が少ないラスターの場合、欠落しているバンドは NoData が設定されたバンドとして解釈されます。 ポピュラリティー ラスターのセル値が欠落したバンドから 1 つの値を選択した場合、出力ラスターは NoData を取得します。 入力ラスターのいずれかが定数の場合、すべてのバンドのセル値が定数と同じで、出力ラスターと同じ数のバンドが含まれるマルチバンド ラスターとして解釈されます。

• すべての入力が、同数の変数を含む多次元ラスター データの場合、このツールは、ディメンション値が同じすべてのスライスについて演算を実行します。 出力は CRF 形式の多次元ラスターになります。 このツールで処理を行うには、一般的なディメンションと一般的なディメンション値が入力の変数に少なくとも 1 つ必要です。これらがないとエラーが発生します。

  すべての入力に 1 つの変数が含まれているものの、名前が異なる場合は、演算を実行する前に多次元変数の照合ジオプロセシング環境をオフにします (Python では arcpy.env.matchMultidimensionalVariable = False を設定)。

  1 つ以上の入力が多次元ラスターで、それ以外の入力が定数である場合、このツールは、すべての変数のすべてのスライスについて、その定数値を使用して演算を実行し、出力は多次元ラスターになります。

• このツールに適用されるジオプロセシング環境の詳細については、解析環境と Spatial Analyst をご参照ください。

パラメーター

• Dialog
• Python

ラベル	説明	データ タイプ
入力ポピュラリティー、または定数値	返されるポピュラリティー位置を定義する入力ラスター。 数値を入力として使用できます。しかし、セル サイズと範囲を最初に環境で設定しておく必要があります。	Raster Layer; Constant
入力ラスター	各セル位置について、値のポピュラリティーを評価するために使用される入力ラスターのリスト。	Raster Layer
マルチバンドとして処理 (オプション)	マルチバンド ラスターのバンドを処理する方法を指定します。 オン—それぞれのマルチバンド ラスター入力はマルチバンド ラスターとして処理されます。 1 つの入力に含まれる各バンドについて、他の入力に含まれる対応バンド番号を使用して演算が行われます。 オフ—マルチバンド ラスター入力の各バンドは、シングルバンド ラスターとして別々に処理されます。 これがデフォルトです。	Boolean

戻り値

ラベル	説明	データ タイプ
出力ラスター	出力ラスター。 出力ラスターの各セルは、入力ポピュラリティー値に合致する入力ラスターの同じ位置の値を表します。	Raster

環境

自動コミット, セル サイズ, セル サイズ投影法, 圧縮, 現在のワークスペース, 範囲, 地理座標系変換, マスク, 出力データのコンフィグレーション キーワード, 出力座標系, スクラッチ ワークスペース, スナップ対象ラスター, タイル サイズ

ライセンス情報

• Basic: Spatial Analyst が必要
• Standard: Spatial Analyst が必要
• Advanced: Spatial Analyst が必要

関連トピック

• ローカル ツールセットの概要
• ジオプロセシング ツールの検索
• 指定された条件を満たす入力リストからの値の検索
• ランク