polyhedron_clip_halfspace — DRIVE `polygrav` op

• 資料種類:any × any × any → any

• 呼叫: import fullseye as fs; fs.ledger.polyhedron_clip_halfspace(mesh, point, normal)(要直接呼叫實作,import polygrav; polygrav.polyhedron_clip_halfspace(mesh, point, normal);從台帳取用則 opsdrive.get("polyhedron_clip_halfspace"))

• GPU:無(僅 CPU 參考實作)

用法

以平面切開封閉網格,把 (x − point)·normal ≥ 0 一側作為封閉實體回傳 → (vertices, faces)。

> 以下的詳細說明為原文 —— 摘要與標題已翻譯。

切り口(平面上の多角形)は point からの扇の三角形で塞ぐ。切り口が非凸でも、point が切り口の外でも、扇の三角形は向き付きで重なって打ち消し合うので、面について線形な量(polyhedron_gravity の重力・ mesh_volume の体積・重心)はそのまま正しい(見た目の三角形は重なることがある)。辺と平面の交点は辺ごとに 1 回だけ作るので、返りのメッシュは有向辺がちょうど打ち消す(閉じている)。平面の上にちょうど乗る頂点は残す側に数える。

Parameters

mesh : (vertices (N,3), faces (M,3))

閉じた三角形メッシュ(外向きの巻き)。

point : (3,)

平面上の 1 点(切り口の扇の中心にもなる)。

normal : (3,)

残す側を向く平面の法線(正規化する)。

Returns

(vertices (N',3), faces (M',3))

残した側の閉じたメッシュ(使わない頂点は落とす)。切り口の三角形は末尾に並ぶ。

平面がメッシュに交わらない(全部が片側)ときは、残す側に全部あればそのまま、全部が反対側なら ValueError。メッシュが閉じていない・非有限・範囲外の索引も ValueError。空の入力(mesh の面が 0 個)は ValueError で拒否する。

參考(範例資料、文獻)

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

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

• 演算法的正典(作者、年份)與用途見上面的族使用指南。

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

• itokawa_gravity_tour — py -3.11 examples/itokawa_gravity_tour.py

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

course_crank · course_s_curve · course_turnaround · course_slope · course_intersection · course_parallel_parking · course_crossing · course_road

同類別(`polygrav`)

polyhedron_gravity

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

polyhedron_clip_halfspace — DRIVE polygrav op

用法