dem_aspect — DEM surface op

Data kinds: depthimage2d

Call: import fullseye as fs; fs.ledger.dem_aspect(dem, cell_size, method='horn', flat_tol=1e-12) (to call the implementation directly, import demops; demops.dem_aspect(dem, cell_size, method='horn', flat_tol=1e-12); from the registry, opsdem.get("dem_aspect"))

Usage

> This operator's description has not been translated yet. The original text follows as it is.

斜面方位 [度]。北 0 度・東回り。平坦なセルは :data:ASPECT_FLAT

平坦を 0 で返さないのは、0 が「北向き斜面」を意味してしまうため

—— 区別できない値を返すのは、例外を出さずに間違える典型。

手順: `dem_slope と同じ 3x3 勾配 (dz/dx, dz/dy)` を取り、下り勾配

向き `atan2(-dz/dx, -dz/dy) を度にして [0, 360)` に折り返す。行 0 が北・

列が増える向きが東という前提で、北 0 / 東 90 / 南 180 / 西 270。

行 0 が南の格子(上下反転した配列)を渡すと南北が入れ替わり、例外は出ない

• `dem, cell_size, method: dem_slope と同じ契約(3x3 以上、nan`

で欠測、番兵値は拒否、`cell_size` は正の [m])。

• `flat_tol: 勾配の大きさ hypot(dz/dx, dz/dy)` [m/m] がこれ以下なら平坦と

みなし `ASPECT_FLAT`(= -1.0)を返す。既定 1e-12 は「数値的に厳密に平坦」だけ。

整数標高の平地でも微小勾配で方位が付くことがあるので、意味のある閾

(例 1e-3)を明示するとよい。

• 返り値: `(H, W) float64。[0, 360) または -1.0nan セルの周りは nan`。

• 方位のヒストグラムや平均を取るときは `-1 を先に除く(out >= 0`)。

Detailed usage guide

dem_terrain_analysis family guide

References (sample data, literature)

• Sample-data catalog (download URLs / licences) — 2-D uses skimage.data (BSD/public domain) plus synthetic images; 3-D lists download URLs for real data sources (Stanford, PDS, …).

• Operator provenance and references — the sources of the research/methods this op family came from.

• The canonical algorithm (author, year) and its uses are named in the family usage guide above.

Runnable examples (verified samples that actually call this op)

poc_dem_terrainpy -3.11 examples/poc_dem_terrain.py

poc_geodetic_height_framespy -3.11 examples/poc_geodetic_height_frames.py

Ops the type connects to (they accept image2d as input)

Same category (surface)

dem_slope · dem_curvature · dem_roughness · dem_tpi


*Provenance: demops.py — DEM operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.