ライン統計 (Line Statistics) (Spatial Analyst)

Spatial Analyst のライセンスで利用可能。

サマリー

円形の近傍でのライン属性の統計値を計算します。

[ライン統計 (Line Statistics)] ツールの詳細

使用法

  • [出力セル サイズ] は、数値で定義するか、既存のラスター データセットから取得できます。セル サイズがパラメーター値として明示的に指定されていない場合、[セル サイズ] 環境が指定されていれば、そこから取得されます。パラメーターのセル サイズも環境のセル サイズも指定されておらず、[スナップ対象ラスター] 環境が設定されている場合には、スナップ ラスターのセル サイズが使用されます。何も指定されていない場合、セル サイズは範囲の幅または高さ (どちらか短い方) を 250 で割って求められます。この範囲は環境で指定された [出力座標系] にあります。

  • セル サイズが数値によって指定されている場合、このツールは出力ラスターに対してこの値を直接使用します。

    セル サイズがラスター データセットを使用して指定されている場合、パラメーターはセル サイズの値ではなくラスター データセットのパスを示します。データセットの空間参照が出力空間参照と同じである場合、解析ではラスター データセットのセル サイズが直接使用されます。データセットの空間参照が出力空間参照と異なる場合は、選択された [セル サイズ投影法] に基づいて投影されます。

  • [最頻値]、[平均値]、[中央値]、[最少頻値] [長さ] の統計情報の場合、近傍内にあるラインの部分だけが考慮されます。 他の種類の場合は、ラインの一部と全体のどちらを使用するかは問題ではありません。

  • ラスター セルの近傍内にラインがない場合、[種類] と [長さ] の統計情報には値 0 が割り当てられます。 他の統計情報については、NoData が割り当てられます。

  • [統計情報の種類 (オプション)] が [最頻値]、[平均値]、[中央値]、[最少頻値] の場合、ラインの長さに従って加重されます。 たとえば、ラインが別のラインの 2 倍の長さである場合、その値は 2 倍頻出すると見なされます。

  • [種類] の場合、出力ラスターの値は必ず整数になります。 [平均値] と [長さ] の場合は、必ず浮動小数になります。 他の統計情報の場合、出力データ タイプは入力アイテム値タイプと同じになります。

  • [統計情報の種類 (オプション)] が [最頻値]、[最大値]、[中央値]、[最小値]、[最少頻値]、および [範囲] の場合、ラスターの出力データ タイプは入力フィールド タイプと同じになります。 [統計情報の種類 (オプション)] が [平均値] と [長さ] の場合、出力ラスターは必ず浮動小数になります。 [種類] の場合、出力ラスターは必ず整数になります。

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

パラメーター

ラベル説明データ タイプ
入力ポリライン フィーチャ

各出力セルの近傍内の統計情報を計算する入力ポリライン フィーチャ。

Feature Layer
フィールド

指定された統計情報を計算するために使用するフィールド。 入力フィーチャの任意の数値フィールドを設定できます。

[統計の種類] を [長さ] に設定する場合、[フィールド] パラメーターは、[なし] に設定できます。

入力フィーチャが Z 値を含む場合、Shape フィールドを使用できます。

Field
出力セル サイズ
(オプション)

作成される出力ラスターのセル サイズ。

このパラメーターは、数値で定義するか、既存のラスター データセットから取得できます。セル サイズがパラメーター値として明示的に指定されていない場合、指定されていれば、環境のセル サイズ値が使用されます。そうでない場合は、追加のルールを使用して別の入力から計算されます。詳細については、使用方法をご参照ください。

Analysis Cell Size
検索範囲
(オプション)

統計情報の計算範囲となる検索範囲 (マップ単位)。

デフォルトの半径は、出力セル サイズの 5 倍です。

Double
統計情報の種類
(オプション)

計算する統計情報の種類を指定します。

統計情報は、近傍内にあるすべてのラインの指定フィールドの値に対して計算されます。

指定したフィールドが整数の場合、使用できる統計情報は、[平均値]、[最頻値]、[最大値]、[平均値]、[最小値]、[最少頻値]、[範囲]、および [種類] です。 フィールドが浮動小数点の場合、使用できる統計情報は、[平均値]、[最大値]、[最小値]、[範囲] のみです。

  • 平均値各近傍内の平均のフィールド値を計算します。長さで重み付けされます。計算の形式:
    • 平均値 = ((長さ * フィールド値) の合計) / (長さの合計)
    近傍内にある長さの部分だけが使用されます。
  • 最頻値近傍内にあるラインで最も長い値を求めます。
  • 最大近傍の最大値を求めます。
  • 中央値平均値を求めます。長さで重み付けされます。概念としては、近傍内のすべての線分は値で並べ替えられ、一直線上に配置されます。 この直線の中央点にある線分の値が平均値です。
  • 最小各近傍の最小値を計算します。
  • 最少頻値近傍内にあるラインで最も短い値を求めます。
  • 範囲値値の範囲 (最大 - 最小)。
  • 種類一意の値の数。
  • 長さ近傍の合計ライン長 フィールドの値が 1 以外の場合、長さは加算される前にアイテム値で乗算されます。 フィールド パラメーターに [なし] を設定する場合に、このオプションが使用できます。
String

戻り値

ラベル説明データ タイプ
出力ラスター

出力ライン統計ラスター。

Raster

LineStatistics(in_polyline_features, field, {cell_size}, {search_radius}, {statistics_type})
名前説明データ タイプ
in_polyline_features

各出力セルの近傍内の統計情報を計算する入力ポリライン フィーチャ。

Feature Layer
field

指定された統計情報を計算するために使用するフィールド。 入力フィーチャの任意の数値フィールドを設定できます。

[統計の種類] を Length に設定する場合、field パラメーターは、[なし] に設定できます。

入力フィーチャが Z 値を含む場合、Shape フィールドを使用できます。

Field
cell_size
(オプション)

作成される出力ラスターのセル サイズ。

このパラメーターは、数値で定義するか、既存のラスター データセットから取得できます。セル サイズがパラメーター値として明示的に指定されていない場合、指定されていれば、環境のセル サイズ値が使用されます。そうでない場合は、追加のルールを使用して別の入力から計算されます。詳細については、使用方法をご参照ください。

Analysis Cell Size
search_radius
(オプション)

統計情報の計算範囲となる検索範囲 (マップ単位)。

デフォルトの半径は、出力セル サイズの 5 倍です。

Double
statistics_type
(オプション)

計算する統計情報の種類を指定します。

統計情報は、近傍内にあるすべてのラインの指定フィールドの値に対して計算されます。

  • MEAN各近傍内の平均のフィールド値を計算します。長さで重み付けされます。計算の形式:
    • 平均値 = ((長さ * フィールド値) の合計) / (長さの合計)
    近傍内にある長さの部分だけが使用されます。
  • MAJORITY近傍内にあるラインで最も長い値を求めます。
  • MAXIMUM近傍の最大値を求めます。
  • MEDIAN平均値を求めます。長さで重み付けされます。概念としては、近傍内のすべての線分は値で並べ替えられ、一直線上に配置されます。 この直線の中央点にある線分の値が平均値です。
  • MINIMUM各近傍の最小値を計算します。
  • MINORITY近傍内にあるラインで最も短い値を求めます。
  • RANGE値の範囲 (最大 - 最小)。
  • VARIETY一意の値の数。
  • LENGTH近傍の合計ライン長 フィールドの値が 1 以外の場合、長さは加算される前にアイテム値で乗算されます。 フィールド パラメーターに [なし] を設定する場合に、このオプションが使用できます。

指定したフィールドが整数の場合、使用できる統計情報は、[平均値]、[最頻値]、[最大値]、[平均値]、[最小値]、[最少頻値]、[範囲]、および [種類] です。 フィールドが浮動小数点の場合、使用できる統計情報は、[平均値]、[最大値]、[最小値]、[範囲] のみです。

String

戻り値

名前説明データ タイプ
out_raster

出力ライン統計ラスター。

Raster

コードのサンプル

LineStatistics (ライン統計) の例 1 (Python ウィンドウ)

次の例では、入力ラスター内の各セルの指定半径内にある線分の平均長を計算しています。

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")
LineStatistics (ライン統計) の例 2 (スタンドアロン スクリプト)

次の例では、入力ラスター内の各セルの指定半径内にある線分の平均長を計算しています。

# 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

# Execute LineStatistics
lineStatOut = LineStatistics(inLines, field, cellSize, searchRadius,
                              "MEAN")

# Save the output 
lineStatOut.save("C:/sapyexamples/output/linestatisout")

関連トピック