傾斜方向 (Aspect) (Spatial Analyst)—ArcGIS Pro

Spatial Analyst のライセンスで利用可能。

3D Analyst のライセンスで利用可能。

サマリー

ラスターサーフェスの各セルから傾斜方向データを作成します。

傾斜方向は、各位置の下りの傾斜角が指しているコンパス方位を特定します。

[サーフェスパラメーター (Surface Parameters)] ツールにより、実装が更新されて機能が向上します。

[傾斜方向 (Aspect)] ツールの詳細

図

使用法

[サーフェスパラメーター (Surface Parameters)] ツールは傾斜方向を新たに実装するので、[傾斜方向 (Aspect)] ツールの代わりに使用することをお勧めします。 [傾斜方向 (Aspect)] ツールは平面を 9 個のローカルセルに収めますが、平面は地形の記述子としてはあまり役に立たないことが多く、対象の自然変動がマスクされたり、強調されたりすることがあります。 [サーフェスパラメーター (Surface Parameters)] ツールは、サーフェスを平面ではなくセルの近傍に収めるため、地形をより自然に適合させることができます。
[傾斜方向 (Aspect)] ツールは、常に 3 x 3 のセルウィンドウを使用して値を計算するのに対し、[サーフェスパラメーター (Surface Parameters)] ツールは 3 x 3 から 15 x 15 のセルまでのウィンドウサイズを使用できます。高解像度の標高データには、大きいウィンドウサイズが便利です。これにより、地表面の処理を適切な縮尺で捉えられるようになります。 [サーフェスパラメーター (Surface Parameters)] にはアダプティブウィンドウオプションもあります。このオプションは地形のローカル変動を評価し、セルごとに最大の適切な近傍サイズを特定します。これは、河川、道路、傾斜の急変によって途切れる、緩やかな同種の地形において便利です。
以前のツールの実行と正確に一致する結果が必要である場合、またはアルゴリズムの正確さよりも高速な実行の方が重要である場合には、[傾斜方向 (Aspect)] ツールの従来のアプローチを引き続き使用できます。
このツールは、3 X 3 のセル移動ウィンドウを使用して、データを処理します。処理するセルが NoData の場合、その位置の出力は NoData になります。
このツールでは、処理するセルに隣接した 8 つのセルのうち、少なくとも 7 つが有効な値を持つ必要があります。有効なセルの数が 7 未満である場合、計算は実行されず、その処理セルの出力は NoData になります。
出力ラスターの最も外側のロウとカラムにあるセルは NoData になります。これは、これらのセルが、入力データセットの境界沿いにあり、必要なだけの有効な隣接セルに囲まれていないためです。
傾斜方向は、0 〜 360 度の正の角度で、北から時計回りに計測されます。
入力ラスターの平らな (傾斜がゼロの) セルの場合、傾斜方向は -1 となります。
測地線による方法の場合、サーフェスの Z 単位を指定することで、出力の精度が確保されます。 [Z 単位] パラメーターは、測地線による方法が選択された場合のみ有効になります。
入力ラスターの「鉛直座標系」では、Z 単位が使用できる場合は自動的に適用されます。入力ラスターの Z 単位がない場合は定義することをお勧めします。 Z 単位の指定には、[投影法の定義 (Define Projection)] ツールを使用できます。これが定義されていない場合、デフォルトでメートルが使用されます。
[測地線方位の投影] (Python では project_geodesic_azimuths) パラメーターは、[方法] パラメーターが [測地線] に設定されている場合にのみ使用できます。
[測地線] 方法の [測地線方位の投影] パラメーターがオンの場合 (Python では project_geodesic_azimuths が PROJECT_GEODESIC_AZIMUTHS に設定されている場合)、以下の点に注意してください。
- 北は常に 360 度として表されます。
- 方位は、非正角な「出力座標系」環境値によって引き起こされる歪みを修正するために投影されます。これらの角度を使用すると、最も急な下り勾配に沿ったポイントを正確に配置できます。
距離ツールセット内のツールで逆方向入力として [傾斜方向] 出力を使用している場合は、[測地線方位の投影] パラメーターをオンにします。
入力ラスターをリサンプリングする必要がある場合は、共一次内挿法を使用します。入力ラスターをリサンプリングする例としては、出力座標系、範囲、またはセルサイズが入力と異なる場合があります。
[入力ラスター] パラメーターの値 (Python の in_raster) が高解像度でセルサイズが数メートル未満の場合や、特にノイズが多い場合は、このツールの直接 3 × 3 近傍ではなく、[サーフェスパラメーター (Surface Parameters)] ツールとそのユーザー定義の近傍距離オプションを使用することを検討してください。より大きな近傍を使用することで、ノイズの多いサーフェスの影響を最小限に抑えることができます。また、高解像度のサーフェスを使用する場合は、より大きな近隣を使用することで、地形やサーフェスの特性をより上手く表現することができます。
このツールは GPU により処理を加速化できます。つまり、システムで互換性のある GPU (グラフィックス処理装置) を使用可能な場合は、その GPU を使用してツールのパフォーマンスを強化できます。このツールの実行に GPU と CPU のどちらを使用するかを制御するには、[解析のターゲットデバイス] (Python の analysis_target_device) パラメーターを使用します。
互換性のある GPU、GPU デバイスの構成と操作、トラブルシューティングのヒントの詳細については、「Spatial Analyst での GPU 処理」をご参照ください。
このツールに適用されるジオプロセシング環境の詳細については、「解析環境と Spatial Analyst」をご参照ください。

パラメーター

ラベル	説明	データタイプ
入力ラスター	入力サーフェスラスター。	Raster Layer
方法 (オプション)	平面 (平面地球) と測地線 (楕円体) のどちらの方法に基づいて計算するかを指定します。平面による方法は、正しい距離と面積が維持される投影法で、ローカルエリアに使用するのに適しています。これは、エリアの都市、郡、小さな州などのエリアをカバーする解析に適しています。測地線による方法では、より正確な結果が生成されますが、処理時間が増加する可能性があります。平面—計算は、2 次元直交座標系を使用して投影された平面で実行されます。これがデフォルトの方法です。測地線—計算は、地球の形状を楕円体と見なして、3 次元直交座標系で実行されます。	String
Z 単位 (オプション)	鉛直方向の Z 値の距離単位を指定します。これは、鉛直座標系で定義されます (存在する場合)。鉛直座標系が存在しない場合、正しい測地線の計算を実現するために、単位リストを使用して Z 単位を定義します。デフォルトはメートルです。インチ—距離単位はインチになります。フィート—距離単位はフィートになります。ヤード—距離単位はヤードになります。 US マイル—距離単位はマイルになります。海里—距離単位は海里になります。ミリメートル—距離単位はミリメートルになります。センチメートル—距離単位はセンチメートルになります。メートル—距離単位はメートルになります。キロメートル—距離単位はキロメートルになります。デシメートル—距離単位はデシメートルになります。	String
測地線方位の投影 (オプション)	出力空間参照によって引き起こされる角度の歪みを修正するために、測地線方位を投影するかどうかを指定します。オフ - 測地線方位は投影されません。これがデフォルトです。オン - 測地線方位が投影されます。このオプションでは CPU 処理のみがサポートされます。	Boolean
解析のターゲットデバイス (オプション)	計算の実行に使用するデバイスを指定します。 GPU の後で CPU—互換性のある GPU が検出された場合、その GPU を使用して計算が実行されます。検出されなかった場合、CPU が使用されます。これがデフォルトです。 CPU のみ—計算は CPU でのみ実行されます。 GPU のみ—計算は GPU でのみ実行されます。	String

戻り値

ラベル	説明	データタイプ
出力ラスター	出力傾斜方向ラスター。浮動小数点タイプになります。	Raster

ラベル

説明

データタイプ

出力ラスター

出力傾斜方向ラスター。

浮動小数点タイプになります。

Raster

Aspect(in_raster, {method}, {z_unit}, {project_geodesic_azimuths}, {analysis_target_device})

名前	説明	データタイプ
in_raster	入力サーフェスラスター。	Raster Layer
method (オプション)	平面 (平面地球) と測地線 (楕円体) のどちらの方法に基づいて計算するかを指定します。 PLANAR—計算は、2 次元直交座標系を使用して投影された平面で実行されます。これがデフォルトの方法です。 GEODESIC—計算は、地球の形状を楕円体と見なして、3 次元直交座標系で実行されます。平面による方法は、正しい距離と面積が維持される投影法で、ローカルエリアに使用するのに適しています。これは、エリアの都市、郡、小さな州などのエリアをカバーする解析に適しています。測地線による方法では、より正確な結果が生成されますが、処理時間が増加する可能性があります。	String
z_unit (オプション)	鉛直方向の Z 値の距離単位を指定します。これは、鉛直座標系で定義されます (存在する場合)。鉛直座標系が存在しない場合、正しい測地線の計算を実現するために、単位リストを使用して Z 単位を定義します。デフォルトはメートルです。 INCH—距離単位はインチになります。 FOOT—距離単位はフィートになります。 YARD—距離単位はヤードになります。 MILE_US—距離単位はマイルになります。 NAUTICAL_MILE—距離単位は海里になります。 MILLIMETER—距離単位はミリメートルになります。 CENTIMETER—距離単位はセンチメートルになります。 METER—距離単位はメートルになります。 KILOMETER—距離単位はキロメートルになります。 DECIMETER—距離単位はデシメートルになります。	String
project_geodesic_azimuths (オプション)	出力空間参照によって引き起こされる角度の歪みを修正するために、測地線方位を投影するかどうかを指定します。 GEODESIC_AZIMUTHS—測地線方位は投影されません。これがデフォルトです。 PROJECT_GEODESIC_AZIMUTHS—測地線方位が投影されます。	Boolean
analysis_target_device (オプション)	計算の実行に使用するデバイスを指定します。 GPU_THEN_CPU—互換性のある GPU が検出された場合、その GPU を使用して計算が実行されます。検出されなかった場合、CPU が使用されます。これがデフォルトです。 CPU_ONLY—計算は CPU でのみ実行されます。 GPU_ONLY—計算は GPU でのみ実行されます。	String

戻り値

名前	説明	データタイプ
out_raster	出力傾斜方向ラスター。浮動小数点タイプになります。	Raster

名前

説明

データタイプ

out_raster

出力傾斜方向ラスター。

浮動小数点タイプになります。

Raster

コードのサンプル

Aspect (傾斜方向) の例 1 (Python ウィンドウ)

この例では、入力サーフェスラスターからアスペクトラスターを作成します。

import arcpy
from arcpy import env  
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outAspect = Aspect("elevation")
outAspect.save("C:/sapyexamples/output/outaspect01.img")

Aspect (傾斜方向) の例 2 (スタンドアロンスクリプト)

この例では、入力サーフェスラスターからアスペクトラスターを作成します。

# Name: Aspect_Ex_02.py
# Description: Derives aspect from a raster surface.
# 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"
method = "GEODESIC"
zUnit = "FOOT"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute Aspect
outAspect = Aspect(inRaster, method, zUnit)

# Save the output 
outAspect.save("C:/sapyexamples/output/outaspect02")

環境

自動コミット, セルサイズ, セルサイズ投影法, 現在のワークスペース, 範囲, 地理座標系変換, マスク, 出力データのコンフィグレーションキーワード, 出力座標系, テンポラリワークスペース, スナップ対象ラスター, タイルサイズ

ライセンス情報

Basic: 次のものが必要 Spatial Analyst または 3D Analyst
Standard: 次のものが必要 Spatial Analyst または 3D Analyst
Advanced: 次のものが必要 Spatial Analyst または 3D Analyst

サマリー

図

使用法

パラメーター

戻り値

戻り値

コードのサンプル

環境

ライセンス情報

関連トピック

このトピックの内容