Delete 'src/GUI/BEFORE_AFTER_COMPARISON.md'

2026-04-01 14:40:56 +08:00
parent 063067e5d0
commit 73c80178c6
1 changed files with 0 additions and 218 deletions
@@ -1,218 +0,0 @@
 # 實現前後對比
 ## 系統架構變化
 ### 舊架構（直接更新）
 ```
 接收執行緒
    ↓
 monitor.latest_data
    ↓
 spin_ros() [10ms]
    ↓
 update_ui() [100% 直接更新 UI]
    ├─ GPS → 立即更新地圖和表格
    ├─ HUD → 立即更新 Panel 和地圖
    ├─ State → 立即更新 State
    ├─ Battery → 立即更新 Battery
    └─ ... 等等
 ❌ 問題：
  - Map 更新頻率太高，可能導致 CPU 過度使用
  - 高頻率的連續更新可能造成視覺閃爍
  - 沒有批次更新機制
 ```
 ### 新架構（分層更新）
 ```
 接收執行緒
    ↓
 monitor.latest_data
    ↓
 spin_ros() [10ms]
    ↓
 update_ui()
    ├─ GPS/HUD → 快取到 _message_cache
    ├─ State → 立即更新
    ├─ Battery → 立即更新
    └─ ... 等等
    ↓
 _update_panel_and_map() [100ms / 10Hz]
    ├─ 讀取 _message_cache GPS 資料
    │   └─ 更新地圖位置和表格
    ├─ 讀取 _message_cache HUD 資料
    │   └─ 更新 Panel 和地圖方向
    └─ 使用上次快取值（如無新消息）
 ✅ 優勢：
  - Map 和 Panel 只在 10Hz 更新，降低 CPU 負荷
  - 批次更新確保原子性
  - 消息未更新時使用上次值，資訊連續性好
  - 分層設計允許不同組件不同更新率
 ```
 ## 代碼實現對比
 ### 舊代碼片段（GPS 更新）
 ```python
 def update_ui(self, msg_type, drone_id, data):
    ...
    elif msg_type == 'gps':
        lat, lon = data.get('lat', 0), data.get('lon', 0)
        self.drone_positions[drone_id] = (lat, lon)
        alt = data.get('alt', 0)
        if not hasattr(self.monitor, 'drone_gps'):
            self.monitor.drone_gps = {}
        self.monitor.drone_gps[drone_id] = {'lat': lat, 'lon': lon, 'alt': alt}
        self.update_overview_table(drone_id, 'latitude', f"{lat:.6f}°")
        self.update_overview_table(drone_id, 'longitude', f"{lon:.6f}°")
        heading = self.drone_headings.get(drone_id, 0)
        self.drone_map.update_drone_position(drone_id, lat, lon, heading)  # ← 直接更新 Map
 ```
 ### 新代碼片段（GPS 快取）
 ```python
 def update_ui(self, msg_type, drone_id, data):
    ...
    # 快取 GPS 和 HUD 資料用於 panel/map 的 10Hz 更新
    if msg_type in ('gps', 'hud'):
        if drone_id not in self._message_cache:
            self._message_cache[drone_id] = {}
        self._message_cache[drone_id][msg_type] = data
        # 不在這裡更新，等待 _update_panel_and_map 在 10Hz 執行
        return
 ```
 ### 新代碼片段（10Hz 批次更新）
 ```python
 def _update_panel_and_map(self):
    """10Hz 定時更新 panel 和 map，使用快取的 GPS 和 HUD 消息"""
    for drone_id in list(self._message_cache.keys()):
        cache = self._message_cache[drone_id]
        # 使用快取的 GPS 資料
        if 'gps' in cache:
            gps_data = cache['gps']
            lat, lon = gps_data.get('lat', 0), gps_data.get('lon', 0)
            self.drone_positions[drone_id] = (lat, lon)
            # ... 更新表格 ...
        # 使用快取的 HUD 資料
        if 'hud' in cache:
            # ... 更新 panel 和 map ...
            self.drone_map.update_drone_position(drone_id, lat, lon, heading)  # ← 10Hz 更新
 ```
 ## 性能影響分析
 ### Map 更新頻率
 | 場景 | 舊架構 | 新架構 | 改進 |
 |------|--------|--------|------|
 | 單架無人機 | ~50Hz | 10Hz | ↓ 80% |
 | 5 架無人機 | ~250Hz | 10Hz | ↓ 96% |
 | 10 架無人機 | ~500Hz | 10Hz | ↓ 98% |
 ### 消息快取大小
 ```
 最大快取大小 = num_drones × 2 messages (gps + hud)
 例如：10 架無人機
  最大快取: 10 × 2 = 20 個消息
  內存使用: ~10KB (非常小)
 ```
 ## 延遲分析
 ### 位置更新延遲
 ```
 GPS 消息到達
    ↓
 快取到 _message_cache
    ↓
 等待至多 100ms（下一個 10Hz 週期）
    ↓
 _update_panel_and_map() 讀取並更新地圖
    ↓
 總延遲: 0-100ms
 用戶體驗：無可見延遲（100ms 對人眼不可察）
 ```
 ## 初始化檢查清單
 在啟動 GUI 時確保：
 - [ ] `panel_map_timer` 已初始化並啟動
  ```python
  self.panel_map_timer = QTimer()
  self.panel_map_timer.timeout.connect(self._update_panel_and_map)
  self.panel_map_timer.start(100)
  ```
 - [ ] `_message_cache` 已初始化為空字典
  ```python
  self._message_cache = {}
  ```
 - [ ] `update_ui()` 正確快取 GPS/HUD 消息
  ```python
  if msg_type in ('gps', 'hud'):
      # 快取邏輯
  ```
 - [ ] `_update_panel_and_map()` 方法存在且被連接
  ```python
  self.panel_map_timer.timeout.connect(self._update_panel_and_map)
  ```
 ## 監控 UI
 ### 添加調試輸出（可選）
 在 `_update_panel_and_map()` 開始添加：
 ```python
 import time
 if not hasattr(self, '_debug_map_time'):
    self._debug_map_time = time.time()
    self._debug_map_count = 0
 self._debug_map_count += 1
 if time.time() - self._debug_map_time >= 1.0:
    cached_drones = len(self._message_cache)
    updated_drones = sum(1 for d in self._message_cache.values() if d)
    print(f"[10Hz] Cycle {self._debug_map_count} | "
          f"Cached: {cached_drones} | "
          f"Updated: {updated_drones}")
    self._debug_map_time = time.time()
    self._debug_map_count = 0
 ```
 ## 故障診斷
 如果地圖或 Panel 沒有更新：
 1. **檢查定時器是否運行**
   ```python
   print(f"Timer active: {self.panel_map_timer.isActive()}")
   ```
 2. **檢查快取是否有數據**
   ```python
   print(f"Cache: {self._message_cache}")
   ```
 3. **檢查方法是否被調用**
   - 在 `_update_panel_and_map()` 開始添加 `print("_update_panel_and_map called")`
 4. **檢查 update_drone_position 是否有錯誤**
   - 查看控制台輸出，是否有異常拋出
 ---
 **版本**: 2025-03-25  
 **狀態**: ✅ 生產就緒