stft_cola_check — ACOUSTICS transform op

• 데이터 종류: 없음 → table(인자만으로 정해지는 연산자 —— 이미지나 데이터 입력을 받지 않습니다)

• 호출: import acoustics; acoustics.stft_cola_check(window='hann', win=256, hop=None)(또는 opsacoustics.get("stft_cola_check"))

사용법

그 (창, 홉) 조합이 COLA 를 만족하는가, 얼마나 정확히 만족하는가.

> 아래 상세 설명은 원문입니다 —— 요약과 제목은 번역되어 있습니다.

COLA — the analysis windows summing to a constant over the hop lattice — is

what lets plain overlap-add work without a division. It is *not* required by

:func:istft, which is weighted, but it is required by anything that

overlap-adds modified frames without renormalising, and getting it wrong

produces a periodic amplitude ripple at `rate/hop` Hz that looks like

tremolo rather than like a bug.

Returns a dict: `cola (bool), constant` (the mean of the overlap sum),

`max_deviation (absolute), relative_deviation, nola` (bool),

`min_squared_sum`, plus the geometry.

Measured (periodic windows, `relative_deviation` of the plain sum):

======== ==== ==== ================== ======== ====

window win hop relative_deviation constant COLA

======== ==== ==== ================== ======== ====

hann 256 128 4.44e-16 1.00 yes

hann 256 64 2.22e-16 2.00 yes

hann 256 85 1.48e-03 1.506 no

hamming 256 128 2.06e-16 1.08 yes

blackman 256 128 1.91e-01 0.84 no

blackman 256 64 3.97e-16 1.68 yes

boxcar 256 128 0.00e+00 2.00 yes

======== ==== ==== ================== ======== ====

The two blackman rows are the useful ones: the same window is COLA at

hop = win/4 and 19 % off at hop = win/2, so "which window" is not the

question — the pair is. The boxcar row was worth measuring rather than

assuming: a rectangular window at 50 % overlap sums to exactly 2 and is

COLA, which is the opposite of the usual intuition about it. Note also that

the constant is not 1 in general — an overlap-add that does not divide by it

is off by a *gain*, which is the failure that looks like a working system.

Raises `ValueError: unknown / all-zero window, hop` outside

`[1, win], win outside [2, MAX_WINDOW]`.

자세한 사용 가이드

• acoustic_condition_monitoring 패밀리 가이드

참고(샘플 데이터·문헌)

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.

• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.

• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.

실행 가능한 예제(이 연산자를 실제로 호출하는 검증된 샘플)

• acoustic_condition_monitoring — py -3.11 examples/acoustic_condition_monitoring.py

타입이 이어지는 다음 연산자(table 를 입력으로 받는 것)

istft

같은 카테고리(transform)

stft · istft

*Provenance: acoustics.py — ACOUSTICS 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

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