Spatial Analyst のライセンスで利用可能。
サマリー
一連のラスターの値が別のラスターと等しい回数をセルごとに評価します。
図
![[等しい値の頻度 (Equal To Frequency)] の図](GUID-5FEC0554-CFFF-40CC-949F-F633DB84464D-web.png "[等しい値の頻度 (Equal To Frequency)] の図")
使用法
入力ラスター リストには任意の数のラスターを指定できます。
[入力値ラスター] (Python では in_value_raster) にマルチバンド ラスターが指定された場合、最初のバンドのみが使用されます。別のバンドを処理するには、使用する特定のバンドを指定します。
[入力ラスター] (Python では in_rasters) の 1 つとしてマルチバンド ラスターが指定された場合、すべてのバンドが使用されます。
マルチバンド ラスターから選択したバンドを処理するには、まず、[コンポジット バンド (Composite Bands)] ツールを使用して、それら特定のバンドから構成される新しいラスター データセットを作成し、その結果を [入力ラスター] (Python では in_rasters) のリストで使用できます。
入力ラスターに NoData を含むセル位置がある場合、その位置の出力は NoData になります。
出力ラスターのタイプは、必ず整数になります。
このツールに適用されるジオプロセシング環境の詳細については、「解析環境と Spatial Analyst」をご参照ください。
構文
EqualToFrequency (in_value_raster, in_rasters)
| パラメーター | 説明 | データ タイプ |
in_value_raster | 入力値ラスターの各セル位置に対して、入力リストのラスターが同じ値を持つ回数 (頻度) を数えることができます。 | Raster Layer |
in_rasters [in_raster,...] | 値ラスターと比較されるラスターのリスト。 | Raster Layer |
戻り値
| 名前 | 説明 | データ タイプ |
| out_raster | 出力ラスター。 出力ラスターの各セルにおいて、値はラスターのリスト内にある対応セルが、値ラスターと同じである回数を表します。 | Raster |
コードのサンプル
EqualToFrequency (等しい値の頻度) の例 1 (Python ウィンドウ)
次の例では、一連の入力ラスターが別のラスターと等しい回数を評価し、結果を TIFF ラスターとして出力しています。
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outETF = EqualToFrequency("cost", ["degs", "negs", "fourgrd"])
outETF.save("C:/sapyexamples/output/outetf.tif")
EqualToFrequency (等しい値の頻度) の例 2 (スタンドアロン スクリプト)
次の例では、一連の入力ラスターが別のラスターと等しい回数を評価し、結果を Grid ラスターとして出力しています。
# Name: EqualToFrequency_Ex_02.py
# Description: Evaluates the number of times a set of rasters is
# equal to another raster on a cell-by-cell basis
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inValueRaster = "cost"
inRaster01 = "degs"
inRaster02 = "negs"
inRaster03 = "fourgrd"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute EqualToFrequency
outETF = EqualToFrequency(inValueRaster, [inRaster01, inRaster02, inRaster03])
# Save the output
outETF.save("C:/sapyexamples/output/outETF")
環境
ライセンス情報
- ArcGIS Desktop Basic: 次のものが必要 Spatial Analyst
- ArcGIS Desktop Standard: 次のものが必要 Spatial Analyst
- ArcGIS Desktop Advanced: 次のものが必要 Spatial Analyst