# SWdata-texttoCAD

本仓库用于存放行星减速器关节模组的 SolidWorks 源文件数据集，方便后续用于 Text-to-CAD 相关研究。

## 📁 目录结构

所有模组文件统一放在 `1_行星关节模组/` 下，按传动类型和级数分类存放：

```text
1_行星关节模组/
├── 1.1_NGW/                    # NGW 型行星减速器
│   ├── 1.1.1_一级/             # 单级减速
│   │   └── [模组文件夹]/
│   └── 1.1.2_二级/             # 两级减速
│       └── [模组文件夹]/
├── 1.2_NW/                     # NW 型行星减速器
│   ├── 1.2.1_一级/
│   │   └── [模组文件夹]/
│   └── 1.2.2_二级/
│       └── [模组文件夹]/
├── 1.3_WW/                     # WW 型行星减速器
│   ├── 1.3.1_一级/
│   │   └── [模组文件夹]/
│   └── 1.3.2_二级/
│       └── [模组文件夹]/
└── 1.4_NGWN/                   # NGWN 型行星减速器
    ├── 1.4.1_一级/
    │   └── [模组文件夹]/
    └── 1.4.2_二级/
        └── [模组文件夹]/
```

## 📤 上传文件指引（给上传者）

### 第一步：确定你的模组属于哪一类

- 看你的减速器有没有**固定内齿圈**、输出端是不是**行星架** → 是的话就是 **NGW**
- 如果不确定属于 NGW / NW / WW / NGWN 中的哪一种，先确认清楚再放
- 传动级数：一组行星轮系算一级，两组串联算两级

### 第二步：创建模组文件夹

在对应的分类文件夹下（例如 `1.1.2_二级/`），新建一个文件夹，**文件夹名建议按以下格式**：

```text
PJ_NGW_S2_090_T80_001
```

字段说明（供参考，不强求完全一致）：

| 字段 | 含义 | 示例 |
|------|------|------|
| PJ | 行星关节模组（固定前缀） | PJ |
| NGW | 传动型式 | NGW / NW / WW / NGWN |
| S2 | 级数 | S1 / S2|
| 090 | 外径档（mm） | 060 / 070 / 090 / 110 |
| T80 | 扭矩档（N·m） | T80 |
| 001 | 同规格序号 | 001 / 002 |

### 第三步：放入文件

每个模组文件夹内建议包含以下内容，**可在根目录下载PJ_NGW_S2_090_T80_001_模板**：

```text
PJ_NGW_S2_090_T80_001/
├── 装配/
│   └── （总装文件）.sldasm
├── 零件/
│   └── *.sldprt
├── 导出/
│   ├── （总装文件）.step
│   └── 零件/
│       └── *.step
├── 清单/
│   └── 零件清单.xlsx
├── 模组信息表.xlsx
├── joint_module_assembly.schema.json  #schema文件
└── joint_module_assembly_sop.json  #sop文件
```

**要求：**

- 总装文件、零件文件请使用英文或数字命名，避免特殊符号
- 每个自制件均需导出 STEP 文件
- 螺纹连接件、弹簧挡圈、垫片等不强制建实体模型，但需在零件清单中写明型号、数量
- `模组信息表.xlsx` 至少包含：模组编号、传动类型、级数、减速比、额定扭矩、质量、设计说明
- 务必包含 `joint_module_assembly.schema.json` 和 `joint_module_assembly_sop.json`（schema 和 sop 文件）

## 📋 零件清单与模组信息表填写说明

### 零件清单（`清单/零件清单.xlsx`）

每个自制件占一行，标准件也必须列出（型号、数量、单重）。

**角色名必须使用下表统一名称**（中英文均可，但同一模组内保持一致）：

| 角色（推荐英文） | 中文 | 备注 |
|----------------|------|------|
| sun_gear | 太阳轮 | 可与轴做成一体 |
| planet_gear | 行星轮 | 数量写在「数量」列（常见 3 或 4） |
| ring_gear | 内齿圈 | 固定在壳体或单独件 |
| carrier | 行星架 | |
| carrier_pin | 行星轴/销 | |
| input_shaft | 输入轴 | |
| output_flange | 输出法兰 | |
| input_flange | 输入/电机法兰 | |
| motor_housing | 电机壳 | |
| gear_housing | 减速器壳体 | |
| mid_housing | 级间壳/隔套 | 两级以上常见 |
| bearing_seat | 轴承座 | |
| bearing | 轴承 | |
| encoder_cover | 编码器盖 | |
| brake_disk_seat | 抱闸座 | 可选 |
| seal_cover | 密封盖 | |
| cable_guide | 走线结构 | 臂关节常见 |
| mount_bracket | 安装耳/支架 | 臂关节常见 |

**清单至少包含以下列**：

| 文件名 | 角色 | 数量 | 材料 | 单件质量(kg) | 备注 |
|--------|------|------|------|-------------|------|

> 两级模组如有两套太阳轮/行星架，建议在文件名或备注中加 `_L1`、`_L2` 区分一级和二级。

### 模组信息表（`模组信息表.xlsx`）

每个模组一张表或一个 Sheet，**以下字段为必填**：

| 字段 | 填写说明 | 示例 |
|------|----------|------|
| 模组编号 | 与文件夹名一致 | PJ_NGW_S2_090_T80_001 |
| 传动类型 | 行星 / 平行轴 / 其他 | 行星 |
| 行星型式 | NGW / NW / WW / NGWN | NGW |
| 级数 | 1 / 2 / 3 | 2 |
| 产品形态 | 纯减速器 / 伺服一体 / 臂关节 | 伺服一体 |
| 外径档 (mm) | 外壳或输出法兰外径 | 90 |
| SolidWorks 版本 | 建模所用版本 | 2020 |
| 总减速比 | 实际减速比 | 49 |
| 各级减速比 | 两级以上尽量分开写 | 7 × 7 |
| 额定输出扭矩 (N·m) | | 80 |
| 峰值输出扭矩 (N·m) | 没有可空 | 240 |
| 额定输入转速 (rpm) | | 3000 |
| 回差 (arcmin) | 没有可空 | 3 |
| 效率 (%) | 铭牌或估算 | 90 |
| 模组总质量 (kg) | 称重或 SW 评估+标准件 | 1.85 |
| 数据来源 | 铭牌 / 实测 / 计算 / 估算 | 铭牌+估算 |
| 额定功率 (W) | 有则填 | 150 |
| 冷却方式 | 自然冷却 / 强制风冷 / 其他 | 自然冷却 |
| 壳体有无散热筋 | 有 / 无（须与模型一致） | 有 |
| 设计说明 | 写清楚简化内容、接口形式、特殊结构 | 见下方示例 |

**设计说明示例**（用中文写几句话即可）：
- 采用两级 NGW 串联，总减速比 49（7×7）
- 输出接口为 6×M6 螺纹孔，PCD φ80
- 中空走线，内径 φ12
- 齿轮齿形简化为节圆圆柱，未画完整渐开线齿廓

## 📥 下载指引（给下载者）

根据你需要的模组类型，进入对应文件夹下载即可：

| 你想要的 | 去这里找 |
|----------|----------|
| NGW 单级减速器 | `1_行星关节模组/1.1_NGW/1.1.1_一级/` |
| NGW 两级减速器 | `1_行星关节模组/1.1_NGW/1.1.2_二级/` |
| NW 单级减速器 | `1_行星关节模组/1.2_NW/1.2.1_一级/` |
| NW 两级减速器 | `1_行星关节模组/1.2_NW/1.2.2_二级/` |
| WW 单级减速器 | `1_行星关节模组/1.3_WW/1.3.1_一级/` |
| WW 两级减速器 | `1_行星关节模组/1.3_WW/1.3.2_二级/` |
| NGWN 单级减速器 | `1_行星关节模组/1.4_NGWN/1.4.1_一级/` |
| NGWN 两级减速器 | `1_行星关节模组/1.4_NGWN/1.4.2_二级/` |

每个模组文件夹内都包含完整的 SW 源文件、STEP 文件、零件清单和模组信息表，下载后可直接使用。

## 📋 文件名与角色参考

零件清单中建议使用以下角色名（中英文均可，但同一模组内保持一致）：

| 角色 | 说明 |
|------|------|
| sun_gear | 太阳轮 |
| planet_gear | 行星轮 |
| ring_gear | 内齿圈 |
| carrier | 行星架 |
| carrier_pin | 行星轴/销 |
| input_shaft | 输入轴 |
| output_flange | 输出法兰 |
| gear_housing | 减速器壳体 |
| motor_housing | 电机壳（一体模组时使用） |
| bearing_seat | 轴承座 |
| seal_cover | 密封盖 |

两级模组如有两套太阳轮/行星架，建议在文件名或备注中加 `_L1`、`_L2` 区分一级和二级。