可視領域(Viewshed) (Spatial Analyst)

ライセンス レベル:BasicStandardAdvanced

サマリ

一連の観測フィーチャから見通せるラスタ サーフェスの位置を決定します。

[可視領域(Viewshed)] の機能の詳細

使用法

構文

Viewshed (in_raster, in_observer_features, {z_factor}, {curvature_correction}, {refractivity_coefficient}, {out_agl_raster})
パラメータ説明データ タイプ
in_raster

入力サーフェス ラスタ。

Raster Layer
in_observer_features

観測位置を指定するフィーチャクラス。

入力には、ポイント フィーチャまたはポリライン フィーチャを使用できます。

Feature Layer
z_factor
(オプション)

サーフェス Z 単位あたりの地表 X、Y 単位の数。

Z 単位の測定基準が入力サーフェスの X、Y 単位と異なる場合、Z 係数を使用して Z 測定単位を調整します。最終的な出力サーフェスを計算する際、入力サーフェスの Z 値に Z 係数が乗算されます。

X、Y 単位と Z 単位の測定基準が同じ場合、Z 係数は 1(デフォルト値)になります。

X、Y 単位と Z 単位の測定基準が異なる場合は、Z 係数に適切な値を設定する必要があります。Z 係数が適切でないと、正しい結果が得られません。たとえば、Z 単位がフィートであり、X、Y 単位がメートルの場合、Z 係数 0.3048 を使用して Z 単位をフィートからメートルへ変換します(1 フィート = 0.3048 メートル)。

Double
curvature_correction
(オプション)

地球の曲率の補正を適用します。

  • FLAT_EARTH 曲率補正は適用されません。これがデフォルトです。
  • CURVED_EARTH 曲率補正が適用されます。
Boolean
refractivity_coefficient
(オプション)

大気中での可視光線の屈折係数。

デフォルト値は 0.13 です。

Double
out_agl_raster
(オプション)

出力 AGL(Above Ground Level)ラスタ。

AGL の結果は、各セル値が 1 つ以上の観測点からそのセルを見通すために、セルに追加する必要がある高さの最小値となっているラスタになります。

この出力ラスタでは、すでに見通せるセルには値 0 が設定されます。

Raster

戻り値

名前説明データ タイプ
out_raster

出力ラスタ。

出力には、入力観測点(またはポリラインの頂点)から、入力サーフェス ラスタの各セル位置を見通せた回数だけが記録されます。観測の頻度は、出力ラスタの属性テーブルに VALUE 項目として記録されます。

Raster

コードのサンプル

Viewshed(可視領域)の例 1(Python ウィンドウ)

この例では、シェープファイルで定義された一連の観測位置から見通せるサーフェス位置を決定します。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outViewshed = Viewshed("elevation","observers.shp",2,"CURVED_EARTH",0.15)
outViewshed.save("C:/sapyexamples/output/outvwshd01")
Viewshed(可視領域)の例 2(スタンドアロン スクリプト)

この例では、シェープファイルで定義された一連の観測位置から見通せるサーフェス位置を決定します。

# Name: Viewshed_Ex_02.py
# Description: Determines the raster surface locations visible to a set of
#              observer features.
# 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
inRaster = "elevation"
inObserverFeatures = "observers.shp"
zFactor = 2
useEarthCurvature = "CURVED_EARTH"
refractivityCoefficient = 0.15

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

# Execute Viewshed
outViewshed = Viewshed(inRaster, inObserverFeatures, zFactor, 
                       useEarthCurvature, refractivityCoefficient)

# Save the output 
outViewshed.save("C:/sapyexamples/output/outvwshd02")

環境

関連トピック

ライセンス情報

ArcGIS for Desktop Basic: 次のものが必要 Spatial Analyst または 3D Analyst
ArcGIS for Desktop Standard: 次のものが必要 Spatial Analyst または 3D Analyst
ArcGIS for Desktop Advanced: 次のものが必要 Spatial Analyst または 3D Analyst
9/17/2013