mesh_edge_lengths — 3D terrain op

• 資料種類:mesh → signal

• 呼叫: import fullseye as fs; fs.ledger.mesh_edge_lengths(V, F, *, per: 'str' = 'vertex') -> 'np.ndarray'(要直接呼叫實作,import render3d; render3d.mesh_edge_lengths(V, F, *, per: 'str' = 'vertex') -> 'np.ndarray';從台帳取用則 ops3d.get("mesh_edge_lengths"))

用法

三角網格的局部邊長(逐頂點、逐面或逐唯一邊)。

回傳逐頂點 (N,)(相接邊的平均)、依面 (M,)(其 3 條邊的平均)，或依唯一邊 (E,)。

這是網格在其自身單位下的解析度圖：一個區域能作為*幾何*承載的最短波長約為局部邊長的兩倍(Nyquist)，這正是 mesh_subdivide(target_edge)與 displacement_band_weights 所使用的量。確定性；對退化網格/未知的 per fail-closed。

取無向的唯一邊 (E,2)，彙總每條邊的長度(網格單位，float64)。

• per='vertex'：與頂點相接的邊長的平均 (N,)。不屬於任何面的孤立頂點沒有邊，因此會被靜默填入 全部邊的平均值(不會是零)。

• per='face'：面的 3 條邊的平均 (M,)。

• per='edge'：唯一邊本身的長度 (E,)。邊的順序是 np.unique 的字典序(頂點 index 由小到大)，與 F 的順序不對應。

per 不是上述 3 種之一、頂點/面為空、face index 越界、座標非有限時拋出 ValueError。用於決定 displacement_band_weights 的 local_edge 或 mesh_subdivide 的 target_edge(例：取中位數的一半)。

參考(範例資料、文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

可執行的範例(實際呼叫該運算子並已驗證的樣例)

• itokawa_regolith_hero — py -3.11 examples_3d/itokawa_regolith_hero.py

型別可銜接的下一個運算子(可接受 signal 作為輸入)

fuse_to_voxel

同類別(terrain)

mesh_displace_fbm · terrain_region_mask · mesh_scatter_boulders · mesh_subdivide · displacement_band_weights · mesh_displace_spectrum · bump_normals_fbm

*Provenance: render3d.py — 3D 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

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