level op• 데이터 종류: 없음 → table(인자만으로 정해지는 연산자 —— 이미지나 데이터 입력을 받지 않습니다)
• 호출: import fullseye as fs; fs.ledger.octave_bands(fraction=3, f_min=22.0, f_max=22050.0, base=10)(구현을 직접 호출하려면 import acoustics; acoustics.octave_bands(fraction=3, f_min=22.0, f_max=22050.0, base=10), 원장에서 가져오려면 opsacoustics.get("octave_bands"))
정의된 작도대로 1/N 옥타브 밴드의 중심 주파수와 대역 끝.
> 아래 상세 설명은 원문입니다 —— 요약과 제목은 번역되어 있습니다.
The band system is a geometric progression through 1 kHz:
f_c = 1000 * G**(x/b) for odd b and 1000 * G**((2x+1)/(2b)) for even b, with edges at f_c * G**(-+1/(2b)). base=10 uses G = 10**(3/10) (the base-ten system, in which ten third-octaves span almost exactly a decade); base=2 uses G = 2 exactly. No published table of centre frequencies is transcribed — the *exact* centres are computed, which is why centers reads 1000.0, 1258.925, 1584.893 rather than the 1000, 1250, 1600 a published series would give.
The parity of fraction changes where 1 kHz sits, and this surprises people. With an odd b (1/1, 1/3) there is a band *centred* on exactly 1000.0 Hz. With an even b (1/2, 1/6, 1/12, 1/24) the offset in the exponent means there is no 1 kHz band at all — instead 1000.0 Hz is exactly a band *edge*, shared by two bands. Measured across fraction = 1, 2, 3, 6, 12, 24: a centre lands on 1000.0 for 1 and 3, and a lower edge lands on it for 2, 6, 12 and 24, in every case to within rtol=1e-12. That is the defining construction, not an artefact, and it matters when a level is quoted "at 1 kHz": in an even system that number comes from one of two adjacent half-bands, not from a band on the tone.
nominal is the exact centre rounded to three significant figures, for labelling only. It is a rounding, not the published nominal series, and it differs from it: measured, the 1/1-octave centres round to 31.6, 63.1, 126.0, 251.0, 501.0, 1000.0, 2000.0, 3980.0, 7940.0, 15800.0, where the published series has 125 and 250 where this has 126 and 251. Do arithmetic with centers and supply your own labels if they have to match a report.
Returns a dict: centers, lower, upper, nominal, fraction, base, ratio (G**(1/b)), bandwidth (upper - lower), index (the integer x).
Exact identities, asserted in the tests: upper/lower = G**(1/b) for every band, center = sqrt(lower*upper) (the centre is the geometric mean of its edges, by construction), and successive centres are in the ratio G**(1/b). Measured for fraction=3, base=10 over 22 Hz - 22.05 kHz (30 bands): the band containing 1000 Hz has lower = 891.250938, center = 1000.000000, upper = 1122.018454; upper/lower - G**(1/3) = 2.2e-16; |center - sqrt(lower*upper)| <= 1.8e-12 over all bands; and successive centre ratios deviate from G**(1/3) by at most 6.7e-16. With base=2 the octave centres come out exactly 31.25, 62.5, 125, 250, 500, 1000, 2000, 4000, 8000, 16000 Hz.
Raises ValueError: fraction not an int in [1, 24], base not 2 or 10, non-positive or non-finite f_min / f_max, f_min >= f_max, and a request for more than MAX_BANDS bands.
• 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
• poc_rail_corrugation — py -3.11 examples/poc_rail_corrugation.py
table 를 입력으로 받는 것)level)octave_spectrum · weighting_response · apply_weighting · equivalent_level · percentile_level
*Provenance: acoustics.py — ACOUSTICS 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.