ポイントの日射量（Points Solar Radiation） (Spatial Analyst)

ライセンス レベル:BasicStandardAdvanced

サマリ

ポイント フィーチャクラスまたはロケーション テーブルの特定位置での日射量を出力します。

日射量の計算方法の詳細

使用法

構文

PointsSolarRadiation (in_surface_raster, in_points_feature_or_table, out_global_radiation_features, {height_offset}, {latitude}, {sky_size}, {time_configuration}, {day_interval}, {hour_interval}, {each_interval}, {z_factor}, {slope_aspect_input_type}, {calculation_directions}, {zenith_divisions}, {azimuth_divisions}, {diffuse_model_type}, {diffuse_proportion}, {transmittivity}, {out_direct_radiation_features}, {out_diffuse_radiation_features}, {out_direct_duration_features})
パラメータ説明データ タイプ
in_surface_raster

入力標高サーフェス ラスタ

Raster Layer
in_points_feature_or_table

日射量を解析するための位置の指定。入力は、ポイント フィーチャクラスまたはテーブルです。

Feature Layer | Table View
out_global_radiation_features

各位置に対して計算した、全天日射量または日射量（直達 + 散乱）を表す出力フィーチャクラス。

出力の単位は、１平方メートルあたりの（WH/m2）です。

Feature Class
height_offset
(オプション)

計算が実行される DEM サーフェス上の高さ（メートル単位）

高さオフセットは、すべての入力位置に適用されます。

Double
latitude
(オプション)

解析エリアの緯度。単位は 10 進度で、北半球では正の値、南半球では負の値で表されます。

空間参照を含む入力サーフェス ラスタに対しては、平均緯度が自動的に計算されます。空間参照を含まない場合、緯度はデフォルトの 45 度に設定されます。

Double
sky_size
(オプション)

可視領域、天空図、太陽軌道図グリッドの解像度または天空サイズ。単位はセルです。

デフォルトでは、200 x 200 セルのラスタが作成されます。

Long
time_configuration
(オプション)

日射量の計算に使用する時間設定（期間）を指定します。

[Time] クラス オブジェクトは、時間設定を指定するために使用します。

使用可能な異なるタイプの時間設定には、TimeWithinDay、TimeMultiDays、TimeSpecialDays、TimeWholeYear があります。

形式は次のとおりです。

  • TimeWithinDay({day},{start_time},{end_time})
  • TimeMultiDays({year},{start_day},{end_day})
  • TimeSpecialDays()
  • TimeWholeYear({year})

デフォルトの時間設定は、TimeMultiDays で、現在のユリウス年の start_day が 5、end_day が 160 に設定されます。

Time configuration
day_interval
(オプション)

1 年間の時間間隔（単位: 日）太陽軌道図の天空のセクタの計算のために使用されます。

デフォルト値は 14（隔週）です。

Long
hour_interval
(オプション)

1 日間の時間間隔（単位: 時間）太陽軌道図の天空のセクタの計算のために使用されます。

デフォルト値は 0.5 です。

Double
each_interval
(オプション)

すべての位置に対して、1 つの総日射量の値を計算するか、または特定の時間と日にちの間隔で複数の値を計算するかを指定します。

  • NOINTERVAL —全時間設定に対して、1 つの総日射量の値が計算されます。これはデフォルトです。
  • INTERVAL —全時間設定の時間間隔ごとに複数の日射量の値が計算されます。出力の数は、時間または日にちの間隔によって異なります。たとえば、一月間隔で一年間の場合には、結果には各位置に対する 12 の日射量の出力値が含まれます。
Boolean
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
slope_aspect_input_type
(オプション)

解析のために、傾斜角と傾斜方向の情報を得る方法

  • FROM_DEM — 傾斜角および傾斜方向グリッドは、入力サーフェス ラスタから計算されます。これがデフォルト設定です。
  • FLAT_SURFACE — 定数値の 0 は、傾斜角と傾斜方向に使用されます。
  • FROM_POINTS_TABLE — 傾斜角と傾斜方向の値は、X、Y 座標とともにログ ファイル内に指定することができます。
String
calculation_directions
(オプション)

可視領域の計算に使用する方位角の数

有効な値は 8 の倍数（8、16、24、32 など）でなければなりません。デフォルト値は 32 方向で、複雑な地形に適しています。

Long
zenith_divisions
(オプション)

天空図内の天空のセクタを作成するために使用する分割数

デフォルトは 8 分割（天頂への相対）です。値は 0 より大きく、天空サイズの値の半分よりも小さくなければなりません。

Long
azimuth_divisions
(オプション)

天空図内の天空のセクタを作成するために使用する分割数

デフォルトは 8 分割（北から）です。有効な値は 8 の倍数でなければなりません。値は 0 より大きく 160 より小さくなければなりません。

Long
diffuse_model_type
(オプション)

散乱日射モデルのタイプ

  • UNIFORM_SKY — 均質な散乱モデル。天空のすべての方向から地球に到達する散乱日射は、すべて同じとなります。これがデフォルト設定です。
  • STANDARD_OVERCAST_SKY — 標準的な曇り空の散乱モデル。地球に到達する散乱日射束は、天頂角によって異なります。
String
diffuse_proportion
(オプション)

全天標準日射量のうち散乱する比率。値の範囲は、0 から 1 です。

この値は大気の状態に従って設定しなければなりません。デフォルト値は、一般的に晴れの場合で 0.3 です。

Double
transmittivity
(オプション)

大気を通過する日射量の（波長全体での平均値）。値の範囲は、0（不透過）から 1（完全透過）です。

デフォルト値は、一般的に晴れの場合で 0.5 です。

Double
out_direct_radiation_features
(オプション)

各位置での直達日射量を表す出力フィーチャクラス。

出力の単位は、１平方メートルあたりの（WH/m2）です。

Feature Class
out_diffuse_radiation_features
(オプション)

各位置での散乱日射量を表す出力フィーチャクラス。

出力の単位は、１平方メートルあたりの（WH/m2）です。

Feature Class
out_direct_duration_features
(オプション)

直達日射量の期間を表す出力フィーチャクラス。

出力の単位は時間です。

Feature Class

コードのサンプル

PointsSolarRadiation（ポイントから日射量を抽出）の例 1（Python ウィンドウ）

次の Python ウィンドウ スクリプトで、PointsSolarRadiation（ポイントから日射量を抽出）ツールの使用方法を示します。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
PointsSolarRadiation("elevation", "observers.shp", 
                     "c:/sapyexamples/output/outglobalrad1.shp", "", 35, 200, 
                     TimeMultipleDays(2009, 91, 212), 14, 0.5,"NOINTERVAL", 
                     1, "FROM_DEM", 32, 8, 8,"STANDARD_OVERCAST_SKY", 0.3, 0.5, 
                     "c:/sapyexamples/output/outdirectrad1.shp", 
                     "c:/sapyexamples/output/outdiffuserad1.shp", 
                     "c:/sapyexamples/output/outduration1.shp")
PointsSolarRadiation（ポイントから日射量を抽出）の例 2（スタンドアロン スクリプト）

特定のポイント位置の日射量を計算します。

# PointsSolarRadiation_Example02.py
# Description: For all point locations, calculates total global, direct,
#    diffuse and direct duration solar radiation for a whole year.
# 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"

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

# Set local variables
inRaster = "elevation"
inPntFC = "observers.shp"
outFeatures = "c:/sapyexamples/output/outglobal1.shp"
latitude = 35.75
skySize = 200
timeConfig = TimeMultipleDays(2009, 91, 212)
dayInterval = 14
hourInterval = 0.5
zFactor = 0.3048
calcDirections = 32
zenithDivisions = 8
azimuthDivisions = 8
diffuseProp = 0.3
transmittivity = 0.5
outDirectRad = "C:/sapyexamples/output/outdirectrad1.shp"
outDiffuseRad = "C:/sapyexamples/output/outdiffuserad1.shp"
outDirectDur = "C:/sapyexamples/output/outduration1.shp"

# Execute PointsSolarRadiation...
PointsSolarRadiation(inRaster, inPntFC, outFeatures, "", latitude, skySize, 
                     timeConfig, dayInterval, hourInterval, "INTERVAL", 
                     zFactor, "FROM_DEM", calcDirections, zenithDivisions, 
                     azimuthDivisions,"STANDARD_OVERCAST_SKY", diffuseProp, 
                     transmittivity, outDirectRad, outDiffuseRad, outDirectDur)

環境

関連トピック

日射量解析ツールの概要
エリアの日射量（Area Solar Radiation）

ライセンス情報

ArcGIS for Desktop Basic: 次のものが必要 Spatial Analyst
ArcGIS for Desktop Standard: 次のものが必要 Spatial Analyst
ArcGIS for Desktop Advanced: 次のものが必要 Spatial Analyst
Copyright © 1995-2013 Esri. All rights reserved.
9/17/2013