feat: implement intelligent caching for STA/LTA results to improve UI responsiveness

app.py

@@ -313,6 +313,8 @@ def select_nearest_stations(st, epicenter_lat, epicenter_lon, n_stations=25, eve
     station_distances = {}  # 改用字典避免重複
     p_wave_detected_count = 0
     p_wave_failed_count = 0
+    cache_hit_count = 0
+    cache_miss_count = 0
 
     # 初始化此事件的 cache
     if event_name and event_name not in sta_lta_cache:
@@ -348,14 +350,32 @@ def select_nearest_stations(st, epicenter_lat, epicenter_lon, n_stations=25, eve
             lon = station_data["Longitude"].values[0]
             elev = station_data["Elevation"].values[0]
 
-            # 偵測 P 波（使用 Z 分量）
-            z_trace = st.select(station=station_code, component="Z")
-            if len(z_trace) == 0:
-                logger.debug(f"測站 {station_code} 無 Z 分量，跳過")
-                p_wave_failed_count += 1
-                continue
-
-            p_arrival_time, cft = detect_p_wave_sta_lta(z_trace[0])
+            # 偵測 P 波（使用 Z 分量）- 優先使用快取
+            if event_name and event_name in sta_lta_cache and station_code in sta_lta_cache[event_name]:
+                # 使用快取的 STA/LTA 結果
+                cached_result = sta_lta_cache[event_name][station_code]
+                p_arrival_time = cached_result["p_arrival_time"]
+                cft = cached_result["cft"]
+                cache_hit_count += 1
+                logger.debug(f"測站 {station_code} 使用快取的 STA/LTA 結果")
+            else:
+                # 重新計算 STA/LTA
+                z_trace = st.select(station=station_code, component="Z")
+                if len(z_trace) == 0:
+                    logger.debug(f"測站 {station_code} 無 Z 分量，跳過")
+                    p_wave_failed_count += 1
+                    continue
+
+                p_arrival_time, cft = detect_p_wave_sta_lta(z_trace[0])
+                cache_miss_count += 1
+
+                # 快取 STA/LTA 結果
+                if event_name:
+                    sta_lta_cache[event_name][station_code] = {
+                        "p_arrival_time": p_arrival_time,
+                        "cft": cft
+                    }
+                    logger.debug(f"測站 {station_code} STA/LTA 結果已快取")
 
             # 只保留成功偵測到 P 波的測站
             if p_arrival_time is None:
@@ -374,12 +394,6 @@ def select_nearest_stations(st, epicenter_lat, epicenter_lon, n_stations=25, eve
             }
             p_wave_detected_count += 1
 
-            # 快取 STA/LTA 結果（spec: 避免滑桿更新時重複計算，提升反應速度）
-            if event_name:
-                sta_lta_cache[event_name][station_code] = {
-                    "p_arrival_time": p_arrival_time,
-                    "cft": cft
-                }
 
         except Exception as e:
             logger.warning(f"測站 {station_code} 資訊查詢失敗: {e}")
@@ -393,7 +407,10 @@ def select_nearest_stations(st, epicenter_lat, epicenter_lon, n_stations=25, eve
 
     # 記錄實際可用的測站數（少於 25 站也允許繼續）
     actual_count = len(selected_stations)
-    logger.info(f"P 波偵測結果: 成功 {p_wave_detected_count} 站, 失敗 {p_wave_failed_count} 站")
+    logger.info(
+        f"P 波偵測結果: 成功 {p_wave_detected_count} 站, 失敗 {p_wave_failed_count} 站 | "
+        f"STA/LTA 快取: 命中 {cache_hit_count} 次, 未命中 {cache_miss_count} 次"
+    )
 
     if actual_count < n_stations:
         logger.warning(

changelog.md

@@ -5,10 +5,12 @@
 ## [Unreleased]
 
 ### Added
-- **STA/LTA 計算結果快取**
+- **STA/LTA 計算結果智能快取**
   - 新增全域快取 `sta_lta_cache`，在選擇事件時儲存所有測站的 STA/LTA 計算結果（P 波到時與 characteristic function）。
+  - **智能快取檢查**：在 `select_nearest_stations` 函數中，優先檢查快取是否存在，若存在則直接使用，避免重複計算。
   - 當使用者調整時間滑桿時，直接使用快取的 P 波到時資訊，避免重複計算 STA/LTA，大幅提升 UI 反應速度。
   - 快取結構：`{event_name: {station_code: {"p_arrival_time": float, "cft": array}}}`
+  - **快取統計**：記錄快取命中率（cache hit/miss），方便除錯與效能分析。
   - P 波到時資訊已存於 `selected_stations` 並透過 `gr.State` 傳遞，無需每次從原始波形重新計算。
 
 - **P 波自動偵測功能（STA/LTA）**