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"))

用法

埋藏界面上给定尺寸空洞的最佳 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 族使用指南

参考(示例数据、文献)

• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 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 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*

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