README.md

---
title: NeuroPath DTI Viewer
emoji: 🧠
colorFrom: gray
colorTo: green
sdk: static
app_file: dti_neuropath/fiber_viewer.html
pinned: false
short_description: StromaPath NeuroPath DTI fiber viewer (static)
license: apache-2.0
---

# NeuroPath · DTI 纖維束 Viewer（靜態）

## `app_file` 與「Entry not found」

HF 的 **`app_file` 必須與 repo 根目錄實際路徑一致**。本 repo 以 **`dti_neuropath/fiber_viewer.html`** 為 Space 入口。

`index.html` 仍可做備用入口。若 push 因 **>10MB** 失敗，見 `.gitignore`（不上傳 `dti_tracts.json`、`.trk`、`甲/` 等；Demo 僅 **00625／00626** 的 `tracts_classified.json` + `lesion_mesh.json`）。

若仍空白：到 **Settings → Space configuration** 確認 **SDK = Static** 後存檔並觸發重建。

**TDA 儀表板**：在 3D Viewer 內點 **「TDAresult download」**（全螢幕疊層，勿直接開 `resolve/main` 網址——HF 會當純文字顯示原始碼）。

## 部署前必改

1. **`hf-config.js`**  
   將 `window.STROMAPATH_HOME` 改成你的 **StromaPath 主站**完整網址（需含 `stromapath-website.html`），頂欄「Products / Contact…」才會連回正確主站。

2. **HF 建立 Space 時**  
   - **SDK** 選 **Static**（勿選 Gradio／Docker，除非你要自己改 Dockerfile）。  
   - **Owner**：`chihsing`  
   - **Space name**：自訂（例如 `stromapath-dti`）。  
   - **License**：與此 README `license` 一致或於網頁另選。

3. **大檔**  
   若 `git push` 失敗，請對大型 JSON／TRK 使用 **Git LFS**，或將部分案例改放 **Dataset** 再以 URL 載入（需改程式）。

## 本機預覽

在 `Brain_DTI_HF` 根目錄啟動 HTTP 伺服器後開 `http://127.0.0.1:PORT/dti_neuropath/fiber_viewer.html`（勿用 `file://`）。

## 隱私

勿上傳未脫敏可辨識病患身分之原始 DICOM／臨床識別資料。