envelope op• 데이터 종류: sweep → signal
• 호출: 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 :data: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.