A Bug That Doesn't Crash Is Worse Than One That Does — Building a QUS Python Refresher

说明与用途

在量化超声模拟中，脉冲长度错误导致所有散射体未被放置，RF 数组保持全零。修正后恢复了正确的信号生成。

问题

A silent shape mismatch in a quantitative ultrasound (QUS) simulation caused all scatterers to be omitted, producing a zero RF array without raising an exception.

结果

The bug was identified and fixed, restoring correct scatterer placement and RF signal generation. The repo now demonstrates a complete QUS pipeline with reproducible notebooks.

工作流

• 1. Define short time axis for pulse generation.
• 2. Generate Gaussian envelope pulse on short axis.
• 3. Create long time axis covering full imaging depth.
• 4. Sum delayed, scaled copies of pulse onto RF array using correct bounds check.
• 5. Verify scatterer placement by counting added echoes.

证据

With a pulse the same length as rf, idx + len(pulse) >= len(rf) for every idx >= 0 — the condition can never be true.

来源

0 out of 200 scatterers get placed with the buggy pulse, versus 200 out of 200 with the correctly‑scoped one.

来源