mesh_decimate_preserving — 3D resolution op

• データ種: mesh → table

• 呼び出し: import fullseye as fs; fs.ledger.mesh_decimate_preserving(V, F, target_faces, protect_quantile=0.8, max_error=None, samples=4000, seed=0) (実装を直接呼ぶなら import meshres; meshres.mesh_decimate_preserving(V, F, target_faces, protect_quantile=0.8, max_error=None, samples=4000, seed=0)、台帳から引くなら ops3d.get("mesh_decimate_preserving"))

使い方

Decimation that keeps the detailed regions and reports what it lost (`table`).

Vertices whose :func:mesh_detail_map `detail` is in the top

`1 − protect_quantile are **protected**: :func:meshrepair.decimate_qem`

never collapses an edge that touches them, so a crater rim, a boulder or

an outlier ridge keeps its exact geometry while the smooth remainder is

reduced toward *target_faces*. The result carries the

:func:mesh_reduction_report; when *max_error* (mesh units) is given and

the measured `detail_max_error` exceeds it, the op refuses

(`ValueError`) instead of returning a mesh that has already lost the

features you protect. Returns ``{"V", "F", "report", "protected_vertices",

"protected_mask", "detail_threshold"}``.

背景知識ガイド(この op の手前にある物理・規約)

• depth_sensors — 深度センサの知識 — 測距原理・実機の値・欠測の出方

参考(サンプルデータ・文献)

• サンプルデータ カタログ(DL URL / ライセンス) — 2-D は skimage.data(BSD/public)+ 合成、3-D は実データ源(Stanford/PDS 等)の DL URL。

• 演算子の来歴・参考文献 — この op 族の元になった研究/手法の出典。

実行できる例(この op を実際に呼ぶ検証済みサンプル)

• mesh_resolution_demo — py -3.11 examples_3d/mesh_resolution_demo.py

型が繋がる次の op(table を入力に取れる)

fuse_to_voxel · mesh_select_lod

同カテゴリ(resolution)

mesh_edge_stats · mesh_detail_map · mesh_split_long_edges · mesh_isotropic_remesh · mesh_sample_points · mesh_lod_chain · mesh_select_lod · mesh_reduction_report

*Provenance: meshres.py — 3D operator registry. この per-op ノートは tools/opdocs.py md が自動生成(手編集しない)。*

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