線密度(Line Density) (Spatial Analyst)

サマリ

各セルの半径内にあるポリライン フィーチャから単位面積ごとの値を計算します。

[線密度(Line Density)] ツールの仕組みの詳細

使用法

構文

LineDensity (in_polyline_features, population_field, {cell_size}, {search_radius}, {area_unit_scale_factor})
パラメータ説明データ タイプ
in_polyline_features

密度を計算する入力ライン フィーチャ。

Feature Layer
population_field

各ポリラインの人口値を示す数値フィールド(ラインを数える回数)。

population フィールドの値は、整数値または浮動小数点値です。

フィールドのオプションとデフォルトの動作は以下のとおりです。

  • アイテムまたは特殊な値を使用せず、各フィーチャを 1 回だけカウントする場合は、None を使用します。

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

  • それ以外の場合、デフォルト フィールドは POPULATION です。以下の条件も適用されます。

    • POPULATION フィールドが存在せず、POPULATIONxxxx フィールドが存在する場合は、このフィールドがデフォルトで使用されます。"xxxx" は任意の有効な文字です。たとえば、POPULATION6POPULATION1974POPULATIONROADTYPE などです。
    • POPULATION フィールドまたは POPULATIONxxxx フィールドが存在せず、POP フィールドが存在する場合は、このフィールドがデフォルトで使用されます。
    • POPULATION フィールド、POPULATIONxxxx フィールド、または POP フィールドが存在せず、POPxxxx フィールドが存在する場合は、このフィールドがデフォルトで使用されます。
    • POPULATION フィールド、POPULATIONxxxx フィールド、POP フィールド、または POPxxxx フィールドが存在しない場合は、NONE がデフォルトで使用されます。
Field
cell_size
(オプション)

出力ラスタ データセットのセル サイズ。

環境設定で特定の値が指定されている場合、その値を使用します。設定されていない場合、セル サイズは、出力空間参照において、出力の範囲の幅または高さ(どちらか短い方)を 250 で割った値になります。

Analysis Cell Size
search_radius
(オプション)

密度の計算対象となる検索範囲。単位は、出力空間参照の投影法の距離単位に基づきます。

たとえば、単位がメートルの場合、1 マイル近傍内のフィーチャをすべて含めるには、検索範囲を 1609.344 に設定します(1 マイル = 1609.344 メートル)。

デフォルトは、出力空間参照において、出力範囲の幅または高さ(どちらか短い方)を 30 で割った値になります。

Double
area_unit_scale_factor
(オプション)

出力密度値の望ましい面積単位。

デフォルトの単位は、出力空間参照の投影法の距離単位に基づいて選択されます。密度の出力を変換する場合は、これを適切な単位に変更できます。線密度の値は長さと面積の両方の単位を変換します。

たとえば、入力単位がメートルの場合、デフォルトの出力の面積密度単位はポイント フィーチャでは平方キロメートル、ポリライン フィーチャではキロメートル/平方キロメートルになります。

入力フィーチャの単位に基づくデフォルトの密度単位は以下のとおりです。

  • SQUARE_MAP_UNITS 単位が不明、ポイント、または度(10 進)の場合。
  • SQUARE_MILES フィート、ヤード、マイル、または海里の場合。
  • SQUARE_KILOMETERS メートルまたはキロメートルの場合。
  • SQUARE_INCHES インチの場合。
  • 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

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute LineDensity
outLineDensity = LineDensity(inPolylineFeatures, populationField, cellSize,
                             searchRadius, "SQUARE_MILES") 

# Save the output 
outLineDensity.save("C:/sapyexamples/output/linedensity")

環境

関連項目

ライセンス情報

ArcView: 必須 Spatial Analyst
ArcEditor: 必須 Spatial Analyst
ArcInfo: 必須 Spatial Analyst

7/10/2012