NavisworksTransport/doc/guide/model_splitter_usage_guide.md

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

功能概述

模型分层拆分功能是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)

• 初始版本发布
• 支持四种分层策略
• 提供预览和批量处理功能
• 生成详细的拆分报告

---

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