structured_light op• 数据种类:image2d → depth
• 调用: import fullseye as fs; fs.ledger.fringe_ftp_phase(image, carrier_axis='x', carrier_period=None, bandwidth=0.35, k=1.0, min_modulation=None, return_info=False)(要直接调用实现,import fringe; fringe.fringe_ftp_phase(image, carrier_axis='x', carrier_period=None, bandwidth=0.35, k=1.0, min_modulation=None, return_info=False);从台账取用则 ops3d.get("fringe_ftp_phase"))
• 经台账调用的返回值: fullseye.ledger.fringe_ftp_phase(...) 只返回声明的 out 类型 depth 的值(底层函数还会返回辅助信息)。需要被丢弃的部分时,使用 fullseye.ledger.fringe_ftp_phase.raw(...),或直接调用 fringe.fringe_ftp_phase。
• GPU:无(仅 CPU 参考实现)
使用 Takeda 傅里叶变换轮廓术从单幅条纹图像恢复高度/相位。
> 以下的详细说明为原文 —— 摘要与标题已翻译。
2-D FFT の直流から離れた片側一次スペクトルを窓で抜き、複素解析信号へ戻して位相を展開し、搬送波の線形ランプを除く。carrier_axis は位相が増える方向("x"=列、"y"=行)。carrier_period は画素単位で、省略時は指定軸の正周波数側にある最大ピークから推定する。★画像が視野の中で周期的(DFT に漏れが無い) ときだけ整数ビンを搬送波とし、そうでなければピークの両隣 1 ビンで DTFT のパワーを細かく評価してサブビンに直す(2026-11-05 まで常に整数ビンに丸め、7.3 px の縞が 7.11 px と読まれて位相 RMS 0.63 rad の傾きが残った)。推定した搬送波は、対象の位相の搬送軸方向の一様な傾きと区別できない(どちらも同じ画像を作る)—— 傾きを残したい、あるいは搬送波が既知なら carrier_period を渡す。bandwidth は搬送周波数に対する Gaussian 窓の標準偏差の比(0 < bandwidth < 1)。k は rad から高さへの係数。
返り値は通常 height。return_info=True なら (height, info) となり、info は搬送波を除いた phase、実際に使った carrier_period、carrier_frequency、estimated_carrier、解析信号の modulation を持つ。高さは既存の phase_to_height(phase, 0, k) で作る。
業務上の言い方では「縞 1 枚から高さ」「1枚の縞画像から位相」を求める op。
1 枚で済む代わりに、対象位相の空間帯域が搬送波と直流/反対側サイドバンドの間に収まる必要がある。急な高さ、段差、オクルージョンでは帯域重なりと Itoh 条件違反で誤る。3 枚以上を撮れて広い帯域や低い搬送波を扱うなら decode_fringe の位相シフト法を使う。一定画像や、抽出した変調振幅が画像の動的範囲に対して小さすぎる画像は丸め誤差から位相を作らず ValueError にする。
出典: M. Takeda, H. Ina and S. Kobayashi, “Fourier-transform method of fringe-pattern analysis for computer-based topography and interferometry,” J. Opt. Soc. Am. 72(1), 156–160 (1982), doi:10.1364/JOSA.72.000156.
• depth_sensors — 深度传感器知识 —— 测距原理、实机数值、缺测的表现
• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。
• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。
• ftp_and_focus_depth — py -3.11 examples_3d/ftp_and_focus_depth.py
depth 作为输入)depth_to_points · tsdf_from_depth · to_points · fuse_to_voxel · depth_to_organized_points · normals_from_depth · occlusion_edges · bearing_angle_image
structured_light)wrapped_phase · unwrap_phase_2d · graycode_decode · decode_fringe · depth_from_focus · synthesize_fringes · absolute_phase · triangulate_column
*Provenance: fringe.py — 3D 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.