ultrasonic op• Data kinds: table → table
• Call: import fullseye as fs; fs.ledger.echo_phase_polarity(echo, interface=1, half_width=None, reference_interface=0, tol_deg=45.0) (to call the implementation directly, import ultrasound; ultrasound.echo_phase_polarity(echo, interface=1, half_width=None, reference_interface=0, tol_deg=45.0); from the registry, opsacoustics.get("echo_phase_polarity"))
Classify an interface echo by its phase relative to the front-surface echo: in phase (Z rises), inverted (Z drops) or quadrature (thin-layer, sign not meaningful) (table).
> The detailed description below is the original text — the summary and the headings are translated.
echo は pulse_echo_ascan の A スキャン(kind='ascan')か sam_cscan の C スキャン(kind='cscan'、既に位相を持つので分類だけする)。A スキャンでは界面のエコーの期待時刻 t_interfaces[interface] での解析信号の偏角から、基準エコー(reference_interface、既定 = 表面)の期待時刻での偏角を引く(解析信号はスペクトルから任意の時刻で厳密に足す)。振幅は ±half_width(既定 2σ_t)のゲートの中の包絡線の山。★包絡線の山の時刻で位相を読まないのは、山は平らで雑音が時刻を動かし、位相が 2π f0 δt だけ回るから(1 ns で 200 MHz なら 72°)。代わりに、積層の厚さの誤差 δd は位相を 4π f0 δd / c 回す(Si・200 MHz で 1 µm あたり 17°)。
分類: |位相| ≤ tol → 同相 (+1)、|位相| ≥ 180° − tol → 反転 (−1)、それ以外 → 直交 (0)。★基準は表面エコー。表面そのものが Z の下がる界面(水より柔らかい最上層)なら表面エコーが反転しているので、Z の上がる深い界面が「反転」と読まれる —— 分類は「表面に対して同じ向きか逆向きか」であって、絶対の Z の上下ではない(tests/test_ultrasound.py の門)。★signed_peak(ゲート内で |RF| が最大のサンプルの符号)も返す —— 現場で言う「極性」はこれだが、直交のエコー(薄い層の微分形)では帯域と標本化でどちらにも転ぶ。signed_peak_agrees が False の行はそれ。返り(A スキャン): phase [rad] phase_deg amplitude t_peak polarity (+1/−1/0)label signed_peak signed_peak_agrees。返り(C スキャン): polarity の地図と各分類の画素数。Raises ValueError: A/C スキャンの印の無い入力、界面の番号が範囲外、tol_deg が [0, 90) の外、ゲートの中の標本が 3 未満。
• acoustic_condition_monitoring family guide
• Sample-data catalog (download URLs / licences) — 2-D uses skimage.data (BSD/public domain) plus synthetic images; 3-D lists download URLs for real data sources (Stanford, PDS, …).
• Operator provenance and references — the sources of the research/methods this op family came from.
• The canonical algorithm (author, year) and its uses are named in the family usage guide above.
• poc_sam_hybrid_bonding_voids — py -3.11 examples/poc_sam_hybrid_bonding_voids.py
table as input)istft · acoustic_interface_coefficients · pulse_echo_ascan · sam_cscan · sam_frequency_tradeoff
ultrasonic)acoustic_material_table · acoustic_layer_stack · acoustic_interface_coefficients · pulse_echo_ascan · sam_cscan · sam_frequency_tradeoff
*Provenance: ultrasound.py — ACOUSTICS operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.