カーネル密度(Kernel Density) (Spatial Analyst)

ライセンス レベル:BasicStandardAdvanced

サマリ

カーネル関数を使用してポイントまたはポリライン フィーチャから単位面積ごとの値を計算し、各ポイントまたはポリラインに滑らかなテーパ サーフェスを合わせます。

カーネル密度(Kernel Density)ツールの仕組みの詳細

[カーネル密度(Kernel Density)] の図
OutRas = KernelDensity(InPts, None, 30)

使用法

構文

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

密度を計算する入力フィーチャ(ポイントまたはライン)。

Feature Layer
population_field

各フィーチャの人口値を示すフィールド。[Population フィールド] は、連続サーフェスを作成する地形上に分散する個数や数量です。

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 メートル)。

デフォルトの検索半径(バンド幅)は、空間的な外れ値(つまり、他のポイントから非常に離れているポイント)に強い Silverman's Rule of Thumb の空間的変異を使用して、その入力データセットに特化して計算されます。このアルゴリズムの説明については、上の使用上のヒントをご参照ください。

Double
area_unit_scale_factor
(オプション)

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

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

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

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

  • SQUARE_MAP_UNITS 単位が不明、ポイント、または度(10 進)の場合。
  • SQUARE_MILES フィート、ヤード、マイル、または海里の場合。
  • SQUARE_KILOMETERS メートルまたはキロメートルの場合。
  • SQUARE_INCHES インチの場合。
  • SQUARE_CENTIMETERS センチメートルの場合。
  • SQUARE_MILLIMETERS ミリメートルの場合。
String

戻り値

名前説明データ タイプ
out_raster

出力カーネル密度ラスタ。

常に浮動小数点ラスタです。

Raster

コードのサンプル

KernelDensity(カーネル密度)の例 1(Python ウィンドウ)

次の例では、ポイント シェープ ファイルから滑らかな密度のラスタを計算しています。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outKDens = KernelDensity("rec_sites.shp", "NONE", 45, 1200, "SQUARE_KILOMETERS")
outKDens.save("C:/sapyexamples/output/kdensout")
KernelDensity(カーネル密度)の例 2(スタンドアロン スクリプト)

次の例では、ポイント シェープ ファイルから滑らかな密度のラスタを計算しています。

# Name: KernelDensity_Ex_02.py
# Description: Calculates a magnitude per unit area from point or polyline 
#    features using a kernel function to fit a smoothly tapered 
#    surface to each point or polyline.
# 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
inFeatures = "rec_sites.shp"
populationField = "NONE"
cellSize = 60
searchRadius = 2500


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

# Execute KernelDensity
outKernelDensity = KernelDensity(inFeatures, populationField, cellSize,
                                 searchRadius, "SQUARE_KILOMETERS")

# Save the output 
outKernelDensity.save("C:/sapyexamples/output/kerneldout")

環境

関連トピック

ライセンス情報

ArcGIS for Desktop Basic: 次のものが必要 Spatial Analyst
ArcGIS for Desktop Standard: 次のものが必要 Spatial Analyst
ArcGIS for Desktop Advanced: 次のものが必要 Spatial Analyst
7/28/2014