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

사용법

2-D 접합면 지도의 집속 탐촉자 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 패밀리 가이드

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

• 샘플 데이터 카탈로그(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 · 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 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

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