Add v3.2.0 Windows .exe and macOS arm64 .dmg installers; refresh model card
Browse files- .gitattributes +2 -0
- README.md +203 -3
- TOM.exe → TOM-Tongue-Segmentation-v3.2.0-arm64.dmg +2 -2
- TOM-Tongue-Segmentation-v3.2.0.exe +3 -0
.gitattributes
CHANGED
|
@@ -34,3 +34,5 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
|
|
| 34 |
*.zst filter=lfs diff=lfs merge=lfs -text
|
| 35 |
*tfevents* filter=lfs diff=lfs merge=lfs -text
|
| 36 |
TOM.exe filter=lfs diff=lfs merge=lfs -text
|
|
|
|
|
|
|
|
|
| 34 |
*.zst filter=lfs diff=lfs merge=lfs -text
|
| 35 |
*tfevents* filter=lfs diff=lfs merge=lfs -text
|
| 36 |
TOM.exe filter=lfs diff=lfs merge=lfs -text
|
| 37 |
+
TOM-Tongue-Segmentation-v3.2.0.exe filter=lfs diff=lfs merge=lfs -text
|
| 38 |
+
TOM-Tongue-Segmentation-v3.2.0-arm64.dmg filter=lfs diff=lfs merge=lfs -text
|
README.md
CHANGED
|
@@ -1,3 +1,203 @@
|
|
| 1 |
-
---
|
| 2 |
-
license: mit
|
| 3 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
license: mit
|
| 3 |
+
language:
|
| 4 |
+
- en
|
| 5 |
+
- zh
|
| 6 |
+
tags:
|
| 7 |
+
- tongue-segmentation
|
| 8 |
+
- tcm
|
| 9 |
+
- traditional-chinese-medicine
|
| 10 |
+
- medical-imaging
|
| 11 |
+
- image-segmentation
|
| 12 |
+
- desktop-app
|
| 13 |
+
library_name: pytorch
|
| 14 |
+
pipeline_tag: image-segmentation
|
| 15 |
+
---
|
| 16 |
+
|
| 17 |
+
# TOM 舌象分割工具 · TOM Tongue Segmentation
|
| 18 |
+
|
| 19 |
+
> AI 驱动的中医舌象智能分割工具 · AI-powered tongue segmentation for TCM research
|
| 20 |
+
|
| 21 |
+
<p align="center">
|
| 22 |
+
<img src="https://raw.githubusercontent.com/orangeshushu/TOM-Tongue-Segmentation-Model/main/docs/assets/icon.png" alt="TOM app icon" width="128">
|
| 23 |
+
</p>
|
| 24 |
+
|
| 25 |
+
[](https://github.com/orangeshushu/TOM-Tongue-Segmentation-Model)
|
| 26 |
+
[](https://github.com/orangeshushu/TOM-Tongue-Segmentation-Model/releases)
|
| 27 |
+
[](https://github.com/orangeshushu/TOM-Tongue-Segmentation-Model/releases)
|
| 28 |
+
[](https://github.com/orangeshushu/TOM-Tongue-Segmentation-Model/blob/main/LICENSE)
|
| 29 |
+
|
| 30 |
+
**[🇨🇳 中文](#-中文版) · [🇺🇸 English](#-english)**
|
| 31 |
+
|
| 32 |
+
---
|
| 33 |
+
|
| 34 |
+
## 🇨🇳 中文版
|
| 35 |
+
|
| 36 |
+
一款面向中医研究与临床的舌象分割桌面工具,自动从舌头照片中分离出舌体区域,支持单张精修和批量处理。
|
| 37 |
+
|
| 38 |
+
### ✨ 功能特性
|
| 39 |
+
|
| 40 |
+
- 🎯 **一键自动分割** —— 打开图片即自动识别舌头区域,通常 1–3 秒完成
|
| 41 |
+
- 🎨 **交互式微调** —— 通过点击 / 框选快速修正分割结果,每次标注后自动重算
|
| 42 |
+
- 📁 **批量处理** —— 整个文件夹一次性处理,可同时输出多种格式
|
| 43 |
+
- 💾 **三种输出格式** —— 透明背景 PNG · 二值掩膜 · 叠加可视化
|
| 44 |
+
- ⚡ **高精度模式** —— 可选 GrabCut 边界精修,更贴合舌体边缘
|
| 45 |
+
- 🌏 **中英双语界面** —— 一键切换中文 / English
|
| 46 |
+
- 🪟 **绿色安装** —— 双击安装即用,无需 Python / CUDA 环境
|
| 47 |
+
|
| 48 |
+
### 📥 下载安装
|
| 49 |
+
|
| 50 |
+
可直接从本仓库下载,或前往 [**GitHub Releases**](https://github.com/orangeshushu/TOM-Tongue-Segmentation-Model/releases) 页面:
|
| 51 |
+
|
| 52 |
+
| 文件 | 大小 | 平台 |
|
| 53 |
+
|---|---|---|
|
| 54 |
+
| [`TOM-Tongue-Segmentation-v3.2.0.exe`](./TOM-Tongue-Segmentation-v3.2.0.exe) | 565 MB | Windows 10 / 11(64 位) |
|
| 55 |
+
| [`TOM-Tongue-Segmentation-v3.2.0-arm64.dmg`](./TOM-Tongue-Segmentation-v3.2.0-arm64.dmg) | 354 MB | macOS 11+(Apple Silicon) |
|
| 56 |
+
|
| 57 |
+
**Windows**:双击 `.exe` 运行安装向导,可选择:
|
| 58 |
+
- **语言**:中文 / English(界面语言可在安装后随时切换)
|
| 59 |
+
- **安装位置**:默认 `%LOCALAPPDATA%\Programs\TOM舌象分割工具\`
|
| 60 |
+
- **桌面快捷方式**:是否创建
|
| 61 |
+
|
| 62 |
+
安装完成后从开始菜单或桌面快捷方式启动。
|
| 63 |
+
|
| 64 |
+
**macOS**:双击 `.dmg` 挂载,将 `TOM Tongue Segmentation.app` 拖入 `Applications` 文件夹即可。首次启动时由于未经 Apple 公证,可能提示「无法验证开发者」——请在 `Applications` 中**右键点击应用 → 选择「打开」→ 在弹窗中再次点「打开」**即可正常运行,之后双击启动不再提示。
|
| 65 |
+
|
| 66 |
+
### 🚀 使用方法
|
| 67 |
+
|
| 68 |
+
#### 单张图片处理
|
| 69 |
+
|
| 70 |
+

|
| 71 |
+
|
| 72 |
+
1. 点击 **打开图片**,选择一张舌头照片
|
| 73 |
+
2. 等待 1–3 秒,应用自动完成分割
|
| 74 |
+
3. 如对结果不满意,可进行交互式微调:
|
| 75 |
+
- **Shift + 左键拖动**:框选舌头区域(最准确)
|
| 76 |
+
- **左键点击**:标记舌头(前景点)
|
| 77 |
+
- **右键点击**:标记背景
|
| 78 |
+
- 每次标注后会自动重新分割
|
| 79 |
+
4. 满意后点击 **保存结果**,选择输出文件夹
|
| 80 |
+
5. 自动生成三种输出:透明背景 PNG · 二值掩膜 · 叠加可视化图
|
| 81 |
+
|
| 82 |
+
#### 批量处理
|
| 83 |
+
|
| 84 |
+

|
| 85 |
+
|
| 86 |
+
1. 切换到 **批量处理** 标签页
|
| 87 |
+
2. 选择 **输入文件夹**(内含待处理的舌头图片)
|
| 88 |
+
3. 选择 **输出文件夹**
|
| 89 |
+
4. 勾选需要的输出类型(抠图 / 掩膜 / 叠加图)
|
| 90 |
+
5. 可选:勾选 **高精度模式**(GrabCut 边界精修,每张多耗时约零点几秒)
|
| 91 |
+
6. 点击 **开始批量分割**
|
| 92 |
+
7. 进度条和日志会实时显示处理状态
|
| 93 |
+
|
| 94 |
+
支持的图片格式:`.jpg` `.jpeg` `.png` `.bmp` `.tif` `.tiff` `.webp`
|
| 95 |
+
|
| 96 |
+
#### 切换语言
|
| 97 |
+
|
| 98 |
+
点击右上角 **EN / 中** 按钮即可在中英文之间切换。
|
| 99 |
+
|
| 100 |
+
### 📋 系统要求
|
| 101 |
+
|
| 102 |
+
- **操作系统**:Windows 10 / 11(64 位)· macOS 11 Big Sur 或更高(Apple Silicon,M1/M2/M3/M4)
|
| 103 |
+
- **内存**:4 GB RAM 以上(推荐 8 GB)
|
| 104 |
+
- **磁盘空间**:约 1.5 GB
|
| 105 |
+
- **加速**:Windows 可选 GPU 加速 · macOS 自动启用 Apple MPS 加速(CPU 也能正常运行)
|
| 106 |
+
|
| 107 |
+
---
|
| 108 |
+
|
| 109 |
+
## 🇺🇸 English
|
| 110 |
+
|
| 111 |
+
A desktop tongue-segmentation tool for TCM research and clinical use. Automatically isolates the tongue region from a photograph, with support for single-image fine-tuning and batch processing.
|
| 112 |
+
|
| 113 |
+
### ✨ Features
|
| 114 |
+
|
| 115 |
+
- 🎯 **One-click auto segmentation** — Tongue region is identified automatically on opening, typically in 1–3 seconds
|
| 116 |
+
- 🎨 **Interactive fine-tuning** — Click / box-select to correct results; re-segments after every edit
|
| 117 |
+
- 📁 **Batch processing** — Process an entire folder at once, output multiple formats simultaneously
|
| 118 |
+
- 💾 **Three output formats** — Transparent PNG cutout · Binary mask · Overlay visualization
|
| 119 |
+
- ⚡ **High-accuracy mode** — Optional GrabCut boundary refinement for tighter edges
|
| 120 |
+
- 🌏 **Bilingual UI** — Switch between English and 中文 with one click
|
| 121 |
+
- 🪟 **Standalone install** — Double-click installer, no Python / CUDA setup required
|
| 122 |
+
|
| 123 |
+
### 📥 Download & Install
|
| 124 |
+
|
| 125 |
+
Download directly from this repository, or visit the [**GitHub Releases**](https://github.com/orangeshushu/TOM-Tongue-Segmentation-Model/releases) page:
|
| 126 |
+
|
| 127 |
+
| File | Size | Platform |
|
| 128 |
+
|---|---|---|
|
| 129 |
+
| [`TOM-Tongue-Segmentation-v3.2.0.exe`](./TOM-Tongue-Segmentation-v3.2.0.exe) | 565 MB | Windows 10 / 11 (64-bit) |
|
| 130 |
+
| [`TOM-Tongue-Segmentation-v3.2.0-arm64.dmg`](./TOM-Tongue-Segmentation-v3.2.0-arm64.dmg) | 354 MB | macOS 11+ (Apple Silicon) |
|
| 131 |
+
|
| 132 |
+
**Windows**: Double-click the `.exe` to run the installer wizard, which lets you choose:
|
| 133 |
+
- **Language**: 中文 / English (UI language can be switched anytime after install)
|
| 134 |
+
- **Install location**: defaults to `%LOCALAPPDATA%\Programs\TOM Tongue Segmentation\`
|
| 135 |
+
- **Desktop shortcut**: yes / no
|
| 136 |
+
|
| 137 |
+
Launch from the Start menu or desktop shortcut after install.
|
| 138 |
+
|
| 139 |
+
**macOS**: Double-click the `.dmg` to mount it, then drag `TOM Tongue Segmentation.app` into the `Applications` folder. Because the bundle is not Apple-notarized, the first launch may show *"cannot be verified"*. To get past it, **right-click the app in `Applications` → Open → Open** in the confirmation dialog. After that first launch, double-clicking works normally.
|
| 140 |
+
|
| 141 |
+
### 🚀 How to Use
|
| 142 |
+
|
| 143 |
+
#### Single Image
|
| 144 |
+
|
| 145 |
+

|
| 146 |
+
|
| 147 |
+
1. Click **Open Image** and pick a tongue photo
|
| 148 |
+
2. Wait 1–3 seconds — the app segments automatically
|
| 149 |
+
3. If you want to refine the result:
|
| 150 |
+
- **Shift + left-drag**: box the tongue region (most accurate)
|
| 151 |
+
- **Left click**: add a foreground (tongue) point
|
| 152 |
+
- **Right click**: mark background
|
| 153 |
+
- Re-segmentation runs after every edit
|
| 154 |
+
4. When satisfied, click **Save Results** and pick an output folder
|
| 155 |
+
5. Three outputs are produced: transparent PNG · binary mask · overlay visualization
|
| 156 |
+
|
| 157 |
+
#### Batch Folder
|
| 158 |
+
|
| 159 |
+

|
| 160 |
+
|
| 161 |
+
1. Switch to the **Batch Folder** tab
|
| 162 |
+
2. Pick an **Input folder** (containing tongue images)
|
| 163 |
+
3. Pick an **Output folder**
|
| 164 |
+
4. Tick which output types you want (cutout / mask / overlay)
|
| 165 |
+
5. Optional: enable **High accuracy** (GrabCut edge refine, adds a fraction of a second per image)
|
| 166 |
+
6. Click **Start batch**
|
| 167 |
+
7. Progress bar and log update in real time
|
| 168 |
+
|
| 169 |
+
Supported image formats: `.jpg` `.jpeg` `.png` `.bmp` `.tif` `.tiff` `.webp`
|
| 170 |
+
|
| 171 |
+
#### Switching Language
|
| 172 |
+
|
| 173 |
+
Click the **EN / 中** button at the top-right to toggle between English and Chinese.
|
| 174 |
+
|
| 175 |
+
### 📋 System Requirements
|
| 176 |
+
|
| 177 |
+
- **OS**: Windows 10 / 11 (64-bit) · macOS 11 Big Sur or newer (Apple Silicon, M1/M2/M3/M4)
|
| 178 |
+
- **RAM**: 4 GB or more (8 GB recommended)
|
| 179 |
+
- **Disk**: ~1.5 GB
|
| 180 |
+
- **Acceleration**: Optional GPU on Windows · Apple MPS used automatically on macOS (CPU also works)
|
| 181 |
+
|
| 182 |
+
---
|
| 183 |
+
|
| 184 |
+
## 📖 引用 · Citation
|
| 185 |
+
|
| 186 |
+
如本工具对您的研究有帮助,欢迎引用我们的文章。
|
| 187 |
+
If this tool helps your research, please cite our paper:
|
| 188 |
+
|
| 189 |
+
> Xie, J., Zhang, Z., Poudel, B., Guo, C., Yu, Y., An, G., ... & Xu, D. (2026). **TOM: An open-source tongue segmentation method with multi-teacher distillation and task-specific data augmentation.** *Expert Systems with Applications*, 131499.
|
| 190 |
+
|
| 191 |
+
🔗 [View on ScienceDirect](https://www.sciencedirect.com/science/article/pii/S0957417426004124)
|
| 192 |
+
|
| 193 |
+
## 🏛️ 研发团队 · Developed by
|
| 194 |
+
|
| 195 |
+
**[Digital Biology Laboratory (DBL)](https://digbio.missouri.edu/)**
|
| 196 |
+
University of Missouri
|
| 197 |
+
|
| 198 |
+
如本工具对您有帮助,欢迎给我们一个 ⭐ Star 以获取后续更新通知。
|
| 199 |
+
If this tool helps you, a ⭐ star is appreciated — and you'll get notified of future updates.
|
| 200 |
+
|
| 201 |
+
## 📄 版权 · Copyright
|
| 202 |
+
|
| 203 |
+
© 2026 Digital Biology Laboratory · University of Missouri
|
TOM.exe → TOM-Tongue-Segmentation-v3.2.0-arm64.dmg
RENAMED
|
@@ -1,3 +1,3 @@
|
|
| 1 |
version https://git-lfs.github.com/spec/v1
|
| 2 |
-
oid sha256:
|
| 3 |
-
size
|
|
|
|
| 1 |
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:72cdebe4f6bba1ffb65b34d050e77b075608bcbf7d51ec4b2ae80f6686ff74ba
|
| 3 |
+
size 371092898
|
TOM-Tongue-Segmentation-v3.2.0.exe
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:d615c1c5ca8143fcf1e8b860f22b74661412c24d80c7cc0d387d41b65a82d377
|
| 3 |
+
size 592040291
|