envelope op• 資料種類:sweep → signal
• 呼叫: import fullseye as fs; fs.ledger.csi_envelope(signal, remove_bias=True)(要直接呼叫實作,import interferometry; interferometry.csi_envelope(signal, remove_bias=True);從台帳取用則 opsinterferometry.get("csi_envelope"))
z 掃描干涉圖的同調包絡(解析訊號的模)。
> 以下的詳細說明為原文 —— 摘要與標題已翻譯。
dsp.envelope computes |hilbert(x)| for any 1-D signal and is called here verbatim, so the two can never drift apart. The one thing added is the one thing an interferogram needs and a generic signal does not: removal of the intensity pedestal. An interferogram is a + b*V(z)*cos(...) with a > 0, and the analytic-signal magnitude of that is not b*V — the DC term passes through the Hilbert transform untouched and dominates.
Measured on the module's reference scan (a = 0.5, b = 0.4, envelope sigma 1.2 um, surface centred): with the bias removed the envelope matches the analytic b*V(z) to 1.83e-07; without it, the error is 0.5 — the entire pedestal — and the recovered "envelope" never goes near zero. dsp.envelope called directly on the same raw interferogram gives that identical 0.5, which is the honest statement of what this operator adds. That is why remove_bias defaults to True; False is available for a scan whose pedestal you have already removed some other way, and it is your statement that you did.
signal: 1-D scan intensities ((n,), n >= 3).
remove_bias: subtract the scan mean before the transform.
Returns a 1-D float64 envelope of the same length.
Raises ValueError: a non-1-D, empty, too-short (< 3), non-finite, complex or masked *signal*, a *signal* over MAX_SCAN_POINTS elements (checked before the float64 promotion), or a non-bool *remove_bias*.
• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。
• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。
• 演算法的正典(作者、年份)與用途見上面的族使用指南。
• coherence_scanning — py -3.11 examples/coherence_scanning.py
signal 作為輸入)—
envelope)—
*Provenance: interferometry.py — INTERFEROMETRY 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.