線密度 (Spatial Analyst ツール)
サマリー
各セルの半径内にあるポリライン フィーチャから単位面積ごとの値を計算します。
線密度の詳細
図
OutRas = LineDensity(InRds, None, 30)
使用法
密度の計算時、近傍内のラインの一部だけが考慮されます。 特定のセルの近傍内にラインがない場合、そのセルには NoData が割り当てられます。
半径パラメーターの値を大きくすると、より一般化された密度ラスターが生成されます。 値が小さいほど、詳細を示すラスターが作成されます。
出力ラスターの値は常に浮動小数値になります。
出力セル サイズ パラメーターは、数値で定義するか、既存のラスター データセットから取得することができます。 セル サイズがパラメーター値として明示的に指定されていない場合、セル サイズ環境が指定されていれば、そこから取得されます。 パラメーターのセル サイズまたは環境のセル サイズは指定されていないが、スナップ対象ラスター環境が設定されている場合、スナップ対象ラスターのセル サイズが使用されます。 何も指定されていない場合、セル サイズは範囲の幅および高さのうち小さい方を 250 で割った値で計算されます (範囲が環境で指定された出力座標系に存在する場合)。
数値を使用してセル サイズを指定した場合、出力ラスターではそれが直接使用されます。
ラスター データセットを使用してセル サイズを指定した場合、パラメーターにはセル サイズの値ではなく、ラスター データセットのパスが表示されます。 データセットの空間参照が出力空間参照と同じであれば、そのラスター データセットのセル サイズが解析で直接使用されます。 データセットの空間参照が出力空間参照と異なる場合、指定した セル サイズ投影法 の値に基づいて投影されます。
NULL 値をサポートするデータ形式 (ファイル ジオデータベース フィーチャクラスなど) では、入力として使用された NULL 値は無視されます。
面積単位の係数単位がフィーチャ (ライン セクションの長さ) に比べて小さい場合、出力値が小さくなる可能性があります。 大きな値を得るには、大きな単位の面積単位の係数 (平方キロメートル対平方メートルなど) を使用します。
このツールに適用されるジオプロセシング環境の詳細については、解析環境と Spatial Analyst をご参照ください。
パラメーター
ラベル
説明
データ タイプ
入力ポリライン フィーチャ
密度を計算する入力ライン フィーチャ。
Feature Layer
母集団フィールド
各ポリラインの母集団値 (ラインをカウントする回数) を示す数値フィールド。
母集団フィールドの値は、整数値または浮動小数点値です。
フィールドのオプションとデフォルトの動作は以下のとおりです。
アイテムまたは特殊な値を使用せず、各フィーチャを 1 回だけカウントする場合は、NONE を使用します。
入力フィーチャに z 値がある場合は、Shape フィールドを使用できます。
Z 値がない場合は、POPULATION がデフォルト フィールドになります。 以下の条件も適用されます。
POPULATION フィールドが存在せず、POPULATIONabcd フィールドが存在する場合は、このフィールドがデフォルトで使用されます。 abcd は有効な任意の文字です (例: POPULATION6、POPULATION1974、POPULATIONROADTYPE)。
POPULATION フィールドも POPULATIONabcd フィールドも存在せず、POP フィールドが存在する場合は、POP フィールドがデフォルトで使用されます。
POPULATION フィールド、POPULATIONabcd フィールド、POP フィールドが存在せず、POPabcd フィールドが存在する場合は、POPabcd フィールドがデフォルトで使用されます。
POPULATION フィールド、POPULATIONabcd フィールド、POP フィールド、POPabcd フィールドがいずれも存在しない場合は、NONE がデフォルトで使用されます。
Field
出力セル サイズ
(オプション)
作成される出力ラスターのセル サイズ。
このパラメーターは、数値で定義するか、既存のラスター データセットから取得することができます。 セル サイズがパラメーター値として明示的に指定されていない場合、環境セル サイズの値が指定されていれば、それが使用されます。そうでない場合、その他のルールを使用してその他の入力から計算されます。 詳細については、使用法セクションをご参照ください。
Analysis Cell Size
検索範囲
(オプション)
密度の計算対象となる検索範囲。 単位は、出力空間参照の投影法の距離単位に基づきます。
たとえば、単位がメートルの場合、1 マイル近傍内のフィーチャをすべて含めるには、検索範囲を 1609.344 に設定します (1 マイル = 1609.344 メートル)。
デフォルトは、出力空間参照において、出力範囲の幅または高さ (どちらか短い方) を 30 で割った値になります。
Double
面積単位
(オプション)
出力密度値に使用される面積単位を指定します。
デフォルトの単位は、出力空間参照の距離単位に基づいて決定されます。 密度の出力を変換する場合は、この単位を適切な単位に変更することができます。 線密度の値は長さと面積の両方の単位を変換します。
出力空間参照を指定しなかった場合、出力空間参照は入力フィーチャクラスと同じになります。 デフォルトの出力密度単位は、出力空間参照の距離単位に基づいて決定されます。 出力の距離単位がメートルの場合、出力の面積密度単位は 平方キロメートル 、ポリライン フィーチャではキロメートル/平方キロメートルになります。 出力の距離単位がフィートの場合、出力の面積密度単位は 平方マイル に設定されます。
出力の距離単位がフィートまたはメートル以外の場合、出力の面積密度単位は 平方マップ単位 に設定されます。 つまり、出力の密度単位は出力空間参照の投影法の距離単位の平方になります。 たとえば、出力の距離の単位がセンチメートルの場合、出力の面積密度の単位は 平方マップ単位 になり、結果として平方センチメートルになります。 出力の距離の単位がキロメートルの場合、出力の面積密度の単位は 平方マップ単位 になり、結果として平方キロメートルになります。
利用可能なオプションとそれに対応する出力の密度単位は次のとおりです。
String
戻り値
ラベル
説明
データ タイプ
出力ラスター
出力線密度ラスター。
常に浮動小数点ラスターです。
Raster
LineDensity(in_polyline_features, population_field, {cell_size}, {search_radius}, {area_unit_scale_factor})
名前
説明
データ タイプ
in_polyline_features
密度を計算する入力ライン フィーチャ。
Feature Layer
population_field
各ポリラインの母集団値 (ラインをカウントする回数) を示す数値フィールド。
母集団フィールドの値は、整数値または浮動小数点値です。
フィールドのオプションとデフォルトの動作は以下のとおりです。
アイテムまたは特殊な値を使用せず、各フィーチャを 1 回だけカウントする場合は、NONE を使用します。
入力フィーチャに z 値がある場合は、Shape フィールドを使用できます。
Z 値がない場合は、POPULATION がデフォルト フィールドになります。 以下の条件も適用されます。
POPULATION フィールドが存在せず、POPULATIONabcd フィールドが存在する場合は、このフィールドがデフォルトで使用されます。 abcd は有効な任意の文字です (例: POPULATION6、POPULATION1974、POPULATIONROADTYPE)。
POPULATION フィールドも POPULATIONabcd フィールドも存在せず、POP フィールドが存在する場合は、POP フィールドがデフォルトで使用されます。
POPULATION フィールド、POPULATIONabcd フィールド、POP フィールドが存在せず、POPabcd フィールドが存在する場合は、POPabcd フィールドがデフォルトで使用されます。
POPULATION フィールド、POPULATIONabcd フィールド、POP フィールド、POPabcd フィールドがいずれも存在しない場合は、NONE がデフォルトで使用されます。
Field
cell_size
(オプション)
作成される出力ラスターのセル サイズ。
このパラメーターは、数値で定義するか、既存のラスター データセットから取得することができます。 セル サイズがパラメーター値として明示的に指定されていない場合、環境セル サイズの値が指定されていれば、それが使用されます。そうでない場合、その他のルールを使用してその他の入力から計算されます。 詳細については、使用法セクションをご参照ください。
Analysis Cell Size
search_radius
(オプション)
密度の計算対象となる検索範囲。 単位は、出力空間参照の投影法の距離単位に基づきます。
たとえば、単位がメートルの場合、1 マイル近傍内のフィーチャをすべて含めるには、検索範囲を 1609.344 に設定します (1 マイル = 1609.344 メートル)。
デフォルトは、出力空間参照において、出力範囲の幅または高さ (どちらか短い方) を 30 で割った値になります。
Double
area_unit_scale_factor
(オプション)
出力密度値に使用される面積単位を指定します。
デフォルトの単位は、出力空間参照の距離単位に基づいて決定されます。 密度の出力を変換する場合は、この単位を適切な単位に変更することができます。 線密度の値は長さと面積の両方の単位を変換します。
出力空間参照を指定しなかった場合、出力空間参照は入力フィーチャクラスと同じになります。 デフォルトの出力密度単位は、出力空間参照の距離単位に基づいて決定されます。 出力の距離単位がメートルの場合、出力の面積密度単位は 平方キロメートルSQUARE_KILOMETERS、ポリライン フィーチャではキロメートル/平方キロメートルになります。 出力の距離単位がフィートの場合、出力の面積密度単位は SQUARE_MILES に設定されます。
出力の距離単位がフィートまたはメートル以外の場合、出力の面積密度単位は SQUARE_MAP_UNITS に設定されます。 つまり、出力の密度単位は出力空間参照の投影法の距離単位の平方になります。 たとえば、出力の距離の単位がセンチメートルの場合、出力の面積密度の単位は SQUARE_MAP_UNITS になり、結果として平方センチメートルになります。 出力の距離の単位がキロメートルの場合、出力の面積密度の単位は SQUARE_MAP_UNITS になり、結果として平方キロメートルになります。
利用可能なオプションとそれに対応する出力の密度単位は次のとおりです。
SQUARE_MAP_UNITS出力空間参照の距離単位の平方が使用されます。
SQUARE_MILESUS マイルが使用されます。
SQUARE_KILOMETERSキロメートルが使用されます。
ACRESUS エーカーが使用されます。
HECTARESヘクタールが使用されます。
SQUARE_YARDSUS ヤードが使用されます。
SQUARE_FEETUS フィートが使用されます。
SQUARE_INCHESUS インチが使用されます。
SQUARE_METERSメートルが使用されます。
SQUARE_CENTIMETERSセンチメートルが使用されます。
SQUARE_MILLIMETERSミリメートルが使用されます。
String
戻り値
名前
説明
データ タイプ
out_raster
出力線密度ラスター。
常に浮動小数点ラスターです。
Raster
コードのサンプル
LineDensity 例 1 (Python ウィンドウ)
この例は、ポリライン シェープ ファイルの長さフィールドの密度ラスターを計算します。
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outLDens = LineDensity("roads.shp", "LENGTH", 45, 1000, "SQUARE_MILES")
outLDens.save("C:/sapyexamples/output/ldensout")
LineDensity スクリプトの例 2 (スタンドアロン スクリプト)
この例は、ポリライン シェープ ファイルの長さフィールドの密度ラスターを計算します。
# Name: LineDensity_Ex_02.py
# Description: Calculates a magnitude per unit area from polyline features
# that fall within a radius around each cell.
# 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
inPolylineFeatures = "roads.shp"
populationField = "length"
cellSize = 120
searchRadius = 1500
# Run LineDensity
outLineDensity = LineDensity(inPolylineFeatures, populationField, cellSize,
searchRadius, "SQUARE_MILES")
# Save the output
outLineDensity.save("C:/sapyexamples/output/linedensity")
環境
自動コミット , セル サイズ , セル サイズ投影法 , 現在のワークスペース , 範囲 , 地理座標系変換 , マスク , 出力データのコンフィグレーション キーワード , 出力座標系 , スクラッチ ワークスペース , スナップ対象ラスター , タイル サイズ
ライセンス情報
Basic: Spatial Analyst が必要
Standard: Spatial Analyst が必要
Advanced: Spatial Analyst が必要
