# 模型分层拆分功能使用指南

## 功能概述

模型分层拆分功能是Navisworks物流路径规划插件的核心功能之一，用于将大型建筑模型按照楼层、属性或其他条件拆分成多个独立的Navisworks文件。这个功能特别适用于：

- 大型建筑项目的分层管理
- 按楼层进行专业协调
- 减少文件大小，提高加载速度
- 便于不同团队分工协作
- 满足DELMIA等下游软件的导入需求

## 功能入口

1. 启动Navisworks 2017
2. 打开需要拆分的模型文件
3. 在"附加模块"选项卡中点击"Transport Plugin"
4. 在弹出的控制面板中切换到"系统管理"标签页
5. 点击"模型分层拆分"按钮

## 界面说明

### 分层策略选择

**按楼层分层**
- 根据模型元素的楼层属性进行分层
- 自动识别常见的楼层属性（Level、Floor、Storey等）
- 适用于标准的建筑模型

**按自定义属性分层**
- 根据用户指定的属性值进行分层
- 可以选择任何模型中存在的属性
- 适用于有特殊分组需求的项目

**按类别分层**
- 根据模型元素的类别进行分层
- 自动识别元素的Family、Type等属性
- 适用于按专业或构件类型分层

**按高程范围分层**
- 根据模型元素的Z坐标进行分层
- 可设置高程容差和最小楼层高度
- 适用于没有楼层属性的模型

### 配置参数

**输出目录**
- 指定拆分后文件的保存位置
- 建议选择有足够空间的目录
- 支持网络路径

**文件命名模式**
- 支持变量替换：
  - `{ProjectName}`: 当前项目名称
  - `{LayerName}`: 分层名称
  - `{DateTime}`: 当前时间戳
- 示例：`{ProjectName}_{LayerName}` → `Building_Floor_01`

**高级选项**
- **包含空分层**: 是否导出没有元素的分层
- **创建子目录**: 为每个分层创建独立的子目录
- **生成报告**: 生成HTML格式的拆分报告
- **高程容差**: 楼层检测时的高程误差范围
- **最小楼层高度**: 用于高程范围分层的最小高度

## 操作步骤

### 第一步：选择分层策略
1. 在"分层策略"下拉框中选择合适的策略
2. 如果选择"按楼层"或"按自定义属性"，需要在"分层属性"中选择对应的属性
3. 系统会自动扫描模型中可用的属性

### 第二步：配置输出参数
1. 点击"浏览"按钮选择输出目录
2. 设置文件命名模式
3. 根据需要调整高级选项

### 第三步：预览分层结果
1. 点击"预览分层"按钮
2. 系统会分析模型并显示预览结果
3. 检查分层名称、元素数量和输出文件路径
4. 确认结果无误后，"开始拆分"按钮会变为可用状态

### 第四步：执行拆分
1. 点击"开始拆分"按钮
2. 确认拆分参数后点击"是"
3. 等待拆分完成，可以通过进度条查看进度
4. 拆分完成后会显示结果统计

## 输出结果

### 文件结构
```
输出目录/
├── ProjectName_Floor_01/
│   ├── ProjectName_Floor_01.nwd
│   ├── ProjectName_Floor_01.json (元数据)
│   └── ProjectName_Floor_01_report.txt
├── ProjectName_Floor_02/
│   ├── ProjectName_Floor_02.nwd
│   ├── ProjectName_Floor_02.json
│   └── ProjectName_Floor_02_report.txt
└── split_summary_report.html (汇总报告)
```

### 文件说明
- **.nwd文件**: 拆分后的Navisworks模型文件
- **.json文件**: 包含分层元数据的JSON文件
- **_report.txt**: 文本格式的分层报告
- **split_summary_report.html**: HTML格式的汇总报告

## 最佳实践

### 模型准备
1. **确保模型完整性**: 拆分前检查模型是否完整加载
2. **检查属性质量**: 确保用于分层的属性值准确一致
3. **备份原始文件**: 建议在拆分前备份原始模型文件

### 分层策略选择
1. **优先使用楼层属性**: 如果模型有标准的楼层属性，优先选择"按楼层分层"
2. **自定义属性的验证**: 使用自定义属性前，先检查属性值的分布情况
3. **高程分层的参数调整**: 使用高程分层时，根据实际建筑高度调整参数

### 性能优化
1. **分批处理大模型**: 对于超大模型，可以先按区域手动选择后再分层
2. **合理设置输出目录**: 选择SSD硬盘作为输出目录可以提高速度
3. **关闭不必要的功能**: 如果不需要报告，可以关闭"生成报告"选项

### 质量控制
1. **预览验证**: 始终先预览分层结果，确认无误后再执行
2. **检查元素数量**: 确保拆分后的元素总数与原模型一致
3. **验证文件完整性**: 拆分完成后，随机打开几个文件验证内容正确性

## 常见问题解决

### 问题1：找不到楼层属性
**现象**: 属性下拉框中没有楼层相关的属性
**解决方案**:
1. 检查模型是否正确加载
2. 尝试使用"按高程范围分层"策略
3. 联系模型提供方确认楼层属性的命名

### 问题2：分层结果不符合预期
**现象**: 预览显示的分层与预期不符
**解决方案**:
1. 检查选择的属性是否正确
2. 调整高程容差参数
3. 使用"按自定义属性分层"并手动选择属性

### 问题3：导出文件过大或过小
**现象**: 某些分层文件异常大或小
**解决方案**:
1. 检查分层逻辑是否正确
2. 验证属性值的分布
3. 考虑使用复合分层策略

### 问题4：拆分过程中断
**现象**: 拆分过程中出现错误或中断
**解决方案**:
1. 检查磁盘空间是否充足
2. 确保Navisworks没有其他耗时操作
3. 尝试分批处理或重启软件后重试

### 问题5：无法打开拆分后的文件
**现象**: 生成的.nwd文件无法在Navisworks中打开
**解决方案**:
1. 检查原始模型是否有损坏
2. 尝试不同的文件格式（nwf、nwc）
3. 确认Navisworks版本兼容性

## 技术限制

### Navisworks API限制
1. **文件格式支持**: 主要支持.nwd格式，其他格式可能有限制
2. **内存使用**: 大模型拆分时可能占用较多内存
3. **并发限制**: 同时只能进行一个拆分操作

### 性能考虑
1. **处理时间**: 大模型的拆分可能需要较长时间
2. **磁盘空间**: 拆分后的文件总大小可能超过原文件
3. **系统资源**: 建议在配置较高的计算机上运行

## 版本兼容性

### 支持的Navisworks版本
- Navisworks Manage 2017
- Navisworks Simulate 2017

### 支持的文件格式
- **输入**: .nwd, .nwf, .nwc, .dwg, .rvt等Navisworks支持的格式
- **输出**: .nwd (推荐), .nwf, .nwc

### 系统要求
- Windows 7 或更高版本
- .NET Framework 4.6.2 或更高版本
- 足够的磁盘空间（建议至少为原文件大小的2倍）

## 更新日志

### v1.0 (2025-07-16)
- 初始版本发布
- 支持四种分层策略
- 提供预览和批量处理功能
- 生成详细的拆分报告

---

如有其他问题，请查看日志文件或联系技术支持。