sam_frequency_tradeoff — ACOUSTICS ultrasonic op

• 데이터 종류: table → table

• 호출: import fullseye as fs; fs.ledger.sam_frequency_tradeoff(stack, void_diameter, water_path=0.001, f_number=3.0, interface=None, k_res=1.02, f_min=1000000.0, f_max=5000000000.0, n_grid=600, bandwidth=0.6, n_sigma_gate=5.0)(구현을 직접 호출하려면 import ultrasound; ultrasound.sam_frequency_tradeoff(stack, void_diameter, water_path=0.001, f_number=3.0, interface=None, k_res=1.02, f_min=1000000.0, f_max=5000000000.0, n_grid=600, bandwidth=0.6, n_sigma_gate=5.0), 원장에서 가져오려면 opsacoustics.get("sam_frequency_tradeoff"))

사용법

묻힌 계면의 크기 a 보이드에 대한 최적 SAM 주파수: 횡방향 충전율 1 − 2^−(a/w)² (w = k_res·λ_w·F#) 대 왕복 감쇠의 절충, 감쇠가 모두 f² 이면 닫힌 형식 (table).

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

信号 S(f) = η(f) · exp(−L(f))、η = 1 − 2^{−(a/w)²} はボイド(直径 a)の中心にガウスの往復 PSF(半値全幅 w = k/f、k = k_res c_w F#)が当たったときの充填率、L(f) = 2 α_w(f) z_w + 2 Σ_{j<interface} α_j(f) d_j(水の経路と上の層の往復減衰 [Np])。減衰がすべて f²(L = β f²)なら dlnS/df = 0 から f* = (k/a) · sqrt(log2(1 + a² ln2 / (β k²)))(小さなボイドの極限で 1/√β)。それ以外は対数格子で探して有界の 1-D 最適化で詰める。

返り: freqs fwhm fill loss_np loss_db signal f_opt(数値) f_opt_closed(閉形式が立つときだけ、そうでなければ None)beta k fwhm_at_opt f_number_min(臨界角の上限)。

時間の分解能の下限も返す: 表面エコーと界面のエコーの間隔 t_sep(積層の往復時間)がパルスの包絡線の n_sigma_gate σ_t(ゲートの半幅 2σ_t + 裾 3σ_t)より短いと、表面エコーの裾がゲートに入る。σ_t = FWHM_PER_SIGMA / (2π · bandwidth · f) なので f_min_time = n_sigma_gate · 2.3548 / (2π · bandwidth · t_sep)、f_opt_usable = max(f_opt, f_min_time)(表面の界面(interface=0)なら下限 0)。★ボイドの反射 |R| は周波数によらず 1 とみなす(薄い空気の層では ~1)。Raises ValueError: 印の無い積層、直径 ≤ 0、f_min ≥ f_max、F# が臨界角の上限より小さい、減衰が 0 (最適周波数が存在しない — 上へ行くほど良い)。

자세한 사용 가이드

• acoustic_condition_monitoring 패밀리 가이드

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

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

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

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

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

• poc_sam_hybrid_bonding_voids — py -3.11 examples/poc_sam_hybrid_bonding_voids.py

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

istft · acoustic_interface_coefficients · pulse_echo_ascan · sam_cscan · echo_phase_polarity

같은 카테고리(ultrasonic)

acoustic_material_table · acoustic_layer_stack · acoustic_interface_coefficients · pulse_echo_ascan · sam_cscan · echo_phase_polarity


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

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