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*.
• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.
• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.
• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.
• coherence_scanning — py -3.11 examples/coherence_scanning.py
signal 를 입력으로 받는 것)—
envelope)—
*Provenance: interferometry.py — INTERFEROMETRY 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.