# anatomy

**Repository Path**: jaypro/anatomy

## Basic Information

- **Project Name**: anatomy
- **Description**: https://github.com/jixiangying/anatomy
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-07
- **Last Updated**: 2026-08-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 人体解剖学3D交互图谱 | Human Anatomy Explorer

<div align="center">

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Data: CC BY-SA 2.1](https://img.shields.io/badge/Data-CC%20BY--SA%202.1-green.svg)](https://creativecommons.org/licenses/by-sa/2.1/jp/)

**[中文](#中文)** | **[English](#english)**

</div>

---

<a name="中文"></a>
## 🇨🇳 中文

基于 **BodyParts3D/ISA** 真实MRI扫描数据的3D人体解剖可视化应用，支持11大系统交互式浏览。本项目采用模型库中的 **ISA (Intuitive Surgical Anatomy)** 分类体系进行组织。

### ✨ 功能特点

- ✅ **真实人体模型** - 基于2mm MRI扫描的医学级数据
- ✅ **11大解剖系统** - 骨骼、肌肉、心血管、神经、消化、呼吸、泌尿、生殖、内分泌、淋巴、皮肤
- ✅ **双语标注** - 中文 + 英文解剖学术语
- ✅ **全局搜索** - 一键搜索所有系统，自动打开对应图层
- ✅ **智能高亮** - 选中模型高亮显示，其他模型自动半透明
- ✅ **图层控制** - 独立开关各系统，自由组合显示
- ✅ **双向交互** - 点击列表项或3D模型相互联动
- ✅ **平滑动画** - 相机自动聚焦到选中部位

### 🚀 快速开始

**在线访问**
🌐 **GitHub Pages**: https://jixiangying.github.io/anatomy/

**本地运行**
```bash
git clone https://github.com/jixiangying/anatomy.git
cd anatomy
python3 -m http.server 3000
# 浏览器访问 http://localhost:3000
```

### 🎮 使用说明

| 操作 | 功能 |
|------|------|
| 左键拖动 | 旋转视角 |
| 右键拖动 | 平移视角 |
| 滚轮 | 缩放 |
| 搜索框 | 全局搜索所有系统的部位 |
| 点击左侧列表 | 高亮3D模型并聚焦 |
| 点击3D模型 | 自动高亮并滚动左侧列表 |
| 点击空白处 | 取消选择，恢复全不透明 |
| 右侧图层控制 | 开关各系统显示 |

### ⚠️ 数据说明

**AI 辅助分类与翻译**

> ⚠️ **注意**：本项目的解剖学分类和中文翻译均由 **AI 基于 BodyParts3D 官网 ISA 相关说明文档** 自动生成，可能存在以下问题：
> - **部件名称提取欠优化**：由于一个模型对应多个解剖学标签（FMA），自动提取的英文名可能不是最通用的术语。
> - **解剖学术语翻译不够精准**：个别生僻术语可能不符合中文医学惯例。
> - **模型分类归属可能存在偏差**。
>
> 🔍 **已知问题**：由于原始 BodyParts3D 模型库的数据组织原因，存在个别解剖实体重复的模型文件（如 **FJ2440** 与 **FJ2769** 均为环状软骨）。
>
> **如需更正**：请直接修改 `data/anatomy_data_simple_refined.json` 文件中的对应字段。
> ```json
> {
>   "id": "FJ3152",
>   "name": "右髋骨 | right hip bone",
>   "system": "骨骼系统",
>   "nameEn": "right hip bone",
>   "nameCn": "右髋骨",
>   "systemEn": "Skeletal System"
> }
> ```
> 欢迎提交 Pull Request 帮助改进数据质量！

### 🏥 数据来源

- **项目**: BodyParts3D / ISA (Intuitive Surgical Anatomy)
- **版本**: Release 4.0 ([2021-06-08 16:43](https://dbarchive.biosciencedbc.jp/data/bodyparts3d/))
- **机构**: 日本东京大学生命科学数据库中心
- **分类体系**: **ISA (Intuitive Surgical Anatomy)**
- **许可**: CC BY-SA 2.1 Japan
- **模型数**: 2,234个OBJ文件

---

<a name="english"></a>
## 🇬🇧 English

A 3D human anatomy visualization application based on **BodyParts3D/ISA** real MRI scan data, supporting interactive browsing of 11 major anatomical systems. This project utilizes the **ISA (Intuitive Surgical Anatomy)** classification system.

### ✨ Features

- ✅ **Real Human Models** - Medical-grade data based on 2mm MRI scans
- ✅ **11 Anatomical Systems** - Skeletal, Muscular, Cardiovascular, Nervous, Digestive, Respiratory, Urinary, Reproductive, Endocrine, Lymphatic, Integumentary
- ✅ **Bilingual Labels** - Chinese + English anatomical terminology
- ✅ **Global Search** - Search across all systems with auto-layer activation
- ✅ **Smart Highlight** - Highlight selected model, others become semi-transparent
- ✅ **Layer Control** - Toggle individual systems, freely combine displays
- ✅ **Bidirectional Interaction** - Click list items or 3D models to sync with each other
- ✅ **Smooth Animation** - Camera automatically focuses on selected parts

### 🚀 Quick Start

**Online Access**
🌐 **GitHub Pages**: https://jixiangying.github.io/anatomy/

**Local Run**
```bash
git clone https://github.com/jixiangying/anatomy.git
cd anatomy
python3 -m http.server 3000
# Open http://localhost:3000 in browser
```

### 🎮 Usage

| Action | Function |
|--------|----------|
| Left drag | Rotate view |
| Right drag | Pan view |
| Scroll | Zoom |
| Search box | Global search for all system parts |
| Click left list | Highlight 3D model and focus |
| Click 3D model | Auto-highlight and scroll left list |
| Click blank area | Deselect, restore full opacity |
| Right control | Toggle system visibility |

### ⚠️ Data Notice

**AI-Assisted Processing**

> ⚠️ **Note**: The anatomical classifications and translations in this project were **automatically generated by AI based on BodyParts3D ISA documentation** and may contain:
> - **Under-optimized Name Extraction**: Since one model may correspond to multiple anatomical labels (FMA), the automatically extracted English names might not be the most common clinical terms.
> - **Imprecise anatomical terminology translations**.
> - **Potential deviations in model classification**.
>
> 🔍 **Known Issues**: Due to the data organization of the original BodyParts3D library, there are a few duplicate model files for the same anatomical entity (e.g., **FJ2440** and **FJ2769** are both cricoid cartilage).
>
> **To Correct**: Please modify the corresponding fields in `data/anatomy_data_simple_refined.json`.
> ```json
> {
>   "id": "FJ3152",
>   "name": "右髋骨 | right hip bone",
>   "system": "骨骼系统",
>   "nameEn": "right hip bone",
>   "nameCn": "右髋骨",
>   "systemEn": "Skeletal System"
> }
> ```
> Pull Requests are welcome to help improve data quality!

### 🏥 Data Source

- **Project**: BodyParts3D / ISA (Intuitive Surgical Anatomy)
- **Version**: Release 4.0 ([2021-06-08 16:43](https://dbarchive.biosciencedbc.jp/data/bodyparts3d/))
- **Organization**: Database Center for Life Science (DBCLS), Japan
- **Classification**: **ISA (Intuitive Surgical Anatomy)**
- **License**: CC BY-SA 2.1 Japan
- **Count**: 2,234 OBJ files

---

<div align="center">

Created with ❤️ for anatomy education
**人体解剖学教育 · Human Anatomy Education**

</div>