tcad-bodeplot/PROJECT_STATUS.md

DSP Bode Plot 專案進度總結 (2026-05-15)

1. 核心功能優化 (DSP & 定點數運算)

• 細部微調 (Fine-tuning)：實施了基於 \delta (Delta) 與 r (Radius) 的參數化微調。
• 定點數精確度修正：採用「兩倍值整數運算」邏輯，解決了 0.5 步階在浮點數圓整時產生的「按鍵沒反應」Bug。
• 防止漂移 (Oscillation Logic)：針對數位微調，實施了奇偶震盪平衡邏輯。當調整 \delta 導致 r 必須隨動時，採用震盪補償防止 r 產生單向累積誤差。
• 參數連動策略：在 0.5 步階時，採取「優先滿足目標變動」原則。若調整 $\delta$，則 r 隨動；反之亦然。

2. UI/UX 介面調整

• 側邊欄優化：
  • 將 r 與 \delta 的調整區域改為垂直堆疊，適應 21rem 的窄邊欄。
  • 移除冗餘的 a1, a2 預覽方塊，僅保留帶有數學公式標籤的 r, \delta 預覽。
• 步階序列：數位微調步階改為自訂序列：[0.5, 1, 2, 4, 8, 32, 256, 1024, 4096, 16384, 65536]。
• 微調量顯示：統一使用 ± 符號並帶空格（例如 ± 0.5）。
• 智能禁用：當數位步階為 0.5 時，自動禁用 r 的控制項，確保以 \delta 為主導。

3. 繪圖系統 (Bode Plot)

• 幅值圖 (Magnitude)：
  • 初始範圍：基於 $systemGain \times 3$，涵蓋 $70 \text{ dB}$。
  • 保留手動彈性：設定為 fixedrange: false，支援滑鼠縮放與 Auto Scale。
  • 狀態保持：使用 uirevision，確保微調參數時不會跳回初始縮放。
• 相位圖 (Phase)：
  • 絕對鎖死：固定範圍為 $[-180^\circ, 180^\circ]$。
  • 禁止縮放：設定為 fixedrange: true，提供穩定的絕對參考。
• 座標軸連動：幅值圖與相位圖的 X 軸（頻率）已完全同步。不論在哪一張圖進行橫向縮放，兩者都會連動。

4. 數學公式參考

• 理想空間：
  • a1 = -1 - r + \delta
  • a2 = r + \delta
• 定點數空間 (Q14 為例)：
  • a0 = 2^{14} = 16384
  • a1 = -a0 - r + \delta
  • a2 = r + \delta
  • 2\delta = a1 + a2 + a0
  • 2r = a2 - a1 - a0

5. 目前 Git 狀態

• 當前分支：dev-ui-fix-20260515 (已於 2026-05-15 17:46 推送至 GitLab)。
• 同步說明：此版本已安全儲存在獨立分支，不影響 main 分支同事的使用。
• 同事試用指令：

  git fetch
  git checkout dev-ui-fix-20260515
  

---

Last Updated: 2026-05-15 17:47