点密度(Point Density) (Spatial Analyst)

ライセンス レベル:BasicStandardAdvanced

サマリ

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

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

使用法

構文

PointDensity (in_point_features, population_field, {cell_size}, {neighborhood}, {area_unit_scale_factor})
パラメータ説明データ タイプ
in_point_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
neighborhood
(オプション)

密度値の計算に使用する各セル周辺のエリアの形状を指定します。

これは、近傍解析クラスです。

近傍解析クラスは次の 4 種類です。NbrAnnulusNbrCircleNbrRectangleNbrWedge

クラスの形式と説明:

  • NbrAnnulus ({内径}, {外径}, {CELL | MAP})

    内径および外形で定義される円環(ドーナツ形状)の近傍。

  • NbrCircle ({半径}, {CELL | MAP})

    指定した半径の円形の近傍。

  • NbrRectangle ({幅}, {高さ}, {CELL | MAP})

    指定した高さと幅の長方形の近傍。

  • NbrWedge ({半径}, {開始角度}, {終了角度}, {CELL | MAP})

    扇形(パイ形)の近傍。扇形は、開始角度、終了角度、および半径で指定されます。扇形の角度は、反時計回りです。角度は、算術の度(正の X 軸から反時計回り)で指定します。負の角度も使用できます。

  • {CELL | MAP}

    単位をセルの数またはマップ単位の値として定義します。

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

Neighborhood
area_unit_scale_factor
(オプション)

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

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

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

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

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

戻り値

名前説明データ タイプ
out_raster

出力ポイント密度ラスタ。

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

Raster

コードのサンプル

PointDensity(点密度)の例 1(Python ウィンドウ)

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
pdensOut = PointDensity("rec_sites.shp", "NONE", 60, NbrCircle(2500, "MAP"))
pdensOut.save("C:/sapyexamples/output/pointdensity")
PointDensity(点密度)の例 2(スタンドアロン スクリプト)

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

# Name: PointDensity_Ex_02.py
# Description: Calculates a magnitude per unit area from point 
#    features that fall within a neighborhood 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
inFeatures = "rec_sites.shp"
populationField = "NONE"
cellSize = 60

# Create the Neighborhood Object
radius = 2500
myNbrCirc = NbrCircle(radius, "MAP")

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

# Execute PointDensity
outPdens = PointDensity(inFeatures, populationField, cellSize, 
                        myNbrCirc, "SQUARE_KILOMETERS")

# Save the output 
outPdens.save("C:/sapyexamples/output/outpdens")

環境

関連トピック

ライセンス情報

ArcGIS for Desktop Basic: 次のものが必要 Spatial Analyst
ArcGIS for Desktop Standard: 次のものが必要 Spatial Analyst
ArcGIS for Desktop Advanced: 次のものが必要 Spatial Analyst
9/17/2013