sam_cscan — ACOUSTICS ultrasonic op

• 資料種類:labels2d × table → table

• 呼叫: import fullseye as fs; fs.ledger.sam_cscan(bond_map, stacks, pixel_size=2e-06, f0=150000000.0, bandwidth=0.6, f_number=3.0, water_path=0.001, gate_interface=1, half_width=None, k_res=1.02, noise_rms=0.0, seed=0, n_reverb=40, psf_nodes=32)(要直接呼叫實作,import ultrasound; ultrasound.sam_cscan(bond_map, stacks, pixel_size=2e-06, f0=150000000.0, bandwidth=0.6, f_number=3.0, water_path=0.001, gate_interface=1, half_width=None, k_res=1.02, noise_rms=0.0, seed=0, n_reverb=40, psf_nodes=32);從台帳取用則 opsacoustics.get("sam_cscan"))

用法

對二維鍵合面圖進行聚焦探頭 C 掃描:逐頻率的高斯橫向 PSF、界面處的時間閘,輸出振幅、相位、同相(帶符號)與帶符號峰值影像(table)。

> 以下的詳細說明為原文 —— 摘要與標題已翻譯。

bond_map は整数ラベルの 2-D 配列、stacks は {ラベル: acoustic_layer_stack} (例: 0 = 誘電体、1 = Cu パッド、2 = ボイド、3 = パッド上のボイド)。各周波数 f で、ラベルごとの反射 R_c(f) を地図に置いてガウスの横 PSF (半値全幅 k_res · (c_w/f) · F#、往復の振幅 PSF、無限の平面で利得 1)で畳み込み、水の経路と減衰を掛けて、ゲートの時刻での解析信号に和を取る。ゲートは t_interfaces[gate_interface] ± half_width(既定 2σ_t)。

出力の像:

• amplitude — ゲート内の包絡線の山(振幅の C スキャン)

• phase — 界面のエコーの期待時刻(表面エコーの時刻 + 積層の往復)での解析信号の偏角 − 表面エコーの期待時刻での偏角 [rad]

• inphase — 期待時刻の解析信号の同相成分 |a| cos(phase)(符号つき。反転したエコーは負)

• signed_peak — ゲート内で |RF| が最大のサンプルの値(従来の極性の読み方)

• tof — 包絡線の山の時刻 [s]

plane_phasor は {ラベル: 複素数} —— そのラベルが一面に広がっていたときの期待時刻の値(雑音なし、基準の偏角を引いた後)。地図の設計(どこがパッドか)が分かっていれば、良品の基準として inphase / amplitude から引ける。★位相を包絡線の山の時刻でなく期待時刻で読む理由は echo_phase_polarity と同じ(山の時刻の揺れが位相を 2π f0 δt 回す。期待時刻なら位相の雑音は 雑音/振幅 だけ)。代わりにダイの厚さの誤差 δd は位相を 4π f0 δd / c 回す —— 厚さが場所で変わる部品では tof から期待時刻を画素ごとに直す必要がある(この op はしていない)。noise_rms は受信の加法雑音(RF の実部の RMS、探触子の帯域の形の色つき雑音)。psf_nodes は横 PSF を厳密に作る周波数の節点の数(その間は f の 1 次補間)。★ボイドの中心でも節点を倍にして変わる量は 1e-3 未満(tests/test_ultrasound.py)。Raises ValueError: 印の無い積層・地図のラベルに積層が無い・結合液が積層ごとに違う・ 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 · echo_phase_polarity · sam_frequency_tradeoff

同類別(ultrasonic)

acoustic_material_table · acoustic_layer_stack · acoustic_interface_coefficients · pulse_echo_ascan · echo_phase_polarity · sam_frequency_tradeoff


*Provenance: ultrasound.py — ACOUSTICS 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

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