ライン統計（Line Statistics） (Spatial Analyst)
使用法
-
[MAJORITY]、[MEAN]、[MEDIAN]、[MINORITY] [LENGTH] の統計情報の場合、近傍内にあるラインの部分だけが考慮されます。他の種類の場合は、ラインの一部と全体のどちらを使用するかは問題ではありません。
-
ラスタ セルの近傍内にラインがない場合、[VARIETY] と [LENGTH] の統計情報には値 0 が割り当てられます。他の統計情報については、NoData が割り当てられます。
-
[統計情報の種類（オプション）] が [MAJORITY]、[MEAN]、[MEDIAN]、[MINORITY] の場合、ラインの長さに従って加重されます。たとえば、ラインが別のラインの 2 倍の長さである場合、その値は 2 倍頻出すると見なされます。
-
[VARIETY] の場合、出力ラスタの値は必ず整数になります。[MEAN] と [LENGTH] の場合は、必ず浮動小数になります。他の統計情報の場合、出力データ タイプは入力アイテム値タイプと同じになります。
-
フィールドが整数の場合、使用できるオーバーレイ統計情報は、[MEAN]、[MAJORITY]、[MAXIMUM]、[MEDIAN]、[MINIMUM]、[MINORITY]、[RANGE]、および [VARIETY] です。フィールドが浮動小数点の場合、使用できる統計情報は、[MEAN]、[MAXIMUM]、[MINIMUM]、[RANGE] のみです。
-
[統計情報の種類（オプション）] が [MAJORITY]、[MAXIMUM]、[MEDIAN]、[MINIMUM]、[MINORITY]、および [RANGE] の場合、ラスタの出力データ タイプは入力フィールド タイプと同じになります。[統計情報の種類（オプション）] が [MEAN] と [LENGTH] の場合、出力ラスタは必ず浮動小数になります。[VARIETY] の場合、出力ラスタは必ず整数になります。
構文
| パラメータ | 説明 | データ タイプ |
in_polyline_features |
ライン統計を計算する入力ポリライン フィーチャ。 | Feature Layer |
field | 指定された統計情報を計算するのに使用するフィールド入力ライン フィーチャの任意の数値フィールドを設定できます。 [統計情報の種類（オプション）] を [Length] に設定する場合、フィールドは、[なし] に設定できます。 入力フィーチャが Z 値を含む場合、Shape フィールドを使用できます。 | Field |
cell_size (オプション) |
出力ラスタ データセットのセル サイズ 環境設定で特定の値が指定されている場合、その値を使用します。設定されていない場合は、出力空間参照において、入力フィーチャ データセットの範囲の幅または高さ（どちらか短い方）を 250 で割った値になります。 | Analysis Cell Size |
search_radius (オプション) |
統計情報の計算範囲となる検索半径（マップ単位）。 デフォルトの半径は、出力セル サイズの 5 倍です。 | Double |
statistics_type (オプション) |
計算する統計情報の種類。 統計情報は、近傍内にあるすべてのラインの指定フィールドの値に対して計算されます。
| String |
戻り値
| 名前 | 説明 | データ タイプ |
| out_raster |
出力ライン統計ラスタ。 | Raster |
コードのサンプル
次の例では、入力ラスタ内の各セルの指定半径内にある線分の平均長を計算しています。
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
lineStatOut = LineStatistics("streams", "LENGTH", 50, 500, "MEAN")
lineStatOut.save("C:/sapyexamples/output/linestatout")
次の例では、入力ラスタ内の各セルの指定半径内にある線分の平均長を計算しています。
# Name: LineStatistics_Ex_02.py
# Description:
# 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
inLines = "streams.shp"
field = "LENGTH"
cellSize = 50
searchRadius = 500
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute LineStatistics
lineStatOut = LineStatistics(inLines, field, cellSize, searchRadius,
"MEAN")
# Save the output
lineStatOut.save("C:/sapyexamples/output/linestatisout")