From da28fe411aa2e7f1565b5c6d58e10e8e288a58f0 Mon Sep 17 00:00:00 2001 From: tian <11429339@qq.com> Date: Thu, 14 Aug 2025 18:33:43 +0800 Subject: [PATCH] =?UTF-8?q?=E5=AE=9E=E7=8E=B0=E4=BA=86=E8=87=AA=E5=8A=A8?= =?UTF-8?q?=E8=A7=84=E5=88=92=E7=AE=97=E6=B3=95=E7=AC=AC=E4=B8=80=E9=98=B6?= =?UTF-8?q?=E6=AE=B5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .claude/settings.local.json | 8 +- .gitignore | 6 +- CHANGELOG.md | 54 ++ CLAUDE.md | 198 +++-- NavisworksTransportPlugin.csproj | 17 + VERSION.md | 2 +- tool/compile.bat => compile.bat | 10 +- deploy-from-anywhere.bat | 109 --- doc/design/2026/C# A_ 寻路优化_.md | 429 +++++++++++ doc/design/2026/Idea.md | 2 +- .../2026/Navisworks 物流路径规划方案_.md | 687 ------------------ .../2026/Navisworks自动路径规划实现方案_.md | 520 ------------- doc/design/2026/寻路算法的对比.md | 72 ++ doc/design/2026/物流路径规划方案.md | 456 ++++++++++++ doc/working/第一阶段MVP实施计划_20250114.md | 463 ++++++++++++ doc/working/第二阶段优化计划_20250814.md | 280 +++++++ .../自动路径规划功能逐步实现方案_20250114.md | 458 ++++++++++++ nuget.exe | Bin 0 -> 8974384 bytes packages.config | 5 + src/Core/PathClickToolPlugin.cs | 1 + src/Core/PathPlanningManager.cs | 466 ++++++++++++ src/Core/PathPlanningModels.cs | 7 +- src/Core/PathPointRenderPlugin.cs | 47 +- .../Properties/CategoryAttributeManager.cs | 274 +++++++ src/PathPlanning/AutoPathFinder.cs | 518 +++++++++++++ .../AutoPathPlanningValidationResult.cs | 149 ++++ src/PathPlanning/GridMap.cs | 414 +++++++++++ src/PathPlanning/GridMapGenerator.cs | 519 +++++++++++++ src/PathPlanning/Point2D.cs | 151 ++++ src/UI/WPF/LogisticsControlPanel.xaml | 46 +- .../ViewModels/LogisticsControlViewModel.cs | 413 +++++++++++ src/UI/WPF/Views/PathEditingView.xaml | 36 + src/Utils/UnitsConverter.cs | 140 ++++ 33 files changed, 5545 insertions(+), 1412 deletions(-) rename tool/compile.bat => compile.bat (80%) delete mode 100644 deploy-from-anywhere.bat create mode 100644 doc/design/2026/C# A_ 寻路优化_.md delete mode 100644 doc/design/2026/Navisworks 物流路径规划方案_.md delete mode 100644 doc/design/2026/Navisworks自动路径规划实现方案_.md create mode 100644 doc/design/2026/寻路算法的对比.md create mode 100644 doc/design/2026/物流路径规划方案.md create mode 100644 doc/working/第一阶段MVP实施计划_20250114.md create mode 100644 doc/working/第二阶段优化计划_20250814.md create mode 100644 doc/working/自动路径规划功能逐步实现方案_20250114.md create mode 100644 nuget.exe create mode 100644 packages.config create mode 100644 src/PathPlanning/AutoPathFinder.cs create mode 100644 src/PathPlanning/AutoPathPlanningValidationResult.cs create mode 100644 src/PathPlanning/GridMap.cs create mode 100644 src/PathPlanning/GridMapGenerator.cs create mode 100644 src/PathPlanning/Point2D.cs create mode 100644 src/Utils/UnitsConverter.cs diff --git a/.claude/settings.local.json b/.claude/settings.local.json index fb9b3aa..6c3b3ff 100644 --- a/.claude/settings.local.json +++ b/.claude/settings.local.json @@ -7,7 +7,13 @@ "WebFetch(domain:adndevblog.typepad.com)", "Bash(.compile.bat)", "Bash(rg:*)", - "Bash(findstr:*)" + "Bash(findstr:*)", + "Bash(mkdir:*)", + "Bash(compile.bat)", + "Bash(./compile.bat)", + "Bash(./tool/compile.bat:*)", + "Bash(\"C:\\Program Files\\Microsoft Visual Studio\\2022\\Community\\MSBuild\\Current\\Bin\\MSBuild.exe\" NavisworksTransportPlugin.csproj /p:Configuration=Debug /p:Platform=AnyCPU /verbosity:minimal)", + "Bash(\"C:\\Program Files\\Microsoft Visual Studio\\2022\\Community\\MSBuild\\Current\\Bin\\MSBuild.exe\" NavisworksTransportPlugin.csproj /p:Configuration=Debug /p:Platform=AnyCPU)" ], "deny": [] } diff --git a/.gitignore b/.gitignore index a0556c9..8a7fe35 100644 --- a/.gitignore +++ b/.gitignore @@ -4,6 +4,10 @@ bin/ obj/ .vs/ +.vscode/ +.idea/ +packages/ # API documentation -api/ \ No newline at end of file +navisworks_api/ + diff --git a/CHANGELOG.md b/CHANGELOG.md index 917d86c..0717f19 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,58 @@ # NavisworksTransport 变更日志 +## [0.4.0] - 2025-08-14 + +### 🎯 自动路径规划系统重大突破 + +#### 核心问题修复 + +- **单位转换系统重构** + - 修复了RoyT.AStar算法坐标系统错误（坐标放大19.7倍的问题） + - 实现了"统一使用米为单位"的架构策略 + - 创建了`UnitsConverter`工具类，集中处理所有单位转换 + - 消除了模型单位与算法单位不匹配导致的坐标异常 + +#### 2.5D路径规划实现 + +- **Z坐标插值系统** + - 解决了路径可视化在错误Z平面（-1800）的问题 + - 实现了起点和终点之间的线性Z坐标插值 + - 支持不平坦通道的高度变化处理 + - 为GridMap添加了PlanningStartPoint和PlanningEndPoint属性 + +#### 可视化优化 + +- **路径连线颜色区分** + - 手动路径连线：黑色 + - 自动路径连线：橙色（在黑色背景下更清晰） + - 移除了调试用的白色测试连线 + +#### 性能与稳定性 + +- **防崩溃机制** + - 限制路径点显示数量（最多10个关键点） + - 智能选择显示点（起点、终点、等间距中间点） + - 优化了图形渲染性能 + +### 技术架构改进 + +- **坐标系统统一** + - 确立了边界转换策略：Navisworks API ↔ 米单位 ↔ 第三方算法 + - 明确了单位转换的责任边界 + - 提高了代码的可维护性和可理解性 + +### 已知问题与后续计划 + +- **Z坐标精度**：当前使用线性插值，未考虑通道坡度变化，部分路径可能位于地面以下 +- **后续优化**：需要根据实际通道地面高度调整Z坐标 + +### 开发者工具优化 + +- 增强了调试日志，区分"A*米坐标"和"网格索引" +- 改进了坐标转换过程的可追溯性 + +--- + ## [0.3.0] - 2025-08-13 ### 重大更新 @@ -11,6 +64,7 @@ - 实现了属性管理和路径设置两个功能的迁移（还剩下动画仿真和系统管理） ### 功能优化 + - **物流属性管理** - 增加了限宽属性 - 支持设置多个物流元素 diff --git a/CLAUDE.md b/CLAUDE.md index 88d323d..45fa10b 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -4,110 +4,156 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co ## Project Overview -NavisworksTransport is a Navisworks 2017 plugin (v0.1.8) for logistics path planning and transportation conflict detection in 3D building models. The plugin enables route optimization, collision detection, and animated object movement along defined paths. +NavisworksTransport is a Navisworks 2026 plugin for logistics path planning and transportation conflict detection in 3D building models. The plugin supports route optimization, collision detection, and animated object movement along defined paths. + +**Current Status**: Navisworks 2026 exclusive development - no legacy 2017 compatibility required. Leverages 2026-specific features for enhanced animation and A* pathfinding capabilities. ## Build Commands -- **Build**: `compile.bat` - Automatically detects MSBuild (VS 2017/2019/2022) or falls back to `dotnet build` -- **Target**: .NET Framework 4.6.2, x64 platform -- **Output**: Direct deployment to `%PROGRAMFILES%\Autodesk\Navisworks Manage 2017\Plugins\NavisworksTransportPlugin\` +- **Build**: `tool\compile.bat` - Automatically detects MSBuild (VS 2022 Community/Professional) or falls back to `dotnet build` +- **Direct build**: `& "C:\Program Files\Microsoft Visual Studio\2022\Community\MSBuild\Current\Bin\MSBuild.exe" NavisworksTransportPlugin.csproj /p:Configuration=Debug /p:Platform=AnyCPU /verbosity:minimal` +- **Target**: .NET Framework 4.8, AnyCPU platform +- **Output**: `bin\Debug\NavisworksTransportPlugin.dll` +- **Dependencies**: RoyT.AStar 3.0.2 (managed via packages.config) ## Architecture Overview -### Core Plugin Structure +### Dual Plugin Architecture +The system implements multiple Navisworks plugin types working together: +- **MainPlugin.cs**: Primary AddInPlugin with ribbon UI and DockPanePlugin integration +- **PathClickToolPlugin.cs**: ToolPlugin for 3D mouse interaction and point placement +- **PathPointRenderPlugin.cs**: RenderPlugin for 3D visualization overlay -- **MainPlugin.cs**: Primary AddInPlugin entry point with ribbon UI -- **PathClickToolPlugin.cs**: ToolPlugin for 3D mouse interaction -- **PathPointRenderPlugin.cs**: RenderPlugin for 3D visualization +### Core Management Layer +- **PathPlanningManager.cs**: Central coordinator for route planning with A* pathfinding support +- **LogisticsAnimationManager.cs**: Enhanced animation system targeting Navisworks 2026 native components +- **TimeLinerIntegrationManager.cs**: Bridge between custom animations and Navisworks TimeLiner +- **CategoryAttributeManager.cs**: COM API wrapper for persistent logistics attribute management +- **VisibilityManager.cs**: Model layer control and filtering +- **ModelSplitterManager.cs**: Model export and layer separation -### Manager Components +### Data and Coordinate Systems +- **PathPlanningModels.cs**: Core data structures with event-driven state management +- **PathDataManager.cs**: JSON serialization with migration support +- **CoordinateConverter.cs**: 2D map overlay to 3D world coordinate transformation chains +- **GeometryExtractor.cs**: Spatial analysis and bounding box calculations +- **FloorDetector.cs**: Automatic floor/level detection for multi-story logistics -- **PathPlanningManager.cs**: Central path planning and route management logic -- **PathAnimationManager.cs**: TimeLiner integration for object movement animation -- **CoordinateConverter.cs**: 2D map overlay to 3D world coordinate conversion -- **CategoryAttributeManager.cs**: COM API wrapper for logistics attribute management -- **VisibilityManager.cs**: Layer visibility and model filtering control -- **ModelSplitterManager.cs**: Model layer separation and export functionality - -### Data and Utilities - -- **PathPlanningModels.cs**: Core data structures (PathEditState, PathRoute, PathPoint) -- **PathDataManager.cs**: Serialization and persistence using Newtonsoft.Json -- **GeometryExtractor.cs**: 3D geometry analysis and bounding box calculations -- **LogManager.cs**: Centralized logging with global exception handling - -### UI Components - -- **LogisticsPropertyEditDialog.cs**: Property editing interface -- **ModelSplitterDialog.cs**: Model splitting configuration UI +### UI Architecture: WPF + WinForms Hybrid +- **WPF Components**: Modern MVVM-based controls in `src\UI\WPF\` + - LogisticsControlPanel: Main docked interface + - ViewModels with INotifyPropertyChanged pattern + - Separated Views for different functional areas +- **WinForms Dialogs**: Legacy property editing interfaces +- **Integration**: ElementHost for WPF in Navisworks environment ## Key Technical Details -### Navisworks API Integration +### Navisworks API Integration Pattern +- **Dual API Strategy**: Native API (`Autodesk.Navisworks.Api`) for core functionality + COM API (`Autodesk.Navisworks.ComApi`) for attribute persistence and TimeLiner operations +- **Plugin Architecture**: Three distinct plugin types registered in single assembly +- **Event-Driven Design**: Global exception handling with `GlobalExceptionHandler` class +- **Navisworks 2026 Focus**: Utilizes 2026-specific API features without backward compatibility constraints -- Uses dual API approach: Native API (`Autodesk.Navisworks.Api`) + COM API (`Autodesk.Navisworks.ComApi`) -- COM API required for attribute persistence and TimeLiner operations -- Plugin types: AddInPlugin (main), ToolPlugin (interaction), RenderPlugin (visualization) +### Pathfinding and Animation System +- **A* Algorithm**: RoyT.AStar library integration for optimal path calculation +- **Animation Pipeline**: Transform-based movement with collision detection integration +- **TimeLiner Bridge**: Synchronization between custom path animations and Navisworks timeline +- **Real-time Collision**: ClashDetectiveIntegration for dynamic conflict detection during animation -### Exception Handling +### State Management and Persistence +- **Session State**: PathEditState enum (None, AddingPoints, EditingPath) with event callbacks +- **Data Serialization**: JSON-based persistence with LogisticsAttributeChangedEventArgs for tracking +- **Coordinate Mapping**: Multi-layer coordinate system supporting 2D overlay on 3D models -Global exception handling implemented in MainPlugin with: - -- AppDomain.CurrentDomain.UnhandledException -- Application.ThreadException -- Automatic recovery and user-friendly error reporting - -### Coordinate Systems - -- Supports 2D map overlay on 3D models with dynamic zoom/pan -- Margin-based boundary calculations for click precision -- Transform chains for coordinate conversion between spaces - -### Logistics Categories - -Eight predefined logistics element types: - -- 门 (Doors), 电梯 (Elevators), 楼梯 (Stairs), 通道 (Channels) +### Logistics Classification System +Eight predefined categories with inheritance from parent to child nodes: +- 门 (Doors), 电梯 (Elevators), 楼梯 (Stairs), 通道 (Channels) - 障碍物 (Obstacles), 装卸区 (Loading Zones), 停车区 (Parking), 检查点 (Checkpoints) ## Development Guidelines -### Language Preference +### Language and Communication +- **使用中文进行所有交流和代码注释** - Primary language for user interaction and code documentation +- 代码注释和文档说明使用中文 - All technical documentation in Chinese -- **使用中文进行所有交流和代码注释** -- 与用户交流时优先使用中文 -- 代码注释和文档说明使用中文 - -### File Organization - -- Core managers handle specific functionality areas -- Models file contains shared data structures -- UI dialogs are separate form classes -- Utilities (logging, geometry, data) are standalone classes - -### Plugin Registration Pattern +### Package Management (Legacy Format) +- **Old-style csproj**: Uses `` with HintPath instead of PackageReference +- **packages.config**: Manual NuGet package management (do NOT use `dotnet add package`) +- **Manual package installation**: Download .nupkg files and extract to packages/ directory +- **Path format**: `packages\{PackageId}.{Version}\lib\{TargetFramework}\{Assembly}.dll` +### Plugin Registration Patterns ```csharp -[Plugin("NavisworksTransport.PluginName", "YourDeveloperID")] +// Multi-plugin registration in single assembly +[Plugin("NavisworksTransport.MainPlugin", "YourDeveloperID")] [AddInPlugin(AddInLocation.AddIn)] +public class MainPlugin : AddInPlugin { } + +[Plugin("NavisworksTransport.PathClickTool", "YourDeveloperID")] +[ToolPluginAttribute("NavisworksTransport.PathClickTool", "YourDeveloperID")] +public class PathClickToolPlugin : ToolPlugin { } ``` -### Error Handling Best Practices +### Critical API Usage Patterns +- **Always reference Navisworks API documentation**: Check `doc\navisworks_api\` before implementing any Navisworks functionality +- **COM API for persistence**: Use COM API for attribute operations that need to persist across sessions +- **GlobalExceptionHandler**: Initialize in MainPlugin constructor for application-wide error handling +- **Thread safety**: UI operations must be marshaled to main thread when called from background processes -- Use LogManager for consistent logging -- Implement try-catch blocks around Navisworks API calls -- **写任何与Navisworks相关的代码，都要查在doc/navisworks_api目录下的官方API文档和示例代码，** -- Provide meaningful error messages to users -- Use COM API error codes for troubleshooting +### Navisworks 2026 Development Focus +- **Exclusive 2026 targeting**: No backward compatibility required - leverage 2026-specific features freely +- **Legacy artifacts**: `src\Legacy\` contains reference code from 2017 version but is not actively maintained +- **Modern animation system**: Use Navisworks 2026 native animation components instead of manual Transform manipulation +- **Enhanced APIs**: Take advantage of improved 2026 APIs for collision detection, animation, and model management -### Dependencies +## API Documentation Search Strategy -- **System.Windows.Forms**: UI dialogs and controls -- **System.Drawing**: Graphics and coordinate operations +### CHM文档搜索最佳实践 + +**问题**：CHM解压后产生大量HTML文件（数千个），标准搜索工具效果有限 + +**解决策略**： + +1. **使用文档结构入口点**： + ```bash + # 优先访问类成员列表 + AllMembers_T_Autodesk_Navisworks_Api_ClassName.htm + ``` + +2. **精确文件名搜索**： + ```bash + find . -name "*ClassName*" -o -name "*MethodName*" + ``` + +3. **分层搜索方法**： + - 先定位到类级别文档 + - 从类成员列表找到方法链接 + - 利用文档间超链接导航 + +4. **搜索模式示例**： + ```bash + # 搜索特定API + grep -r "SaveFile\|Export.*nwd" --include="*.htm" doc/navisworks_api/ + + # 查找特定类的所有成员 + find . -name "AllMembers_T_Autodesk_Navisworks_Api_Document.htm" + ``` + +5. **常用API文档路径**： + - Document类：`AllMembers_T_Autodesk_Navisworks_Api_Document.htm` + - TimeLiner：`AllMembers_T_Autodesk_Navisworks_Api_Timeliner_*.htm` + - 插件基类：`AllMembers_T_Autodesk_Navisworks_Api_Plugins_*.htm` + +**避免的搜索方式**： +- 避免在HTML内容中进行模糊搜索（标签干扰） +- 不要依赖GUID格式的文件名 +- 避免使用过于宽泛的搜索词 ## Testing and Deployment -- Manual testing required through Navisworks Manage 2017 -- Plugin automatically deploys to Navisworks plugin directory during build -- Restart Navisworks after compilation to load new plugin version -- Use LogManager output for debugging and troubleshooting +- **Testing environment**: Navisworks Manage 2026 exclusively - 2017 support discontinued +- **Plugin deployment**: Build output automatically copies to Navisworks 2026 plugin directory +- **Hot reload**: Restart Navisworks required after compilation to load new plugin version +- **Debugging**: Use LogManager for centralized logging and `tool\LogViewer.bat` for log analysis +- **2026 Features**: Test advanced animation capabilities, enhanced collision detection, and improved model handling diff --git a/NavisworksTransportPlugin.csproj b/NavisworksTransportPlugin.csproj index 1ecdf7f..d1d10c3 100644 --- a/NavisworksTransportPlugin.csproj +++ b/NavisworksTransportPlugin.csproj @@ -84,6 +84,12 @@ + + + + packages\RoyT.AStar.3.0.2\lib\netstandard2.0\Roy-T.AStar.dll + True + @@ -112,6 +118,13 @@ + + + + + + + Form @@ -151,6 +164,7 @@ + @@ -196,4 +210,7 @@ + + + diff --git a/VERSION.md b/VERSION.md index 9325c3c..60a2d3e 100644 --- a/VERSION.md +++ b/VERSION.md @@ -1 +1 @@ -0.3.0 \ No newline at end of file +0.4.0 \ No newline at end of file diff --git a/tool/compile.bat b/compile.bat similarity index 80% rename from tool/compile.bat rename to compile.bat index b4f9d9f..e3fe34c 100644 --- a/tool/compile.bat +++ b/compile.bat @@ -1,15 +1,15 @@ @echo off -echo Building NavisworksTransport Plugin with Model Splitter... +echo Building NavisworksTransport Plugin... -REM Set MSBuild path (adjust if needed) -set MSBUILD_PATH="C:\Program Files (x86)\Microsoft Visual Studio\2019\Professional\MSBuild\Current\Bin\MSBuild.exe" +REM Set MSBuild path (check Community edition first) +set MSBUILD_PATH="C:\Program Files\Microsoft Visual Studio\2022\Community\MSBuild\Current\Bin\MSBuild.exe" REM Check if MSBuild exists, try alternative paths if not exist %MSBUILD_PATH% ( set MSBUILD_PATH="C:\Program Files\Microsoft Visual Studio\2022\Professional\MSBuild\Current\Bin\MSBuild.exe" ) if not exist %MSBUILD_PATH% ( - set MSBUILD_PATH="C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional\MSBuild\15.0\Bin\MSBuild.exe" + set MSBUILD_PATH="C:\Program Files (x86)\Microsoft Visual Studio\2019\Professional\MSBuild\Current\Bin\MSBuild.exe" ) if not exist %MSBUILD_PATH% ( echo MSBuild not found. Trying dotnet build... @@ -21,7 +21,7 @@ echo Using MSBuild: %MSBUILD_PATH% REM Build the project echo Building project... -%MSBUILD_PATH% NavisworksTransportPlugin.csproj /p:Configuration=Debug /p:Platform="Any CPU" /p:TargetFrameworkVersion=v4.6.2 +%MSBUILD_PATH% "NavisworksTransportPlugin.csproj" /p:Configuration=Debug /p:Platform=AnyCPU /verbosity:minimal :end if %ERRORLEVEL% EQU 0 ( diff --git a/deploy-from-anywhere.bat b/deploy-from-anywhere.bat deleted file mode 100644 index a5c32c1..0000000 --- a/deploy-from-anywhere.bat +++ /dev/null @@ -1,109 +0,0 @@ -@echo off -echo === Navisworks Transport Plugin Deployment (Auto-locate) === -echo. - -REM Try to find the project directory -set "PROJECT_DIR=" - -REM Check current directory first -if exist "NavisworksTransportPlugin.csproj" ( - set "PROJECT_DIR=%CD%" - goto :found -) - -REM Check if we're in a subdirectory, go up one level -cd .. -if exist "NavisworksTransportPlugin.csproj" ( - set "PROJECT_DIR=%CD%" - goto :found -) - -REM Check common locations -if exist "C:\Users\Tellme\apps\NavisworksTransport\NavisworksTransportPlugin.csproj" ( - set "PROJECT_DIR=C:\Users\Tellme\apps\NavisworksTransport" - goto :found -) - -REM If not found, ask user -echo ERROR: Could not locate NavisworksTransportPlugin.csproj -echo Please navigate to the project directory and run deploy-plugin.bat -echo. -echo Expected project structure: -echo NavisworksTransportPlugin.csproj -echo bin\Debug\NavisworksTransportPlugin.dll -echo. -pause -exit /b 1 - -:found -echo Found project at: %PROJECT_DIR% -cd /d "%PROJECT_DIR%" -echo. - -REM Check if compiled files exist -if not exist "bin\Debug\NavisworksTransportPlugin.dll" ( - echo ERROR: Plugin file not found, please compile the project first - echo Run command: dotnet build NavisworksTransportPlugin.csproj - echo. - echo Current directory contents: - dir /b - echo. - if exist "bin" ( - echo bin directory contents: - dir bin /b - if exist "bin\Debug" ( - echo bin\Debug directory contents: - dir "bin\Debug" /b - ) - ) - pause - exit /b 1 -) - -REM Set target directory (Navisworks installation Plugins folder) -set "TARGET_DIR=C:\Program Files\Autodesk\Navisworks Manage 2026\Plugins\NavisworksTransportPlugin" - -echo Target directory: %TARGET_DIR% -echo NOTE: Administrator privileges required to write to this directory -echo. - -REM Create directories -if not exist "%TARGET_DIR%" ( - mkdir "%TARGET_DIR%" 2>nul - if errorlevel 1 ( - echo ERROR: Failed to create directory. Please run as Administrator. - pause - exit /b 1 - ) - echo [OK] Created plugin directory -) - -REM Copy files -copy "bin\Debug\NavisworksTransportPlugin.dll" "%TARGET_DIR%\" >nul 2>&1 -if errorlevel 1 ( - echo ERROR: Failed to copy plugin file. Please run as Administrator. - pause - exit /b 1 -) -echo [OK] Copied plugin file: NavisworksTransportPlugin.dll - -if exist "bin\Debug\NavisworksTransport.Tian.name.txt" ( - copy "bin\Debug\NavisworksTransport.Tian.name.txt" "%TARGET_DIR%\" >nul 2>&1 - if errorlevel 1 ( - echo WARNING: Failed to copy localization file - ) else ( - echo [OK] Copied localization file: NavisworksTransport.Tian.name.txt - ) -) - -echo. -echo SUCCESS: Plugin deployed successfully! -echo. -echo Next steps: -echo 1. Start Navisworks Manage 2026 -echo 2. Look for "Logistics Path Planning" dockable panel -echo 3. If not visible, check Plugin Manager -echo. -echo Plugin location: %TARGET_DIR% -echo. -pause \ No newline at end of file diff --git a/doc/design/2026/C# A_ 寻路优化_.md b/doc/design/2026/C# A_ 寻路优化_.md new file mode 100644 index 0000000..84aea6b --- /dev/null +++ b/doc/design/2026/C# A_ 寻路优化_.md @@ -0,0 +1,429 @@ + + +# **性能优化C\# A\*寻路算法：GitHub上的高性能实现深度解析** + +## **I. 执行摘要** + +A\*算法作为路径规划领域的基石，在游戏开发、机器人导航、物流优化和人工智能等多个领域发挥着举足轻重的作用。它以其在静态环境中寻找最优路径的能力而备受青睐，在完备性和计算效率之间取得了平衡。当需要在已知且不变的图或网格中找到两点之间的最短或最低成本路径时，A\*通常是首选算法。 + +然而，尽管A\*算法在理论上表现出色，但其在C\#中的标准实现常常面临显著的性能瓶颈。这些瓶颈通常源于低效的数据结构，尤其是“开放列表”（优先级队列），导致成本高昂的插入和提取操作。此外，堆上过多的对象分配会增加垃圾回收的开销，从而导致性能出现不可预测的波动。次优的网格遍历技术和冗余计算进一步加剧了这些问题，使得基本实现不足以应对大规模或实时应用的需求 1。 + +要在C\#中实现高性能A\*，需要采取多方面的方法。关键策略包括：采用高效的优先级队列（例如二叉堆）、利用C\#的值类型（struct）来表示节点以减少垃圾回收开销、以及实现专门的网格表示（例如直接的“计算网格”、线性数组和2的幂次方网格尺寸以实现位运算）。算法层面的改进，例如“忽略旧节点”技术和优化的网格清理机制，在最大限度地减少冗余工作和提高吞吐量方面也发挥着至关重要的作用 1。 + +开源社区提供了这些优化实践的优秀范例。例如，roy-t/AStar项目展示了针对网格和图的现代高性能实现，而CastorTiu在CodeProject上发表的“Fast PathFinder”文章中概述的详细原理，则为理解各种底层优化如何产生复合效应提供了宝贵的见解。BlueRaja/High-Speed-Priority-Queue-for-C-Sharp存储库虽然并非完整的A\*实现，但它是任何C\# A\*解决方案实现峰值性能的关键基础组件 1。 + +最终，C\#中A\*算法的最佳性能是一个全面的工程挑战，需要仔细考虑数据结构效率、内存管理和算法的独创性。此外，路径规划算法本身的选择（例如A\*与D\* Lite等动态变体）至关重要，必须与环境特性（尤其是其动态性）相符。开发人员必须严格测试其解决方案，以验证其在特定应用场景中的性能提升。 + +## **II. A\*寻路基础** + +### **A\*算法解析** + +A\*是一种启发式搜索算法，旨在加权图或网格中查找从指定起始节点到目标节点的最短路径。其“启发式”特性源于它使用启发式函数来指导搜索，使其比非启发式算法更高效。它通过维护两个列表来运行：一个“开放列表”（待评估节点）和一个“关闭列表”（已评估节点） 7。 + +* 核心原理 + A\*算法的核心在于其对每个节点的评估，该评估结合了从起始点到当前节点的实际成本和从当前节点到目标点的估计成本。这种结合使得A\*能够在探索最有可能通向目标的路径时，同时避免不必要的搜索。算法在每次迭代中都会从开放列表中选择估计总成本最低的节点进行扩展，从而确保在满足启发式函数条件下找到最优路径。 +* **组成部分** + * 节点与边 + 节点是搜索空间的基本构建块，代表离散位置，例如网格单元格或交叉点。边表示节点之间的连接，通常与“成本”或“权重”相关联。这些成本可以代表距离、时间、资源消耗等 7。 + * 成本函数（g(n)） + 这个值代表从起始节点到当前节点n的实际累积路径成本。当从当前节点移动到下一个相邻节点时，新成本的计算方式为：newCost \= costSoFar\[current\] \+ graph.Cost(current, next)。costSoFar字典存储了到达每个节点迄今为止的最低累积成本 7。 + * 启发式函数（h(n)） + 这是从当前节点n到目标节点的估计成本。启发式函数对于A\*的效率至关重要；一个好的启发式函数可以显著减少探索的节点数量。对于基于网格的寻路，常见的启发式函数包括曼哈顿距离（适用于4方向移动：∣a.x−b.x∣+∣a.y−b.y∣）和欧几里得距离（适用于8方向或连续移动）。为了保证A\*找到最优路径，启发式函数必须是可接受的（从不高估到目标的真实成本）和一致的（从n到目标的估计成本小于或等于移动到相邻节点$n'的成本加上从n'$到目标的估计成本） \[7, 7。 + * 评估函数（f(n)） + 这是A\*优先级排序的核心，计算公式为：f(n)=g(n)+h(n)。这个值代表从起始节点经过当前节点n到目标的估计总成本。$f(n)$值越低的节点被认为越有希望，并被优先扩展 8。 + * 开放列表（前沿/优先级队列） + 这是一个数据结构，用于存储所有已发现但尚未完全评估的节点。节点根据其$f(n)值进行排序，其中f(n)$值最低的节点具有最高优先级。算法不断从该列表中提取最高优先级的节点进行处理 7。 + * 关闭列表（cameFrom/costSoFar） + 这些通常是Dictionary对象。cameFrom存储每个已访问节点的父节点，以便在找到目标后重建路径。costSoFar存储从起始点到每个节点迄今为止找到的最低累积成本。这些列表可防止算法不必要地重新访问和重新评估节点，从而避免无限循环或低效搜索 7。 + +### **标准C\#实现基线 (Red Blob Games)** + +Red Blob Games 提供的C\#实现 7 是一个出色的A\*算法基本教学示例。它清晰地定义了 + +AStarSearch方法，接受Graph、start Location和goal Location作为参数。它使用Dictionary\来存储cameFrom路径信息，并使用Dictionary\来跟踪costSoFar。Location被定义为一个包含整数x和y坐标的struct，并且为了在Dictionary和HashSet等基于哈希的集合中正确高效地使用Location对象作为键，它重写了Equals和GetHashCode方法 7。 + +一个关键的观察点是Red Blob Games实现的PriorityQueue类。作者明确指出，这是一个“占位符，效率低下的实现”，它使用了List的Tuple\ 7。这种简单的基于 + +List的方法需要线性扫描来查找和移除最高优先级的元素，使得Dequeue操作在最坏情况下具有$O(N)$的时间复杂度，其中$N$是队列中的元素数量。 + +基于List的优先级队列虽然易于理解，但代表着一个显著的性能瓶颈。对于大型图，在每次迭代中频繁地对前沿队列进行$O(N)$的入队和出队操作，会占据算法总执行时间的大部分，使得算法的运行速度慢得令人无法接受。Red Blob Games 自己也建议使用C\# 2020+中内置的PriorityQueue\<\>或其它高速优先级队列库来获得生产级别的性能 1。 + +A\*算法的核心循环会重复地从“开放列表”中提取$f(n)$值最低的节点，并插入新的或更新的相邻节点。如果“开放列表”使用简单的\`List\`实现（如Red Blob Games基线所示 7），查找最小元素需要遍历所有$N$个元素，时间复杂度为O(N)。类似地，在维护排序顺序（如果尝试的话）或移除任意元素时，也可能是O(N)。由于这些操作在主while循环中频繁发生（对于V个节点，大约运行V次；对于E条边，大约运行E次），因此整体复杂度会迅速升级到$O(V^2)$或$O(VE)$，从而使该算法对于大型搜索空间来说变得不切实际。Red Blob Games在7中明确警告其基于 + +List的PriorityQueue效率低下，并建议使用优化的替代方案，这直接证实了这是一个主要的性能瓶颈。这一观察强调了算法设计和优化中的一个基本原则：关键操作的数据结构选择通常比任何其他因素更能决定算法的整体性能特征。一个看似小的$O(N)$操作，当在嵌套循环中重复执行时，可以将一个原本高效的算法转变为性能瓶颈。这为A\*中高效优先级队列的关键作用奠定了基础。 + +### **A\*与其他寻路算法的比较** + +* Dijkstra算法 + A\*本质上是Dijkstra算法的改进。Dijkstra算法查找图中从单个源节点到所有其他可达节点的最短路径。相比之下，A\*通过使用启发式函数来指导搜索，专门针对查找单个特定目的地的最短路径进行了优化。对于单目的地寻路，A\*通常比Dijkstra算法探索的节点少得多，从而显著加快了计算时间，尤其是在大型地图上。例如，一项基准测试显示，在包含5000个节点的地图上，A\*比Dijkstra算法快约7倍，同时仍能找到相同的最优路径 \[12, 7。 +* 广度优先搜索 (BFS) + BFS通过在当前深度级别探索所有相邻节点，然后移动到下一级别，从而在无权重图中找到最短路径。虽然它在无权重场景中保证了最短路径，但对于加权图或包含障碍物的复杂环境，它变得非常低效，因为它不根据成本优先考虑路径。A\*及其成本函数和启发式函数专为加权图设计，在此类上下文中效率更高 \[75, S\_R42, S\_S8\]。 +* 深度优先搜索 (DFS) + DFS通过尽可能深入地遍历每个分支，然后回溯来探索图。它不保证找到最短路径，因此不适用于大多数需要最优性的寻路应用。 + +A\*的核心区别在于其“启发式”特性，这意味着它使用启发式函数（h(n)）来估计到目标的成本 \[7。这种指导允许A\*优先探索似乎直接通向目标的路径，从而有效地修剪掉搜索空间中不太可能包含最优路径的大部分。这与Dijkstra算法（向所有方向扩展直到找到目标）或BFS（逐层探索而不考虑路径成本）等“非启发式”算法形成鲜明对比。12中的定量数据表明A\*在5000节点地图上比Dijkstra“快约7倍”，这直接证明了这种性能优势。启发式函数减少访问节点数量的能力（如12中的视觉比较所示）是这种加速的直接原因。这一观察强调了算法选择是一个关键的性能决策。对于需要在加权图中找到单目的地最短路径的问题，A\*通常是更好的选择，因为它具有智能剪枝功能。然而，A\*的有效性高度依赖于其启发式函数的质量和可接受性。选择不当的启发式函数可能导致次优路径，甚至降低性能，有时甚至比更简单的非启发式搜索更慢。这突出了在设计有效启发式函数时领域特定知识的重要性。 + +## **III. 性能优化的必要性** + +### **为何优化A\*？** + +* 大型搜索空间 + 现代应用程序，尤其是在游戏开发（例如开放世界环境、大型策略地图）、机器人导航和复杂网络路由中，涉及包含数百万个节点的地图或图。未经优化的A\*算法可能需要数秒甚至数分钟才能计算出路径，使其无法使用 1。 +* 实时性要求 + 许多应用程序要求即时寻路。游戏、自动驾驶车辆和实时策略 (RTS) 模拟需要路径在毫秒内计算完成，以确保流畅的游戏体验、响应式导航或即时决策。延迟可能导致糟糕的用户体验或关键系统故障 1。 +* 高智能体密度 + 在涉及大量智能体（例如人群模拟、多机器人协调）的场景中，每个智能体都需要频繁地重新计算路径，即使是中等效率的算法，其累积计算负载也可能变得不堪重负。这会导致系统变慢、帧率下降或智能体“卡住”。 +* 动态环境（即使有重新规划） + 尽管A\*主要用于静态环境，但即使在半动态场景中，由于微小变化或新信息需要重新计算路径时，底层A\*实现的效率也至关重要。频繁的重新规划会放大核心算法中的任何低效率。 + +### **识别性能瓶颈** + +* 低效数据结构操作 + A\*中最常见且最重要的瓶颈是其核心数据结构（特别是“开放列表”（优先级队列）和“关闭列表”）的性能。如果这些数据结构使用List或ArrayList等通用集合实现，则添加、删除或搜索元素等操作可能具有$O(N)$时间复杂度。CodeProject文章明确指出，“搜索开放和关闭节点列表所花费的时间”是标准A\*实现中的“主要瓶颈” 1。 +* 过多内存分配（垃圾回收开销） + 在C\#和其他托管语言中，在堆上频繁创建对象（例如，为每个节点或路径段使用class实例）会导致垃圾回收器（GC）的压力增加。GC周期可能在实时应用程序中引入不可预测的暂停或“卡顿”，严重影响响应能力 1。 +* 冗余计算 + 重复计算相同的值（例如成本或启发式估计），或在紧密循环中执行复杂的坐标转换，可能会累积显著的开销。尽管这些操作单独来看很小，但当执行数百万次时，它们可能会成为主要的性能消耗 1。 + +CodeProject文章 1 提供了一个引人注目的例子，说明了同时优化CPU周期和内存占用对性能的重要性。文章指出，主要瓶颈是“搜索开放和关闭节点列表所花费的时间”，这表明与低效数据结构访问相关的CPU密集型问题。同时，它强调将节点改为 + +struct“减少了垃圾回收开销”，解决了与内存相关的性能问题。文章中的“Fast PathFinder”实现了“300到1500倍”的速度提升，但代价是“对于1024x1024的网格，额外增加了13MB的内存”。这明确展示了经典的空时权衡：投入更多内存（用于直接访问的“计算网格”和可能更大的优先级队列结构）可以显著减少查找和操作所需的CPU周期，从而带来整体性能的提升。这一分析强调，性能优化很少是一蹴而就的。它通常是一个整体过程，其中一个领域的改进（例如，数据结构效率降低CPU周期）可能需要在另一个领域进行权衡（例如，增加内存使用）。深入理解所选编程语言（本例中为C\#）如何管理内存（堆与栈、垃圾回收）与理解算法复杂度同样重要。开发人员必须仔细分析其应用程序的具体限制（例如，嵌入式设备上的内存限制与游戏PC上充足的RAM）以做出明智的架构决策。 + +### **优化格局** + +* 速度与内存 + 这是一个反复出现的主题。实现更高的速度通常需要使用更多的内存，例如通过预计算数据结构、更大的查找表或更复杂的优先级队列数据结构。CodeProject的优化就明确指出了其内存开销 1。 +* 路径质量与速度 + 激进的启发式算法、简化假设（例如，仅使用整数成本）或某些算法捷径可以加速寻路，但可能导致路径并非真正最优（最短或成本最低）。CodeProject实现中的“重新开放关闭节点”设置就是一个很好的例子：启用它会产生“更好、更平滑的路径”，但“会花费更多时间”。开发人员必须决定严格的最优性是否比实时响应性更优先1, 7。 +* 实现复杂性 + 高度优化的算法，特别是那些采用巧妙位运算、自定义数据结构或复杂内存管理的算法，在实现、调试和维护方面固有地比简单、教科书式的版本更复杂。这需要在开发工作量和运行时性能之间进行权衡 1。 + +## **IV. C\# A\*核心优化策略** + +### **提升效率的高级数据结构** + +* **优先级队列** + * 基石 + 高效的优先级队列可以说是A\*性能最关键的组成部分。它管理着“开放列表”，确保始终首先检索到$f(n)$值最低（估计总成本）的节点进行扩展。这个操作，即Dequeue（或extract-min），以及Enqueue（插入新节点）和可能的Decrease-Key（更新节点优先级），在算法执行过程中会重复进行 7。 + * **优化实现** + * 二叉堆 (MinHeap) + 这是A\*优先级队列最常见且广泛推荐的数据结构。它为Enqueue（插入）和Dequeue（提取最小元素）操作提供了对数时间复杂度（O(logN)），其中N是堆中的元素数量。这使其比简单的基于List的方法性能显著提高 3。 + BlueRaja/High-Speed-Priority-Queue-for-C-Sharp库是专为C\#寻路优化的二叉堆的典型示例，强调速度和低开销 4。 + roy-t/AStar库也明确利用了MinHeap来实现其高性能 3。 + * 斐波那契堆 + 虽然理论上为decrease-key操作提供了卓越的渐近复杂度（$O(1)$摊还），但斐波那契堆通常具有更高的常数因子，并且实现起来更复杂。在实践中，对于大多数A\*场景，二叉堆由于结构更简单且缓存性能更好，通常会优于斐波那那契堆 5。 + * SortedSetPriorityQueue (红黑树) + 使用System.Collections.Generic.SortedSet（通常实现为红黑树）可以为插入、decrease-key和提取最小元素操作提供$O(\\log V)$的复杂度。虽然这是一个可行的选择，但自定义的二叉堆实现通常针对寻路特定需求进行了优化，并能提供更好的实际性能 5。 +* **基于哈希的集合** + * Dictionary 或 Hashtable 用于 cameFrom 和 costSoFar + 这些集合对于存储和高效检索路径信息和累积成本至关重要。它们为插入、查找和更新操作提供了平均$O(1)$的时间复杂度，考虑到A\*中频繁的访问模式，这一点至关重要。CodeProject文章特别指出，通过将关闭列表从ArrayList替换为Hashtable，性能得到了提升 1。 + * Equals 和 GetHashCode 的重要性 + 对于用作Dictionary或HashSet中键的自定义Location或Node结构体/类，正确重写Equals和GetHashCode方法至关重要。如果没有正确的实现，哈希冲突会使平均$O(1)$的性能降级为$O(N)$，并且Dictionary查找可能无法找到等效的节点 7。 + +表1：A\*优先级队列实现比较分析 + +| 优先级队列类型 | Enqueue 复杂度 | Dequeue 复杂度 | Decrease-Key 复杂度 | A\*实际性能 | 内存开销 | C\#实现注意事项 | +| :---- | :---- | :---- | :---- | :---- | :---- | :---- | +| 无序列表 | O(1) | O(N) | O(N) | 差 | 低 | 简单但慢，不推荐 | +| 有序列表 | O(N) | O(1) | O(N) | 较差 | 低 | 插入慢，不推荐 | +| 二叉堆 (MinHeap) | O(logN) | O(logN) | O(logN) | 优秀 | 中等 | 常见，BlueRaja/High-Speed-Priority-Queue-for-C-Sharp，.NET内置PriorityQueue\<\> | +| 斐波那契堆 | O(1) | O(logN) | O(1) (摊还) | 良好 (高常数) | 高 | 理论最优，但实现复杂，实际常数高 | +| 红黑树 (SortedSet) | O(logN) | O(logN) | O(logN) | 良好 | 中等 | System.Collections.Generic.SortedSet | + +上述表格基于5中对各种优先级队列实现的渐近复杂度分析，这些分析直接适用于A\*算法。以表格形式呈现这些信息，可以清晰、简洁地比较每种实现的理论性能特征，并解释为何二叉堆（或 + +MinHeap）通常是A\*最实用和高效的选择。它还突出了所涉及的权衡，例如，斐波那契堆理论上更优的decrease-key复杂度可能由于常数因子较高而无法转化为更好的实际性能。此表格可作为选择合适优先级队列的宝贵决策工具。 + +### **内存与对象管理** + +* **节点的值类型（struct）** + * 减少垃圾回收开销 + 在C\#中，class实例是分配在托管堆上的引用类型，受垃圾回收的影响。而struct是值类型，通常分配在栈上或内联在其他数据结构中（例如数组、其他结构体）。通过将节点表示定义为struct而不是class，可以显著减少频繁堆分配和随后的垃圾回收周期所带来的开销。这对于A\*中频繁创建和处理大量节点的性能关键循环来说，是一项至关重要的优化 1。 + * 改善缓存局部性 + 当struct连续存储在内存中（例如在数组中）时，它们受益于更好的CPU缓存利用率。访问已在缓存中的数据比从主内存中获取数据快得多，从而带来整体性能提升。 +* **优化节点结构** + * 最小化大小 + 除了使用struct之外，最小化每个节点struct的实际内存占用也至关重要，特别是对于可能隐式或显式表示数百万个节点的大型网格。CodeProject文章通过将节点结构大小从32字节优化到仅13字节来证明了这一点。这是通过删除冗余数据（例如，通过数组索引而不是在节点内显式存储坐标）和使用更紧凑的数据类型（例如，对于父节点链接使用ushort而不是int，假设坐标在ushort范围内）实现的 1。 + +CodeProject文章 1 明确指出通过将节点改为 + +struct来“减少垃圾回收开销”，这突出了C\#等托管语言中一个关键但经常被忽视的性能方面。在典型的A\*实现中，可能会实例化和丢弃大量的Node对象。如果这些是class实例，则每次分配都会增加垃圾回收器的压力。当GC运行时，它可能会引入不可预测的暂停（即使很短暂），这对实时应用程序有害。通过使用struct，节点被分配在栈上（对于局部变量）或直接嵌入到包含结构中（如数组或其他结构体），从而避免了单独的堆分配，从而显著降低了GC周期的频率和持续时间。这是一种微妙但深刻的优化，直接影响寻路算法的响应能力和可预测性。这一分析扩展到C\#性能调优的一般原则：在性能关键的代码路径中最小化堆分配。这可能涉及使用struct、为频繁创建的对象实现对象池，或利用更新的.NET功能（如Span\）进行直接内存操作，所有这些都旨在减少GC压力并提高缓存局部性。 + +### **网格与地图表示增强** + +* **用于$O(1)$访问的计算网格** + * 消除列表搜索 + 对于基于网格的寻路，CodeProject文章中识别出的最重要优化是引入了“计算网格”。它不再维护一个需要查找操作的单独的“关闭列表”（例如，Hashtable），而是使用一个二维数组（PathFinderNode\[,\]）或一个线性一维数组（PathFinderNode）来直接存储每个网格单元格的状态。这允许通过使用其 (X, Y) 坐标作为索引，以O(1)（常数时间）访问任何节点的状态或成本信息。这完全消除了对单独的“关闭列表”查找的需求，并简化了“开放列表”的作用，使其仅管理待处理的节点 1。 +* **线性数组转换** + * 简化坐标访问 + 为了进一步增强计算网格，作者将固定的二维数组（PathFinderNode\[,\]）转换为线性（一维）数组（PathFinderNode）。这简化了坐标转换（例如，index \= y \* width \+ x），并且与C\#中的原生二维数组索引相比，有时可以带来更高效的CPU内存访问模式 1。 +* **2的幂次方网格尺寸** + * 利用位运算 + 一个非常巧妙的优化是限制网格的宽度和高度为2的幂次方（例如，64x64、128x128、1024x1024）。这允许使用位运算（例如，(y \<\< log2\_width) \+ x）而不是计算成本更高的乘法和除法运算来进行坐标转换（例如，将二维(x, y)转换为一维index）。位运算在CPU级别通常快得多 1。 + +“计算网格”、“线性数组转换”和“2的幂次方网格尺寸”的结合 1 展示了对网格问题优化深刻的理解。通过将二维坐标映射到一维数组，算法本质上实现了一种高效的空间哈希形式。当与2的幂次方约束结合时，坐标查找和转换可以使用闪电般的位运算来执行，而不是较慢的算术运算。这将通常为 + +O(logN)（对于基于哈希的集合）或O(N)（对于基于列表的）查找转换为直接的$O(1)$内存访问。这是访问模式的根本性转变，带来了巨大的性能提升，特别是对于大型网格。这种方法虽然特定于基于网格的寻路，但说明了高性能计算中的一个更广泛的原则：理解底层内存布局、CPU架构以及利用底层操作（如位移）可以解锁超越通用数据结构所能提供的性能增益。对于具有固定、规则结构的问题，直接数组访问和位运算技巧通常优于更抽象或通用的数据结构。 + +### **算法改进** + +* **“忽略旧节点”策略** + * 避免昂贵的移除操作 + 在A\*中，可能会找到一条通往已添加到“开放列表”（优先级队列）中的节点的更短路径。一种天真的方法是搜索并移除优先级队列中旧的、成本更高的条目，这可能是一个昂贵的$O(N)或O(\\log N)$操作，具体取决于优先级队列的实现。“忽略旧节点”优化避免了这种情况。相反，旧的、成本更高的条目只是留在优先级队列中。当这个旧节点最终出队时，通过检查“计算网格”中的costSoFar或“关闭”状态，会检测到已经处理了通往它的更好路径，并且旧节点会被简单地忽略。这显著简化了优先级队列的操作，使其仅限于Enqueue和Dequeue，避免了对现有元素进行昂贵的移除或“减少键”操作 1。 +* **优化网格清理** + * 递增状态值 + 对于需要频繁调用寻路的应用（例如在游戏循环中），将整个网格的“开放”或“关闭”状态重置为默认值（例如零）可能是一个耗时的$O(N)$操作。CodeProject实现引入了一个巧妙的优化：它不是物理上清除计算网格，而是在每次新搜索时递增“开放”和“关闭”状态值（或使用唯一的搜索ID）。如果节点的当前状态值低于当前搜索的唯一标识符，则其在先前搜索中的状态值在当前搜索中被视为“未研究”。这避免了完全的内存重新初始化，大大减少了寻路调用之间的开销 1。 +* **启发式函数调优** + * 对速度和路径质量的影响 + 启发式函数（h(n)）的选择和实现深刻影响A\*搜索的速度和结果路径的质量（最优性）。更准确（但仍可接受且一致）的启发式函数可以更直接地引导搜索到目标，探索更少的节点，从而加快计算速度。然而，过于复杂的启发式函数本身可能成为计算瓶颈 1。 + * “破局”机制 + 当A\*遇到多个具有相同计算$f(n)$成本的路径时，可以应用“破局”启发式。这个额外因素有助于算法做出“最佳猜测”，以继续朝着有希望的方向搜索，通常会产生更平滑、更“自然”的路径，并防止算法不必要地探索同样“好”但最终不那么直接的替代方案 1。 +* **成本精度** + * 整数与浮点成本 + CodeProject作者对成本计算精度进行了实验，发现使用int进行成本和总成本计算（有效地丢弃小数）会使算法在使用浮点数时“慢约10倍”，而对于复杂地图，路径质量没有显著改善。浮点运算在某些架构上可能比整数运算慢，并且微妙的精度差异可能导致算法更频繁地重新评估节点。这说明了牺牲一些精度可以带来显著性能提升的权衡 1。 +* **移动限制** + * 对角线 + 启用或禁用对角线移动（8个方向与4个方向）会影响搜索空间和路径外观 1。 + * 重对角线 + 如果允许对角线移动，增加其成本（“重对角线”）可以阻止其使用，从而导致路径更趋向于正交 1。 + * 惩罚转向 + 每次算法改变方向时增加少量成本，会导致路径更平滑、更“自然”，因为会惩罚过多的转向。这可能会增加计算时间，但会改善路径美观度 1。 +* **重新开放关闭节点** + * 最优性与速度 + 标准A\*实现可能不会重新开放已移至“关闭列表”的节点。然而，如果发现通往“关闭”节点的新的、成本更低的路径，允许算法“重新开放”并重新评估该节点可以导致真正最优且更平滑的路径。这会增加计算时间，因为算法可能会多次访问和处理节点。对于实时应用程序，可能更倾向于稍微次优但更快的路径 1。 + +“忽略旧节点”和“优化网格清理”技术 1 是算法巧妙性的典范，它超越了仅仅选择高效数据结构。 “忽略旧节点”通过利用A\*最终会找到节点最低成本路径的事实，避免了优先级队列中昂贵的移除操作。这推迟并有效地消除了昂贵的列表操作。“优化网格清理”是一种巧妙的技巧，可以避免在连续寻路调用之间进行$O(N)$的内存重置，这在动态或频繁查询的场景中可能是一个显著的开销。它不是将内存清零，而是使用唯一的搜索ID或递增状态值，从而利用现有的内存状态。这些优化展示了对算法迭代性质、内存访问模式和C\#运行时的深刻理解，寻找在微观层面减少冗余工作和昂贵操作的方法。这些技术表明，真正的性能优化通常需要多层方法。虽然数据结构提供了基础效率，但显著的收益也可以来自高度专业的算法调整，这些调整利用了问题和执行环境的特定特征。这通常涉及权衡：为了实际的、特定领域的速度而牺牲一些理论上的纯粹性或通用性。 + +### **预计算与缓存** + +* 预计算成本 + 对于图结构和边成本不经常变化的静态或半静态地图，预计算某些值可以显著减少运行时计算。例如，roy-t/AStar库明确指出，“大多数计算（如边成本）在构建图时就已预计算”，这在实际路径搜索时节省了时间。这会将计算负载从运行时转移到初始化阶段 3。 + +## **V. GitHub上领先的C\# A\*实现** + +### **roy-t/AStar** + +* 项目概述 + 该项目位于github.com/roy-t/AStar，被描述为C\#中“基于A\*算法的快速2D寻路库”。它支持任何面向.NET Standard 2.0或更高版本的.NET变体，确保了广泛的兼容性。一个关键的设计理念是它不依赖外部依赖项，使其轻量且易于集成。该库采用MIT许可证，鼓励开放使用 3。 +* **关键优化** + * MinHeap用于优先级队列 + 该库明确指出其优先级队列使用了MinHeap数据结构。这是高性能A\*的基础选择，为添加和提取元素提供了高效的$O(\\log N)$操作 3。 + * 预计算成本 + 一个显著的优化是“大多数计算（如边成本）在构建图时就已预计算”。这会将计算工作从关键的寻路循环转移到图初始化阶段，从而缩短搜索时间 3。 + * 图优先表示 + 尽管它提供了方便的网格类（Grids.CreateGridWithLateralConnections、Grids.CreateGridWithDiagonalConnections），但该库内部使用图进行所有底层寻路。这种抽象允许灵活地建模各种移动模式（例如，网格上的车、象或后棋移动），同时利用优化的图遍历算法 3。 +* 性能基准 + 该存储库声称具有令人印象深刻的性能，指出“即使对于包含10,000个节点和40,000条边的大型图，该算法也能在10毫秒内找到路径”。这一定量声明突显了其对速度的关注以及其优化的有效性 3。 +* 可用性与特性 + 该库旨在通过网格类抽象图的细节，从而易于使用。它支持定义遍历速度，允许加权路径，而不仅仅是简单的最短距离。它还提供了模仿防止切角等行为的选项，这是旧寻路器中的常见功能 3。 + +### **BlueRaja/High-Speed-Priority-Queue-for-C-Sharp** + +* 作为基础组件的作用 + BlueRaja/High-Speed-Priority-Queue-for-C-Sharp GitHub存储库包含一个针对寻路应用优化的C\#优先级队列 4。高效的优先级队列对于A\*算法的性能至关重要。A\*的效率在很大程度上取决于其管理“开放列表”的能力，该列表需要快速地插入新节点、更新现有节点的优先级以及提取具有最低成本的节点。如果优先级队列操作效率低下，即使A\*算法的核心逻辑再优化，整体性能也会受到严重限制。因此，一个高性能的优先级队列是构建任何快速A\*实现的基础。 +* 实现细节 + 该项目提供了一个高度优化的优先级队列实现，具有以下关键特性： + * 速度 + 它被描述为比其他C\#优先级队列更快，特别适用于寻路场景 4。 + * 易用性 + 该库易于使用，简化了开发人员的集成过程 6。 + * 无外部依赖 + 它不依赖于第三方库，这降低了项目的复杂性并简化了部署 6。 + * 许可 + 该软件在MIT许可下，可免费用于个人和商业用途 6。 + * LINQ支持 + 它实现了IEnumerable\接口，提供了对LINQ的支持，使得数据查询和操作更加便捷 6。 + * 单元测试 + 该实现经过了全面的单元测试，确保了其可靠性和正确性 6。 + * 稳定优先级队列 + 它具有稳定的优先级队列实现，这意味着具有相同优先级的项目将按照它们入队的顺序出队，这在某些应用中可能很重要 6。 + * 性能增强 + 在.NET 4.5下编译时，它利用了新的强制内联支持，以实现更快的速度 6。 + * 分发 + 该项目已发布到NuGet，便于集成到其他项目中 6。 + * 兼容性 + 它应适用于.NET 2.0及更高版本 6。 + * 实现 + 该项目包含两种优先级队列实现：一种用于最大速度（无线程安全和安全检查），另一种更易于使用且更安全 6。 + * 语言 + 该项目完全用C\#编写 6。 +* 对性能的影响 + 该优先级队列对A\*算法的整体性能贡献巨大。通过提供高效的入队、出队和优先级更新操作，它显著减少了A\*算法核心循环中的时间消耗。例如，如果一个A\*算法需要处理数百万个节点，那么每次操作从$O(N)降到O(\\log N)$所带来的性能提升是指数级的。这种基础组件的优化，使得上层A\*算法能够充分发挥其启发式搜索的优势，从而在大型复杂环境中实现毫秒级的路径查找。 + +### **CodeProject的“Fast PathFinder” (CastorTiu的实现)** + +* 历史意义与影响 + CodeProject文章“A\* algorithm implementation in C\#” 1 详细介绍了CastorTiu的A\*算法实现及其优化。该实现因其在性能方面的开创性工作而具有重要的历史意义。作者最初因找不到满足其项目特定需求的C\# A\*版本而开发此实现，旨在提供一个高性能且可重用的资源。该项目附带一个前端应用程序，允许用户试验各种参数并分析算法行为，这对于理解和调优A\*算法非常有价值 1。 +* 量化性能增益 + 作者对标准A\*算法的性能感到沮丧，尤其是在大型网格上。主要瓶颈在于搜索开放和关闭节点列表所花费的时间。为了解决这个问题，作者进行了一系列关键优化，最终实现了惊人的性能提升：与标准算法相比，速度提高了300到1500倍。例如，一个标准算法需要131秒才能解决的地图，使用优化版本只需100毫秒。然而，这种显著的速度提升并非没有代价，优化版本对于1024x1024的网格需要额外约13MB的内存 1。 +* 架构经验 + CastorTiu的实现引入了多项创新，这些创新对于现代高性能A\*实现仍然具有重要意义： + * 数据结构优化 + 将开放列表从标准的ArrayList或List替换为优先级队列，以提高节点检索时间。关闭列表则替换为Hashtable，以实现更快的查找 1。 + * 使用结构体 + 将节点从类切换为结构体，以减少垃圾回收开销，提高内存效率 1。 + * 计算网格 + 最显著的优化是使用第二个“计算网格”来存储节点，从而允许通过其 (X, Y) 坐标进行$O(1)$访问。这消除了对关闭列表的需求，并简化了开放列表的作用，使其仅限于推送和弹出成本最低的节点 1。 + * 内存减少 + 节点结构经过优化，通过删除冗余坐标数据、启发式值以及使用ushort而不是int作为父节点链接，将其大小从32字节减少到13字节 1。 + * 线性数组 + 计算网格从固定二维数组（PathFinderNode\[,\]）更改为线性数组（PathFinderNode），以简化坐标访问并消除来回转换 1。 + * 2的幂次方网格 + 添加了一个约束，即网格宽度和高度必须是2的幂次方，从而可以使用更快的位运算（移位和逻辑运算）代替数学运算进行坐标转换 1。 + * 忽略旧节点 + 当发现通往已在开放列表中的节点的新的、成本更低的路径时，作者决定将旧节点留在列表中，而不是移除或替换它。旧节点将具有更高的成本，并在稍后处理时，由于已被标记为关闭而直接忽略。这比在列表中执行移除操作快得多 1。 + * 优化网格清理 + 为了避免在寻路调用之间耗时的计算网格清理过程，作者实现了一个系统，其中“开放”和“关闭”状态值在每次新搜索时递增2。这意味着先前搜索的节点状态在当前搜索中被有效地视为“未研究”，而无需重置 1。 + * 变量作用域 + 局部变量被提升为成员变量，以在堆上一次性创建，避免在栈上重复创建和销毁 1。 + * 成本计算 + 作者选择使用int进行成本和总成本计算，舍弃小数。因为虽然浮点数提供了更多细节，但它们导致算法更频繁地重新评估节点，使其速度慢约10倍，而对于复杂地图，路径质量没有显著改善 1。 + +### **其他相关的C\# A\*项目（简要提及）** + +除了上述重点项目外，GitHub上还有其他值得关注的C\# A\*寻路实现，它们针对特定用例或提供了不同的功能集： + +* TheCyaniteProject/PathFinder3D + 该项目专注于3D A\*寻路，其特点是不需要烘焙导航网格，并且可以与动态创建的地形（如MapMagic或其他）一起使用。这对于需要实时适应变化环境的3D游戏或模拟非常有用 10。 +* kbrizov/Pathfinding-Algorithms + 这是一个更通用的存储库，其中包含各种寻路算法的实现，包括A\*。虽然可能没有像roy-t/AStar那样专门针对A\*进行极致优化，但它为学习和比较不同算法提供了有用的资源 11。 +* hugoscurti/hierarchical-pathfinding + 该项目实现了Unity中的近最优分层寻路（HPA\*）算法，并使用《龙腾世纪：起源》的地图进行测试。HPA\*是一种高级技术，通过在不同抽象级别上规划路径来提高大型地图的寻路性能，适用于需要在大规模环境中进行高效导航的场景 10。 + +表2：选定C\# A\*实现的功能与优化比较 + +| 项目名称 | 主要关注点 | 关键优化技术 | 性能特性 | 内存权衡 | 环境类型 | 许可证 | +| :---- | :---- | :---- | :---- | :---- | :---- | :---- | +| roy-t/AStar | 2D网格和图寻路 | MinHeap、预计算成本、图优先表示 | 10,000节点/40,000边在10ms内 | 低 | 静态 | MIT | +| BlueRaja/High-Speed-Priority-Queue-for-C-Sharp | 高性能优先级队列 | 二叉堆、强制内联、无外部依赖 | 极快，降低GC开销 | 低 | 通用 | MIT | +| CodeProject "Fast PathFinder" | 高速网格寻路 | 计算网格、线性数组、2的幂次方网格、忽略旧节点、结构体、整数成本 | 300-1500x加速，13MB额外内存 | 高 | 静态 | 自定义 | +| TheCyaniteProject/PathFinder3D | 3D动态地形寻路 | 无需烘焙导航网格 | 实时动态 | 未指定 | 动态 | 未指定 | +| kbrizov/Pathfinding-Algorithms | 通用寻路算法 | 未指定 | 学习/比较 | 未指定 | 未指定 | 未指定 | +| hugoscurti/hierarchical-pathfinding | 分层寻路 (HPA\*) | HPA\*算法 | 大型地图高效寻路 | 未指定 | 静态 | 未指定 | + +此表格总结了上述C\# A\*项目的主要特点、优化策略和性能概览，为开发人员在选择适合其特定需求的实现时提供了快速参考。 + +## **VI. 动态与复杂环境下的A\*变体** + +### **标准A\*在动态环境中的局限性** + +标准A\*算法主要设计用于静态或已知环境。它在搜索开始时假定所有障碍物、成本和图结构都是已知的且不会改变。当环境发生变化时（例如，出现新的障碍物、现有障碍物移动或成本发生变化），标准A\*算法无法有效适应。它需要重新从头开始计算整个路径，这在动态或未知环境中效率极低，尤其是在需要频繁重新规划路径的场景中。在多智能体系统中，A\*在低密度情况下表现良好，但在高拥堵水平下，特定起始位置可能会出现问题，导致算法卡住并失败，这凸显了其在动态环境中的局限性。 + +### **D\*与D\* Lite简介** + +为了解决标准A\*在动态环境中的局限性，开发了D\*算法及其变体，如D\* Lite（动态A\*）。D\*算法是一种寻路算法，用于机器人和自主系统在未知或动态环境中导航。它旨在处理环境变化并相应地重新规划路径，使其成为环境未知或不断变化的应用程序的流行选择。 + +D\*算法是A\*算法的扩展，它结合了前向和后向搜索，以高效地重新规划路径。它通过维护一个待处理节点的优先级队列来工作，并迭代处理队列中的节点，在必要时更新成本并重新规划路径。当环境发生变化时，D\*算法通过更新受影响节点的成本来重新规划路径。 + +D\*及其变体已被广泛用于自主机器人，包括火星探测器“机遇号”和“勇气号”。Field D\*是D\*的一种基于插值的变体，它将节点定义在网格的角点上，并使用线性插值使路径点可以位于网格边的任何位置。这样，它可以在非均匀环境中生成直接、低成本和平滑的路径，解决了传统网格寻路算法将机器人运动限制在少数几个离散方向（例如，0、45、90度）的问题，从而产生非自然、次优的路径。 + +D\* Lite是D\*算法的简化版本，更高效且易于实现。它在自主车辆和机器人领域得到了应用。与A\*不同，D\* Lite在动态环境中表现出卓越的适应性，通过实时重新计算路线，在所有测试场景中都成功完成任务而没有失败，这表明它适用于需要对环境变化有高成功率的应用。 + +### **C\# D\* Lite实现** + +在GitHub上，可以找到D\* Lite的C\#实现，例如Bastiantheone/DStarLite \[7。该项目提供了D\* Lite算法的C\#实现，可用于在机器人探索地图时将其导航到目标坐标。该实现假定地图可以表示为具有可导航和不可导航地形的网格。默认情况下，机器人可以向前、向后和侧向移动，但不能对角线移动。不过，通过简单的代码修改，可以允许对角线移动或为不同移动添加不同成本 \[7。 + +该实现要求创建一个继承自DStarLiteEnvironment接口的类，该类负责环境与算法之间的交互，包含MoveTo和GetObjectsInVision两个方法。例如，TestProgram.cs中提供了如何使用该实现的示例 \[7。 + +### **选择正确的算法** + +选择合适的寻路算法取决于应用程序的具体需求和环境特性： + +* 静态与已知环境 + 如果环境是静态的且所有信息在搜索开始时都已知，那么A\*算法通常是最佳选择。它能够找到最优路径，并且通过本报告中讨论的各种优化，可以实现极高的性能。 +* 动态与未知环境 + 如果环境是动态的，或者信息是逐步发现的（例如，机器人探索未知地形），那么D\*或D\* Lite等动态寻路算法是更合适的选择。这些算法能够高效地重新规划路径，而无需每次环境变化都从头开始计算。D\* Lite因其简化和高效的特性，在需要快速适应环境变化的机器人和自主系统应用中特别受欢迎。 +* 路径平滑度 + 对于需要更自然、平滑路径的应用（例如，自动驾驶），Field D\*等基于插值的D\*变体可能更优，因为它们允许路径点位于网格边上的任意位置，从而生成更平滑的轨迹。 + +## **VII. 实际应用与未来展望** + +### **选择最优实现** + +选择最优的A\*实现需要根据项目的具体需求进行权衡。没有一个“一刀切”的解决方案，因为不同的优化策略会带来不同的性能特性和资源消耗。 + +* 网格尺寸与复杂度 + 对于小型或中型网格，即使是标准A\*实现（例如Red Blob Games的基线版本），在经过优先级队列优化后也可能足够。但对于大型网格（例如1024x1024或更大），CodeProject的“Fast PathFinder”所展示的计算网格、线性数组和2的幂次方网格尺寸等优化变得至关重要，因为它们提供了$O(1)$的节点访问速度，显著减少了查找时间 1。 +* 环境动态性 + 如果环境是完全静态的，A\*是理想选择。如果环境会发生变化，但变化不频繁，或者可以接受短暂的路径重新计算延迟，那么一个高度优化的A\*实现仍然可行。然而，对于环境持续变化或信息逐步发现的场景（例如机器人导航），D\*或D\* Lite等动态寻路算法是更好的选择，因为它们能够高效地进行路径重新规划。 +* 内存约束 + 一些高性能优化（例如CodeProject的“Fast PathFinder”中的计算网格）会增加内存消耗。在内存受限的环境（例如嵌入式系统或移动设备）中，可能需要权衡速度以减少内存占用。在这种情况下，选择内存效率更高的优先级队列（例如某些二叉堆实现）和紧凑的节点结构变得更为重要 1。 +* 路径质量要求 + 如果路径必须是严格最优的（最短或最低成本），则需要确保启发式函数是可接受且一致的，并且可能需要启用“重新开放关闭节点”等功能，即使这会增加计算时间 1。如果可以接受轻微次优但计算速度更快的路径，则可以调整启发式或禁用某些功能以提高性能。 +* 开发与维护成本 + 高度优化的算法通常更复杂，开发和维护成本更高。选择一个成熟且文档完善的开源库（如roy-t/AStar）可以显著降低开发负担，同时仍能获得高性能 3。 + +### **基准测试您的解决方案** + +在任何性能关键型应用程序中，对寻路解决方案进行严格的基准测试至关重要。仅凭理论分析或通用基准测试结果不足以保证在特定应用场景下的性能。 + +* 使用BenchmarkDotNet + C\#生态系统提供了强大的基准测试工具，如BenchmarkDotNet。该工具允许开发人员精确测量代码的执行时间、内存分配和CPU使用情况。它能够揭示隐藏的内存成本，例如接口调用、Lambda表达式、值类型装箱以及其他看似无害的代码所导致的堆分配 2。通过 + BenchmarkDotNet，开发人员可以： + * **量化优化效果**：精确测量特定优化（例如，切换优先级队列、使用结构体）对性能的影响。 + * **识别新的瓶颈**：当一个瓶颈被消除后，BenchmarkDotNet可以帮助识别下一个性能瓶颈。 + * **防止性能回归**：在持续集成/持续部署 (CI/CD) 流程中集成基准测试，可以防止未来的代码更改无意中引入性能下降。 + +### **调试与可视化** + +理解算法行为和识别性能问题需要有效的调试和可视化工具。 + +* 实时进度显示 + CodeProject的“Fast PathFinder”提供了一个前端应用程序，可以实时显示算法的运行过程，包括节点如何被开放和关闭 1。这种可视化对于理解算法的探索模式和识别低效区域非常有价值。 +* 路径可视化 + Red Blob Games的实现包含DrawGrid静态方法，用于可视化cameFrom数组，显示墙壁和路径方向 7。这种功能对于验证路径的正确性和直观地理解算法的输出至关重要。 +* 内存分析器 + 使用C\#的内存分析器（例如Visual Studio内置的分析器或JetBrains dotMemory）可以帮助识别和解决内存泄漏、过度分配和垃圾回收压力问题。这与使用结构体和优化节点结构等内存管理策略相辅相成。 + +### **寻路算法的新兴趋势** + +寻路领域仍在不断发展，新的研究和技术不断涌现： + +* 多智能体寻路 (MAPF) + 在许多真实世界场景中，多个智能体需要同时找到路径并避免相互碰撞。MAPF算法旨在解决这一复杂问题，例如基于冲突搜索 (CBS) 的方法。 +* 连续空间寻路 + 传统的A\*通常在离散网格上操作。然而，对于机器人和自动驾驶车辆，在连续空间中进行寻路以生成更平滑、更自然的轨迹变得越来越重要。Field D\*就是其中一种尝试解决此问题的算法。 +* 深度学习与强化学习 + 人工智能领域的最新进展正在影响寻路。深度学习模型可以学习复杂的环境表示，而强化学习可以训练智能体在动态环境中找到最优策略，尽管这些方法通常需要大量数据和计算资源。 +* 分层寻路 + 对于超大型地图，分层寻路算法（如HPA\*）通过在不同抽象级别上规划路径来提高效率。首先在高层规划粗略路径，然后在局部细化路径，从而显著减少搜索空间 10。 + +## **VIII. 结论** + +在C\#中实现高性能A\*寻路算法是一个多方面且细致的工程挑战。它超越了对算法基本原理的理解，深入到数据结构选择、内存管理和算法微调的复杂性。 + +本报告的分析表明，A\*性能优化的核心在于**高效的优先级队列**。像二叉堆这样的数据结构，其对数时间复杂度的操作，是实现快速节点插入和提取的基础，从而显著优于简单的基于列表的实现 3。 + +BlueRaja/High-Speed-Priority-Queue-for-C-Sharp等专门优化的优先级队列库，为任何A\*实现提供了关键的性能支撑 6。 + +其次，**精细的内存管理**至关重要。将节点表示为struct而非class，可以显著减少垃圾回收开销并改善CPU缓存局部性 1。CodeProject的“Fast PathFinder”所展示的节点结构紧凑化，将节点大小从32字节缩减到13字节，进一步体现了内存优化的重要性 1。 + +第三，对于网格环境，**创新的网格表示和访问模式**带来了巨大的性能飞跃。引入“计算网格”以实现$O(1)$的节点访问，结合线性数组和2的幂次方网格尺寸以利用位运算进行坐标转换，这些技术共同将寻路速度提高了数百甚至上千倍 1。 + +最后，**巧妙的算法改进**，如“忽略旧节点”策略（避免昂贵的优先级队列移除操作）和“优化网格清理”（避免在连续搜索之间进行耗时的内存重置），展示了对算法行为和C\#运行时环境的深刻理解如何转化为显著的性能提升 1。 + +**最终建议：** + +1. **优先级队列为王**：始终使用高性能的优先级队列实现（如二叉堆），而不是C\#中简单的List或SortedList。 +2. **拥抱值类型**：在可能的情况下，将A\*节点定义为struct，以减少堆分配和垃圾回收压力，从而提高实时应用的响应能力。 +3. **网格优化**：对于基于网格的寻路，考虑实现一个直接的“计算网格”以实现$O(1)$访问，并探索线性数组和2的幂次方网格尺寸以利用位运算。 +4. **精细调整**：根据项目需求仔细选择和调整启发式函数、成本精度、移动规则和“重新开放关闭节点”等参数，以在路径最优性、计算速度和内存消耗之间找到最佳平衡。 +5. **环境决定算法**：在动态或未知环境中，标准A\*的局限性显而易见。在这种情况下，应优先考虑D\*或D\* Lite等动态寻路算法，它们能够高效地进行路径重新规划。 +6. **严格基准测试**：使用BenchmarkDotNet等工具对您的寻路解决方案进行系统性基准测试，以量化优化效果，识别隐藏的性能成本，并确保在目标环境中达到预期的性能水平。 + +通过采纳这些经过验证的优化策略并利用GitHub上可用的高性能C\#实现，开发人员可以构建出能够满足最严苛性能需求的A\*寻路系统，从而在游戏、机器人和各种AI应用中实现流畅、高效的导航。 + +#### **引用的著作** + +1. A\* algorithm implementation in C\# \- CodeProject, 访问时间为 八月 14, 2025， [https://www.codeproject.com/Articles/15307/A-algorithm-implementation-in-C-](https://www.codeproject.com/Articles/15307/A-algorithm-implementation-in-C-) +2. Is Your C\# Code Fast? Benchmarking to Find Hidden Costs \- YouTube, 访问时间为 八月 14, 2025， [https://www.youtube.com/watch?v=yIRBO7xQ43o](https://www.youtube.com/watch?v=yIRBO7xQ43o) +3. roy-t/AStar: A fast 2D path finding library based on the A ... \- GitHub, 访问时间为 八月 14, 2025， [https://github.com/roy-t/AStar](https://github.com/roy-t/AStar) +4. priority-queue · GitHub Topics, 访问时间为 八月 14, 2025， [https://github.com/topics/priority-queue](https://github.com/topics/priority-queue) +5. EliahKagan/Dijkstra: Visualizing Dijkstra's algorithm with various priority queues \- GitHub, 访问时间为 八月 14, 2025， [https://github.com/EliahKagan/Dijkstra](https://github.com/EliahKagan/Dijkstra) +6. BlueRaja/High-Speed-Priority-Queue-for-C-Sharp: A C ... \- GitHub, 访问时间为 八月 14, 2025， [https://github.com/BlueRaja/High-Speed-Priority-Queue-for-C-Sharp](https://github.com/BlueRaja/High-Speed-Priority-Queue-for-C-Sharp) +7. Implementation of A\* \- Red Blob Games, 访问时间为 八月 14, 2025， [https://www.redblobgames.com/pathfinding/a-star/implementation.html](https://www.redblobgames.com/pathfinding/a-star/implementation.html) +8. Mastering Pathfinding with A-Star: A Practical Guide and C\# Implementation \- Medium, 访问时间为 八月 14, 2025， [https://medium.com/@hanxuyang0826/mastering-pathfinding-with-a-star-a-practical-guide-and-c-implementation-f76f1643d8c3](https://medium.com/@hanxuyang0826/mastering-pathfinding-with-a-star-a-practical-guide-and-c-implementation-f76f1643d8c3) +9. A\* Pathfinding Data Structure \- Stack Overflow, 访问时间为 八月 14, 2025， [https://stackoverflow.com/questions/27832405/a-pathfinding-data-structure](https://stackoverflow.com/questions/27832405/a-pathfinding-data-structure) +10. astar-pathfinding · GitHub Topics · GitHub, 访问时间为 八月 14, 2025， [https://github.com/topics/astar-pathfinding](https://github.com/topics/astar-pathfinding) +11. a-star-path-finding · GitHub Topics, 访问时间为 八月 14, 2025， [https://github.com/topics/a-star-path-finding](https://github.com/topics/a-star-path-finding) +12. Pathfinding Algorithms in C\# \- CodeProject, 访问时间为 八月 14, 2025， [https://www.codeproject.com/Articles/1221034/Pathfinding-Algorithms-in-Csharp](https://www.codeproject.com/Articles/1221034/Pathfinding-Algorithms-in-Csharp) \ No newline at end of file diff --git a/doc/design/2026/Idea.md b/doc/design/2026/Idea.md index ec9eb3c..e5b0050 100644 --- a/doc/design/2026/Idea.md +++ b/doc/design/2026/Idea.md @@ -19,7 +19,7 @@ 2. 用停靠窗口做物流控件 ### **2.2\. 自动路径生成** -1. 用A*算法进行路径规划 +1. 用Field D*算法进行路径规划 ### **2.3\. 仿真动画** 1. 用变换实现物流物体的移动，同时进行碰撞检测 diff --git a/doc/design/2026/Navisworks 物流路径规划方案_.md b/doc/design/2026/Navisworks 物流路径规划方案_.md deleted file mode 100644 index c04681f..0000000 --- a/doc/design/2026/Navisworks 物流路径规划方案_.md +++ /dev/null @@ -1,687 +0,0 @@ - - -# **基于Navisworks 2026 API开发物流仿真插件和交互式导航控件的技术方案** - -## **执行摘要** - -本技术方案旨在为Navisworks 2026开发一款全面的插件和交互式导航控件，以满足大型建筑和制造项目中对高级物流规划和验证日益增长的需求。该解决方案将实现通道选择、路径规划、物流属性设置、碰撞检测和动画仿真等核心功能。本方案特别关注大型模型的性能优化和实用性，支持多种文件格式的导入导出，并确保与达索系统DELMIA平台的无缝集成。通过在BIM环境中实现先进的物流仿真，该方案旨在弥合设计协调与高级制造仿真之间的鸿沟，从而优化施工和运营工作流程。它将静态BIM模型转化为动态、可操作的仿真环境，支持资产的整个生命周期管理，从而实现主动问题解决、减少昂贵返工并提高从概念到运营的整体项目效率。 - -## **1\. 引言** - -### **1.1. 项目概述与目标** - -在当今复杂的大型建筑和制造项目中，对高级物流规划和验证的需求日益迫切。传统的BIM工具往往缺乏满足这些特定需求的能力，特别是在处理复杂的场地布局、精密的物料流以及最大程度减少现场冲突和延误方面。本项目旨在通过开发一款强大的Navisworks 2026插件和交互式导航控件来应对这些挑战，该插件专门用于解决物流仿真和验证需求。 - -该插件的核心功能将包括： - -* **通道选择：** 允许用户在模型中定义和选择特定的路径或区域。 -* **智能路径规划：** 促进设备和物料物流路线的创建、优化和修改。 -* **动态物流属性管理：** 将与物流相关的自定义数据（例如，物料类型、处理要求、交付计划）附加并管理到模型元素中。 -* **自动化碰撞检测：** 执行针对物流场景量身定制的高级碰撞测试，包括动态对象间碰撞和对象与静态元素碰撞。 -* **逼真动画仿真：** 在三维模型中可视化物流流和运动，以便进行视觉验证和利益相关者沟通。 - -除了这些核心功能之外，本方案还将重点关注关键的非功能性要求：处理超大型BIM模型时的性能可扩展性、支持多样化项目数据源的广泛文件格式兼容性，以及与达索系统DELMIA平台的无缝集成，以利用其先进的制造和机器人仿真能力。 - -将Navisworks（一种BIM协调工具）与DELMIA（一种数字制造和仿真平台）集成，体现了行业向更深层次数字连续性的战略性转变。这不仅仅是技术数据交换，更是为了建立一个贯穿BIM数据从设计和施工阶段到运营规划、制造乃至设施管理的连续数字主线。该插件在此过程中扮演着至关重要的桥梁角色，将静态BIM模型转化为动态、可操作的仿真环境，支持整个资产生命周期管理。这种集成促进了主动问题解决，减少了昂贵的返工，并提高了从概念到运营的整体项目效率。这种连接预示着对工业4.0原则的战略性推动，其中数据在以前孤立的领域（设计、施工、制造、运营）之间无缝流动。因此，该插件的作用从单纯的功能添加提升为跨领域数据流和分析的关键推动者，使得BIM数据能够被用于高级运营规划。这意味着解决方案不仅要解决技术集成挑战，还要考虑BIM元素与制造/物流实体之间的数据语义映射和上下文转换。这要求数据模型具有高度灵活性，并且可能需要可配置的映射规则，以确保数据在不同平台间的一致性和实用性，从而实现真正的集成生命周期管理方法。 - -### **1.2. Navisworks 2026 API概况及关键增强功能** - -本节将深入探讨Navisworks 2026 API，阐明其能力、结构以及与本插件开发相关的最新更新。 - -Navisworks提供了一个强大的.NET编程接口（API），允许开发人员编写自定义插件、自动化任务并将Navisworks控件嵌入到其他应用程序中 1。软件开发工具包（SDK）通常安装在 - -\\api\\文件夹下，并包含开发者指南和参考指南等重要文档 1。 - -Navisworks 2026在继承先前版本（如2024、2025）的基础上，引入了多项强大的增强功能 2。与本项目开发特别相关的API变更和改进包括： - -* **属性集（Property Sets）：** 这是对先前“常用属性（Property Favourites）”的重大改进，属性集现在允许用户同时打开最多四个属性面板，每个面板都可以配置不同的属性集。这一变化简化了自定义属性集的过滤和创建，使得管理和显示特定数据更加直观 3。这直接影响了“物流属性管理”的需求。 -* **碰撞检测器（Clash Detective）改进：** 碰撞检测器获得了实质性增强，包括改进的过滤和排序功能、新的“设置默认受让人（Set Default Assignee）”选项、“上次运行（Last Run）”列，以及在报告中包含“碰撞结果优先级（Clash result priority）”的能力。“测试类型（Test Type）”现在是一个独立的列，解放了“描述（Description）”列以供用户编辑备注。新按钮允许删除空碰撞组，并且“碰撞计数（Clash Count）”列显示组内的碰撞数量。分组功能现在直接嵌入到碰撞检测器表单中。此外，通过Navisworks协调问题插件创建问题时，碰撞和问题状态会同步 3。这些改进对于自动化碰撞检测和报告非常有利。 -* **外观分析器（Appearance Profiler）重新设计：** 外观分析器经过重新设计，新增了配置文件区域、用户友好的图标，以及更易于使用的“按属性（By Property）”选项卡，其中包含预填充的下拉列表。配置文件现在保存为XML文件，取代了旧的DAT文件格式，并支持导入现有DAT文件，这些文件将被转换为XML格式 3。 -* **测量面板（Measure Panel）更新：** 测量工具窗口已重新设计，采用更简单、更现代的用户界面，现在包含“保存测量（Save Measurement）”选项，允许用户将当前测量保存到“已保存测量（Saved Measurements）”对话框中 2。 -* **枢轴点锁定（Pivot Point Lock）：** 状态栏中新增了一个按钮，在使用导航工具时可以锁定和解锁枢轴点，从而实现更精确的导航 2。 -* **NWD导出选项：** 新增了NWD导出选项，例如排除隐藏项目 2。 -* **用户界面/可用性改进：** Navisworks中的许多对话框、表单和图标都得到了改进，包括改进的窗口停靠行为和可用性，以及改进的颜色选择器 2。主页上的“最近（Recent）”选项卡现在可以显示置顶文件，并且云图标指示非本地存储的文件 3。 -* **选择树（Selection Tree）增强：** 解决了选择树层次结构与SmartPlant 3D不匹配的问题，VUE文件属性在组和几何级别上正确显示，并且项目不再错误地溢出选择树底部 3。 -* **插件管理器（Plugin Manager）：** 主页上的“应用程序管理器（App Manager）”已被“插件管理器”取代，提供了启用和禁用插件、查找更新和安装位置的便捷访问 5。 -* **系统变量支持：** 在全局选项中支持系统变量，例如%temp%和%username%，用于项目目录、站点目录、自动保存位置和临时文件位置 5。 -* **Revit集成修复：** 解决了从Revit文件（RVT或NWC）打开时嵌套族显示在正确父族下、共享参数正确显示以及NWC文件中元素在Navisworks中列在错误类别下的问题 3。 -* **.NET Framework兼容性：** Navisworks 2024（以及隐含的2026）是基于.NET Framework 4.8构建的，这意味着使用.NET API的应用程序需要使用Visual Studio 2022及以上版本进行编译 10。在可能的情况下，鼓励从COM API迁移到.NET API 1。 -* **ApplicationControl.Initialize()的解决方法：** 对于.NET控件应用程序中Autodesk.Navisworks.Api.Controls.ApplicationControl.Initialize()可能抛出异常的问题，目前的解决方法是在调用该方法之前将Navisworks的安装目录添加到系统PATH环境变量中 10。 -* **NwCreate API：** 该API用于创建Navisworks模型（NWC文件），支持几何体、属性、文本、视点、选择集、材质、纹理和灯光的创建。它提供了C和C++ API，支持从基本面片三角形网格到B-rep实体的几何体创建，包括布尔运算（并集、减法、交集）、挤压和旋转等基本建模操作 1。 -* **事务（Transaction）类：**.NET API中的事务机制允许捆绑撤销信息和内部通知，这在某些情况下可以显著提高性能，因为Navisworks内部和GUI的许多部分会推迟更新 11。 -* **网格和标高API：** Navisworks API允许控制网格和标高的可见性、颜色、模式和特定显示级别，这对于探索场景和提供空间上下文非常有用 10。 - -Navisworks内部数据格式的演变，例如外观分析器从DAT文件到XML文件的转变 3，以及对属性集功能的强调 3，表明了Navisworks正朝着更开放、结构化和可扩展的数据格式发展。这不仅仅是用户界面的改变，更是基础性的转变，它促进了程序化访问、数据交换和定制化。这种演进与开放BIM和更好数据互操作性的更广泛行业趋势相契合，减少了供应商锁定，并支持更复杂的、数据驱动的工作流程。API的增强反映了Autodesk致力于支持复杂的自定义解决方案和与其他平台（如DELMIA）进行更深层次集成的决心，这对于本次项目至关重要。 - -## **2\. 插件架构与用户界面设计** - -### **2.1. 整体插件结构 (C\#.NET)** - -本Navisworks插件将采用C\#语言开发，并基于.NET Framework 4.8，这是Navisworks 2024及更高版本所支持的环境，需要使用Visual Studio 2022或更高版本进行编译 10。插件的核心将围绕Navisworks API提供的各种插件类型构建，以实现所需的功能和用户交互。 - -主要的插件类型包括： - -* **CommandHandlerPlugin：** 这种插件类型在Navisworks 2012中引入，允许开发人员创建具有多个命令的插件，并将它们组织到主产品Ribbon用户界面中的自定义选项卡中 14。它比基本的 - AddInPlugin提供了更复杂的控制。通过使用PluginAttribute、StringsAttribute、RibbonLayoutAttribute、RibbonTabAttribute和CommandAttribute等属性，可以定义插件的基本属性、本地化文本、Ribbon布局以及命令的行为 15。例如， - RibbonLayoutAttribute指向一个XAML文件，该文件定义了自定义Ribbon的布局 14。 - CommandAttribute定义了将在应用程序中执行操作的命令，包括ID、显示名称、图标、工具提示和快捷方式等属性 14。 -* **AddInPlugin：** 这是最基本的插件类型，用于向Navisworks添加额外的功能 1。它通常用于实现简单的自动化任务或非UI相关的逻辑。 -* **DockPanePlugin：** 这种插件类型允许开发人员在Navisworks GUI系统中添加自定义的可停靠面板 19。这对于创建交互式导航控件的用户界面至关重要。在 - CreateControlPane方法中，ElementHost控件（一个Windows Forms控件）可用于托管WPF（Windows Presentation Foundation）元素，从而实现丰富的用户界面 19。 - DestroyControlPane方法则负责释放资源 19。 - -开发过程中，Navisworks SDK中提供的开发者指南（PDF格式）和参考指南（CHM文件）将是不可或缺的资源，它们详细介绍了.NET API的类和工具，并指导如何编写插件和应用程序 1。此外，由于Navisworks 2024 API中存在 - -Autodesk.Navisworks.Api.Controls.ApplicationControl.Initialize()可能抛出异常的问题，需要采用将Navisworks安装目录添加到PATH环境变量的解决方法 10。 - -### **2.2. 交互式导航控件设计** - -交互式导航控件将是插件的核心组成部分，提供直观的用户体验，以定义、规划和可视化物流路径。 - -* **自定义UI元素：** 为了提供丰富且响应迅速的用户体验，控件的用户界面将使用WPF（Windows Presentation Foundation）技术构建 19。WPF允许创建复杂且美观的界面，同时与.NET API无缝集成。 -* **视口交互：** - * **鼠标/键盘输入：** 通过实现InputPlugin，插件将能够处理鼠标点击、移动和键盘事件 20。这对于用户在模型中直接选择对象、定义路径点或触发特定操作至关重要。 - * **射线投射（Ray Casting）：** 为了实现精确的对象或模型表面点的选择，将利用View.PickItemFromPoint(x,y)方法 20。该方法接收屏幕坐标，并返回一个 - PickItemResult对象，其中包含选定对象（ModelItem）及其在世界坐标系（WCS）中的精确点信息 20。 - * **绘制临时图形：** Graphics类将用于在视口中绘制临时图形，例如物流路径的线条或多段线，以及选定通道的边界框 12。 - OverlayRenderModel和OverlayRenderWindow方法可用于在模型空间或窗口空间中渲染这些叠加图形 12。这将为用户提供实时的视觉反馈，例如在路径规划过程中动态显示路径。 - * **相机操作：** Navisworks API提供了对视点（Viewpoint）和相机（Camera）的全面控制，允许程序化地移动、旋转和调整相机位置 11。这将用于在路径规划和动画仿真过程中，自动调整视口以跟随物流移动或聚焦于关键区域。 -* **通道/路径选择界面：** - * **自定义选择树：** Navisworks API支持创建自定义选择树，可以通过实现InwSelectionTreePlugin或InwOpUserSelectionTreePlugin来实现 11。这将允许插件以逻辑和用户友好的方式组织和显示物流相关的模型元素（例如，通道、区域、设备）。 - * **程序化选择：** Document.CurrentSelection类提供了对当前选择的访问和操作方法，包括清除、添加或替换选定项目 27。 - * **搜索集（Search Sets）：** Search类是Navisworks API中用于查找模型项的强大工具，相当于GUI中的“查找（Find）”功能 28。它将用于通过自定义属性、类别或其他条件来过滤和选择与物流相关的元素，例如快速识别所有定义为“物流通道”的构件 5。 - -### **2.3. 大型模型性能考量** - -处理大型BIM模型时，性能是至关重要的考量因素。该插件将采用多项策略来确保其在大型模型环境中的响应性和实用性。 - -* **优化数据访问：** - * **高效遍历选择树：** 标准的Windows树控件在处理非常大的树时效率低下 11。对于大型模型，递归遍历整个层次结构会非常慢。建议采用类似 - AppInfo示例的方法，即只在节点展开时才加载其子节点，从而限制展开速度对性能的影响 11。 - * **批量操作：** 对于模型修改，应利用Navisworks.NET API的事务（Transaction）机制 11。事务能够捆绑多个操作，从而提高性能并确保数据一致性。对于COM API，可以使用 - state.BeginEdit和state.EndEdit来捆绑撤销信息和内部通知，这可以显著加快操作速度 11。对于.NET API，推荐使用 - using (Transaction transaction \= new Transaction(document))块来确保事务的正确管理和回滚 31。 - * **利用内部数据结构：** 在访问属性时，应高效利用Navisworks内部的属性结构，通过显示名称、内部名称或组合名称来查找特定属性 29。 -* **模型优化技术：** - * **隐藏冗余几何碎片：** 隐藏模型中不必要的几何碎片可以显著减少处理和渲染的负担，特别是那些数量巨大（例如1000个或更多）的碎片 34。 - * **消除不必要的几何体：** 隐藏或删除在VR或特定分析中不需要的元素，例如重复的钢筋、螺母、螺栓、透明元素（渲染成本高）、树木或家具等“锦上添花”的特征 34。 - * **定义截面框：** 通过启用截面工具并调整截面框，可以只隔离和处理模型中正在审查的特定区域，从而提高性能和加载速度 34。 - * **使用选择集和搜索集：** 利用Navisworks的选择集和搜索集来分组和管理这些需要隐藏或隔离的元素，使操作更加高效 34。 - * **优化NWD导出：** 在导出NWD文件时，可以配置选项以排除隐藏项目，从而生成更小、更优化的文件 2。 -* **硬件和软件配置：** - * **系统要求：** 确保开发和运行环境满足Navisworks的最低系统要求。对于大型模型，建议使用配备64GB RAM的计算机 35。 - * **显卡和驱动程序：** 确保使用最强大的显卡，并定期更新显卡驱动程序，因为过时或损坏的驱动程序可能导致严重的性能问题 35。在某些情况下，关闭硬件加速可以作为诊断或临时解决性能问题的手段 35。 - * **Navisworks设置：** 探索并调整Navisworks应用程序菜单\>选项\>显示中的各种设置，以优化显示变量 35。 - * **网络环境：** 如果文件从中央服务器位置访问，网络带宽可能成为性能瓶颈。尝试将文件复制到本地计算机进行操作，以评估网络影响 35。 - * **“加载时关闭NWC/NWD文件”选项：** 启用此选项会增加加载时间，因为它会强制Navisworks在加载时完全加载整个文件并释放文件锁，而不是按需加载 35。 -* **线程和异步操作：** - * Navisworks API并非完全多线程就绪。大多数API调用应在主UI线程上执行 36。尽管可以从其他线程访问API，但结果可能不可预测且常常是致命的 36。 - * 对于后台处理，建议利用Navisworks的Idling事件 36。这允许应用程序在Navisworks空闲时执行任务，而不会阻塞主UI线程。当工作线程完成任务时，它会向应用程序发出信号，以便在下一次 - Idling事件或DocumentClosed等其他事件触发时进行处理 36。 - * 在处理ApplicationControl.Initialize()时，需要注意将Navisworks安装目录添加到PATH环境变量的解决方法，以避免“外部组件抛出异常”的问题 10。 - * 对于大型模型，业界对Navisworks API中缺乏直接的LOD（细节级别）或顶点简化API表示关注 37。这意味着开发人员需要通过上述模型优化技术（如隐藏不必要的几何体）来间接管理模型复杂性，而不是通过API进行几何体简化。 - -对大型模型性能的关注不仅仅是技术挑战，更是实际部署中至关重要的战略要求。所提出的技术，例如选择性加载、批量操作和几何体简化，反映了对如何有效管理计算资源的深刻理解。这不仅限于编码实践，还包括工作流程优化（例如，在创作工具中准备模型，选择性NWD导出）和硬件考量。这种整体方法对于确保插件在处理多千兆字节模型时仍能保持可用性和响应性至关重要，直接影响用户采纳和项目效率。 - -## **3\. 核心功能实现细节** - -### **3.1. 通道选择与路径规划** - -物流仿真插件的核心功能之一是允许用户定义和规划物流通道和路径。 - -* **定义通道：** - * 插件将允许用户通过在模型中选择几何体（例如，楼层、走廊、特定区域）来定义物流通道。这可以通过利用InputPlugin来捕获鼠标点击事件并识别用户选择的模型元素来实现 20。 - * 选定的通道定义将作为自定义属性（用户数据）存储在相应的ModelItem实例上 7。这些自定义属性可以包含通道的名称、类型（例如，人行道、车辆通道）、容量限制等信息。Navisworks 2026的属性集功能将用于组织这些物流相关的自定义属性，使其易于管理和过滤 3。 - * 为了检索和操作这些带有自定义属性的元素，将使用Search API，通过SearchCondition.HasCategoryByDisplayName或SearchCondition.HasPropertyByName等方法来过滤和查找具有特定物流属性的构件 28。 -* **路径生成与优化：** - * 路径规划将利用Navisworks中模型的几何数据。通过访问ModelItem.BoundingBox()可以获取元素的边界框信息，而Model.Transform则提供了模型的变换矩阵，这些都可用于计算路径的几何约束和可行性 10。 - * 生成的路径将在Navisworks视口中通过Graphics类进行可视化，绘制为线条或多段线 12。这将为用户提供直观的路径预览。 - * 对于复杂的路径查找和优化，如果Navisworks API本身不提供内置算法，可以考虑集成外部路径规划库。例如，可以基于模型几何体构建一个简化的图（节点和边），然后应用A\*算法等来查找最优路径，同时考虑通道的宽度、高度限制和障碍物。 -* **交互式路径编辑：** - * 插件将允许用户在视口中直接拖动和修改路径节点，以进行路径的交互式编辑。这需要InputPlugin来捕获鼠标拖动事件，并结合Graphics类提供实时的视觉反馈，例如在拖动节点时动态更新路径的显示。 - * 路径修改后，插件将动态更新底层存储的自定义属性或几何体数据，以确保路径定义的持久性。 - -### **3.2. 物流属性管理** - -有效的物流仿真离不开对模型元素的详细物流属性管理。 - -* **自定义属性创建与关联：** - * 插件将能够程序化地向ModelItem实例添加、修改和删除自定义属性（用户数据） 7。这对于将物流特定信息（如物料类型、重量、尺寸、处理说明、交付日期、所需设备等）附加到模型构件至关重要。 - * Navisworks 2026引入的“属性集（Property Sets）”功能将用于组织和显示这些物流相关的属性，使其在属性面板和选择检查器中易于过滤和访问 3。 -* **数据持久性：** - * 添加到模型项的自定义属性将随NWD文件一起保存，确保数据的持久性 29。 - * 对于更大型或更复杂的物流数据集，可以考虑使用外部数据库进行存储，并通过GUID或其他唯一标识符将数据与Navisworks模型元素关联起来 29。Navisworks支持链接到外部数据库，这可以通过“数据工具（Data Tools）”功能实现，允许从外部数据库（如Excel文件）导入属性并将其显示为自定义选项卡 7。 - -### **3.3. 物流自动化碰撞检测** - -碰撞检测是物流规划中的关键环节，用于识别潜在的冲突和瓶颈。 - -* **碰撞测试配置：** - * 插件将通过Document.Clash属性访问Navisworks的碰撞检测器功能 42。 - * 可以程序化地创建和配置ClashTest实例 10。这将允许定义各种物流碰撞测试，例如： - * 物流路径与静态结构（墙壁、柱子、设备）之间的硬碰撞。 - * 移动设备与临时安装（脚手架、物料堆）之间的软碰撞（基于容差）。 - * 不同物流流线之间的交叉碰撞。 - * 为碰撞测试定义选择集（ClashSelection）至关重要，例如将物流路径定义为A组，将可能与之碰撞的结构或设备定义为B组 42。 - * 可以设置PrimitiveTypes（例如Triangles、Lines、Points）来指定在碰撞检测中考虑的几何图元类型，从而提高检测的准确性和相关性 10。 - * Navisworks 2026碰撞检测器的新功能将得到充分利用，包括按属性分组碰撞、分配优先级级别以及编辑描述字段，以更好地管理和分类物流碰撞问题 3。 -* **动态碰撞检测（基于动画）：** - * Navisworks的碰撞检测器可以与动画器（Animator）工具集成，实现基于时间的碰撞检查 46。这将允许插件在物流动画仿真过程中自动检查移动对象之间的干扰，或移动对象与静态元素沿物流路径的干扰。 - * 插件可以自动化在动画的特定步骤运行碰撞测试，以捕获特定时间点的冲突 47。 -* **报告与可视化：** - * 插件将能够生成自定义碰撞报告，其中可以包含新引入的优先级列，以便更好地突出关键物流冲突 3。 - * 碰撞结果将直接在Navisworks视口中可视化，例如通过高亮显示冲突对象或显示碰撞点。 - * 碰撞数据可以导出为CSV格式，以便在外部工具（如Microsoft Power BI）中进行进一步分析和可视化，从而生成交互式报告，提高项目团队的沟通效率 13。 - -### **3.4. 逼真动画仿真** - -动画仿真是可视化物流流程和验证路径规划有效性的重要手段。 - -* **创建动画：** - * 插件将利用Navisworks的动画器（Animator）工具来创建对象动画 47。 - * 可以程序化地定义关键帧，以控制物流对象（如叉车、起重机、运输车辆）的移动、旋转和缩放 47。例如，可以设置门在观察者接近时自动打开的动画 47。 - * SavedViewpointAnimation类可用于创建相机动画，使视点沿着定义的物流路径移动，提供“漫游”式的仿真体验 48。 - * Scripter工具可以用于将动画与特定事件（如按键、碰撞）关联起来，实现更高级的交互式仿真 18。 -* **基于路径的动画：** - * 虽然Navisworks的Alias产品线中存在“设置运动路径（Set Motion Path）”功能 56，但Navisworks API在直接创建基于曲线或样条的动画方面可能存在限制 47。因此，插件可能需要手动生成沿预定义物流路径的关键帧。 - * 这将涉及计算路径上的离散点，并利用Transform3D和Matrix3类来程序化地应用对象的平移和旋转变换，从而模拟沿着路径的运动 10。 -* **仿真播放控制：** - * 插件将提供对动画播放的程序化控制，包括开始、停止、暂停和调整播放速度 48。 - * 可以将动画播放与外部物流计划或时间表同步，以实现更精确的4D物流仿真。 -* **物流流可视化：** - * 利用外观覆盖（Appearance Overrides）功能 59，可以根据物流属性（例如，物料类型、交付状态）对模型中的对象进行颜色编码，从而直观地显示物流状态。 - * 在仿真过程中，可以在视口中实时显示物流对象的关键信息，例如当前位置、速度、预计到达时间等。 - -# **3.5. 导航地图输出** - -为了满足客户对导航地图和路径规划结果输出的需求，本插件将提供将当前视口内容导出为图片和视频的功能。 - -## 3.5.1 输出为图片格式 - -### 功能描述 -允许用户将当前 Navisworks 视口中显示的导航地图、规划路径以及模型状态（包括高亮显示、隐藏/淡化等）保存为高质量的静态图片文件。 - -### 实现方式 -利用 Navisworks COM API 提供的图像导出功能。 - -### 用户界面 (UI) 交互 -在交互式导航控件的面板中，添加一个"导出图片"按钮。点击该按钮后，将弹出一个文件保存对话框，允许用户选择输出路径、文件名和图片格式（例如 PNG、JPEG）。 - -### 技术实现细节 - -#### 1. 获取当前文档和 COM 状态 -首先，需要获取 Navisworks 的当前活动文档，并通过 COM 互操作获取 InwOpState10 对象，这是访问许多底层导出功能的关键。 - -```csharp -Document doc = Application.ActiveDocument; -ComApi.InwOpState10 oState = ComApiBridge.State; -``` - -#### 2. 获取图像导出插件选项 -Navisworks 内部通过名为 "lcodpimage" 的插件处理图像导出。我们可以通过 GetIOPluginOptions 方法获取其配置选项。 - -```csharp -ComApi.InwOaPropertyVec options = oState.GetIOPluginOptions("lcodpimage"); -``` - -#### 3. 配置导出参数 -通过遍历 options.Properties()，可以设置图像的格式、宽度和高度等参数。 - -##### 设置图片格式 -将 export.image.format 属性设置为所需的值。例如，"lcodpexpng" 用于 PNG 格式，"lcodpexjpeg" 用于 JPEG 格式。 - -```csharp -foreach (ComApi.InwOaProperty opt in options.Properties()) -{ - if (opt.name == "export.image.format") - { - opt.value = "lcodpexpng"; // 或 "lcodpexjpeg" - } -} -``` - -##### 设置分辨率 -找到 export.image.width 和 export.image.height 属性，并将其值设置为用户指定的分辨率（例如，1920x1080）。 - -```csharp -foreach (ComApi.InwOaProperty opt in options.Properties()) -{ - if (opt.name == "export.image.width") - { - opt.value = 1920; - } - if (opt.name == "export.image.height") - { - opt.value = 1080; - } -} -``` - -#### 4. 执行导出操作 -调用 DriveIOPlugin 方法，传入插件名称、输出文件路径和配置好的选项。 - -```csharp -string outputPath = "C:\\Path\\To\\Your\\NavigationMap.png"; // 用户选择的路径 -oState.DriveIOPlugin("lcodpimage", outputPath, options); -``` - -#### 5. 错误处理与用户反馈 -在导出过程中应加入 try-catch 块来捕获可能发生的异常，并向用户提供成功或失败的反馈。 - -## 3.5.2 输出为视频格式 - -### 功能描述 -将物流组件沿规划路径的动画仿真过程录制为视频文件（例如 AVI 格式），以便在外部播放器中查看。 - -### 实现方式 -由于 Navisworks.NET API 不直接提供录制视频的功能，我们将采用"逐帧图像序列导出 + 外部视频合成"的策略。 - -### 用户界面 (UI) 交互 -在交互式导航控件的面板中，添加一个"导出视频"按钮。点击该按钮后，将弹出一个对话框，允许用户设置视频的输出路径、文件名、帧率、分辨率和视频编码器等参数。 - -### 技术实现细节 - -#### 1. 动画生成与播放控制 - -##### 创建动画 -插件需要首先根据规划的物流路径，程序化地创建物流组件（例如待载转运车）和/或相机（视点）的动画。这可以通过设置一系列关键帧来实现。 - -- **对象动画**：利用 `ComApi.State.OverrideTransform` 方法，在每个时间步长更新物流组件的位置和旋转，模拟其沿路径的移动。 -- **视点动画**：创建 `SavedViewpointAnimation` 对象，并向其中添加一系列 `SavedViewpoint`。每个 `SavedViewpoint` 代表动画中某一时刻的相机位置和方向。 - -##### 动画播放控制 -通过程序化地控制动画的播放进度，例如使用计时器或 Navisworks 的 Idling 事件来逐帧推进动画，确保在每个时间点都能捕获到正确的模型状态。 - -#### 2. 逐帧图像捕获 -在动画播放的每个帧（或预设的时间间隔），执行上述"输出为图片格式"的步骤，将当前视口的内容捕获为一张图片。 - -##### 命名约定 -将这些图片按顺序保存到临时目录，并采用统一的命名约定，例如 `frame_00001.png`, `frame_00002.png`，以便后续的视频合成工具能够正确识别序列。 - -##### 性能优化 -图像捕获是一个耗时操作。为了避免阻塞 Navisworks UI，建议在后台线程中执行图像捕获任务，并使用进度条向用户显示当前进度。 - -#### 3. 外部视频合成 -一旦所有图像帧都被捕获并保存，就需要使用外部工具将这些图像序列合成为视频文件。 - -##### 选择工具 -FFmpeg 是一个功能强大且广泛使用的开源命令行工具，支持多种视频格式和编码器，非常适合此任务。 - -##### 集成方式 - -**命令行调用**：插件可以通过 `System.Diagnostics.Process` 类在 C# 代码中调用 FFmpeg 命令行工具。例如，将 PNG 图像序列合成为 AVI 视频的命令可能如下所示： - -```bash -ffmpeg -framerate 24 -i C:\Temp\frames\frame_%05d.png -c:v mpeg4 -q:v 5 C:\Output\NavigationVideo.avi -``` - -其中： -- `-framerate 24`：设置视频帧率为 24 FPS -- `-i C:\Temp\frames\frame_%05d.png`：指定输入图像序列的路径和命名模式 -- `-c:v mpeg4`：指定视频编码器为 MPEG-4 -- `-q:v 5`：设置视频质量（值越小质量越高，文件越大） -- `C:\Output\NavigationVideo.avi`：指定输出视频文件路径和名称 - -**FFmpeg.NET 封装库**：也可以考虑使用现有的 FFmpeg.NET 封装库（例如 FFmpeg.AutoGen 或 MediaToolkit），它们提供了更面向对象的 API，可以更方便地在 C# 代码中直接控制 FFmpeg 的功能，而无需手动构建命令行字符串。 - -##### 视频参数 -允许用户在 UI 中设置视频的帧率（例如 15 FPS 或 24 FPS，Navisworks 自身手动导出时推荐 10-15 FPS，最高 24 FPS）、分辨率（例如 Full HD 1920x1080）、编码器和输出格式。 - -#### 4. 清理 -视频合成完成后，插件应自动删除临时生成的图像序列文件，以释放磁盘空间。 - -## 性能考量 - -- **图像捕获速度**：逐帧捕获高分辨率图像会显著影响性能。在设计动画时，应平衡动画时长、帧率和分辨率，以确保可接受的导出时间。 - -- **文件 I/O**：大量图像文件的读写操作会产生 I/O 瓶颈。考虑使用高性能的存储设备，并优化文件写入策略。 - -- **FFmpeg 性能**：FFmpeg 的视频合成速度取决于所选的编码器、硬件配置以及是否支持硬件加速。在部署前应进行充分的测试和优化。 - -通过上述方法，插件将能够满足您对导航地图和路径规划结果以图片和视频形式输出的需求，为物流仿真提供直观且实用的可视化成果。 - -## **4\. 文件格式支持与DELMIA集成** - -本方案的关键在于确保Navisworks插件能够与DELMIA平台进行高效的数据交换，这需要广泛的文件格式支持和精心设计的数据集成策略。 - -### **4.1. 多格式导入/导出能力** - -Navisworks作为项目审阅软件，其核心优势在于支持多种CAD文件格式的聚合 2。 - -* **Navisworks原生支持：** - * Navisworks支持超过60种文件格式的导入，包括但不限于AutoCAD、Revit、Inventor、IFC、DWG、DXF、NWC、NWD、NWF等 1。这意味着插件可以处理来自不同BIM和CAD软件的异构模型数据。 - * Navisworks 2026引入了新的2026文件格式，用于保存NWD和NWF文件，并允许用户在选项编辑器中设置默认保存版本 4。 - * 导出NWD文件时，现在可以配置新的选项，例如排除隐藏项目，这有助于生成更精简的模型用于共享或集成 2。 - * NwCreate API允许程序化地创建NWC文件，这对于从第三方应用程序导出自定义格式或将自定义数据集成到Navisworks模型中非常有用 1。 - * Navisworks还支持将模型导出为DWF格式 62 和FBX格式 29。 -* **插件特定导入/导出：** - * 为了与DELMIA进行数据交换，插件需要能够将物流路径和相关属性导出为通用且易于解析的格式，如XML、JSON或CSV 10。XML是一种通用、轻量级的基于XML的格式，适用于快速高效地共享实时、准确的三维数据 63。 - * Navisworks原生支持将属性导出为CSV文件 5，这为导出物流属性提供了直接途径。 - * 可以开发自定义导出器，利用.NET API将物流路径的几何数据（如XYZ坐标点序列）和关联的自定义属性打包成DELMIA所需的数据结构。 - -### **4.2. 与DELMIA的集成** - -DELMIA是达索系统3DEXPERIENCE平台下的数字制造和生产解决方案，专注于优化生产系统和流程 66。与DELMIA的集成将使Navisworks中的物流规划能够利用DELMIA的高级仿真能力。 - -* **DELMIA在物流仿真方面的能力：** - * DELMIA提供全面的解决方案，涵盖数字制造、生产系统优化、机器人技术和工厂仿真 66。 - * 其关键功能包括工作单元设计、机器人编程、虚拟调试、物料和资源流分析、瓶颈识别以及关键绩效指标（KPI）仪表板 67。这些功能与Navisworks中定义的物流路径和属性相结合，可以实现更深入的物流分析和优化。 - * DELMIA支持导入多种CAD文件类型，包括SOLIDWORKS文件、DXF、STEP、Revit和三维点云数据 61。值得注意的是，DELMIA支持从Navisworks 2012到2025版本的NWD和NWF文件 61。 - * DELMIA可以导入XML文件用于零件轮廓和轨迹/路径数据 63。DELMIA Robotics还支持机器人程序和轨迹的导入/导出，并允许使用VB.NET创建自定义翻译器 68。 -* **数据交换策略：** - * **初始模型传输：** Navisworks模型（NWC/NWD）可以导出为DELMIA兼容的格式，如STEP或IFC。如果DELMIA 2026直接支持Navisworks 2026的NWD格式，则可以直接传输；否则，可以考虑转换为FBX等通用三维格式作为中间步骤 29。 - * **物流数据交换：** 将Navisworks中定义的物流路径（几何信息）及其关联的属性（元数据）导出为XML或JSON文件。 - * 对于路径：可以将路径表示为由一系列XYZ坐标点定义的多段线或样条曲线。 - * 对于属性：需要将Navisworks中的自定义属性映射到DELMIA的数据模型中，确保语义一致性。 - * **DELMIA导入与处理：** 在DELMIA内部，可以开发自定义导入器（如果DELMIA提供相应的API）或利用其现有的导入功能。例如，DELMIA支持导入XML文件作为轨迹或路径数据 63。对于机器人程序，DELMIA允许创建VB.NET自定义翻译器来处理特定格式的数据 68。 - * **仿真结果回传Navisworks（可选但有价值）：** 考虑将DELMIA的仿真结果（例如，优化后的路径、瓶颈报告、新的碰撞数据）导出回Navisworks，以便在BIM模型中进行可视化和进一步的协调。这将需要定义一个互惠的数据交换格式和流程。 - -尽管文件格式兼容性是集成的重要基础 61，但真正的挑战在于语义互操作性。仅仅将几何文件（例如，将NWD导入DELMIA）并不能自动传输Navisworks中丰富的BIM数据或专门定义的物流自定义属性。解决方案必须解决如何将这些数据 - -**映射**并**情境化**到DELMIA的仿真环境中。这意味着需要一个定义良好的物流信息数据模式，并且可能需要一个中间件组件或自定义翻译器，它能够理解Navisworks的属性结构和DELMIA的输入要求。这对于超越单纯的几何可视化，实现跨平台的实际仿真和分析至关重要。 - -# **5\. 模型切分及导出** - -该功能将允许用户根据以下三种方式选择模型元素： - -1. **按楼层切分**：根据模型中定义的楼层属性，选择特定楼层的所有模型元素。 -2. **按自定义属性切分**：根据用户指定的属性类别、属性名称和属性值，筛选出符合条件的模型元素。 -3. **按当前选择切分**：使用用户在 Navisworks 视口或选择树中已选中的模型元素。 - -选定模型元素后，插件将自动隐藏所有非选定元素，然后将当前可见的模型导出为一个新的 NWD 文件，确保新文件中不包含任何隐藏项。导出完成后，模型将恢复到原始的可见状态。 - -## 5.1 用户界面 (UI) 设计 - -为了提供直观且高效的用户体验，建议在自定义的 Ribbon 选项卡中添加一个新按钮，并设计一个专用的对话框或可停靠面板（Dockable Pane）来承载切分和导出选项。 - -### 5.1.1 Ribbon 按钮 - -- **位置**：在自定义的"物流仿真"Ribbon 选项卡中，添加一个名为"模型切分与导出"的按钮。 -- **图标**：配备一个清晰的图标，例如一个带有剪刀或文件导出符号的模型图标。 -- **工具提示**："根据楼层、属性或当前选择，将模型子集导出为新的 NWD 文件。" - -### 5.1.2 "模型切分与导出"对话框/面板 (WPF) - -该对话框/面板将使用 WPF (Windows Presentation Foundation) 技术构建，以提供丰富的交互性。 - -#### 切分方式选择区 - -- **标题**："选择切分方式" -- **控件**：三个单选按钮 (RadioButton)： - - **"按楼层"**：选中后，下方显示楼层选择控件。 - - **"按自定义属性"**：选中后，下方显示属性输入控件。 - - **"按当前选择"**：选中后，下方显示"使用当前选择"按钮。 - -#### 切分条件设置区（根据选择方式动态显示） - -##### 若选择"按楼层" - -- **标签**："选择楼层" -- **控件**：下拉列表 (ComboBox)，动态填充当前模型中检测到的所有楼层名称（例如：Level 1, F2, Ground Floor）。 -- **特殊要求处理**：考虑在楼层选择后，提供一个可选的复选框或高级设置，用于"忽略编组站区域楼层间上下贯穿模块"。这需要插件能够识别这些特定模块的属性。 - -##### 若选择"按自定义属性" - -- **标签**："属性类别名称" (TextBox) -- **标签**："属性名称" (TextBox) -- **标签**："属性值" (TextBox) -- **提示**：可在文本框旁提供示例或"浏览属性"按钮，帮助用户查找正确的属性路径。 - -##### 若选择"按当前选择" - -- **按钮**："使用当前选择" (Button)。点击后，插件将获取 Navisworks 当前选中的所有模型元素。 -- **显示**：可选地，显示当前选中元素的数量，例如"已选中：X 个元素"。 - -#### 预览与导出操作区 - -- **按钮**："预览选择" (Button)。点击后，插件将临时隐藏所有非选定元素，只显示即将导出的模型子集。这有助于用户在导出前进行视觉确认。 -- **按钮**："恢复原始视图" (Button)。点击后，恢复模型到"预览选择"前的可见状态。 -- **标签**："输出文件路径" (TextBox) -- **按钮**："浏览..." (Button)。打开文件保存对话框，让用户选择保存路径和文件名。 -- **标签**："NWD 版本" (ComboBox)。允许用户选择导出的 NWD 文件版本，例如"Navisworks 2026"。 -- **复选框**："排除隐藏项" (Checkbox)。此选项应默认勾选且不可修改，以确保只导出可见内容。 -- **按钮**："导出 NWD" (Button)。执行导出操作。 -- **进度条/状态信息**：在导出过程中显示进度或状态消息。 - -## 5.2 技术实现细节 (C#.NET) - -该功能将作为 Navisworks 插件的一部分，利用 Navisworks.NET API 进行开发。 - -### 5.2.1 核心工作流 - -1. **获取当前文档**： - ```csharp - Document doc = Application.ActiveDocument; - ``` - -2. **启动事务**：为了确保模型可见性更改的原子性和性能，所有隐藏/显示操作都应包裹在 Transaction 中。 - ```csharp - using (Transaction transaction = new Transaction(doc)) - ``` - -3. **确定要导出的模型项** (`ModelItemCollection itemsToExport`)：根据用户在 UI 中选择的切分方式执行相应的逻辑。 - -4. **临时隐藏非导出模型项**： - - 获取模型中所有 ModelItem 的集合。 - - 计算出 `itemsToExport` 的补集，即 `itemsToHide`。 - - 调用 `doc.Models.SetHidden(itemsToHide, true);` 来隐藏这些元素。 - -5. **执行 NWD 导出**： - ```csharp - doc.SaveFile(outputPath, DocumentFileVersion.Navisworks2026); - ``` - 由于 Navisworks 2026 的 NWD 导出功能支持排除隐藏项，此方法将自动排除之前隐藏的元素。 - -6. **恢复原始可见性**： - 调用 `doc.Models.SetHidden(new ModelItemCollection(), false);` 或 `doc.Models.UnhideAll();` 来显示所有元素，恢复模型到导出前的状态。 - -7. **提交事务**： - ```csharp - transaction.Commit(); - ``` - -### 5.2.2 切分方式的具体实现 - -#### 1. 按楼层切分 - -##### 楼层数据获取 - -- 遍历 `doc.Models` 中的所有 Model 和其 `RootItem.DescendantsAndSelf`。 -- 对于每个 ModelItem，访问其 `PropertyCategories`。 -- 查找包含楼层信息的属性类别（例如，`PropertyCategoryNames.Element` 或其他自定义类别）和属性名称（例如，"Level"、"Floor"、"Base Level"）。这些名称可能因原始 CAD 软件而异，需要进行适配或配置。 -- 收集所有唯一的楼层值，并填充到 UI 的下拉列表中。 - -##### 模型项筛选 - -- 当用户选择一个楼层后，构建一个 Search 对象。 -- 添加搜索条件： - ```csharp - SearchCondition.HasPropertyByDisplayName("Element", "Level") - .EqualValue(VariantData.FromDisplayString(selectedFloorLevel)) - ``` -- 执行搜索： - ```csharp - ModelItemCollection itemsToExport = search.FindAll(doc, false); - ``` - -##### 忽略贯穿模块 - -如果需要忽略"编组站区域楼层间上下贯穿模块"，则在上述搜索条件中添加额外的 AND 条件，例如： - -```csharp -search.SearchConditions.Add( - SearchCondition.HasPropertyByDisplayName("CustomCategory", "ModuleType") - .NotEqualValue(VariantData.FromDisplayString("ThroughFloor")) -); -``` - -这要求这些模块在模型中具有可识别的属性。 - -#### 2. 按自定义属性切分 - -##### 用户输入 -直接从 UI 获取用户输入的属性类别名称、属性名称和属性值。 - -##### 模型项筛选 - -- 构建 Search 对象。 -- 添加搜索条件： - ```csharp - SearchCondition.HasPropertyByDisplayName(userCategoryName, userPropertyName) - .EqualValue(VariantData.FromDisplayString(userPropertyValue)) - ``` -- 执行搜索： - ```csharp - ModelItemCollection itemsToExport = search.FindAll(doc, false); - ``` - -#### 3. 按当前选择切分 - -##### 获取当前选择 - -```csharp -ModelItemCollection itemsToExport = doc.CurrentSelection.SelectedItems; -``` - -由于 `SelectedItems` 是只读集合，如果后续需要修改此集合，应将其复制到新的 `ModelItemCollection` 中。 - -### 5.2.3 性能优化考量 - -鉴于客户处理的是大型建筑模型，性能是关键。 - -- **事务 (Transaction)**：批量隐藏/显示操作应在单个事务中完成，以减少 Navisworks 内部更新和撤销信息的开销，显著提高性能。 - -- **高效集合操作**：使用 `ModelItemCollection` 和 `SetHidden` 方法对集合进行操作，而不是逐个元素处理。 - -- **优化搜索**：充分利用 Search API 的强大过滤能力，通过精确的 `SearchCondition` 快速定位目标元素，避免不必要的全模型遍历。 - -- **避免不必要的 UI 刷新**：在执行大量模型操作时，尽量减少 UI 刷新，例如在事务内部不进行频繁的 `RequestDelayedRedraw`。 - -- **内存管理**：对于大型模型，确保代码在处理大量 ModelItem 时有效管理内存，避免内存泄漏。 - -## 5.3 验收标准 - -- 插件能够成功加载并显示"模型切分与导出"功能按钮。 - -- "模型切分与导出"对话框/面板能够正常打开，并提供所有预期的切分方式和选项。 - -- "按楼层"切分方式能够正确识别并列出模型中的楼层，并能根据所选楼层准确筛选出模型元素。 - -- "按自定义属性"切分方式能够根据用户输入的属性信息准确筛选出模型元素。 - -- "按当前选择"切分方式能够准确获取 Navisworks 当前选中的模型元素。 - -- "预览选择"功能能够临时隐藏非选定元素，只显示即将导出的模型子集，且"恢复原始视图"功能能够正确恢复模型原始可见性。 - -- 导出 NWD 文件时，能够成功排除所有隐藏的模型元素，确保新文件只包含可见的子集。 - -- 导出过程在处理大型模型时保持流畅，性能表现良好。 - -- 导出的 NWD 文件能够正常打开，并包含正确的模型子集和属性信息。 - -通过上述详细设计，该功能将能够满足客户对大型模型分层或按属性切分并导出为独立文件的实用性需求，同时兼顾性能。 - -## **6\. 结论与建议** - -### **6.1. 技术方案总结** - -本技术方案为Navisworks 2026插件和交互式导航控件的开发提供了全面的蓝图，旨在彻底改变大型项目中物流规划和验证的方式。通过利用Navisworks 2026 API的最新增强功能，该解决方案将实现通道选择、智能路径规划、动态物流属性管理、自动化碰撞检测和逼真动画仿真等核心功能。在设计中，我们特别强调了大型模型的性能优化，包括高效的数据访问、模型简化技术和对线程的审慎管理。此外，该方案确保了对多种文件格式的广泛支持，并详细规划了与达索系统DELMIA平台的无缝集成，从而在BIM和数字制造领域之间建立了关键的数字连续性。 - -### **6.2. 主要优势与战略影响** - -该集成解决方案将带来多项显著优势和深远的战略影响： - -* **增强物流规划与验证：** 插件将使项目团队能够在三维模型中精确定义、可视化和优化物流路径，从而在实际施工或生产之前识别并解决潜在问题。 -* **提高项目效率与成本节约：** 通过在早期阶段进行碰撞检测和动画仿真，可以减少现场冲突、物料处理错误和返工，从而显著节约时间和成本。 -* **促进跨领域协作：** 将Navisworks的BIM协调能力与DELMIA的先进制造仿真能力相结合，将打破传统的数据孤岛，促进设计、施工和制造团队之间的无缝协作。 -* **支持全生命周期管理：** 该解决方案将BIM数据从设计和施工阶段扩展到运营规划和设施管理，为资产的整个生命周期提供更全面的数字双胞胎。 -* **提升决策质量：** 动态物流仿真和数据驱动的分析将为利益相关者提供更准确的见解，从而做出更明智的决策，优化资源利用和生产率。 - -### **6.3. 实施建议** - -为了确保本技术方案的成功实施和长期价值，提出以下建议： - -* **分阶段开发：** 建议采用迭代和分阶段的开发方法，首先实现核心功能，然后逐步添加高级特性和优化。这有助于管理项目复杂性并确保早期交付可用的功能。 -* **专用性能测试：** 鉴于大型模型的性能要求，应在整个开发生命周期中进行严格的性能测试。这包括对数据加载、路径计算、碰撞检测和动画播放进行基准测试，并根据实际项目数据进行优化。 -* **持续的用户参与：** 在UI/UX设计和功能开发过程中，应持续与最终用户（BIM经理、物流专家、项目工程师）进行沟通和反馈。这将确保插件满足实际操作需求，并提供直观、高效的用户体验。 -* **探索未来API增强：** 持续关注Navisworks API的未来更新和增强功能。Autodesk对开放性和互操作性的承诺可能带来新的API，从而实现与DELMIA更深层次的集成或更先进的仿真能力。 -* **数据模式定义与映射工具：** 投资于明确定义物流信息的数据模式，并开发或利用工具来促进Navisworks自定义属性与DELMIA数据模型之间的映射。这对于确保数据在不同平台间语义一致性地流动至关重要。 -* **考虑云端协作：** 探索将解决方案与Autodesk Construction Cloud（包括BIM 360）等云平台集成 2。这将进一步增强团队协作，实现实时数据共享和基于云的冲突管理，从而提升整体工作流程效率。 - -#### **引用的著作** - -1. Navisworks API | Autodesk Platform Services (APS), 访问时间为 八月 11, 2025， [https://aps.autodesk.com/developer/overview/navisworks](https://aps.autodesk.com/developer/overview/navisworks) -2. Enjoy exclusive benefits on Autodesk Navisworks Manage 2026 \- Cadac Group, 访问时间为 八月 11, 2025， [https://www.cadac.com/us/autodesk-navisworks-manage-2026/](https://www.cadac.com/us/autodesk-navisworks-manage-2026/) -3. Product Update: Navisworks 2026 \- What's New \- Autodesk Community, 访问时间为 八月 11, 2025， [https://forums.autodesk.com/t5/navisworks-forum/product-update-navisworks-2026-what-s-new/td-p/13401440](https://forums.autodesk.com/t5/navisworks-forum/product-update-navisworks-2026-what-s-new/td-p/13401440) -4. What's New in Navisworks 2026 \- Autodesk Help, 访问时间为 八月 11, 2025， [https://help.autodesk.com/view/NAV/2026/ENU/?guid=Navisworks\_Whats\_New\_2026](https://help.autodesk.com/view/NAV/2026/ENU/?guid=Navisworks_Whats_New_2026) -5. Enhancements in Navisworks 2026 \- Autodesk Help, 访问时间为 八月 11, 2025， [https://help.autodesk.com/view/NAV/2026/ENU/?guid=Navisworks\_2026\_enhancements](https://help.autodesk.com/view/NAV/2026/ENU/?guid=Navisworks_2026_enhancements) -6. Autodesk Navisworks 2026 \- New Features \- YouTube, 访问时间为 八月 11, 2025， [https://www.youtube.com/watch?v=dOy91ZB\_3-A](https://www.youtube.com/watch?v=dOy91ZB_3-A) -7. Property Sets \- Navisworks \- Autodesk Help, 访问时间为 八月 11, 2025， [https://help.autodesk.com/view/NAV/2026/ENU/?guid=Display\_Property\_Sets](https://help.autodesk.com/view/NAV/2026/ENU/?guid=Display_Property_Sets) -8. Clash Detective Improvements \- Navisworks \- Autodesk Help, 访问时间为 八月 11, 2025， [https://help.autodesk.com/view/NAV/2026/ENU/?guid=WN\_Clash\_Detective\_Improvements&](https://help.autodesk.com/view/NAV/2026/ENU/?guid=WN_Clash_Detective_Improvements&) -9. Navisworks 2026 Appearance Profile : r/bim, 访问时间为 八月 11, 2025， [https://www.reddit.com/r/bim/comments/1mj6ko2/navisworks\_2026\_appearance\_profile/](https://www.reddit.com/r/bim/comments/1mj6ko2/navisworks_2026_appearance_profile/) -10. Navisworks \- AEC DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/navisworks/](https://adndevblog.typepad.com/aec/navisworks/) -11. Navisworks API \- AEC DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/navisworks/page/12/](https://adndevblog.typepad.com/aec/navisworks/page/12/) -12. Navisworks \- AEC DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/navisworks/page/4/](https://adndevblog.typepad.com/aec/navisworks/page/4/) -13. flyingturtle13/Navis-Clash\_Data\_Exporter: Exports Navisworks Clash Detective data to be consumed by Power BI Clash Metrics Reports \- GitHub, 访问时间为 八月 11, 2025， [https://github.com/flyingturtle13/Navis-Clash\_Data\_Exporter](https://github.com/flyingturtle13/Navis-Clash_Data_Exporter) -14. Custom Ribbon of Navisworks part 1 \- AEC DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/2012/07/custom-ribbon-of-navisworks-part-1.html](https://adndevblog.typepad.com/aec/2012/07/custom-ribbon-of-navisworks-part-1.html) -15. Navisworks .NET: Create Ribbon Using CommandHandlerPlugin/CommandAttribute/RibbonTabAttribute/RibbonLayoutAttribute/StringsAttribute/PluginAttribute/.XAML/Local Name File \- RevitNetAddinWizard & NavisworksNetAddinWizard, 访问时间为 八月 11, 2025， [https://spiderinnet.typepad.com/blog/2013/11/navisworks-net-create-ribbon-using-commandhandlerplugincommandattributeribbontabattributeribbonlayoutattributestringsat.html](https://spiderinnet.typepad.com/blog/2013/11/navisworks-net-create-ribbon-using-commandhandlerplugincommandattributeribbontabattributeribbonlayoutattributestringsat.html) -16. Navisworks .NET: Create All Kinds of Ribbon Buttons and Controls, 访问时间为 八月 11, 2025， [https://spiderinnet.typepad.com/blog/2014/01/navisworks-net-create-all-kinds-of-ribbon-buttons-and-controls.html](https://spiderinnet.typepad.com/blog/2014/01/navisworks-net-create-all-kinds-of-ribbon-buttons-and-controls.html) -17. Navisworks · RibbonLayoutAttribute Constructor \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2018/C\_Autodesk\_Navisworks\_Api\_Plugins\_RibbonLayoutAttribute\_ctor\_1\_362212bd.htm](https://apidocs.co/apps/navisworks/2018/C_Autodesk_Navisworks_Api_Plugins_RibbonLayoutAttribute_ctor_1_362212bd.htm) -18. Make NavisWORK for You: Intro to the Navisworks API \- Autodesk, 访问时间为 八月 11, 2025， [https://static.au-uw2-prd.autodesk.com/Class\_Handout\_CS226911\_Make\_NavisWORK\_for\_You\_Intro\_to\_the\_Navisworks\_API\_Jake\_Lovelace.pdf](https://static.au-uw2-prd.autodesk.com/Class_Handout_CS226911_Make_NavisWORK_for_You_Intro_to_the_Navisworks_API_Jake_Lovelace.pdf) -19. Navisworks API : Dockable Pane Plugin – TwentyTwo, 访问时间为 八月 11, 2025， [https://twentytwo.space/2022/03/31/navisworks-api-dockable-pane-plugin/](https://twentytwo.space/2022/03/31/navisworks-api-dockable-pane-plugin/) -20. Navisworks 2014 API new feature InputPlugin \- AEC DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/2013/05/navisworks-2014-api-new-feature-inputplugin.html](https://adndevblog.typepad.com/aec/2013/05/navisworks-2014-api-new-feature-inputplugin.html) -21. Using Ray Casting To Move 3D Objects // OpenGL Tutorial \#32 \- YouTube, 访问时间为 八月 11, 2025， [https://www.youtube.com/watch?v=lj5hx6pa\_jE](https://www.youtube.com/watch?v=lj5hx6pa_jE) -22. How to check the coordinates and elevation of an element or a point in Navisworks, 访问时间为 八月 11, 2025， [https://www.autodesk.com/support/technical/article/caas/sfdcarticles/sfdcarticles/How-to-check-the-elevation-coordinates-of-an-element-or-a-point-in-Navisworks.html](https://www.autodesk.com/support/technical/article/caas/sfdcarticles/sfdcarticles/How-to-check-the-elevation-coordinates-of-an-element-or-a-point-in-Navisworks.html) -23. Programmatically using acedgrdraw for temporary graphics in all viewports \- AEC DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/autocad/2013/01/programmatically-using-acedgrdraw-for-temporary-graphics-in-all-viewports.html](https://adndevblog.typepad.com/autocad/2013/01/programmatically-using-acedgrdraw-for-temporary-graphics-in-all-viewports.html) -24. Navisworks · Graphics.Line Method (Point3D, Point3D) \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2018/M\_Autodesk\_Navisworks\_Api\_Graphics\_Line\_2\_92bd7b81.htm](https://apidocs.co/apps/navisworks/2018/M_Autodesk_Navisworks_Api_Graphics_Line_2_92bd7b81.htm) -25. Navisworks API : Viewpoint (Part-1) \- TwentyTwo, 访问时间为 八月 11, 2025， [https://twentytwo.space/2020/12/06/navisworks-api-viewpoint-part-1/](https://twentytwo.space/2020/12/06/navisworks-api-viewpoint-part-1/) -26. Navisworks \- Selection Tree Window \- Autodesk Help, 访问时间为 八月 11, 2025， [https://help.autodesk.com/view/NAV/2024/ENU/?guid=GUID-AF4CFA5C-1455-4444-982A-34FBA2AE4608](https://help.autodesk.com/view/NAV/2024/ENU/?guid=GUID-AF4CFA5C-1455-4444-982A-34FBA2AE4608) -27. Navisworks · Selections and Collections of ModelItem \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2018/87317537-2911-4c08-b492-6496c82b3edb.htm](https://apidocs.co/apps/navisworks/2018/87317537-2911-4c08-b492-6496c82b3edb.htm) -28. Navisworks · Search Class \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2018/T\_Autodesk\_Navisworks\_Api\_Search.htm](https://apidocs.co/apps/navisworks/2018/T_Autodesk_Navisworks_Api_Search.htm) -29. Navisworks API \- AEC DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/navisworks/page/2/](https://adndevblog.typepad.com/aec/navisworks/page/2/) -30. Forge-Navisworks-ClashTest/Navisworks Plugin/Class1.cs at master \- GitHub, 访问时间为 八月 11, 2025， [https://github.com/xiaodongliang/Forge-Navisworks-ClashTest/blob/master/Navisworks%20Plugin/Class1.cs](https://github.com/xiaodongliang/Forge-Navisworks-ClashTest/blob/master/Navisworks%20Plugin/Class1.cs) -31. Transaction Class \- Revit API Docs, 访问时间为 八月 11, 2025， [https://www.revitapidocs.com/2017.1/308ebf8d-d96d-4643-cd1d-34fffcea53fd.htm](https://www.revitapidocs.com/2017.1/308ebf8d-d96d-4643-cd1d-34fffcea53fd.htm) -32. Navisworks .NET API Properties \- AEC DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/2012/05/navisworks-net-api-properties.html](https://adndevblog.typepad.com/aec/2012/05/navisworks-net-api-properties.html) -33. Navisworks API \- AEC DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/navisworks/page/14/](https://adndevblog.typepad.com/aec/navisworks/page/14/) -34. Optimizing Your Navisworks File \- IrisVR, 访问时间为 八月 11, 2025， [https://help.irisvr.com/hc/en-us/articles/360036941213-Optimizing-Your-Navisworks-File](https://help.irisvr.com/hc/en-us/articles/360036941213-Optimizing-Your-Navisworks-File) -35. Performance issues when navigating a model in Navisworks \- Autodesk, 访问时间为 八月 11, 2025， [https://www.autodesk.com/support/technical/article/caas/sfdcarticles/sfdcarticles/Navisworks-performance-issues-and-settings.html](https://www.autodesk.com/support/technical/article/caas/sfdcarticles/sfdcarticles/Navisworks-performance-issues-and-settings.html) -36. Multi-threading with Revit \- AEC DevBlog \- TypePad, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/2012/06/multi-threading-with-revit.html](https://adndevblog.typepad.com/aec/2012/06/multi-threading-with-revit.html) -37. LOD or Vertex Reduction API for Large Models in Navisworks \- Autodesk Community, 访问时间为 八月 11, 2025， [https://forums.autodesk.com/t5/navisworks-api/lod-or-vertex-reduction-api-for-large-models-in-navisworks/m-p/13316376](https://forums.autodesk.com/t5/navisworks-api/lod-or-vertex-reduction-api-for-large-models-in-navisworks/m-p/13316376) -38. Add/Modify/Remove custom attribute using COM API \- AEC DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/2012/08/addmodifyremove-custom-attribute-using-com-api.html](https://adndevblog.typepad.com/aec/2012/08/addmodifyremove-custom-attribute-using-com-api.html) -39. Custom Properties \- Navisworks \- Autodesk Help, 访问时间为 八月 11, 2025， [https://help.autodesk.com/view/NAV/2024/ENU/?guid=GUID-23C2693B-E459-43CD-A14A-F82A3F959189](https://help.autodesk.com/view/NAV/2024/ENU/?guid=GUID-23C2693B-E459-43CD-A14A-F82A3F959189) -40. add custom properties to all desired model items \- AEC DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/2013/03/add-custom-properties-to-all-desired-model-items.html](https://adndevblog.typepad.com/aec/2013/03/add-custom-properties-to-all-desired-model-items.html) -41. All About Clash Detection with Navisworks \- United-BIM, 访问时间为 八月 11, 2025， [https://www.united-bim.com/get-to-know-all-about-clash-detection-with-navisworks/](https://www.united-bim.com/get-to-know-all-about-clash-detection-with-navisworks/) -42. Clash Detective \- Navisworks \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2018/87317537-2911-4c08-b492-6496c82b3ee5.htm](https://apidocs.co/apps/navisworks/2018/87317537-2911-4c08-b492-6496c82b3ee5.htm) -43. Navisworks API \- Create Clash test? : r/bim \- Reddit, 访问时间为 八月 11, 2025， [https://www.reddit.com/r/bim/comments/1l5494a/navisworks\_api\_create\_clash\_test/](https://www.reddit.com/r/bim/comments/1l5494a/navisworks_api_create_clash_test/) -44. To Run a Clash test using api \- Autodesk Community, 访问时间为 八月 11, 2025， [https://forums.autodesk.com/t5/navisworks-api/to-run-a-clash-test-using-api/td-p/6607309](https://forums.autodesk.com/t5/navisworks-api/to-run-a-clash-test-using-api/td-p/6607309) -45. ApiDocs.co · Navisworks · ClashTest Class, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2018/T\_Autodesk\_Navisworks\_Api\_Clash\_ClashTest.htm](https://apidocs.co/apps/navisworks/2018/T_Autodesk_Navisworks_Api_Clash_ClashTest.htm) -46. Navisworks Help | Overview of Clash Detective Tool | Autodesk, 访问时间为 八月 11, 2025， [https://help.autodesk.com/cloudhelp/2026/ENU/Navisworks-Clash-Detective/files/GUID-36D9904E-12F3-4F82-8DD3-C2103DB0BC29.htm](https://help.autodesk.com/cloudhelp/2026/ENU/Navisworks-Clash-Detective/files/GUID-36D9904E-12F3-4F82-8DD3-C2103DB0BC29.htm) -47. Navisworks Help | Animate Objects | Autodesk, 访问时间为 八月 11, 2025， [https://help.autodesk.com/view/NAV/2024/ENU/?guid=GUID-DD38DF54-B0A6-4B80-86D3-D7C70584CCE7](https://help.autodesk.com/view/NAV/2024/ENU/?guid=GUID-DD38DF54-B0A6-4B80-86D3-D7C70584CCE7) -48. Navisworks Help | Record and Play Back Animations | Autodesk, 访问时间为 八月 11, 2025， [https://help.autodesk.com/view/NAV/2025/ENU/?guid=GUID-23867287-0FD7-4A96-849C-4FAA6F72F0C7](https://help.autodesk.com/view/NAV/2025/ENU/?guid=GUID-23867287-0FD7-4A96-849C-4FAA6F72F0C7) -49. Linking Animations to Timeliner tasks \- Beyond Design: the Construction and BIM blog, 访问时间为 八月 11, 2025， [https://beyonddesign.typepad.com/posts/2011/09/linking-animations-to-timeliner-tasks.html](https://beyonddesign.typepad.com/posts/2011/09/linking-animations-to-timeliner-tasks.html) -50. Animating Object Doors in Navisworks: A Step-By-Step Guide | VDCI.edu, 访问时间为 八月 11, 2025， [https://vdci.edu/learn/cad/animating-object-doors-in-navisworks](https://vdci.edu/learn/cad/animating-object-doors-in-navisworks) -51. How to Use Animation in Navisworks — Part 1 \- YouTube, 访问时间为 八月 11, 2025， [https://www.youtube.com/watch?v=69Dygkw6KcA](https://www.youtube.com/watch?v=69Dygkw6KcA) -52. Transform Object with a Series of Moves \- AEC DevBlog \- TypePad, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/2014/08/transform-object-with-a-series-of-moves.html](https://adndevblog.typepad.com/aec/2014/08/transform-object-with-a-series-of-moves.html) -53. Navisworks · SavedViewpointAnimation Class \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2017/T\_Autodesk\_Navisworks\_Api\_SavedViewpointAnimation.htm](https://apidocs.co/apps/navisworks/2017/T_Autodesk_Navisworks_Api_SavedViewpointAnimation.htm) -54. Can naviswork Api work with animator? \- Autodesk Community, 访问时间为 八月 11, 2025， [https://forums.autodesk.com/t5/navisworks-api/can-naviswork-api-work-with-animator/td-p/3414831](https://forums.autodesk.com/t5/navisworks-api/can-naviswork-api-work-with-animator/td-p/3414831) -55. Navisworks Tutorial \- Creating a script \- YouTube, 访问时间为 八月 11, 2025， [https://www.youtube.com/watch?v=NS--XTcMLSE](https://www.youtube.com/watch?v=NS--XTcMLSE) -56. Alias 2026 Help | Set Motion Path | Autodesk, 访问时间为 八月 11, 2025， [https://help.autodesk.com/view/ALIAS/2026/ENU/?guid=Alias\_Animation\_Animation\_menu\_Set\_Motion\_Path\_html](https://help.autodesk.com/view/ALIAS/2026/ENU/?guid=Alias_Animation_Animation_menu_Set_Motion_Path_html) -57. Alias 2026 Help | Create motion path animation | Autodesk, 访问时间为 八月 11, 2025， [https://help.autodesk.com/cloudhelp/2026/ENU/Alias-Video-Tutorials/files/animation/create-motion-path-animation.html](https://help.autodesk.com/cloudhelp/2026/ENU/Alias-Video-Tutorials/files/animation/create-motion-path-animation.html) -58. Autodesk Navisworks Manage 2026 | Autodesk Accessibility Conformance Report International Edition, 访问时间为 八月 11, 2025， [https://damassets.autodesk.net/content/dam/autodesk/www/migration/government/2026/vpat-autodesk-navisworks-manage-2026.pdf](https://damassets.autodesk.net/content/dam/autodesk/www/migration/government/2026/vpat-autodesk-navisworks-manage-2026.pdf) -59. Navisworks · Model.Guid Property \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2018/P\_Autodesk\_Navisworks\_Api\_Model\_Guid.htm](https://apidocs.co/apps/navisworks/2018/P_Autodesk_Navisworks_Api_Model_Guid.htm) -60. Navisworks \- Interface Solutions \- UNITEC Informationssysteme GmbH, 访问时间为 八月 11, 2025， [https://unitec.de/en/solutions/navisworks-interfaces](https://unitec.de/en/solutions/navisworks-interfaces) -61. Supported CAD files \- Visual Components, 访问时间为 八月 11, 2025， [https://www.visualcomponents.com/supported-cad-files/](https://www.visualcomponents.com/supported-cad-files/) -62. Navisworks · Document.ExportAsDwf Method \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2018/M\_Autodesk\_Navisworks\_Api\_Document\_ExportAsDwf\_1\_bb3a7a4f.htm](https://apidocs.co/apps/navisworks/2018/M_Autodesk_Navisworks_Api_Document_ExportAsDwf_1_bb3a7a4f.htm) -63. Dassault Systemes Delivers 3D XML Specifications and Player, 访问时间为 八月 11, 2025， [https://www.3ds.com/newsroom/press-releases/dassault-systemes-delivers-3d-xml-specifications-and-player](https://www.3ds.com/newsroom/press-releases/dassault-systemes-delivers-3d-xml-specifications-and-player) -64. How do you create thread standards using an XML file? \- TECHNIA, 访问时间为 八月 11, 2025， [https://www.technia.com/en/faqs/how-do-you-create-thread-standards-using-an-xml-file/](https://www.technia.com/en/faqs/how-do-you-create-thread-standards-using-an-xml-file/) -65. Exporting/Importing Tracks in Neutral Format, 访问时间为 八月 11, 2025， [http://www.maruf.ca/files/catiahelp/fitug\_C2/fitugbt0506.htm](http://www.maruf.ca/files/catiahelp/fitug_C2/fitugbt0506.htm) -66. DELMIAWorks | Dassault Systèmes, 访问时间为 八月 11, 2025， [https://www.3ds.com/products/delmia/delmiaworks](https://www.3ds.com/products/delmia/delmiaworks) -67. Explore DELMIA Digital Manufacturing Solutions \- Vias3D, 访问时间为 八月 11, 2025， [https://vias3d.com/delmia/](https://vias3d.com/delmia/) -68. DELMIA Robotics Simulation, Design and Programming Software | Dassault Systèmes, 访问时间为 八月 11, 2025， [https://www.3ds.com/products/delmia/industrial-engineering/robotics](https://www.3ds.com/products/delmia/industrial-engineering/robotics) -69. 3DEXPERIENCE DELMIA Factory Simulation – 3D Virtual Twin \- Hawk Ridge Systems, 访问时间为 八月 11, 2025， [https://hawkridgesys.com/3dexperience-delmia-factory-simulation](https://hawkridgesys.com/3dexperience-delmia-factory-simulation) -70. help.solidworks.com, 访问时间为 八月 11, 2025， [https://help.solidworks.com/2024/English/DraftSight/DraftSightSW/c\_import\_part\_contours.htm\#:\~:text=The%20Import%20Delmia%20command%20lets,CNC)%20machine%20for%20cutting%20purposes.](https://help.solidworks.com/2024/English/DraftSight/DraftSightSW/c_import_part_contours.htm#:~:text=The%20Import%20Delmia%20command%20lets,CNC\)%20machine%20for%20cutting%20purposes.) -71. DELMIA D5 \- CATIADOC, 访问时间为 八月 11, 2025， [http://catiadoc.free.fr/online/bascuddl\_C2/bascuddl0100.htm](http://catiadoc.free.fr/online/bascuddl_C2/bascuddl0100.htm) -72. Additive Manufacturing Software & 3D Printing | DELMIA \- Dassault Systèmes, 访问时间为 八月 11, 2025， [https://www.3ds.com/products/delmia/industrial-engineering/additive-manufacturing](https://www.3ds.com/products/delmia/industrial-engineering/additive-manufacturing) -73. DELMIA Robotics \- Portfolio \- 3DEXPEREINCE \- V21 | PDF \- Scribd, 访问时间为 八月 11, 2025， [https://www.scribd.com/presentation/891392847/DELMIA-Robotics-Portfolio-3DEXPEREINCE-V21](https://www.scribd.com/presentation/891392847/DELMIA-Robotics-Portfolio-3DEXPEREINCE-V21) -74. DELMIA Robotics 2 (WL2) : CSM Object Modeler (CSM) | PDF | Machines | Simulation, 访问时间为 八月 11, 2025， [https://www.scribd.com/document/561011260/WL2](https://www.scribd.com/document/561011260/WL2) -75. Navisworks Best Practices & Advanced Techniques in 2025 \- Novatr, 访问时间为 八月 11, 2025， [https://www.novatr.com/blog/navisworks-best-practices](https://www.novatr.com/blog/navisworks-best-practices) \ No newline at end of file diff --git a/doc/design/2026/Navisworks自动路径规划实现方案_.md b/doc/design/2026/Navisworks自动路径规划实现方案_.md deleted file mode 100644 index a36b8d1..0000000 --- a/doc/design/2026/Navisworks自动路径规划实现方案_.md +++ /dev/null @@ -1,520 +0,0 @@ - - -# **自动化路径规划实现方案：基于Navisworks的物流组件模拟与可视化** - -## **执行摘要** - -本报告详细阐述了一种全面的自动化路径规划与物流模拟解决方案，该方案充分利用了Autodesk Navisworks强大的API，以实现高级BIM模型分析与可视化。所提出的插件将高效的数据提取、复杂的空间简化技术（如体素化、导航网格和路点图）、以及先进的路径搜索算法（如A\*和多启发式A\*（MHA\*））相结合。其核心创新在于设计定制化的成本函数，这些函数能够整合物流相关的预设属性（例如通行性、速度限制和宽度限制）以及实时数据。该解决方案进一步涵盖了物流组件沿计算路径的程序化动画控制、基于Navisworks碰撞检测功能的实时碰撞检测，以及最优路径的直观三维可视化。本系统旨在通过提供一个强大的、数据驱动的平台来模拟复杂的运营场景，从而显著提升建筑和设施管理中的项目效率、安全性和决策水平。 - -## **1\. 引言：BIM中自动化路径规划的必要性** - -### **1.1. BIM在物流与施工管理中的演进** - -建筑信息模型（BIM）通过提供设施物理和功能特性的三维数字表示，彻底改变了建筑、工程和施工（AEC）行业。它已成为各类应用（包括施工机器人和进度监控）时空和语义信息的丰富来源 1。BIM能够创建虚拟模型并将来自不同软件（如Revit、AutoCAD和Inventor）的数据整合到一个协调统一的环境中，这对于增强协调性、沟通效率以及缩短项目工期和降低成本至关重要 5。 - -BIM模型蕴含着海量数据，能够提供全面的建筑布局信息、内部结构和门窗位置等细节 1。这种“数字孪生”的概念正日益受到关注，它旨在创建一个与物理世界实时同步的虚拟副本，从而在设计和运营阶段提供更深层次的洞察 2。然而，BIM本质上是一种静态的“设计”表示 13，而现实世界的施工现场是动态变化的，存在临时障碍物和移动物体 13。这种静态模型与动态现实之间的差距，凸显了在物流和施工管理中进行动态模拟和路径规划的迫切需求，以弥合“设计”与“建造”之间的差异 3。 - -### **1.2. 自动化路径规划对效率和安全的战略价值** - -自动化路径规划使自主车辆和机器人能够找到从起始配置到目标配置的最优、无障碍路径，从而最大限度地降低运输成本（包括时间、距离、风险和燃料消耗）14。这对于物流、机器人技术和建筑行业至关重要，通过避免碰撞和优化资源部署，可以提高生产力并增强安全性 1。 - -在复杂的3D环境中进行手动路径规划是不可行的 15。自动化路径规划对于自主系统至关重要 14，它能够优化物流、减少燃料消耗并确保及时交付 15。在建筑领域，它能够使多台机器同时工作而避免冲突，从而提高生产力 4。将自动化路径规划与BIM集成，可以利用语义信息实现“更智能、更安全、更精确的机器人导航” 18。安全性是主要驱动因素，因为碰撞会导致高昂的成本和延误 19。通过将静态BIM数据转化为动态操作的可行智能，自动化路径规划直接解决了复杂环境中的物流和安全核心挑战。 - -### **1.3. Navisworks在模拟方面的能力和可扩展性概述** - -Navisworks是一款全面的项目审查软件，支持三维协调、四维规划、照片级真实感可视化、动态模拟和精确分析 22。它能够整合来自各种CAD软件（如AutoCAD、Revit和Inventor）的模型，并支持多种文件格式 22。其.NET API允许开发定制插件、实现自动化和嵌入控件，从而使开发人员能够扩展其功能。 - -Navisworks旨在审查和协调来自多个专业的大型三维模型 10。它内置了碰撞检测（Clash Detective）、时间线（TimeLiner）和动画（Animator）等专业工具 26。其.NET API是实现定制化的主要接口，支持多种插件类型，包括用于简单命令的 - -AddInPlugin、用于自定义Ribbon界面的CommandHandlerPlugin、用于自定义可停靠窗口的DockPanePlugin、用于处理鼠标和键盘事件的InputPlugin、以及用于自定义图形和工具行为的RenderPlugin和ToolPlugin 27。这种可扩展性是构建定制路径规划解决方案的关键。Navisworks凭借其处理大型联邦模型的能力和可扩展的API，成为开发高级模拟和路径规划解决方案的理想平台。 - -### **1.4. 报告结构和核心目标** - -本报告将概述其组织结构，引导读者深入了解数据提取、空间简化、算法选择、动画、可视化以及未来的发展方向。 - -## **2\. Navisworks模型数据提取用于空间智能** - -高效地从大型Navisworks模型中提取相关的几何和语义信息是自动化路径规划的基础步骤。这需要深入理解Navisworks.NET API以及优化数据访问的策略。 - -### **2.1. Navisworks.NET API：架构与数据访问最佳实践** - -Navisworks API交互的核心围绕着Application、Document、Model和ModelItem这些基本对象。Application对象提供对活动Document的访问。一个Document可以包含多个Model，每个Model代表一个加载的文件。ModelItem是模型中对象的层次化表示，可以通过Model.RootItem及其Children或Descendants属性进行访问 32。 - -对于ModelItem的查询，Navisworks提供了迭代、Search API和LINQ三种机制 38。 - -Search API通常是根据属性查找项目最快的方法，因为它在原生代码中执行，类似于Navisworks GUI中的“查找项目”功能 38。LINQ虽然表达力强，但由于频繁在托管代码和原生代码之间切换，效率最低 38。因此，在进行大规模筛选时，应优先使用 - -Search API。 - -在程序化修改模型或其属性时，使用NavisworksTransaction（或COM API中的state.BeginEdit/EndEdit）对于性能至关重要。事务能够将多个操作打包，延迟内部通知和撤销信息，从而显著加快批量更改的速度 22。 - -Navisworks支持多种插件类型，包括用于简单命令的AddInPlugin、用于自定义Ribbon界面的CommandHandlerPlugin、用于自定义可停靠窗口的DockPanePlugin、用于处理鼠标和键盘事件的InputPlugin、以及用于自定义图形和工具行为的RenderPlugin/ToolPlugin 27。插件类型的选择取决于所需的用户交互和后台处理。 - -Navisworks API的复杂性（COM与.NET的混合使用、多种插件类型、性能考量）意味着一个健壮的解决方案需要仔细的架构规划，以平衡功能性、性能和可维护性。API的混合性质（例如，COM用于几何图元提取，.NET用于高级操作）表明需要互操作性策略。Navisworks API同时提供.NET和COM接口 22。尽管.NET是新开发的首选，但某些关键功能（如详细几何图元提取，通过 - -InwSimplePrimitivesCB接口实现）仍主要通过COM API暴露，这需要使用COM互操作 44。这种互操作可能会由于托管代码和非托管代码之间的数据封送而引入性能开销 38。因此，需要采取一种细致的策略：首先使用更快的.NET - -Search API进行ModelItem的初步筛选 38，然后有选择地使用COM互操作进行缩减后的项目集合的几何提取。对模型或其属性的任何修改都应封装在 - -NavisworksTransaction块中，以通过减少UI刷新和捆绑撤销操作来优化性能 22。插件类型的选择（例如， - -DockPanePlugin用于复杂UI，AddInPlugin用于简单执行）30也会影响整体应用程序架构和响应能力。对于诸如图生成等计算密集型任务，将核心计算与UI线程分离至关重要，尽管Navisworks通常不支持从后台线程直接调用API 49，这意味着需要仔细的同步或外部进程通信。 - -### **2.2. 几何信息的高效提取** - -ModelItem.Geometry属性提供了对项目几何表示的访问 36。为了提取详细的图元（顶点、三角形、线），通常需要实现COM API的 - -InwSimplePrimitivesCB接口并将其传递给frag.GenerateSimplePrimitives()方法 44。这种回调机制允许处理单个几何组件。返回的坐标位于局部坐标系（LCS）中，必须使用 - -GetLocalToWorldMatrix()转换为世界坐标系（WCS）45。 - -ModelItem.BoundingBox()方法返回项目及其子项在世界空间中的轴对齐三维包围盒（BoundingBox3D）56。这提供了一种快速、粗略的对象空间范围表示，可用于初步的交叉检查 56和空间分区算法。 - -对于非常大的模型，提取所有原始几何体可能会成为性能瓶颈 27。诸如细节级别（LOD）或顶点简化等策略对于在进一步处理之前简化几何数据至关重要 10。虽然Navisworks具有内部机制来实现这一点，但API可能需要自定义实现或利用外部库进行显式控制。 - -从Navisworks中提取的原始几何数据通常过于密集，无法进行高效的路径规划。关键在于在提取过程中或提取后立即应用简化技术，以创建计算上可管理、同时平衡精度和性能的表示。对COM API的依赖（用于详细几何图元）意味着需要强大的互操作包装器。Navisworks模型，特别是大型模型，可能包含数百万个几何图元 27。直接处理所有这些数据进行路径规划是不切实际的，因为它会带来巨大的计算成本和内存消耗 66。 - -ModelItem.Geometry属性是访问几何数据的入口点 36，但要获取实际的顶点和三角形，必须使用COM API的 - -InwSimplePrimitivesCB回调函数 44。对于大型模型，这个过程可能会很慢 27。因此，在生成导航图之前，实施细节层次（LOD）或顶点简化 10等数据缩减策略至关重要。包围盒（ - -BoundingBox3D）56提供了一种轻量级的方法来执行初步的空间查询和粗略的碰撞检测，这可以显著减少所需的详细几何提取数量。 - -### **2.3. 语义数据采集：自定义属性和特性** - -Navisworks允许用户向ModelItem添加自定义属性 68。这些属性组织在 - -PropertyCategory下，并包含DataProperty对象。属性可以通过显示名称或内部名称进行访问。 - -自定义属性，如“通道”、“门”和“电梯”，是至关重要的语义输入。这些属性可以映射到路径规划的属性，例如通行性（例如，墙壁不可通行，门在打开时可通行）、速度限制（例如，通道允许高速，门需要减速）或宽度/高度限制。BIM模型提供了丰富的文本信息，可以通过自然语言处理（NLP）进行处理，以增强路径规划 18。 - -路径规划解决方案的真正智能源于集成语义信息，而不仅仅是原始几何数据。在基本几何碰撞检测中经常被忽视的自定义BIM属性，成为将通用路径规划问题转化为上下文感知物流优化挑战的关键“元数据”。这需要一个健壮的自定义属性数据模式。虽然几何定义了物理空间，但语义信息定义了该空间的含义及其组成部分。Navisworks允许定义和访问自定义属性 68。这些属性可以对元素进行分类（例如，“通道”作为可通行路径，“门”作为条件通行点，“电梯”作为垂直运输节点）。然后，这些语义数据用于在导航图中分配成本或约束。例如，一扇“门”可能具有“可开启”或“宽度”属性，这直接影响路径规划决策。能够读取 - -ModelItem的所有属性对于此功能至关重要。Search API可以根据这些自定义属性筛选项目，从而高效地收集相关语义数据 38。正是这个语义层，将简单的最短路径与 - -*最优物流路径*区分开来。 - -### **表2.1：Navisworks API模型数据提取的关键接口** - -| 类名 | 主要方法/属性 | 用途 | 性能说明 | -| :---- | :---- | :---- | :---- | -| Application | ActiveDocument | 提供对当前活动Navisworks文档的访问。 | 应用程序的入口点。 | -| Document | Models, CurrentSelection, GetClash() | 管理加载的模型、当前选择和碰撞检测功能。 | GetClash()用于访问碰撞检测数据。 | -| Model | RootItem, Children, Descendants | 表示加载到文档中的单个模型文件，提供对模型项层次结构的访问。 | RootItem是模型层次结构的根节点。 | -| ModelItem | Geometry, BoundingBox(), PropertyCategories, FindFirstGeometry() | 表示模型层次结构中的单个项目，对应于选择树中的元素。 | Geometry属性提供几何访问，BoundingBox()用于获取空间范围。 | -| ModelGeometry | PrimitiveTypes, IsSolid | 表示模型中的几何体。 | PrimitiveTypes指示几何体类型（三角形、线等）。 | -| PropertyCategory | DisplayName, Name, Properties | 表示模型项的属性类别（例如，“项目”、“实体句柄”、“自定义”）。 | 可通过显示名称或内部名称查找。 | -| DataProperty | DisplayName, Name, Value, DataType | 表示属性类别中的单个属性及其值。 | Value可以是字符串、数字、日期等。 | -| Search | Selection, SearchConditions, FindAll() | 用于根据指定条件查找ModelItem。 | FindAll()在原生代码中执行，比LINQ快，适用于大规模筛选 38。 | -| BoundingBox3D | Min, Max, Center, Intersects() | 表示三维空间中的轴对齐包围盒。 | 用于快速、粗略的空间查询和碰撞预检查 56。 | -| InwSimplePrimitivesCB (COM) | Line(), Point(), Triangle() | 回调接口，用于从几何体中提取原始图元（顶点、线、三角形）。 | 需通过COM互操作访问，返回LCS坐标，需转换为WCS 44。 | -| ComBridge (COM Interop) | State, ToInwOaPath() | .NET与COM API之间的桥接，用于访问COM对象。 | 允许在.NET插件中利用COM特有功能。 | - -## **3\. 空间简化与导航图生成** - -### **3.1. 复杂三维BIM环境中的路径规划挑战** - -BIM模型虽然数据丰富，但由于其几何复杂性和潜在的不准确性，并不直接适用于路径规划。对大型模型进行路径规划面临多重挑战，包括复杂的几何结构、狭窄的通道和多层建筑布局 66。直接在原始网格数据上执行路径搜索计算成本极高，甚至可能导致内存溢出 66。 - -机器人路径规划的核心概念是配置空间（C-space）66。C-space表示机器人所有可能的位姿（位置和方向）集合，并将机器人视为一个点，将障碍物膨胀为在C-space中的对应区域。这种抽象使得碰撞检测问题简化为C-space中一个点与膨胀障碍物之间的交叉检查。然而，显式计算C-space的精确形状通常非常困难，因此通常采用采样或离散化的方法。 - -此外，BIM模型通常反映的是“设计”状态，与实际施工现场的“建成”状态可能存在差异 13。这种差异可能导致模型中的路径在现实中无法通行，或者出现未建模的临时障碍物。因此，路径规划算法需要具备一定的鲁棒性，能够处理环境不确定性，或者需要与实时传感器数据结合以进行动态调整。 - -鉴于这些挑战，对原始BIM模型进行空间简化，并将其转化为适用于路径规划的导航图（Navigation Graph）是必不可少的步骤。这种简化不仅提高了计算效率，还使得路径规划算法能够更有效地抽象和分析环境。 - -### **3.2. 导航图创建的算法设计** - -为了将大型模型中复杂的几何空间简化为可用于路径规划的导航图，可以采用多种算法，每种算法都有其优点和适用场景。 - -#### **3.2.1. 基于体素化的方法** - -体素化是将三维模型离散化为一系列规则网格单元（体素）的过程，每个体素被标记为可通行或不可通行 13。这种方法能够提供统一的空间表示，简化碰撞检测。 - -为了提高效率和降低内存占用，可以采用高效的体素化技术，例如使用内存高效的游程编码（run-length encoding）来存储体素数据，并采用自适应体素尺寸 82。自适应体素化允许在不同区域使用不同大小的体素，例如在开放空间使用大体素，在狭窄区域使用小体素，从而平衡细节和性能。 - -在体素化过程中，必须考虑物流组件（例如叉车、机器人）的实际尺寸（高度和宽度）81。通过“膨胀”障碍物，即在障碍物周围增加一个缓冲区，可以确保计算出的路径能够容纳组件的物理尺寸。例如，对于桌子下方或狭小空间，障碍物表面可以向下扩展；对于狭窄的间隙，障碍物可以水平扩展以防止组件通过 82。此外，为了允许组件在楼梯、坡道等垂直结构上移动，可以先将实体障碍物在Z轴正方向上减小一个体素，再创建“虚拟障碍物”以防止在不应通行区域（如过陡的坡度或横梁上方）行驶 82。 - -体素化提供了一种鲁棒的方式来表示三维空间，尤其适用于复杂、杂乱的环境以及处理组件尺寸。然而，其缺点是可能产生“不自然”的路径，如果不对路径进行平滑处理，并且可能占用大量内存。自适应体素化是平衡细节和性能的关键技术。 - -#### **3.2.2. 导航网格（NavMesh）生成** - -导航网格（NavMesh）是一种将可步行区域表示为一组凸多边形（通常是三角形）的抽象数据结构 86。在单个凸多边形内部，路径规划可以简单地通过直线完成。在多边形之间，则通过图搜索算法（如A\*）进行路径查找 87。这种方法在开放空间中比密集体素网格更高效，因为它只表示可通行区域，而不是整个空间。 - -NavMesh的生成可以采用多种算法，包括Delaunay三角剖分和基于增长的方法 80。Delaunay三角剖分通过连接顶点生成一系列三角形，以最大化平均最小内角，从而提供良好的覆盖范围 90。基于增长的方法则通过在空间中“播种”几何体，然后让其扩展直到遇到障碍物，再将接触的几何体连接起来形成NavMesh 90。 - -NavMesh在处理多层结构（如楼梯、坡道和电梯）时面临挑战 87。通常需要额外的连接信息来表示这些垂直过渡。NavMesh通常是静态的 87，这意味着对于动态环境，可能需要重新生成或采用混合方法来适应变化。NavMeshes能够提供更接近人类直觉的路径表示，并且在开放区域通常比密集体素网格更节省内存。然而，从复杂的BIM几何体中精确生成NavMesh以及处理垂直过渡是其主要挑战。 - -#### **3.2.3. 路点图（Waypoint Graph）构建** - -路点图通过在环境中的关键位置（如门口、交叉口、开放空间）放置节点（路点），并根据这些路点之间的视线可达性建立连接（边）来构建 78。如果两个路点之间可以画出一条不与任何障碍物相交的直线，则认为它们之间存在有效连接 78。 - -由于连接所有可能的路点（$O(n^2)$复杂度）计算成本很高，因此可以利用空间分区数据结构（如八叉树或四叉树）来提高效率 78。这些数据结构能够快速识别出与潜在连接相关的障碍物，从而高效地执行线-三角形交叉测试。此外，稀疏化技术可以进一步降低内存使用和遍历成本。例如，如果一个新连接与现有连接方向相似，则只保留成本较低（距离最短）的连接 78。 - -路点图的优点是简单灵活，尤其适用于大型稀疏环境。路径的质量在很大程度上取决于路点的智能放置以及高效的视线检查，这可以通过空间数据结构和GPU加速来完成。 - -### **3.3. 插件实现策略用于图生成** - -在Navisworks中实现导航图生成功能，需要选择合适的插件类型并有效管理计算负载。 - -Navisworks插件可以是简单的AddInPlugin，也可以是具有自定义用户界面的DockPanePlugin 30。对于涉及复杂用户交互和显示图生成参数的场景， - -DockPanePlugin通常是更合适的选择，因为它允许创建自定义的可停靠窗口，提供更丰富的用户体验。 - -图生成，尤其是对于大型BIM模型，可能是一个耗时的计算过程 10。为了避免Navisworks主界面的冻结，保持用户界面的响应性，将图生成的核心计算任务卸载到后台线程或外部进程至关重要。然而，需要注意的是，Navisworks API通常不支持从非主线程直接进行模型操作 49。这意味着，如果核心计算在后台线程进行，其结果必须通过适当的同步机制（例如，使用 - -Application.Invoke或事件回调）传递回主UI线程，以便在Navisworks模型中进行更新或可视化。或者，可以将计算密集型任务完全封装在独立的外部进程中，并通过进程间通信（IPC）将结果传递给Navisworks插件。这种分离计算的方法能够有效利用多核处理器资源，并确保Navisworks应用程序的流畅运行。 - -## **4\. 最优路径搜索算法与约束集成** - -### **4.1. 路径搜索算法的选择：A\* vs. Dijkstra** - -路径搜索算法是自动化路径规划的核心。A\*和Dijkstra是两种广泛使用的算法，它们在寻路领域各有优劣。 - -Dijkstra算法是一种单源最短路径算法，它能够找到从起始节点到图中所有其他节点的最短路径 15。它通过迭代地选择距离源节点最近的未访问节点来扩展搜索范围，并更新其邻居的距离值。Dijkstra算法在边权重非负的情况下，能够保证找到最优路径 99。其搜索过程是均匀向外扩散的，类似于广度优先搜索。 - -A\*算法是一种启发式搜索算法，它结合了Dijkstra算法的优点和启发式函数（heuristic function）来提高效率 15。启发式函数 - -h(n)估计从当前节点n到目标节点的成本，从而引导搜索向目标方向进行。A\*算法的评估函数f(n) \= g(n) \+ h(n)，其中g(n)是从起始节点到当前节点n的实际成本。如果启发式函数是可采纳的（admissible），即它从不高估到达目标的实际成本，那么A\*算法能够保证找到最优路径 101。当启发式函数为零时，A\*算法等同于Dijkstra算法 101。 - -对于大型导航图，A\*算法通常是首选，因为其启发式函数能够显著剪枝搜索空间，从而在保证最优性的前提下，实现更快的搜索速度 99。Dijkstra算法虽然也能找到最短路径，但它会探索所有可能的路径，对于大型图而言效率较低。因此，对于BIM环境中的物流路径规划，A\*算法因其效率和最优性保证而成为更合适的选择。 - -### **4.2. 定制成本函数用于物流优化** - -路径规划的真正价值在于能够根据实际物流运营参数定制成本函数。这使得路径规划超越了简单的最短距离计算，能够生成考虑时间、安全和移动物体物理限制的“最优”路径。 - -* **通行性（Passability）**：环境中不可通行的区域（如墙壁、固定设备或结构件）应被赋予极高的成本（通常视为无限大），以确保路径规划算法完全避开这些区域 15。在导航图构建阶段，这些区域的节点或边可以直接从图中移除，或者在成本函数中体现为不可逾越的障碍。 -* **速度限制（Speed Limits）**：不同的区域或路径段可能具有不同的速度限制，这直接影响通过该区域所需的时间。例如，在宽敞的“通道”中，物流组件可以高速移动，对应的边成本较低；而在“门”口或狭窄区域，速度需要降低，相应的边成本会增加 111。这些速度限制可以根据BIM模型中的语义属性（例如，房间类型、通道宽度）进行预设，也可以根据实时交通状况或安全警报进行动态调整。在成本函数中，可以将时间作为成本度量，即成本 \= 距离 / 速度。 -* **宽度/高度限制（Width/Height Constraints）**：物流组件（如叉车、起重机）具有特定的物理尺寸。路径规划必须确保所选路径能够容纳组件的宽度和高度，避免其在狭窄或低矮区域卡住或碰撞 108。这些限制通常在导航图生成阶段（如体素化或NavMesh烘焙）通过膨胀障碍物或裁剪不可通行区域来处理。但在路径搜索阶段，也可以通过为不满足尺寸要求的路径段赋予惩罚性成本，或直接将其从可行路径中排除。 -* **实时数据动态调整成本**：为了应对施工现场的动态性，路径成本函数应能够根据实时数据进行动态调整 18。例如，如果某个区域因临时施工活动而变得拥堵或危险，其对应的路径成本可以临时增加，从而引导物流组件避开该区域。BIM模型中的语义信息（如“危险区域”属性）可以与实时传感器数据（如RFID、摄像头）结合，动态调整路径成本，以优先考虑安全而非最短距离 18。 - -通过定制成本函数，路径规划系统能够生成真正意义上的“最优”物流路径，这些路径不仅考虑了距离，还综合了时间、安全、通行性以及组件的物理限制等多种因素。 - -### **4.3. 多启发式A\* (MHA\*) 实现鲁棒性和适应性** - -对于像施工现场这样复杂且动态的环境，单一的启发式函数可能不足以应对所有情况。多启发式A\* (MHA\*) 算法提供了一种更鲁棒的解决方案，它通过结合多种启发式函数来平衡全局效率和局部适应性。 - -MHA\*算法允许集成不同的启发式函数。例如，可以结合欧几里得距离作为可采纳启发式函数（确保路径的最优性），以及由人工势场（Artificial Potential Fields, APF）生成的、可能不可采纳的启发式函数 13。APF通过在障碍物周围创建排斥力场并在目标点创建吸引力场来引导路径，从而实现局部避障和安全裕度 75。 - -BIM模型中嵌入的文本信息（例如，特定区域或对象被标记为“危险区域”）可以通过自然语言处理（NLP）进行分析，并用于动态调整APF的强度和范围 18。例如，如果某个区域被语义标记为高风险，其排斥势场会增强，从而在路径规划中优先避开该区域，即使这可能导致路径稍微变长。这种方法使得路径规划能够感知上下文，并根据环境的动态变化和风险水平进行自适应调整，从而提高了机器人在复杂环境中的安全性和可信度 18。 - -### **表4.1：A\*与Dijkstra在BIM路径规划中的比较分析** - -| 特征 | Dijkstra算法 | A\*算法 | -| :---- | :---- | :---- | -| **算法类型** | 无信息搜索（Uninformed Search）/贪婪算法 16 | 有信息搜索（Informed Search）/最佳优先搜索 15 | -| **启发式函数使用** | 无 16 | 使用启发式函数h(n)估计从当前节点到目标的成本 99 | -| **最优性保证** | 保证找到最短路径（前提是边权重非负）99 | 如果启发式函数可采纳（从不高估实际成本），则保证找到最短路径 101 | -| **效率/复杂度** | 对于邻接矩阵表示为O(V2)，使用优先队列可达O((V+E)logV) 100。搜索均匀扩散 99。 | 最坏情况下与Dijkstra相似，但通过良好启发式函数可显著提高效率，剪枝搜索空间 99。搜索有方向性 99。 | -| **典型应用场景** | 网络路由协议，查找所有节点的最短路径 16。 | 导航系统、游戏AI寻路、机器人路径规划 15。 | -| **BIM/物流应用中的优势** | 适用于需要探索所有可行路径的场景，或当缺乏有效启发式函数时。 | 更适合大型BIM模型中的目标导向路径规划，通过启发式函数显著加速搜索，同时保证最优性 106。 | - -### **表4.2：定制成本函数参数及其对路径优化的影响** - -| 参数 | 数据来源 | 成本调整逻辑 | 对路径的影响 | -| :---- | :---- | :---- | :---- | -| **通行性** | BIM几何体（墙壁、固定设备）、自定义属性（例如，“不可通行区域”）78 | 对不可通行区域的边赋予无限大成本。 | 确保路径避开物理障碍物。 | -| **速度限制** | 自定义属性（例如，“通道”、“门”的速度限制）、实时交通数据 111 | 将时间作为成本度量，即成本 \= 距离 / 速度。速度越低，成本越高。 | 引导路径通过更快的区域，或在需要时减速。 | -| **宽度/高度限制** | BIM几何体（狭窄通道、低矮空间）、组件物理尺寸、自定义属性 108 | 在图生成阶段（体素膨胀、NavMesh烘焙）排除不可通行区域；或对不满足尺寸要求的边赋予惩罚性成本。 | 确保路径能够容纳物流组件的物理尺寸，避免卡滞或碰撞。 | -| **安全区域/危险区域** | 自定义属性（例如，“危险区域”）、实时传感器数据、NLP分析BIM文本信息 18 | 引入人工势场（APF），对危险区域的边赋予额外惩罚性成本，该成本可根据风险等级动态调整。 | 引导路径避开危险区域，优先考虑安全性。 | -| **坡度/高差** | BIM地形数据、结构几何体 82 | 对上坡或下坡（取决于组件类型）赋予更高成本，或限制最大坡度。 | 引导路径选择更平缓的坡度，优化组件的移动效率。 | -| **路径平滑度** | 路径转弯次数、急转弯角度 85 | 对频繁或急剧的转弯赋予额外成本。 | 生成更平滑、更自然的路径，减少组件的机械磨损和能量消耗。 | - -## **5\. 物流组件动画与实时碰撞检测** - -### **5.1. 物流组件沿计算路径的动画** - -在Navisworks视口中对物流组件进行动画，需要将计算出的路径数据（一系列三维点）转化为模型项的变换（位置和旋转）26。Navisworks API提供了对 - -ModelItem变换的程序化控制，包括位置（Position）和旋转（Rotation）26。 - -路径规划算法通常输出一系列离散的三维路点。为了实现平滑的动画效果，这些离散点需要通过插值生成连续的运动轨迹。例如，可以使用样条曲线（如Catmull-Rom样条）来平滑连接路点，从而生成更自然的运动路径 123。然后，可以将这些轨迹点转化为 - -ModelItem的变换关键帧。Navisworks内置的Animator工具支持基于关键帧的动画 26。虽然 - -SavedViewpointAnimation主要用于视点动画，但其通过关键帧插值实现平滑过渡的原理，同样适用于物体动画。 - -实现动画的关键在于将计算出的路径点序列转化为Navisworks可识别和执行的变换序列。这可以通过在每个时间步更新ModelItem的Transform属性来实现。为了确保动画的真实感，动画的播放速度应与路径规划中计算出的行进时间同步，即考虑了速度限制和障碍物影响后的实际行进时间。 - -### **5.2. 动画过程中的实时碰撞检测** - -在物流模拟中，实时碰撞检测对于确保操作安全和效率至关重要。Navisworks的碰撞检测（Clash Detective）功能可以与动画相结合，实现对移动物体之间或移动物体与静态环境之间冲突的自动检查 26。 - -Navisworks的Clash Detective是一个强大的冲突检测工具 6，可以通过API进行程序化访问和控制 27。通过将动画场景与碰撞检测测试关联起来，可以实现基于时间的碰撞检查。这意味着Navisworks可以在动画播放的特定时间步（例如，每0.1秒）自动运行碰撞测试，以检测移动组件与环境或其他移动组件之间的任何干涉 26。 - -需要区分离散碰撞检测和连续碰撞检测 141。Navisworks内置的碰撞检测通常是离散的，即在动画的预设时间间隔内进行检查。对于慢速移动的物体，这种离散检查通常足够；但对于高速移动的物体，可能会出现“穿透”现象，即物体在两个检查帧之间穿过障碍物而未被检测到 142。在这种情况下，可能需要更复杂的连续碰撞检测算法，或者增加碰撞检测的频率（即减小时间步长）142。 - -一旦检测到碰撞，系统应立即采取响应策略，例如： - -* **暂停动画**：在碰撞发生时立即停止动画播放，以便用户检查和分析冲突 26。 -* **高亮显示冲突对象**：通过改变冲突对象的颜色或透明度，使其在视口中突出显示 38。 -* **触发警报**：向用户发出视觉或听觉警报，指示碰撞的发生。 -* **重新规划路径**：在某些情况下，如果碰撞是可避免的，系统可以触发路径的重新计算，以寻找一条新的无冲突路径 26。 - -### **表5.1：Navisworks API动画与碰撞检测类** - -| 类名 | 主要方法/属性 | 用途 | -| :---- | :---- | :---- | -| ModelItem | OverridePermanentTransform(), Position, Rotation | 表示模型中的单个项目，可对其进行位置和旋转变换以实现动画。OverridePermanentTransform用于程序化控制物体移动 26。 | -| Transform3D | Translation, Rotation, Scale | 表示三维变换，包含平移、旋转和缩放分量。用于定义ModelItem的动画状态。 | -| Animator (概念性) | Create Object Animations, Add Interactivity | Navisworks内置的动画工具，用于创建关键帧动画和交互脚本。API可与其功能进行概念性集成 26。 | -| SavedViewpointAnimation | Children (包含SavedViewpoint作为关键帧) | 用于存储和播放视点动画，其关键帧插值原理可借鉴于物体动画平滑 124。 | -| DocumentClash | TestsData, GetClash() | 提供对Navisworks碰撞检测功能的访问。 | -| ClashTest | SelectionA, SelectionB, TestType, Tolerance, Children (包含ClashResult) | 定义单个碰撞测试的配置，包括选择集、测试类型和容差。其Children属性包含碰撞结果 28。 | -| ClashResult | Status, Selection1, Selection2, DisplayName | 表示单个碰撞检测结果，包含冲突状态、涉及的物体和描述。 | -| DocumentClashTests | Tests, TestsRunTest(), TestsEditResultStatus() | 管理碰撞测试的集合，提供运行测试和修改结果状态的方法 44。 | -| ModelItemCollection | Add(), AddRange(), CopyFrom() | 可读写的ModelItem集合，用于定义碰撞测试的选择集或动画对象集合。 | - -## **6\. 路径在Navisworks视口中的三维可视化** - -### **6.1. 将计算路径渲染为三维图形** - -为了直观地展示计算出的路径，需要将其渲染为Navisworks视口中的三维图形。Navisworks API的Graphics类提供了绘制临时三维图元的功能，包括点、线和多段线 27。 - -路径可以表示为一系列三维点，然后使用Graphics.Polyline3D()方法绘制成一条连续的三维多段线 147。为了增强路径的可读性和视觉效果，可以定制其外观： - -* **颜色和透明度**：使用Graphics.Color()方法设置路径的颜色和透明度，例如，将路径设置为鲜艳的颜色并带有一定的透明度，使其在模型中清晰可见而不遮挡底层几何体 146。 -* **线宽**：通过Graphics.LineWidth()设置路径的粗细，使其在复杂模型中更容易被识别 146。 -* **动态高亮**：在动画播放过程中，可以动态高亮显示当前物流组件所在的路径段，例如改变该段的颜色或增加其亮度，从而清晰指示组件的实时位置和行进方向。这可以通过在OverlayRenderModel或OverlayRenderWindow回调中重新绘制特定路径段来实现 40。 - -渲染路径时，应使用OverlayRenderModel或OverlayRenderWindow方法 40，这些方法用于绘制叠加图形，它们不会永久修改模型，而是作为临时图形显示在视口上方，非常适合动态路径可视化。 - -### **6.2. 路径点自动贴合模型表面** - -为了确保可视化路径的真实感和准确性，路径点应自动贴合模型表面（例如，地板、坡道）。这避免了路径点悬浮在空中或穿透地面的视觉不一致。 - -实现路径点贴合模型表面可以通过以下两种主要方法： - -* **投影路径点到模型表面**：对于每个计算出的路径点，可以将其投影到最近的可通行模型表面上 60。Navisworks API可能提供类似Revit中 - Face.Project()或Inventor API中SurfaceBody.LocateUsingPoint()的方法来执行此操作 60。这些方法能够找到一个三维点在指定表面上的最近投影点。 -* **利用Navisworks的捕捉功能或自定义射线投射**：Navisworks在用户界面中提供了强大的捕捉功能（例如，捕捉到顶点、边、面）163。虽然API中可能没有直接公开这些UI捕捉的精确程序化等效项，但可以通过自定义射线投射（ray-casting）来实现类似功能 38。从路径点向下方投射一条射线，检测与模型表面的第一个交点，该交点即为路径点在表面上的贴合位置。这种方法需要对模型的几何体进行高效的射线-三角形交叉测试，可以利用空间数据结构（如BVH或八叉树）来加速。 - -### **6.3. 动态显示与用户交互** - -有效的路径可视化解决方案需要具备交互性和响应性。路径的动态更新以及直观的用户界面控制，能够增强用户体验并促进分析。 - -路径可视化应能够实时更新，以反映模拟的进展或参数的变化（例如，速度限制、临时障碍物）172。这意味着当物流组件在动画中移动时，路径的已通过部分可以改变颜色或消失，而未通过部分则保持可见。 - -为了实现用户对路径规划和动画的控制，可以开发自定义的用户界面元素： - -* **Ribbon按钮**：使用CommandHandlerPlugin可以创建自定义的Ribbon选项卡和按钮 175。这些按钮可以触发路径计算、动画播放/暂停、重置视图或导出结果等操作。 -* **可停靠面板**：通过DockPanePlugin可以创建自定义的可停靠窗口 46。这些面板可以用于输入路径的起点/终点、调整物流组件的尺寸、设置速度限制或定义其他物流相关属性，并实时显示路径计算的状态和结果。 - -这些UI元素将作为用户与路径规划系统交互的主要接口，提供直观的控制和反馈，从而提升整个解决方案的可用性和分析价值。 - -### **表6.1：Navisworks Graphics API用于路径可视化** - -| 类名 | 主要方法/属性 | 用途 | 使用注意事项 | -| :---- | :---- | :---- | :---- | -| Graphics | Polyline3D(Point3DList points), Line(Point3D start, Point3D end) | 用于在Navisworks视口中绘制三维多段线和线段，以表示路径。 | 绘制的图形是临时的，通常用于叠加显示，不会永久保存到模型中。 | -| | Color(Color color, double alpha), LineWidth(double width) | 设置绘制图形的颜色、透明度和线宽。 | Color参数接受Autodesk.Navisworks.Api.Color对象，alpha控制透明度（0.0-1.0）。 | -| | BeginModelContext(), EndModelContext() | 定义一个模型上下文，在此上下文中绘制的图形使用三维模型空间坐标。 | 适用于需要与模型几何体精确对齐的图形。 | -| | BeginWindowContext(), EndWindowContext() | 定义一个窗口上下文，在此上下文中绘制的图形使用二维窗口空间坐标。 | 适用于绘制屏幕叠加UI元素或与视口大小相关的图形。 | -| | OverlayRenderModel(View view, Graphics graphics) (在ToolPlugin/RenderPlugin中重写) | 在模型叠加缓冲区中渲染图形，通常用于临时高亮或绘制。 | 确保在适当的插件生命周期方法中调用，以实现动态更新。 | -| Point3D | X, Y, Z | 表示三维空间中的一个点，用于定义路径的顶点。 | Navisworks API中的基本三维点结构。 | -| Point3DList | Add(Point3D point) | Point3D对象的集合，用于传递给Polyline3D方法绘制多段线。 | 方便地存储和管理路径点序列。 | -| Color | FromByteRGB(byte r, byte g, byte b), FromARGB(byte a, byte r, byte g, byte b) | 定义图形的颜色和透明度。 | 可以通过RGB或ARGB值创建颜色对象。 | -| View | PickItemFromPoint(int x, int y) | 根据屏幕坐标拾取模型中的项目，返回PickItemResult，其中包含拾取点在WCS中的坐标。 | 可用于实现路径点到模型表面的捕捉，或用户交互式选择路径点 38。 | -| PickItemResult | Point, ModelItem | 包含PickItemFromPoint方法返回的拾取结果，包括拾取点和拾取到的模型项。 | Point属性提供拾取点在世界坐标系中的精确位置。 | - -## **7\. 结论与未来方向** - -本报告详细阐述了在Autodesk Navisworks中实现自动化物流路径规划和模拟的综合方案。该方案通过Navisworks API高效提取BIM模型的几何和语义信息，利用体素化、NavMesh或路点图等技术简化复杂的3D空间，并采用A\*或MHA\*算法计算最优路径。通过定制成本函数，方案能够整合物流相关的预设属性（如通行性、速度限制、宽度限制）和实时数据，从而生成考虑多重约束的智能路径。此外，方案还包括物流组件沿计算路径的程序化动画控制、基于Navisworks Clash Detective的实时碰撞检测，以及路径的动态三维可视化，包括路径点自动贴合模型表面和路径的动态高亮显示。该系统旨在显著提升物流规划、施工模拟和设施管理中的效率、安全性和决策水平。 - -未来的研究方向可以进一步扩展本解决方案的能力和应用范围： - -* **更高级的物理模拟与动态环境适应**：当前方案主要依赖于Navisworks的碰撞检测功能，这通常是离散的。未来可以探索集成更高级的物理引擎，实现连续碰撞检测和更真实的物理交互，尤其是在高速或复杂动态场景中 141。此外，结合实时传感器数据（如激光扫描、RFID）和机器学习（ML）算法，可以实现对“建成”环境的实时更新和动态障碍物的识别，从而使路径规划更具适应性 13。 -* **多智能体路径规划（Multi-Agent Pathfinding, MAPF）**：目前的路径规划通常针对单个物流组件。在复杂的施工现场或仓库中，可能有多台物流组件同时运行。未来的研究可以聚焦于MAPF算法，以协调多个智能体的路径，避免相互碰撞和死锁，从而优化整体物流效率 66。 -* **与外部系统集成**：将Navisworks路径规划解决方案与企业级系统（如仓库管理系统WMS、物联网IoT平台、机器人操作系统ROS）进行更深层次的集成，可以实现数据流的自动化和端到端的物流管理 2。例如，从WMS获取任务指令，通过Navisworks规划路径，将指令发送给机器人执行，并将实时状态反馈回BIM模型。 -* **用户体验与交互的增强**：进一步优化用户界面，提供更直观的路径编辑、模拟参数调整和结果分析工具。例如，利用虚拟现实（VR）或增强现实（AR）技术，提供沉浸式的路径审查和模拟体验 12。 - -通过持续的研发和创新，基于Navisworks的自动化路径规划解决方案有望在提升建筑和物流行业的智能化水平方面发挥关键作用。 - -#### **引用的著作** - -1. Path Planning for Construction Robot Based on the Improved A\* Algorithm and Building Information Modeling \- MDPI, 访问时间为 八月 11, 2025， [https://www.mdpi.com/2075-5309/15/5/719](https://www.mdpi.com/2075-5309/15/5/719) -2. Safe Pathfinding in BIM Worlds Utilizing Dynamic MHA\* Algorithms using APF and Natural Language Processing \- arXiv, 访问时间为 八月 11, 2025， [https://arxiv.org/html/2411.15371v2](https://arxiv.org/html/2411.15371v2) -3. (PDF) Safe and trustworthy robot pathfinding with BIM, MHA\*, and NLP \- ResearchGate, 访问时间为 八月 11, 2025， [https://www.researchgate.net/publication/394167025\_Safe\_and\_trustworthy\_robot\_pathfinding\_with\_BIM\_MHA\_and\_NLP](https://www.researchgate.net/publication/394167025_Safe_and_trustworthy_robot_pathfinding_with_BIM_MHA_and_NLP) -4. An Extension of BIM Using AI: a Multi Working-Machines Pathfinding Solution, 访问时间为 八月 11, 2025， [https://www.researchgate.net/publication/354427408\_An\_Extension\_of\_BIM\_Using\_AI\_a\_Multi\_Working-Machines\_Pathfinding\_Solution](https://www.researchgate.net/publication/354427408_An_Extension_of_BIM_Using_AI_a_Multi_Working-Machines_Pathfinding_Solution) -5. How To Use BIM Clash Detection To Streamline Construction Projects \- Matterport, 访问时间为 八月 11, 2025， [https://matterport.com/blog/bim-clash-detection](https://matterport.com/blog/bim-clash-detection) -6. Leveraging BIM for Efficient Clash Detection in Construction \- Gsource Technologies, 访问时间为 八月 11, 2025， [https://www.gsourcedata.com/leveraging-bim-for-efficient-clash-detection-in-construction/](https://www.gsourcedata.com/leveraging-bim-for-efficient-clash-detection-in-construction/) -7. Advanced Visualization with BIM | www.usa.skanska.com, 访问时间为 八月 11, 2025， [https://www.usa.skanska.com/what-we-deliver/services/innovation/advanced-visualization-with-bim/](https://www.usa.skanska.com/what-we-deliver/services/innovation/advanced-visualization-with-bim/) -8. BIM visualization for construction sites \- The new era \- BIMCommunity, 访问时间为 八月 11, 2025， [https://www.bimcommunity.com/community/bim-visualization-for-construction-sites-the-new-era/](https://www.bimcommunity.com/community/bim-visualization-for-construction-sites-the-new-era/) -9. All About Clash Detection with Navisworks \- United-BIM, 访问时间为 八月 11, 2025， [https://www.united-bim.com/get-to-know-all-about-clash-detection-with-navisworks/](https://www.united-bim.com/get-to-know-all-about-clash-detection-with-navisworks/) -10. The Comprehensive Guide to Autodesk Navisworks \- Multisoft Virtual Academy, 访问时间为 八月 11, 2025， [https://www.multisoftvirtualacademy.com/blog/the-comprehensive-guide-to-autodesk-navisworks](https://www.multisoftvirtualacademy.com/blog/the-comprehensive-guide-to-autodesk-navisworks) -11. Navisworks Best Practices & Advanced Techniques in 2025 \- Novatr, 访问时间为 八月 11, 2025， [https://www.novatr.com/blog/navisworks-best-practices](https://www.novatr.com/blog/navisworks-best-practices) -12. How NVIDIA Omniverse Is Revolutionizing Building Development and Management, 访问时间为 八月 11, 2025， [https://goto.archi/blog/post/nvidia-omniverse-is-revolutionizing-building-development-and-management](https://goto.archi/blog/post/nvidia-omniverse-is-revolutionizing-building-development-and-management) -13. Bayesian BIM-Guided Construction Robot Navigation with NLP Safety Prompts in Dynamic Environments \- arXiv, 访问时间为 八月 11, 2025， [https://arxiv.org/html/2501.17437v1](https://arxiv.org/html/2501.17437v1) -14. Path Planning \- MATLAB & Simulink \- MathWorks, 访问时间为 八月 11, 2025， [https://www.mathworks.com/discovery/path-planning.html](https://www.mathworks.com/discovery/path-planning.html) -15. Pathfinding Algorithms \- Meegle, 访问时间为 八月 11, 2025， [https://www.meegle.com/en\_us/topics/algorithm/pathfinding-algorithms](https://www.meegle.com/en_us/topics/algorithm/pathfinding-algorithms) -16. A Systematic Review and Analysis of Intelligence-Based Pathfinding Algorithms in the Field of Video Games \- MDPI, 访问时间为 八月 11, 2025， [https://www.mdpi.com/2076-3417/12/11/5499](https://www.mdpi.com/2076-3417/12/11/5499) -17. Pathfinding algorithms : the four Pillars. | by Hybesis \- H.urna | Medium, 访问时间为 八月 11, 2025， [https://medium.com/@urna.hybesis/pathfinding-algorithms-the-four-pillars-1ebad85d4c6b](https://medium.com/@urna.hybesis/pathfinding-algorithms-the-four-pillars-1ebad85d4c6b) -18. Semantic Optimal Robot Navigation Using Building Information on Construction Sites, 访问时间为 八月 11, 2025， [https://www.iaarc.org/publications/2021\_proceedings\_of\_the\_38th\_isarc/semantic\_optimal\_robot\_navigation\_using\_building\_information\_on\_construction\_sites.html](https://www.iaarc.org/publications/2021_proceedings_of_the_38th_isarc/semantic_optimal_robot_navigation_using_building_information_on_construction_sites.html) -19. BIM Clash Detection: Process, Benefits, Best Practices \- Hitech CADD Services, 访问时间为 八月 11, 2025， [https://www.hitechcaddservices.com/news/bim-clash-detection-process-advantages-and-best-practices/](https://www.hitechcaddservices.com/news/bim-clash-detection-process-advantages-and-best-practices/) -20. Clash Detection — Omniverse Extensions \- NVIDIA Omniverse, 访问时间为 八月 11, 2025， [https://docs.omniverse.nvidia.com/extensions/latest/ext\_clash-detection.html](https://docs.omniverse.nvidia.com/extensions/latest/ext_clash-detection.html) -21. BIM Clash Detection in Construction Guide \- iSCANO, 访问时间为 八月 11, 2025， [https://iscano.com/real-world-applications-laser-scanning-lidar/clash-detection-construction/](https://iscano.com/real-world-applications-laser-scanning-lidar/clash-detection-construction/) -22. Navisworks API | Autodesk Platform Services (APS), 访问时间为 八月 11, 2025， [https://aps.autodesk.com/developer/overview/navisworks](https://aps.autodesk.com/developer/overview/navisworks) -23. Enjoy exclusive benefits on Autodesk Navisworks Manage 2026 \- Cadac Group, 访问时间为 八月 11, 2025， [https://www.cadac.com/us/autodesk-navisworks-manage-2026/](https://www.cadac.com/us/autodesk-navisworks-manage-2026/) -24. Navisworks \- Interface Solutions \- UNITEC Informationssysteme GmbH, 访问时间为 八月 11, 2025， [https://unitec.de/en/solutions/navisworks-interfaces](https://unitec.de/en/solutions/navisworks-interfaces) -25. Supported CAD files \- Visual Components, 访问时间为 八月 11, 2025， [https://www.visualcomponents.com/supported-cad-files/](https://www.visualcomponents.com/supported-cad-files/) -26. Navisworks Help | Animate Objects | Autodesk, 访问时间为 八月 11, 2025， [https://help.autodesk.com/view/NAV/2024/ENU/?guid=GUID-DD38DF54-B0A6-4B80-86D3-D7C70584CCE7](https://help.autodesk.com/view/NAV/2024/ENU/?guid=GUID-DD38DF54-B0A6-4B80-86D3-D7C70584CCE7) -27. Navisworks \- AEC DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/navisworks/](https://adndevblog.typepad.com/aec/navisworks/) -28. Navisworks · Developer Guide \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2018/87317537-2911-4c08-b492-6496c82b3ed0.htm](https://apidocs.co/apps/navisworks/2018/87317537-2911-4c08-b492-6496c82b3ed0.htm) -29. Navisworks .NET: AddInPlugin and Attributes (PluginAttribute & AddInPluginAttribute), 访问时间为 八月 11, 2025， [https://spiderinnet.typepad.com/blog/2013/10/navisworks-net-addinplugin-and-attributes-pluginattribute-addinpluginattribute.html](https://spiderinnet.typepad.com/blog/2013/10/navisworks-net-addinplugin-and-attributes-pluginattribute-addinpluginattribute.html) -30. Navisworks · AddInPlugin Class \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2018/T\_Autodesk\_Navisworks\_Api\_Plugins\_AddInPlugin.htm](https://apidocs.co/apps/navisworks/2018/T_Autodesk_Navisworks_Api_Plugins_AddInPlugin.htm) -31. Plugins and Add-ons for Navisworks \- Autodesk App Store, 访问时间为 八月 11, 2025， [https://apps.autodesk.com/navis/en/Home/Index](https://apps.autodesk.com/navis/en/Home/Index) -32. Navisworks · Model.Guid Property \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2018/P\_Autodesk\_Navisworks\_Api\_Model\_Guid.htm](https://apidocs.co/apps/navisworks/2018/P_Autodesk_Navisworks_Api_Model_Guid.htm) -33. Use Navisworks API with WPF Binding Model Hierarchy to Tree View \- AEC DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/2013/04/use-navisworks-api-with-wpf-binding-model-hierarchy-to-tree-view.html](https://adndevblog.typepad.com/aec/2013/04/use-navisworks-api-with-wpf-binding-model-hierarchy-to-tree-view.html) -34. Navisworks · Selections and Collections of ModelItem \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2018/87317537-2911-4c08-b492-6496c82b3edb.htm](https://apidocs.co/apps/navisworks/2018/87317537-2911-4c08-b492-6496c82b3edb.htm) -35. Navisworks \- Selection Tree Window \- Autodesk Help, 访问时间为 八月 11, 2025， [https://help.autodesk.com/view/NAV/2024/ENU/?guid=GUID-AF4CFA5C-1455-4444-982A-34FBA2AE4608](https://help.autodesk.com/view/NAV/2024/ENU/?guid=GUID-AF4CFA5C-1455-4444-982A-34FBA2AE4608) -36. Navisworks · ModelItem Class \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2017/T\_Autodesk\_Navisworks\_Api\_ModelItem.htm](https://apidocs.co/apps/navisworks/2017/T_Autodesk_Navisworks_Api_ModelItem.htm) -37. Navisworks · ModelItem.Model Property \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2018/P\_Autodesk\_Navisworks\_Api\_ModelItem\_Model.htm](https://apidocs.co/apps/navisworks/2018/P_Autodesk_Navisworks_Api_ModelItem_Model.htm) -38. Navisworks .NET API : Find Item \- AEC DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/2012/05/navisworks-net-api-find-item.html](https://adndevblog.typepad.com/aec/2012/05/navisworks-net-api-find-item.html) -39. Navisworks · Search Class \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2018/T\_Autodesk\_Navisworks\_Api\_Search.htm](https://apidocs.co/apps/navisworks/2018/T_Autodesk_Navisworks_Api_Search.htm) -40. Navisworks API \- AEC DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/navisworks/page/4/](https://adndevblog.typepad.com/aec/navisworks/page/4/) -41. Navisworks API \- AEC DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/navisworks/page/12/](https://adndevblog.typepad.com/aec/navisworks/page/12/) -42. Transaction Class \- Revit API Docs, 访问时间为 八月 11, 2025， [https://www.revitapidocs.com/2017.1/308ebf8d-d96d-4643-cd1d-34fffcea53fd.htm](https://www.revitapidocs.com/2017.1/308ebf8d-d96d-4643-cd1d-34fffcea53fd.htm) -43. Model Derivative API ignores conversionMethod v3 and still uses Navisworks for IFC conversion, resulting in Error Code 5 \- Stack Overflow, 访问时间为 八月 11, 2025， [https://stackoverflow.com/questions/79719050/model-derivative-api-ignores-conversionmethod-v3-and-still-uses-navisworks-for-i](https://stackoverflow.com/questions/79719050/model-derivative-api-ignores-conversionmethod-v3-and-still-uses-navisworks-for-i) -44. Navisworks API \- AEC DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/navisworks/page/15/](https://adndevblog.typepad.com/aec/navisworks/page/15/) -45. Get primitive from solid of Navisworks \- AEC DevBlog \- TypePad, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/2012/05/get-primitive-from-solid-of-navisworks.html](https://adndevblog.typepad.com/aec/2012/05/get-primitive-from-solid-of-navisworks.html) -46. Navisworks API : Dockable Pane Plugin – TwentyTwo, 访问时间为 八月 11, 2025， [https://twentytwo.space/2022/03/31/navisworks-api-dockable-pane-plugin/](https://twentytwo.space/2022/03/31/navisworks-api-dockable-pane-plugin/) -47. A Simpler Dockable Panel Sample \- The Building Coder, 访问时间为 八月 11, 2025， [https://thebuildingcoder.typepad.com/blog/2013/05/a-simpler-dockable-panel-sample.html](https://thebuildingcoder.typepad.com/blog/2013/05/a-simpler-dockable-panel-sample.html) -48. Use Navisworks API with WPF \- Create a .NET control application of WPF \- AEC DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/2013/03/use-navisworks-api-with-wpf-create-a-net-control-application-of-wpf.html](https://adndevblog.typepad.com/aec/2013/03/use-navisworks-api-with-wpf-create-a-net-control-application-of-wpf.html) -49. Multi-threading with Revit \- AEC DevBlog \- TypePad, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/2012/06/multi-threading-with-revit.html](https://adndevblog.typepad.com/aec/2012/06/multi-threading-with-revit.html) -50. Revit API Documentation \- RVTDocs.com, 访问时间为 八月 11, 2025， [https://rvtdocs.com/2026/whatsnew?utm\_source=youtube\&utm\_medium=video\&utm\_campaign=tutorial\&utm\_content=whats\_new\_in\_API\_2026](https://rvtdocs.com/2026/whatsnew?utm_source=youtube&utm_medium=video&utm_campaign=tutorial&utm_content=whats_new_in_API_2026) -51. Autodesk Navisworks Manage 2026 | Autodesk Accessibility Conformance Report International Edition, 访问时间为 八月 11, 2025， [https://damassets.autodesk.net/content/dam/autodesk/www/migration/government/2026/vpat-autodesk-navisworks-manage-2026.pdf](https://damassets.autodesk.net/content/dam/autodesk/www/migration/government/2026/vpat-autodesk-navisworks-manage-2026.pdf) -52. Navisworks · ModelItem.Geometry Property \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2018/P\_Autodesk\_Navisworks\_Api\_ModelItem\_Geometry.htm](https://apidocs.co/apps/navisworks/2018/P_Autodesk_Navisworks_Api_ModelItem_Geometry.htm) -53. Navisworks · ModelGeometry Class \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2018/T\_Autodesk\_Navisworks\_Api\_ModelGeometry.htm](https://apidocs.co/apps/navisworks/2018/T_Autodesk_Navisworks_Api_ModelGeometry.htm) -54. Section View Geometry \- The Building Coder \- TypePad, 访问时间为 八月 11, 2025， [https://thebuildingcoder.typepad.com/blog/2011/08/section-view-geometry.html](https://thebuildingcoder.typepad.com/blog/2011/08/section-view-geometry.html) -55. GetVertices Method \- Revit API Docs, 访问时间为 八月 11, 2025， [https://www.revitapidocs.com/2017.1/d9517837-8141-235b-f6a1-3dc3ce053859.htm](https://www.revitapidocs.com/2017.1/d9517837-8141-235b-f6a1-3dc3ce053859.htm) -56. Navisworks · ModelItem.BoundingBox Method \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2018/M\_Autodesk\_Navisworks\_Api\_ModelItem\_BoundingBox.htm](https://apidocs.co/apps/navisworks/2018/M_Autodesk_Navisworks_Api_ModelItem_BoundingBox.htm) -57. Navisworks · Document.GetBoundingBox Method \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2018/M\_Autodesk\_Navisworks\_Api\_Document\_GetBoundingBox\_1\_ea7b1ae4.htm](https://apidocs.co/apps/navisworks/2018/M_Autodesk_Navisworks_Api_Document_GetBoundingBox_1_ea7b1ae4.htm) -58. Navisworks · BoundingBox3D Class \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2017/T\_Autodesk\_Navisworks\_Api\_BoundingBox3D.htm](https://apidocs.co/apps/navisworks/2017/T_Autodesk_Navisworks_Api_BoundingBox3D.htm) -59. Navisworks API : Find Intersect and Override Color \- TwentyTwo, 访问时间为 八月 11, 2025， [https://twentytwo.space/2020/05/16/navisworks-api-find-intersect-and-override-color/](https://twentytwo.space/2020/05/16/navisworks-api-find-intersect-and-override-color/) -60. Navisworks .NET API Properties \- AEC DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/2012/05/navisworks-net-api-properties.html](https://adndevblog.typepad.com/aec/2012/05/navisworks-net-api-properties.html) -61. Closest Grid Point Intersection to an Object \- AEC DevBlog \- TypePad, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/2014/01/closest-grid-point-intersection-to-an-object.html](https://adndevblog.typepad.com/aec/2014/01/closest-grid-point-intersection-to-an-object.html) -62. LOD or Vertex Reduction API for Large Models in Navisworks \- Autodesk Community, 访问时间为 八月 11, 2025， [https://forums.autodesk.com/t5/navisworks-api/lod-or-vertex-reduction-api-for-large-models-in-navisworks/m-p/13316376](https://forums.autodesk.com/t5/navisworks-api/lod-or-vertex-reduction-api-for-large-models-in-navisworks/m-p/13316376) -63. Optimizing Your Navisworks File \- IrisVR, 访问时间为 八月 11, 2025， [https://help.irisvr.com/hc/en-us/articles/360036941213-Optimizing-Your-Navisworks-File](https://help.irisvr.com/hc/en-us/articles/360036941213-Optimizing-Your-Navisworks-File) -64. Performance is slow with larger files in Navisworks \- Autodesk, 访问时间为 八月 11, 2025， [https://www.autodesk.com/support/technical/article/caas/sfdcarticles/sfdcarticles/Navisworks-2016-performance-is-slow-with-large-files.html](https://www.autodesk.com/support/technical/article/caas/sfdcarticles/sfdcarticles/Navisworks-2016-performance-is-slow-with-large-files.html) -65. Performance issues when navigating a model in Navisworks \- Autodesk, 访问时间为 八月 11, 2025， [https://www.autodesk.com/support/technical/article/caas/sfdcarticles/sfdcarticles/Navisworks-performance-issues-and-settings.html](https://www.autodesk.com/support/technical/article/caas/sfdcarticles/sfdcarticles/Navisworks-performance-issues-and-settings.html) -66. Motion planning \- Wikipedia, 访问时间为 八月 11, 2025， [https://en.wikipedia.org/wiki/Motion\_planning](https://en.wikipedia.org/wiki/Motion_planning) -67. PATHFINDING ALGORITHMS IN GRAPHS AND APPLICATIONS \- Dipòsit Digital UB, 访问时间为 八月 11, 2025， [https://diposit.ub.edu/dspace/bitstream/2445/140466/1/memoria.pdf](https://diposit.ub.edu/dspace/bitstream/2445/140466/1/memoria.pdf) -68. Custom properties \- BricsCAD BIM \- Bricsys Help Center, 访问时间为 八月 11, 2025， [https://help.bricsys.com/en-us/document/bricscad-bim/building-data/custom-properties](https://help.bricsys.com/en-us/document/bricscad-bim/building-data/custom-properties) -69. Reviewing custom property sets \- Spectra Geospatial Help Portal, 访问时间为 八月 11, 2025， [https://help.spectrageospatial.com/origin/latest/en/map-bim-property-sets.htm](https://help.spectrageospatial.com/origin/latest/en/map-bim-property-sets.htm) -70. Custom Properties \- Navisworks \- Autodesk Help, 访问时间为 八月 11, 2025， [https://help.autodesk.com/view/NAV/2024/ENU/?guid=GUID-23C2693B-E459-43CD-A14A-F82A3F959189](https://help.autodesk.com/view/NAV/2024/ENU/?guid=GUID-23C2693B-E459-43CD-A14A-F82A3F959189) -71. Add/Modify/Remove custom attribute using COM API \- AEC DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/2012/08/addmodifyremove-custom-attribute-using-com-api.html](https://adndevblog.typepad.com/aec/2012/08/addmodifyremove-custom-attribute-using-com-api.html) -72. Autodesk Navisworks 2026 \- New Features \- YouTube, 访问时间为 八月 11, 2025， [https://www.youtube.com/watch?v=dOy91ZB\_3-A](https://www.youtube.com/watch?v=dOy91ZB_3-A) -73. add custom properties to all desired model items \- AEC DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/2013/03/add-custom-properties-to-all-desired-model-items.html](https://adndevblog.typepad.com/aec/2013/03/add-custom-properties-to-all-desired-model-items.html) -74. Navisworks API \- AEC DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/navisworks/page/2/](https://adndevblog.typepad.com/aec/navisworks/page/2/) -75. \[Literature Review\] Safe and Trustworthy Robot Pathfinding with BIM, MHA\*, and NLP, 访问时间为 八月 11, 2025， [https://www.themoonlight.io/en/review/safe-and-trustworthy-robot-pathfinding-with-bim-mha-and-nlp](https://www.themoonlight.io/en/review/safe-and-trustworthy-robot-pathfinding-with-bim-mha-and-nlp) -76. Navisworks-Net-Plugin-Property-Database-Example/NetPluginPropertyDatabaseExample/Class1.cs at master \- GitHub, 访问时间为 八月 11, 2025， [https://github.com/xiaodongliang/Navisworks-Net-Plugin-Property-Database-Example/blob/master/NetPluginPropertyDatabaseExample/Class1.cs](https://github.com/xiaodongliang/Navisworks-Net-Plugin-Property-Database-Example/blob/master/NetPluginPropertyDatabaseExample/Class1.cs) -77. Path planning in three-dimensional space based on butterfly optimization algorithm \- PMC, 访问时间为 八月 11, 2025， [https://pmc.ncbi.nlm.nih.gov/articles/PMC11303821/](https://pmc.ncbi.nlm.nih.gov/articles/PMC11303821/) -78. Automated generation of waypoints \- DiVA portal, 访问时间为 八月 11, 2025， [https://www.diva-portal.org/smash/get/diva2:1333581/FULLTEXT02.pdf](https://www.diva-portal.org/smash/get/diva2:1333581/FULLTEXT02.pdf) -79. Pathfinding in a 3D Space with obstacles : r/Unity3D \- Reddit, 访问时间为 八月 11, 2025， [https://www.reddit.com/r/Unity3D/comments/1b2y4hv/pathfinding\_in\_a\_3d\_space\_with\_obstacles/](https://www.reddit.com/r/Unity3D/comments/1b2y4hv/pathfinding_in_a_3d_space_with_obstacles/) -80. Generation of navigation graphs for indoor space \- SciSpace, 访问时间为 八月 11, 2025， [https://scispace.com/pdf/generation-of-navigation-graphs-for-indoor-space-t2xvg3m2bf.pdf](https://scispace.com/pdf/generation-of-navigation-graphs-for-indoor-space-t2xvg3m2bf.pdf) -81. Pathfinding method for an indoor drone based on a BIM-semantic model \- ResearchGate, 访问时间为 八月 11, 2025， [https://www.researchgate.net/publication/361971292\_Pathfinding\_method\_for\_an\_indoor\_drone\_based\_on\_a\_BIM-semantic\_model](https://www.researchgate.net/publication/361971292_Pathfinding_method_for_an_indoor_drone_based_on_a_BIM-semantic_model) -82. ALGORITHMS FOR VOXEL-BASED ARCHITECTURAL SPACE ..., 访问时间为 八月 11, 2025， [https://www.research.autodesk.com/app/uploads/2023/06/Algorithms-for-VASA.pdf](https://www.research.autodesk.com/app/uploads/2023/06/Algorithms-for-VASA.pdf) -83. BeliefMapNav: 3D Voxel-Based Belief Map for Zero-Shot Object Navigation \- arXiv, 访问时间为 八月 11, 2025， [https://arxiv.org/html/2506.06487v1](https://arxiv.org/html/2506.06487v1) -84. (PDF) BeliefMapNav: 3D Voxel-Based Belief Map for Zero-Shot Object Navigation, 访问时间为 八月 11, 2025， [https://www.researchgate.net/publication/392530510\_BeliefMapNav\_3D\_Voxel-Based\_Belief\_Map\_for\_Zero-Shot\_Object\_Navigation](https://www.researchgate.net/publication/392530510_BeliefMapNav_3D_Voxel-Based_Belief_Map_for_Zero-Shot_Object_Navigation) -85. Voxel path finding \- YouTube, 访问时间为 八月 11, 2025， [https://www.youtube.com/watch?v=bvMnVSBj3Ns](https://www.youtube.com/watch?v=bvMnVSBj3Ns) -86. Pathfinding in Computer Games \- Arrow@TU Dublin, 访问时间为 八月 11, 2025， [https://arrow.tudublin.ie/cgi/viewcontent.cgi?article=1063\&context=itbj](https://arrow.tudublin.ie/cgi/viewcontent.cgi?article=1063&context=itbj) -87. Navigation mesh \- Wikipedia, 访问时间为 八月 11, 2025， [https://en.wikipedia.org/wiki/Navigation\_mesh](https://en.wikipedia.org/wiki/Navigation_mesh) -88. Creating a Custom NavMesh. Toward the end of my class on Game… | by Robert Jones, 访问时间为 八月 11, 2025， [https://medium.com/@RJones0421/creating-a-custom-navmesh-b5c75b2fe5d2](https://medium.com/@RJones0421/creating-a-custom-navmesh-b5c75b2fe5d2) -89. Problems with the generation of NavMeshes in IFC based Imports \- Unreal Engine Forums, 访问时间为 八月 11, 2025， [https://forums.unrealengine.com/t/problems-with-the-generation-of-navmeshes-in-ifc-based-imports/539346](https://forums.unrealengine.com/t/problems-with-the-generation-of-navmeshes-in-ifc-based-imports/539346) -90. View of Full 3D Spatial Decomposition for the Generation of Navigation Meshes, 访问时间为 八月 11, 2025， [https://ojs.aaai.org/index.php/AIIDE/article/view/12376/12235](https://ojs.aaai.org/index.php/AIIDE/article/view/12376/12235) -91. How to make navigation meshes for pathfinding? \- Stack Overflow, 访问时间为 八月 11, 2025， [https://stackoverflow.com/questions/27896021/how-to-make-navigation-meshes-for-pathfinding](https://stackoverflow.com/questions/27896021/how-to-make-navigation-meshes-for-pathfinding) -92. Generating navmesh (3D) from walkable points \- Stack Overflow, 访问时间为 八月 11, 2025， [https://stackoverflow.com/questions/34668287/generating-navmesh-3d-from-walkable-points](https://stackoverflow.com/questions/34668287/generating-navmesh-3d-from-walkable-points) -93. How do NavMeshes work? : r/gamedev \- Reddit, 访问时间为 八月 11, 2025， [https://www.reddit.com/r/gamedev/comments/195svf/how\_do\_navmeshes\_work/](https://www.reddit.com/r/gamedev/comments/195svf/how_do_navmeshes_work/) -94. How to Convert a Point Cloud to a 3D Mesh in Python and C++ \- MeshLib, 访问时间为 八月 11, 2025， [https://meshlib.io/feature/point-cloud-to-mesh/](https://meshlib.io/feature/point-cloud-to-mesh/) -95. waypointTrajectory \- Waypoint trajectory generator \- MATLAB \- MathWorks, 访问时间为 八月 11, 2025， [https://www.mathworks.com/help/nav/ref/waypointtrajectory-system-object.html](https://www.mathworks.com/help/nav/ref/waypointtrajectory-system-object.html) -96. GraphNav Map Structure \- Spot SDK \- Boston Dynamics, 访问时间为 八月 11, 2025， [https://dev.bostondynamics.com/docs/concepts/autonomy/graphnav\_map\_structure.html](https://dev.bostondynamics.com/docs/concepts/autonomy/graphnav_map_structure.html) -97. CGAL 6.0.1 \- Quadtrees, Octrees, and Orthtrees: User Manual, 访问时间为 八月 11, 2025， [https://doc.cgal.org/latest/Orthtree/index.html](https://doc.cgal.org/latest/Orthtree/index.html) -98. When to use Binary Space Partitioning, Quadtree, Octree? \- Stack Overflow, 访问时间为 八月 11, 2025， [https://stackoverflow.com/questions/99796/when-to-use-binary-space-partitioning-quadtree-octree](https://stackoverflow.com/questions/99796/when-to-use-binary-space-partitioning-quadtree-octree) -99. Dijkstra vs. A\* – Pathfinding | Baeldung on Computer Science, 访问时间为 八月 11, 2025， [https://www.baeldung.com/cs/dijkstra-vs-a-pathfinding](https://www.baeldung.com/cs/dijkstra-vs-a-pathfinding) -100. Difference Between Dijkstra's Algorithm and A\* Search Algorithm \- GeeksforGeeks, 访问时间为 八月 11, 2025， [https://www.geeksforgeeks.org/dsa/difference-between-dijkstras-algorithm-and-a-search-algorithm/](https://www.geeksforgeeks.org/dsa/difference-between-dijkstras-algorithm-and-a-search-algorithm/) -101. algorithm \- Difference and advantages between dijkstra & A star \- Stack Overflow, 访问时间为 八月 11, 2025， [https://stackoverflow.com/questions/13031462/difference-and-advantages-between-dijkstra-a-star](https://stackoverflow.com/questions/13031462/difference-and-advantages-between-dijkstra-a-star) -102. Can Dijkstra's Algorithm work on a graph with weights of 0? \- Stack Overflow, 访问时间为 八月 11, 2025， [https://stackoverflow.com/questions/49460439/can-dijkstras-algorithm-work-on-a-graph-with-weights-of-0](https://stackoverflow.com/questions/49460439/can-dijkstras-algorithm-work-on-a-graph-with-weights-of-0) -103. C\# Program for Dijkstra's shortest path algorithm | Greedy Algo-7 \- GeeksforGeeks, 访问时间为 八月 11, 2025， [https://www.geeksforgeeks.org/c-sharp/csharp-program-for-dijkstras-shortest-path-algorithm-greedy-algo-7/](https://www.geeksforgeeks.org/c-sharp/csharp-program-for-dijkstras-shortest-path-algorithm-greedy-algo-7/) -104. \[OC\] Comparing two pathfinding algorithms : r/dataisbeautiful \- Reddit, 访问时间为 八月 11, 2025， [https://www.reddit.com/r/dataisbeautiful/comments/k2mqdp/oc\_comparing\_two\_pathfinding\_algorithms/](https://www.reddit.com/r/dataisbeautiful/comments/k2mqdp/oc_comparing_two_pathfinding_algorithms/) -105. A\* search algorithm \- Wikipedia, 访问时间为 八月 11, 2025， [https://en.wikipedia.org/wiki/A\*\_search\_algorithm](https://en.wikipedia.org/wiki/A*_search_algorithm) -106. Mastering Pathfinding with A-Star: A Practical Guide and C\# Implementation \- Medium, 访问时间为 八月 11, 2025， [https://medium.com/@hanxuyang0826/mastering-pathfinding-with-a-star-a-practical-guide-and-c-implementation-f76f1643d8c3](https://medium.com/@hanxuyang0826/mastering-pathfinding-with-a-star-a-practical-guide-and-c-implementation-f76f1643d8c3) -107. AI | Search Algorithms | A\* Search \- Codecademy, 访问时间为 八月 11, 2025， [https://www.codecademy.com/resources/docs/ai/search-algorithms/a-star-search](https://www.codecademy.com/resources/docs/ai/search-algorithms/a-star-search) -108. Algorithm: path finding with variable path width \- Stack Overflow, 访问时间为 八月 11, 2025， [https://stackoverflow.com/questions/28621166/algorithm-path-finding-with-variable-path-width](https://stackoverflow.com/questions/28621166/algorithm-path-finding-with-variable-path-width) -109. A\* search algorithm \- Rosetta Code, 访问时间为 八月 11, 2025， [https://rosettacode.org/wiki/A\*\_search\_algorithm](https://rosettacode.org/wiki/A*_search_algorithm) -110. EpPathFinding.cs- A Fast Path Finding Algorithm (Jump Point Search) in C\# (grid-based), 访问时间为 八月 11, 2025， [https://www.codeproject.com/Articles/632424/EpPathFinding-cs-A-Fast-Path-Finding-Algorithm-Jum](https://www.codeproject.com/Articles/632424/EpPathFinding-cs-A-Fast-Path-Finding-Algorithm-Jum) -111. Heuristics \- Stanford CS Theory, 访问时间为 八月 11, 2025， [http://theory.stanford.edu/\~amitp/GameProgramming/Heuristics.html](http://theory.stanford.edu/~amitp/GameProgramming/Heuristics.html) -112. Pathfinding With Speed Based Turning Restrictions \- Game Development Stack Exchange, 访问时间为 八月 11, 2025， [https://gamedev.stackexchange.com/questions/178873/pathfinding-with-speed-based-turning-restrictions](https://gamedev.stackexchange.com/questions/178873/pathfinding-with-speed-based-turning-restrictions) -113. Variable Speed Limits \- NHTSA, 访问时间为 八月 11, 2025， [https://www.nhtsa.gov/book/countermeasures-that-work/speeding-and-speed-management/countermeasures/legislation-and-licensing/variable-speed-limits](https://www.nhtsa.gov/book/countermeasures-that-work/speeding-and-speed-management/countermeasures/legislation-and-licensing/variable-speed-limits) -114. Dynamic Speed Limits \- SafetyCube DSS, 访问时间为 八月 11, 2025， [https://www.roadsafety-dss.eu/assets/data/pdf/synopses/Dynamic\_speed\_limits\_30062017.pdf](https://www.roadsafety-dss.eu/assets/data/pdf/synopses/Dynamic_speed_limits_30062017.pdf) -115. (PDF) Optimize the Settings of Variable Speed Limit System to Improve the Performance of Freeway Traffic \- ResearchGate, 访问时间为 八月 11, 2025， [https://www.researchgate.net/publication/282549917\_Optimize\_the\_Settings\_of\_Variable\_Speed\_Limit\_System\_to\_Improve\_the\_Performance\_of\_Freeway\_Traffic](https://www.researchgate.net/publication/282549917_Optimize_the_Settings_of_Variable_Speed_Limit_System_to_Improve_the_Performance_of_Freeway_Traffic) -116. Pathfinding \- PathPlanner Docs, 访问时间为 八月 11, 2025， [https://pathplanner.dev/pplib-pathfinding.html](https://pathplanner.dev/pplib-pathfinding.html) -117. A\* Pathfinding Project \- Arongranberg.com, 访问时间为 八月 11, 2025， [https://arongranberg.com/astar/documentation/stable/pathfinding.html](https://arongranberg.com/astar/documentation/stable/pathfinding.html) -118. Movement costs for pathfinders \- Stanford CS Theory, 访问时间为 八月 11, 2025， [http://theory.stanford.edu/\~amitp/GameProgramming/MovementCosts.html](http://theory.stanford.edu/~amitp/GameProgramming/MovementCosts.html) -119. A\* algorithm implementation in C\# \- CodeProject, 访问时间为 八月 11, 2025， [https://www.codeproject.com/Articles/15307/A-algorithm-implementation-in-C-](https://www.codeproject.com/Articles/15307/A-algorithm-implementation-in-C-) -120. Transform Object with a Series of Moves \- AEC DevBlog \- TypePad, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/2014/08/transform-object-with-a-series-of-moves.html](https://adndevblog.typepad.com/aec/2014/08/transform-object-with-a-series-of-moves.html) -121. How to: Animate an Object Along a Path (Point Animation) \- WPF | Microsoft Learn, 访问时间为 八月 11, 2025， [https://learn.microsoft.com/en-us/dotnet/desktop/wpf/graphics-multimedia/how-to-animate-an-object-along-a-path-point-animation](https://learn.microsoft.com/en-us/dotnet/desktop/wpf/graphics-multimedia/how-to-animate-an-object-along-a-path-point-animation) -122. How to move a model in Navisworks \- Autodesk, 访问时间为 八月 11, 2025， [https://www.autodesk.com/support/technical/article/caas/sfdcarticles/sfdcarticles/How-to-move-a-model-in-Navisworks.html](https://www.autodesk.com/support/technical/article/caas/sfdcarticles/sfdcarticles/How-to-move-a-model-in-Navisworks.html) -123. How To Make An Object Follow A Path In Three.js \- YouTube, 访问时间为 八月 11, 2025， [https://www.youtube.com/watch?v=nwiaqLGAyjo](https://www.youtube.com/watch?v=nwiaqLGAyjo) -124. Navisworks · SavedViewpointAnimation Class \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2017/T\_Autodesk\_Navisworks\_Api\_SavedViewpointAnimation.htm](https://apidocs.co/apps/navisworks/2017/T_Autodesk_Navisworks_Api_SavedViewpointAnimation.htm) -125. Navisworks Tutorial \- Animating objects \- YouTube, 访问时间为 八月 11, 2025， [https://www.youtube.com/watch?v=9oYrcjxeyWM](https://www.youtube.com/watch?v=9oYrcjxeyWM) -126. Animating Object Doors in Navisworks: A Step-By-Step Guide | VDCI.edu, 访问时间为 八月 11, 2025， [https://vdci.edu/learn/cad/animating-object-doors-in-navisworks](https://vdci.edu/learn/cad/animating-object-doors-in-navisworks) -127. Can naviswork Api work with animator? \- Autodesk Community, 访问时间为 八月 11, 2025， [https://forums.autodesk.com/t5/navisworks-api/can-naviswork-api-work-with-animator/td-p/3414831](https://forums.autodesk.com/t5/navisworks-api/can-naviswork-api-work-with-animator/td-p/3414831) -128. How to Use Animation in Navisworks — Part 1 \- YouTube, 访问时间为 八月 11, 2025， [https://www.youtube.com/watch?v=69Dygkw6KcA](https://www.youtube.com/watch?v=69Dygkw6KcA) -129. Navisworks Help | Record and Play Back Animations | Autodesk, 访问时间为 八月 11, 2025， [https://help.autodesk.com/view/NAV/2025/ENU/?guid=GUID-23867287-0FD7-4A96-849C-4FAA6F72F0C7](https://help.autodesk.com/view/NAV/2025/ENU/?guid=GUID-23867287-0FD7-4A96-849C-4FAA6F72F0C7) -130. Implementation of A\* \- Red Blob Games, 访问时间为 八月 11, 2025， [https://www.redblobgames.com/pathfinding/a-star/implementation.html](https://www.redblobgames.com/pathfinding/a-star/implementation.html) -131. Using Motion Animations in Navisworks Clash Detection \- Arkance Systems UK, 访问时间为 八月 11, 2025， [https://ukcommunity.arkance.world/hc/en-us/articles/21566403706386-Using-Motion-Animations-in-Navisworks-Clash-Detection](https://ukcommunity.arkance.world/hc/en-us/articles/21566403706386-Using-Motion-Animations-in-Navisworks-Clash-Detection) -132. Navisworks \- Time-Based and Soft Clash Testing \- Autodesk Help, 访问时间为 八月 11, 2025， [https://help.autodesk.com/view/NAV/2024/ENU/?guid=GUID-CB255F54-6B5E-4AF4-869D-ED06A0CDF75D](https://help.autodesk.com/view/NAV/2024/ENU/?guid=GUID-CB255F54-6B5E-4AF4-869D-ED06A0CDF75D) -133. Navisworks Help | Overview of Clash Detective Tool | Autodesk, 访问时间为 八月 11, 2025， [https://help.autodesk.com/cloudhelp/2026/ENU/Navisworks-Clash-Detective/files/GUID-36D9904E-12F3-4F82-8DD3-C2103DB0BC29.htm](https://help.autodesk.com/cloudhelp/2026/ENU/Navisworks-Clash-Detective/files/GUID-36D9904E-12F3-4F82-8DD3-C2103DB0BC29.htm) -134. (PDF) Investigations into the Use of BIM Technology for Collision ..., 访问时间为 八月 11, 2025， [https://www.researchgate.net/publication/393990649\_Investigations\_into\_the\_Use\_of\_BIM\_Technology\_for\_Collision\_Detection\_in\_the\_Comprehensive\_Layout\_of\_Building\_Electrical\_and\_Mechanical\_Pipelines](https://www.researchgate.net/publication/393990649_Investigations_into_the_Use_of_BIM_Technology_for_Collision_Detection_in_the_Comprehensive_Layout_of_Building_Electrical_and_Mechanical_Pipelines) -135. Navisworks API \- Create Clash test? : r/bim \- Reddit, 访问时间为 八月 11, 2025， [https://www.reddit.com/r/bim/comments/1l5494a/navisworks\_api\_create\_clash\_test/](https://www.reddit.com/r/bim/comments/1l5494a/navisworks_api_create_clash_test/) -136. Clash Detective \- Navisworks \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2018/87317537-2911-4c08-b492-6496c82b3ee5.htm](https://apidocs.co/apps/navisworks/2018/87317537-2911-4c08-b492-6496c82b3ee5.htm) -137. To Run a Clash test using api \- Autodesk Community, 访问时间为 八月 11, 2025， [https://forums.autodesk.com/t5/navisworks-api/to-run-a-clash-test-using-api/td-p/6607309](https://forums.autodesk.com/t5/navisworks-api/to-run-a-clash-test-using-api/td-p/6607309) -138. flyingturtle13/Navis-Clash\_Data\_Exporter: Exports Navisworks Clash Detective data to be consumed by Power BI Clash Metrics Reports \- GitHub, 访问时间为 八月 11, 2025， [https://github.com/flyingturtle13/Navis-Clash\_Data\_Exporter](https://github.com/flyingturtle13/Navis-Clash_Data_Exporter) -139. Forge-Navisworks-ClashTest/Navisworks Plugin/Class1.cs at master \- GitHub, 访问时间为 八月 11, 2025， [https://github.com/xiaodongliang/Forge-Navisworks-ClashTest/blob/master/Navisworks%20Plugin/Class1.cs](https://github.com/xiaodongliang/Forge-Navisworks-ClashTest/blob/master/Navisworks%20Plugin/Class1.cs) -140. ApiDocs.co · Navisworks · ClashTest Class, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2018/T\_Autodesk\_Navisworks\_Api\_Clash\_ClashTest.htm](https://apidocs.co/apps/navisworks/2018/T_Autodesk_Navisworks_Api_Clash_ClashTest.htm) -141. Collision detection \- Wikipedia, 访问时间为 八月 11, 2025， [https://en.wikipedia.org/wiki/Collision\_detection](https://en.wikipedia.org/wiki/Collision_detection) -142. Continuous Collision Detection (Background Information), 访问时间为 八月 11, 2025， [https://digitalrune.github.io/DigitalRune-Documentation/html/138fc8fe-c536-40e0-af6b-0fb7e8eb9623.htm](https://digitalrune.github.io/DigitalRune-Documentation/html/138fc8fe-c536-40e0-af6b-0fb7e8eb9623.htm) -143. gamedev.stackexchange.com, 访问时间为 八月 11, 2025， [https://gamedev.stackexchange.com/questions/34198/when-to-use-collision-detection-methods\#:\~:text=Continuous%20vs%20discrete%20determines%20how,time%20that%20collision%20will%20be.](https://gamedev.stackexchange.com/questions/34198/when-to-use-collision-detection-methods#:~:text=Continuous%20vs%20discrete%20determines%20how,time%20that%20collision%20will%20be.) -144. Real-time Collision Detection with Implicit Objects \- DiVA portal, 访问时间为 八月 11, 2025， [https://www.diva-portal.org/smash/get/diva2:343820/FULLTEXT01.pdf](https://www.diva-portal.org/smash/get/diva2:343820/FULLTEXT01.pdf) -145. Navisworks \- Highlight Clashes \- Autodesk Help, 访问时间为 八月 11, 2025， [https://help.autodesk.com/view/NAV/2025/ENU/?guid=GUID-CE709428-BE16-461C-BA5F-3CA9874EB392](https://help.autodesk.com/view/NAV/2025/ENU/?guid=GUID-CE709428-BE16-461C-BA5F-3CA9874EB392) -146. Navisworks · Graphics.Line Method (Point3D, Point3D) \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2018/M\_Autodesk\_Navisworks\_Api\_Graphics\_Line\_2\_92bd7b81.htm](https://apidocs.co/apps/navisworks/2018/M_Autodesk_Navisworks_Api_Graphics_Line_2_92bd7b81.htm) -147. Navisworks · Graphics.Polyline3D Method \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2017/M\_Autodesk\_Navisworks\_Api\_Graphics\_Polyline3D\_1\_7dde8a79.htm](https://apidocs.co/apps/navisworks/2017/M_Autodesk_Navisworks_Api_Graphics_Polyline3D_1_7dde8a79.htm) -148. Navisworks · Graphics.Vertex Method \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2018/M\_Autodesk\_Navisworks\_Api\_Graphics\_Vertex\_1\_067fe20b.htm](https://apidocs.co/apps/navisworks/2018/M_Autodesk_Navisworks_Api_Graphics_Vertex_1_067fe20b.htm) -149. ModelGeometry Members \- Navisworks \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2018/AllMembers\_T\_Autodesk\_Navisworks\_Api\_ModelGeometry.htm](https://apidocs.co/apps/navisworks/2018/AllMembers_T_Autodesk_Navisworks_Api_ModelGeometry.htm) -150. Creating a Polyline3d without using Transactions \- AutoCAD DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/autocad/2012/06/creating-a-polyline3d-without-using-transactions.html](https://adndevblog.typepad.com/autocad/2012/06/creating-a-polyline3d-without-using-transactions.html) -151. Navisworks · Graphics Class \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2018/T\_Autodesk\_Navisworks\_Api\_Graphics.htm](https://apidocs.co/apps/navisworks/2018/T_Autodesk_Navisworks_Api_Graphics.htm) -152. Get geometry primitive in Navisworks \- Autodesk Community, 访问时间为 八月 11, 2025， [https://forums.autodesk.com/t5/navisworks-api/get-geometry-primitive-in-navisworks/td-p/11848882](https://forums.autodesk.com/t5/navisworks-api/get-geometry-primitive-in-navisworks/td-p/11848882) -153. Creating Civil 3D TIN Surface from Contours (Polylines) using .NET API \- AEC DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/infrastructure/2014/01/creating-civil-3d-tin-surface-from-contours-polylines-using-net-api.html](https://adndevblog.typepad.com/infrastructure/2014/01/creating-civil-3d-tin-surface-from-contours-polylines-using-net-api.html) -154. How to draw lines in Viewport3D? \- Microsoft Q\&A, 访问时间为 八月 11, 2025， [https://learn.microsoft.com/en-us/answers/questions/357742/how-to-draw-lines-in-viewport3d](https://learn.microsoft.com/en-us/answers/questions/357742/how-to-draw-lines-in-viewport3d) -155. How to Build a 3D CAD Viewer in C\# from Scratch Using Eyeshot (devDept), 访问时间为 八月 11, 2025， [https://blog.prototechsolutions.com/build-a-3d-cad-viewer-in-c-using-eyeshot/](https://blog.prototechsolutions.com/build-a-3d-cad-viewer-in-c-using-eyeshot/) -156. Navisworks · Graphics.Bitmap Method (Int32, Point2D, UInt32, UInt32, Double) \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2017/M\_Autodesk\_Navisworks\_Api\_Graphics\_Bitmap\_5\_7f9a8f4d.htm](https://apidocs.co/apps/navisworks/2017/M_Autodesk_Navisworks_Api_Graphics_Bitmap_5_7f9a8f4d.htm) -157. Side Loading \- Manually Installing a Navisworks Plugin | House of BIM, 访问时间为 八月 11, 2025， [https://www.houseofbim.com/posts/side-loadingmanually-installing-a-navisworks-plugin/](https://www.houseofbim.com/posts/side-loadingmanually-installing-a-navisworks-plugin/) -158. Navisworks Help | Draw Links in 3D Mode | Autodesk, 访问时间为 八月 11, 2025， [https://help.autodesk.com/view/NAV/2024/ENU/?guid=GUID-90EC4AF5-2940-45F7-A2B5-7AA41362C4B8](https://help.autodesk.com/view/NAV/2024/ENU/?guid=GUID-90EC4AF5-2940-45F7-A2B5-7AA41362C4B8) -159. Determining the Face Tangent at a Picked Point \- The Building Coder \- TypePad, 访问时间为 八月 11, 2025， [https://thebuildingcoder.typepad.com/blog/2015/02/determining-the-face-tangent-at-a-picked-point.html](https://thebuildingcoder.typepad.com/blog/2015/02/determining-the-face-tangent-at-a-picked-point.html) -160. Edge or Face by point coordinates \- Manufacturing DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/manufacturing/2012/12/edge-or-face-by-point-coordinates.html](https://adndevblog.typepad.com/manufacturing/2012/12/edge-or-face-by-point-coordinates.html) -161. Navisworks · ProjectionResult Class \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2017/T\_Autodesk\_Navisworks\_Api\_ProjectionResult.htm](https://apidocs.co/apps/navisworks/2017/T_Autodesk_Navisworks_Api_ProjectionResult.htm) -162. ProjectWithGuessPoint Method \- Revit API Docs, 访问时间为 八月 11, 2025， [https://www.revitapidocs.com/2024/db8cc42a-9f34-611a-d9c5-852f3935887f.htm](https://www.revitapidocs.com/2024/db8cc42a-9f34-611a-d9c5-852f3935887f.htm) -163. How to Use Blender's Snapping Feature (Tutorial) \- YouTube, 访问时间为 八月 11, 2025， [https://www.youtube.com/watch?v=-c0Evpf8V3A](https://www.youtube.com/watch?v=-c0Evpf8V3A) -164. Snap Mode Toolbox \- Bentley Product Documentation, 访问时间为 八月 11, 2025， [https://docs.bentley.com/LiveContent/web/Promis.e%20Help-v11/en/SnapMode.html](https://docs.bentley.com/LiveContent/web/Promis.e%20Help-v11/en/SnapMode.html) -165. Precision Measurement Tips in Navisworks\! \- YouTube, 访问时间为 八月 11, 2025， [https://www.youtube.com/watch?v=Cn7ynNcPkXE](https://www.youtube.com/watch?v=Cn7ynNcPkXE) -166. Snapping to an object \- Vectorworks, 访问时间为 八月 11, 2025， [http://app-help.vectorworks.net/2022/eng/VW2022\_Guide/Basic2/Snapping\_to\_an\_object.htm](http://app-help.vectorworks.net/2022/eng/VW2022_Guide/Basic2/Snapping_to_an_object.htm) -167. Using Ray Casting To Move 3D Objects // OpenGL Tutorial \#32 \- YouTube, 访问时间为 八月 11, 2025， [https://www.youtube.com/watch?v=lj5hx6pa\_jE](https://www.youtube.com/watch?v=lj5hx6pa_jE) -168. Navisworks 2014 API new feature InputPlugin \- AEC DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/2013/05/navisworks-2014-api-new-feature-inputplugin.html](https://adndevblog.typepad.com/aec/2013/05/navisworks-2014-api-new-feature-inputplugin.html) -169. Using Point Clouds in Navisworks \- YouTube, 访问时间为 八月 11, 2025， [https://www.youtube.com/watch?v=HPHmsD1kF5U](https://www.youtube.com/watch?v=HPHmsD1kF5U) -170. ApiDocs.co · Navisworks · View.PickItemFromPoint Method (Int32, Int32, Int32, Boolean), 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2018/M\_Autodesk\_Navisworks\_Api\_View\_PickItemFromPoint\_4\_300d0cd3.htm](https://apidocs.co/apps/navisworks/2018/M_Autodesk_Navisworks_Api_View_PickItemFromPoint_4_300d0cd3.htm) -171. Xiaodong Liang \- AEC DevBlog \- TypePad, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/xiaodong-liang/page/3/](https://adndevblog.typepad.com/aec/xiaodong-liang/page/3/) -172. 3D viewport layouts in Motion \- Apple Support (BY), 访问时间为 八月 11, 2025， [https://support.apple.com/en-by/guide/motion/motn17c69bbf/mac](https://support.apple.com/en-by/guide/motion/motn17c69bbf/mac) -173. Display Viewport \- Foundry Learn, 访问时间为 八月 11, 2025， [https://learn.foundry.com/modo/content/help/pages/modo\_interface/viewports/utility/display.html](https://learn.foundry.com/modo/content/help/pages/modo_interface/viewports/utility/display.html) -174. Animate the camera—ArcGIS Pro | Documentation, 访问时间为 八月 11, 2025， [https://pro.arcgis.com/en/pro-app/3.4/help/mapping/animation/animate-the-camera.htm](https://pro.arcgis.com/en/pro-app/3.4/help/mapping/animation/animate-the-camera.htm) -175. Custom Ribbon of Navisworks part 1 \- AEC DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/2012/07/custom-ribbon-of-navisworks-part-1.html](https://adndevblog.typepad.com/aec/2012/07/custom-ribbon-of-navisworks-part-1.html) -176. Navisworks .NET: Create Ribbon Using CommandHandlerPlugin/CommandAttribute/RibbonTabAttribute/RibbonLayoutAttribute/StringsAttribute/PluginAttribute/.XAML/Local Name File \- RevitNetAddinWizard & NavisworksNetAddinWizard, 访问时间为 八月 11, 2025， [https://spiderinnet.typepad.com/blog/2013/11/navisworks-net-create-ribbon-using-commandhandlerplugincommandattributeribbontabattributeribbonlayoutattributestringsat.html](https://spiderinnet.typepad.com/blog/2013/11/navisworks-net-create-ribbon-using-commandhandlerplugincommandattributeribbontabattributeribbonlayoutattributestringsat.html) -177. Navisworks · RibbonLayoutAttribute Constructor \- ApiDocs.co, 访问时间为 八月 11, 2025， [https://apidocs.co/apps/navisworks/2018/C\_Autodesk\_Navisworks\_Api\_Plugins\_RibbonLayoutAttribute\_ctor\_1\_362212bd.htm](https://apidocs.co/apps/navisworks/2018/C_Autodesk_Navisworks_Api_Plugins_RibbonLayoutAttribute_ctor_1_362212bd.htm) -178. What's New in Navisworks 2026 \- Autodesk Help, 访问时间为 八月 11, 2025， [https://help.autodesk.com/view/NAV/2026/ENU/?guid=Navisworks\_Whats\_New\_2026](https://help.autodesk.com/view/NAV/2026/ENU/?guid=Navisworks_Whats_New_2026) -179. Navisworks .NET: Create All Kinds of Ribbon Buttons and Controls, 访问时间为 八月 11, 2025， [https://spiderinnet.typepad.com/blog/2014/01/navisworks-net-create-all-kinds-of-ribbon-buttons-and-controls.html](https://spiderinnet.typepad.com/blog/2014/01/navisworks-net-create-all-kinds-of-ribbon-buttons-and-controls.html) -180. Add Custom Panel and Button to Built-in Tab of Navisworks Ribbon \- AEC DevBlog, 访问时间为 八月 11, 2025， [https://adndevblog.typepad.com/aec/2016/01/add-custom-panel-and-button-to-built-in-tab-of-navisworks-ribbon.html](https://adndevblog.typepad.com/aec/2016/01/add-custom-panel-and-button-to-built-in-tab-of-navisworks-ribbon.html) -181. Dockable Windows \- YouTube, 访问时间为 八月 11, 2025， [https://www.youtube.com/watch?v=DleiMs0n9Mk](https://www.youtube.com/watch?v=DleiMs0n9Mk) -182. NVIDIA Omniverse: Modern Collaborative Workflows | Autodesk University, 访问时间为 八月 11, 2025， [https://www.autodesk.com/autodesk-university/class/NVIDIA-Omniverse-Modern-Collaborative-Workflows-2021](https://www.autodesk.com/autodesk-university/class/NVIDIA-Omniverse-Modern-Collaborative-Workflows-2021) -183. 3D-simulation software to optimize factory planning \- tarakos GmbH, 访问时间为 八月 11, 2025， [https://www.tarakos.de/en/simulation-software.html](https://www.tarakos.de/en/simulation-software.html) -184. Sim Logistics AB \- Flow simulation, 访问时间为 八月 11, 2025， [https://www.simlogistics.se/flow-simulation](https://www.simlogistics.se/flow-simulation) -185. Explore DELMIA Digital Manufacturing Solutions \- Vias3D, 访问时间为 八月 11, 2025， [https://vias3d.com/delmia/](https://vias3d.com/delmia/) -186. 3DEXPERIENCE DELMIA Factory Simulation – 3D Virtual Twin \- Hawk Ridge Systems, 访问时间为 八月 11, 2025， [https://hawkridgesys.com/3dexperience-delmia-factory-simulation](https://hawkridgesys.com/3dexperience-delmia-factory-simulation) -187. DELMIAWorks | Dassault Systèmes, 访问时间为 八月 11, 2025， [https://www.3ds.com/products/delmia/delmiaworks](https://www.3ds.com/products/delmia/delmiaworks) \ No newline at end of file diff --git a/doc/design/2026/寻路算法的对比.md b/doc/design/2026/寻路算法的对比.md new file mode 100644 index 0000000..4172003 --- /dev/null +++ b/doc/design/2026/寻路算法的对比.md @@ -0,0 +1,72 @@ +# Field D\*算法评估与对比 + +在物流路径规划中，选择合适的算法至关重要，它直接影响路径的质量、计算效率以及对环境变化的适应性。我们将Field D\*、D\*和A\*这三种算法进行对比，以评估它们在您项目中的适用性。 + +## 1. A\*算法 + +A\*算法是一种广泛使用的路径规划算法，它通过结合Dijkstra算法的全局最优性（保证找到最短路径）和贪婪最佳优先搜索的效率（通过启发式函数引导搜索），在已知静态环境中寻找从起点到单一目标的最短路径 [1, 2, 3, 4]。 + +* **优点：** + * **效率高：** 相较于Dijkstra算法，A\*在大型图上针对单一目标搜索时显著更快，因为它会优先探索那些看起来更接近目标的路径 [2, 3]。 + * **最优性：** 如果启发式函数是可容许且一致的，A\*能保证找到最短路径 [1]。 + * **实现相对简单：** 有大量现成的C#实现和教程可供参考 [5, 1, 6]。 +* **缺点：** + * **静态环境：** A\*算法主要为静态环境设计。当环境发生变化（例如，新的障碍物出现或门的状态改变）时，需要重新运行整个算法来计算新路径，这可能导致计算开销 [3]。 + * **路径“锯齿状”：** 在离散网格上，A\*生成的路径通常是沿着网格线或对角线移动的，可能看起来不够平滑或“自然”，尤其是在允许8方向移动时 [7]。 + +## 2. D\*算法 (Dynamic A\*) + +D\*算法（Dynamic A\*）是A\*算法的扩展，专门用于在**未知或动态变化的环境**中进行路径规划和重新规划 [8]。它通过结合前向和后向搜索，能够高效地在环境发生变化时更新路径，而无需从头开始重新计算 [8]。 + +* **优点：** + * **高效重新规划：** D\*的核心优势在于其能够高效地处理环境变化并重新规划路径 [8]。当障碍物出现或消失时，它能快速适应。 + * **适应动态环境：** 适用于环境信息不完全已知或持续变化的场景，例如机器人探索未知地形 [8]。 +* **缺点：** + * **复杂性高：** 相较于A\*，D\*算法的实现更为复杂，需要维护更多的内部信息（如OPEN/CLOSED集合、路径树和g值） [3, 8]。 + * **计算成本和内存开销：** 尽管能够高效重新规划，但D\*的初始计算和维护成本通常高于A\* [3, 8]。 + * **路径平滑性：** 类似于A\*，D\*在离散网格上生成的路径也可能存在“锯齿状”问题，因为它仍然基于网格单元格之间的离散移动。 +* **变体：** D\* Lite是D\*的一个简化版本，更高效且易于实现，常用于自主车辆和机器人领域 [8]。研究表明，D\* Lite在处理高密度动态环境（如交通拥堵）时表现出卓越的适应性和鲁棒性，能够动态重新计算路线并成功完成任务，而A\*在某些情况下可能会失败或卡住 [9]。 + +## 3. Field D\*算法 + +Field D\*算法是D\*算法的一种变体，它在D\*处理动态环境能力的基础上，进一步优化了路径的平滑性和自然度 [7]。它通过**插值**技术，允许路径上的航点位于网格边缘的任意位置，而不是局限于网格单元格的中心，从而生成更直接、低成本且平滑的路径，尤其适用于非均匀成本环境 [7]。 + +* **优点：** + * **路径平滑性：** 这是Field D\*最显著的优势。它解决了传统网格路径规划器中离散状态转换导致路径不自然的问题，能够生成更适合车辆运动的平滑路径 [7]。 + * **处理非均匀成本：** 能够很好地处理网格中不同区域的非均匀移动成本，这对于您项目中门（高成本）和通道（低成本）的属性设置非常有利 [7]。 + * **动态环境适应性：** 继承了D\*算法处理动态环境和高效重新规划的能力 [7, 8]。 +* **缺点：** + * **最高复杂性：** Field D\*是这三种算法中最复杂的，其插值和节点定义（在网格角点而非中心）增加了实现的难度和潜在的计算开销 [7, 8]。 + * **计算量：** 尽管它能生成更优的路径，但为了实现平滑性，可能需要更多的计算资源，这与您“减少计算量”的目标可能存在冲突 [8]。 + +## 算法对比总结 + +下表总结了三种算法的关键特性： + +| 特性/算法 | Dijkstra | A\* | D\* (Dynamic A\*) | Field D\* | +| :-------- | :------- | :-- | :---------------- | :-------- | +| **核心目的** | 寻找从起点到所有可达节点的最短路径 | 寻找从起点到单一目标的最短路径 | 在未知/动态环境中高效重新规划路径 | 在动态/非均匀成本环境中生成平滑且最优的路径 | +| **环境类型** | 静态 | 静态（环境变化需重新运行） | 动态/未知 | 动态/非均匀成本 | +| **路径质量** | 最优（最短） | 最优（最短，若启发式函数可容许） | 最优（最短，支持重新规划） | 最优（最短，且路径更平滑自然） | +| **计算成本** | 对于单一目标搜索，在大图上效率较低 | 对于单一目标搜索，比Dijkstra高效 | 比A\*复杂，维护成本和内存开销更高 | 最复杂，插值计算可能增加计算量 | +| **主要优势** | 保证找到所有最短路径 | 静态环境中单目标路径规划的效率和最优性 | 环境变化时高效重新规划，适应动态环境 | 生成高度平滑的路径，处理非均匀成本，适应动态环境 | +| **主要劣势** | 不适合单目标搜索，效率低 | 环境变化需完全重新计算，路径可能“锯齿状” | 实现复杂，资源消耗相对较高 | 实现最复杂，计算开销可能最高，可能超出项目简化需求 | +| **项目适用性** | 不推荐（过于通用） | **推荐作为首选**：高效、成熟，适合大部分静态障碍物场景，可通过重新运行应对门状态变化。 | **可选**：如果门状态频繁变化或有临时障碍物，D\* Lite可能是一个折衷方案，提供动态适应性。 | **有潜力，但需权衡**：能生成更适合车辆的平滑路径，并处理门/通道的非均匀成本。但其复杂性和潜在的计算开销可能与“减少计算量”的目标相悖。 | + +## Field D\*在本项目中的适用性评估 + +根据您的项目需求，即“检测车辆能否无碰撞的到达终点”、“2.5D场景尽量简化，减少计算量”，并考虑到“路径中经过的门、通道等，可以设置通过性和限制性属性”，以下是Field D\*的适用性分析： + +1. **路径平滑性：** Field D\*能够生成平滑的路径 [7]，这对于物流车辆在大型建筑中行驶非常有利，因为实际车辆的运动不是严格的90度或45度转弯。如果路径的“自然度”和可行驶性是关键要求，Field D\*具有明显优势。 +2. **非均匀成本环境：** 项目中门和通道的“通过性和限制性属性”可以很好地映射到Field D\*处理非均匀成本网格的能力 [7]。例如，通过门可以设置更高的成本，而通过指定通道可以设置更低的成本，从而引导车辆优先选择更优的路线。 +3. **动态环境适应性：** 尽管大型建筑的结构（墙壁、柱子）是静态的，但门的状态（开/关）或临时障碍物的出现可以被视为动态变化。Field D\*继承了D\*的动态重新规划能力 [8]，这意味着当这些属性或环境发生变化时，插件可以更高效地更新路径，而无需完全重新计算。 + +然而，Field D\*的**复杂性和潜在的计算开销**是需要重点考虑的因素 [8]。您明确要求“尽量简化，减少计算量”。Field D\*的插值计算和更复杂的节点定义可能会增加计算负担，这可能与您的简化目标相悖。对于一个主要由静态障碍物构成的2.5D环境，且动态变化（如门状态）相对较少或可控的场景，一个经过优化的A\*算法（例如，使用高效的优先队列和结构体节点 [5]）可能已经足够，并且在计算量上更具优势。 + +**结论：** + +* **A\*算法**是您项目的**首选**。它在静态环境中表现出色，计算效率高，且实现相对简单。对于门的状态变化，可以通过在每次状态改变时重新运行A\*来处理，或者在网格构建时动态调整相关单元格的成本。 +* **Field D\*算法**在生成**平滑路径**和处理**非均匀成本**方面具有显著优势，这对于物流车辆的实际行驶非常理想。如果路径的平滑性和自然度是项目的核心且不可妥协的需求，并且您有能力投入更多精力处理其更高的实现复杂性和潜在的计算开销，那么Field D\*是一个值得深入研究的**高级选项**。 +* **D\* Lite**可以作为A\*和Field D\*之间的一个**折衷方案**。它提供了D\*的动态重新规划能力，但比完整的Field D\*更简单、更高效，适用于门状态频繁变化或有少量临时障碍物的场景。 + +在项目初期，建议从实现一个高效的A\*算法开始，因为它能满足核心的无碰撞路径规划需求，并符合“减少计算量”的目标。如果后续测试发现路径平滑性或对动态变化的响应速度成为瓶颈，再考虑升级到Field D\*或D\* Lite，以逐步增加复杂性。 diff --git a/doc/design/2026/物流路径规划方案.md b/doc/design/2026/物流路径规划方案.md new file mode 100644 index 0000000..edffbb8 --- /dev/null +++ b/doc/design/2026/物流路径规划方案.md @@ -0,0 +1,456 @@ + + +# **Navisworks 2026物流路径规划插件：BIM环境中无碰撞车辆导航的高级实现指南** + +## **I. 执行摘要** + +本报告旨在详细阐述在Navisworks 2026中开发C\#插件的综合方案，以实现大型建筑模型内物流车辆的自动化、无碰撞路径规划。该解决方案的核心在于智能模型数据提取、基于网格的A\*路径规划算法、简化的包围盒碰撞检测以及强大的路径可视化和数据导出功能。本插件能够克服原生模型属性中缺乏明确物流属性的挑战，显著降低计算开销，并生成可操作的导航地图，从而大幅提升大型建筑环境中的运营效率。通过精确识别和分类模型元素、高效计算最优路径以及直观地展示结果，本插件为现代物流管理提供了关键的数字工具。 + +## **II. BIM中的物流路径规划概述** + +### **问题陈述与项目目标** + +在大型多层建筑（如仓库、工厂或大型商业综合体）中，物流运营面临着优化车辆移动的严峻挑战。手动路径规划耗时、易出错，并且通常无法有效适应动态变化或识别最优路线。用户提出的核心问题是，在Navisworks模型中，针对特定楼层内的物流车辆（例如叉车、托盘搬运车），需要实现自动化的路径规划，以确保无碰撞。鉴于原生BIM数据中缺少明确的“物流”属性，这要求从建筑元素的几何和通用BIM属性中推断出它们的角色（如墙壁、柱子、门、通道）。 + +本插件的主要目标包括： + +1. **高效识别和分类模型元素：** 开发方法，即使在缺乏专用属性的情况下，也能快速识别和分类与物流规划相关的元素（障碍物、可通行通道、门）。 +2. **自动化无碰撞路径规划：** 实现一个鲁棒的算法，在用户定义的起点和终点之间生成最优路径，确保与静态障碍物或其他指定禁行区域无碰撞。 +3. **在Navisworks中可视化路径：** 直接在Navisworks视口中渲染计算出的路径，以便即时进行视觉验证和用户反馈。 +4. **导出可导航地图数据：** 以结构化、机器可读的格式（例如JSON）输出规划的路径和相关信息，以便与外部物流或导航系统集成。 +5. **最小化计算负荷：** 采用简化的碰撞检测技术（包围盒）和优化算法，确保在大型复杂模型中也能实现响应式性能。 + +### **插件范围** + +本插件专为Navisworks 2026设计，并使用C\#.NET开发。其初始范围仅限于**2.5D路径规划**，这意味着它在建筑物的特定楼层内运行。这种简化通过消除垂直导航（楼梯、电梯、楼层之间的坡道）的考虑，显著降低了路径规划问题的复杂性。重点在于以车辆为中心的规划，其中车辆的物理尺寸通过简化的包围盒表示来考虑。碰撞检测被简化为包围盒交叉，这是一种在精度和计算效率之间取得平衡的实用选择，适用于此特定的2.5D场景。 + +### **Navisworks API在空间分析中的概述** + +Autodesk Navisworks.NET API为与加载模型数据进行程序化交互提供了强大的接口。与本项目相关的关键功能包括： + +* **模型遍历：** 迭代ModelItem的层次结构 1，以访问单个元素。 +* **几何查询：** 检索几何属性，例如BoundingBox3D 2，用于碰撞检测和元素分类。虽然原始几何图形（ + ModelItem.Geometry 4）可访问，但本项目对包围盒简化的强调将优先考虑前者以提高性能。 +* **过滤和选择：** 根据各种标准程序化选择元素，包括空间过滤器（BoundingBoxIntersectsFilter 6）和基于属性的搜索 7。API还支持用户定义的 + SelectionSet 9，用于元素的持久分组。 +* **视口图形：** 自定义绘图功能（Graphics类，OverlayRenderModel 3）允许直接在Navisworks环境中可视化规划的路径。 +* **碰撞检测（高级/可选）：** DocumentClash API 11 提供对Navisworks原生碰撞检测引擎的程序化访问，可用于预分析或验证，但通常对于实时路径规划来说过于繁重。 + +## **III. 模型数据准备与特征提取** + +这个关键阶段解决了在缺乏明确物流属性的情况下，如何解释原始BIM模型数据以创建可导航环境进行路径规划的挑战。 + +### **识别与物流相关的模型元素** + +由于原生模型属性中缺乏明确的物流属性，需要研究更具可行性的方法来快速识别和过滤与物流规划相关的模型。 + +#### **策略1：包围盒过滤与尺寸分析** + +Navisworks API直接提供对任何ModelItem的BoundingBox3D的访问 2。诸如 + +BoundingBoxIntersectsFilter 6之类的过滤器以及 + +oNewBox.Contains(x.BoundingBox()) 15之类的方法，可以实现高效的空间查询，例如识别特定楼层体积内的所有元素。 + +Document.Models.RootItem.DescendantsAndSelf.Where(x \=\> oNewBox.Contains(x.BoundingBox())) 15模式对于广泛的空间过滤非常有效。 + +这种策略对于将元素隔离在2.5D规划平面（特定楼层）内，并推断对象的物理特性和潜在角色至关重要。通过分析元素包围盒的尺寸（长、宽、高），可以对其性质进行有根据的推断。例如，一个非常高、窄的元素可能是柱子或管道，而一个长、宽、扁平的元素可能是墙壁或楼板。 + +由于用户明确指出“原生模型属性中缺乏明确的物流属性”，这意味着直接通过属性过滤“是障碍物”或“是通道”是不可行的。然而，每个ModelItem都具有BoundingBox3D。这个包围盒的*尺寸*和*比例*可以作为分类的强大启发式依据。例如，一个Z轴尺寸（高度）非常小但X和Y尺寸很大的包围盒可能表示楼层，而一个高而细长的包围盒可能表示柱子。一个较大包围盒内的几何体间隙可能暗示着一个门洞。这要求开发一套基于典型建筑元素尺寸的启发式规则。例如，“门洞”可以被识别为一个薄的、相对较短的元素（或在墙体包围盒内检测到的空隙），其尺寸落在常见的门宽/高范围内。这超越了简单的数据检索，实现了从几何数据进行*语义推断*，这对于自动化分类至关重要。 + +虽然BoundingBoxIntersectsFilter 6对于初步的广泛过滤是高效的，但遍历 + +ModelItem.Descendants 1并对 + +*每个*后代调用BoundingBox() 2对于非常大的模型来说可能计算密集。用户提出的“减少计算量”要求至关重要。为了优化，应采用多阶段过滤过程。首先，使用 + +BoundingBoxIntersectsFilter快速将ModelItem集合缩小到仅与目标楼层包围盒相交的元素。然后，仅对这个缩小后的集合执行更详细的尺寸分析和属性检查。此外，对于静态元素，它们的包围盒数据可以在初始化期间一次性提取并缓存，避免在后续路径规划操作中重复进行API调用。 + +#### **策略2：基于属性的识别（推断性）** + +Navisworks中的“选择树窗口” 8 显示了基于类别、族、类型和实例的层次结构。这意味着这些属性可以通过API访问。尽管在片段中没有明确显示，但 + +ModelItem.GetUserFilteredPropertyCategories 2暗示了属性访问。按名称模式过滤是一种常见方法 7，在概念上适用于Navisworks。 + +即使没有专门的“物流”属性，标准的BIM属性通常也包含描述性关键词（例如，“门”、“墙”、“柱”、“管道”、“风管”、“家具”、“设备”）。这些可以进行程序化查询以分类元素。 + +仅依靠属性名称可能因不同模型或创作工具之间命名约定不一致而不可靠。同样，仅凭包围盒启发式也可能存在模糊性。因此，一个鲁棒的分类系统应*结合*这些策略。例如，首先尝试通过通用属性名称识别元素（例如，过滤“类型”或“族”属性包含“门”的ModelItem）。然后，通过检查其包围盒尺寸是否落在预期的门尺寸范围内来验证这些识别出的“门”。对于没有明确描述性属性的元素，或自定义元素，包围盒分析成为主要的备用方案。这种多层方法提高了准确性，并增强了对不同模型质量的适应性。 + +为了确保插件对多样化BIM模型和用户偏好的适应性，用于基于属性识别的关键词（例如，“墙”、“柱”、“门”、“走廊”、“坡道”、“楼梯”）不应硬编码在插件源代码中。插件应提供一个用户界面（WPF），允许用户定义和管理与不同物流分类相关的关键词列表或正则表达式（例如，“障碍物关键词”、“通道关键词”、“门关键词”）。这使得分类规则外部化，使插件在不同项目和建模标准中具有高度灵活性和可重用性，直接支持了“手工设置补充”的要求。 + +#### **策略3：手动选择与持久化集合** + +Navisworks的SelectionSet对象 9 允许对 + +ModelItem进行显式分组。用户可以从Document.CurrentSelection.SelectedItems 1 创建这些集合，并将其持久化在Navisworks文档中 9。API允许程序化创建和访问这些集合（ + +ActiveDocument.SelectionSets.CreateSelectionSource(newSelectionSet) 10）。 + +这种策略对于“支持手工设置补充”的要求至关重要。它使用户能够直接干预并分类自动化方法可能误解或完全遗漏的特定元素或区域（例如，临时施工障碍物、指定的装卸区或作为障碍物的独特建筑特征）。 + +当用户明确定义SelectionSet（例如，将一组元素标记为“禁行区”或“主要物流通道”）时，这种明确的用户意图应始终优先于任何通过属性分析或包围盒启发式推断出的自动化分类。元素分类逻辑应实现清晰的层次结构：首先，检查ModelItem是否属于任何用户定义的SelectionSet（例如，“障碍物”、“通道”、“门”）。如果找到匹配项，则应用该分类并跳过进一步的自动化推断。这确保了用户专业知识和特定项目要求得到直接整合和尊重。 + +虽然SelectionSet是持久的 9，但底层BIM模型可能会演变。元素可能被移动、删除或其属性发生变化。这可能导致手动分类过时或无效。插件应提供验证或刷新现有 + +SelectionSet的功能，使其与模型的当前状态保持一致。这可能涉及检查集合中引用的ModelItem是否仍然存在，或者它们的属性是否仍然符合集合的预期目的。插件可以突出显示或标记过时的集合，提示用户进行审查和更新，从而随着时间的推移保持用户定义数据的完整性。 + +### **创建可导航网格表示（2.5D）** + +建筑物的连续2.5D楼层空间必须离散化为统一的网格，通常是2D节点数组。每个节点代表楼层上的一个小区域（单元格）。 + +1. **定义网格范围：** 确定活动楼层的最小和最大X和Y坐标。这可以从整个楼层的包围盒或其中与物流相关的元素集合中得出。 +2. **选择网格分辨率：** 选择一个单元格大小（例如，0.5米x 0.5米）。这是一个关键参数，影响路径精度和计算负荷。 +3. **初始化网格单元格：** 创建一个2D数组（例如，GridCell\[,\]），其中每个GridCell对象包含IsWalkable（或IsTraversable）、Cost等属性，以及对占据该单元格的ModelItem的引用。 +4. **填充障碍物：** 遍历所有已识别的障碍物ModelItem。对于每个障碍物，将其BoundingBox3D投影到2D平面上，并将所有相交的网格单元格标记为IsWalkable \= false（或Cost \= infinity）。此步骤应考虑车辆的尺寸（参见下文的“膨胀障碍物”）。 +5. **填充通道/可通行区域：** 将剩余的单元格标记为IsWalkable \= true，并赋予默认Cost（例如，1）。被识别为“通道”的单元格可能会获得较低的成本。 + +A\*等路径规划算法在离散图上运行 17。此网格作为图结构，将复杂的BIM几何体抽象为简化的、可搜索的表示。 + +更精细的网格分辨率（更小的单元格大小）允许更精确的路径，这些路径更紧密地遵循建筑物和障碍物的轮廓。然而，它会指数级地增加图中的节点数量，导致内存消耗和路径规划计算时间显著增加 17 中关于“网格大小”影响渲染和计算时间的说明。因此，插件必须提供一个用户可配置的网格分辨率参数。这允许用户平衡路径精度（例如，对于狭窄的走廊）与可用的计算资源。对于典型的物流场景，通常会找到一个平衡点，其中单元格大小是车辆最小尺寸或最窄可通行路径的一小部分。 + +如果选择的网格单元格大小相对于模型的特征过大，薄障碍物（例如，小管道、栏杆，甚至薄墙）可能会被网格离散化完全忽略，或者狭窄的通道可能被错误地标记为不可通行。网格生成逻辑需要智能地处理如何将ModelItem包围盒映射到网格单元格。即使障碍物的包围盒小于单个网格单元格，如果它有效地阻挡了通行，该单元格（或相邻单元格）也应标记为障碍物。这可能涉及一个“膨胀”或“扩张”步骤，其中障碍物稍微扩大以确保它们被网格捕获，或者确保网格分辨率始终小于最小的关键特征。 + +### **处理门和通道：自动识别与默认属性** + +Navisworks API没有直接用于“门”或“通道”识别的API，但ModelItem属性 8 和包围盒 2 是主要数据源。用户明确要求“尽量自动识别并用默认物流属性规划，支持手工设置补充”。 + +门是物流路径中的关键元素，因为它们代表有条件的可通行点（开/关状态）。通道代表首选或指定的路径。这些在网格图中需要特殊处理，以影响路径规划行为。 + +**详细实现：** + +1. **自动识别：** 结合基于属性的过滤（例如，ModelItem.Name或ModelItem.Type包含“门”、“闸门”、“通道”、“走廊”）和包围盒尺寸分析（例如，墙洞中薄的矩形包围盒）来自动识别潜在的门和通道。 +2. **默认属性：** + * **门：** 默认情况下，识别出的门应被视为“可通行”，但其遍历成本应略高于开放空间（例如，成本为5，而开放空间为1）。这鼓励路径规划算法使用门，但如果存在同样短的开放路径，则不鼓励不必要地穿过它们。 + * **通道：** 识别出的通道（例如，主要走廊、指定车辆车道）应分配比普通开放空间更低的遍历成本（例如，成本为0.5或0.8）。这使得A\*算法偏向于这些指定的路线。 +3. **手动覆盖：** 插件的用户界面（WPF）应允许用户： + * 审查自动识别的门/通道。 + * 手动将其他ModelItem分类为门、通道或障碍物（使用SelectionSet 9）。 + * 调整特定门或通道的遍历成本。 + * 切换门的“开/关”状态，动态更新其可通行性（例如，关闭的门=无限成本）。 + +门并非静态障碍物；其可通行性取决于其状态（开/关）。虽然查询暗示默认的“可通行”属性，但更高级的系统会考虑这种动态状态。在网格表示中，门应由具有特定“门”属性的单元格（或一系列单元格）表示。其遍历成本应是条件性的：当“打开”时成本较低，当“关闭”时成本实际上为无限。手动覆盖功能应允许用户更改此状态，在路径规划之前动态更新网格。这通过允许实际操作考虑直接支持了“手动设置补充”要求。 + +“通道”一词暗示了物流的优选或指定路线。路径规划算法理想情况下应偏好这些路线。通过为被识别为“通道”一部分的网格单元格分配较低的遍历成本，A\*算法（它最小化总成本 18）将自然地优先选择这些路线。这允许优化不仅限于最短距离，还包括物流车辆的“最有效”或“最实用”路径，这可能涉及稍微长一点但更不拥堵或更宽的路线。 + +### **提取几何体和包围盒数据用于碰撞代理** + +用户明确要求“用包围盒的方式简化碰撞检测”。这意味着虽然原始几何体可用，但碰撞的主要数据将是包围盒。WCS转换对于整个模型中一致的空间计算至关重要。 + +1. **车辆包围盒：** 根据物流车辆（例如叉车）的实际尺寸定义一个BoundingBox3D。这将是一个常量或用户可配置的参数。 +2. **障碍物包围盒提取：** 对于所有被分类为障碍物的ModelItem，使用ModelItem.BoundingBox() 2 检索其 + BoundingBox3D。这些包围盒代表静态碰撞几何体。 +3. **坐标系一致性：** 确保所有包围盒（车辆、障碍物、楼层范围）都在相同的坐标系（世界坐标系 \- WCS）中。ModelItem.BoundingBox()通常返回WCS包围盒。如果通过COM API (GenerateSimplePrimitives()) 提取任何几何图元，则其LCS坐标需要使用GetLocalToWorldMatrix() 3 进行显式转换。 + +用户指令是“减少计算量”。片段显示，通过COM API访问原始几何体可能比使用.NET API属性显著慢 13（13显示COM几何体提取对于大型模型可能需要更长时间）。因此，插件应专门使用 + +ModelItem.BoundingBox()进行碰撞检测，因为它是一个直接的.NET API调用，并且为此目的比提取和处理原始几何图元更有效。这与性能优化目标完全一致。 + +在路径规划过程中，将执行许多碰撞检查（车辆的包围盒与多个静态障碍物之间的检查）。每次检查都重复查询或遍历所有障碍物将效率低下。因此，在识别所有静态障碍物并提取其包围盒后，应将它们存储在优化的空间数据结构中（例如，简单的2D网格覆盖、四叉树或k-d树），以便快速查询特定区域内的潜在碰撞。这种预计算显著降低了路径规划算法执行期间碰撞检查的成本。 + +## **IV. 路径规划算法选择与实现** + +本节详细介绍了生成无碰撞路径的核心逻辑，重点关注所选算法的选择和具体实现考虑。 + +### **路径规划算法评估（A\* vs. Dijkstra）** + +Dijkstra和A\*算法都常用于最短路径规划 21。A\*被描述为“与Dijkstra基本相同，只做了一个简单的修改” 22，它通过使用“到最终目的地的直线距离”（启发式）来根据边缘距离目标点的远近来优先处理边缘。关键发现是，对于相同大小的地图，A\*比Dijkstra“快约7倍”，并且找到“相同的最低成本”路径 22。GitHub主题显示了许多C\#实现 21。 + +用户查询强调“自动规划路径”和效率。A\*是一种成熟的算法，在找到最优（最短）路径和计算性能之间取得了极好的平衡，使其非常适合这种目标导向的问题。A\*是Dijkstra算法的扩展，它使用启发式函数来估计从当前节点到目标的成本，从而更直接地引导搜索。这使得A\*在大型图上的目标导向路径规划中比Dijkstra显著更快，同时仍能保证最短路径（如果启发式函数是可容许且一致的）。对于大型建筑模型，即使A\*效率很高，但对于极高网格分辨率的模型，A\*也可能变得计算密集。GitHub主题 23 提到了“分层路径规划”（HPA\*）。HPA\*可以被视为未来实现极端可扩展性的增强功能。它通过将详细网格抽象为更高级别的图（例如，连接主要房间或走廊），在该高级图上找到路径，然后仅在相关段内执行详细的A\*搜索。这为非常大型、复杂的环境带来了显著的性能提升，但增加了相当大的实现复杂性。 + +下表对Dijkstra和A\*路径规划算法进行了比较，以阐明A\*在此物流路径规划应用中的优越性： + +| 算法 | 核心原理 | 主要优点 | 主要缺点 | 适用于物流路径规划 | +| :---- | :---- | :---- | :---- | :---- | +| **Dijkstra** | 通过迭代扩展搜索，从单一起始节点找到到所有其他可达节点的最短路径，始终从成本最低的未访问节点开始。 | 保证在非负边缘权重的图中找到最短路径。 | 向所有方向探索，通常访问许多不相关的节点，对于大型图上的目标导向搜索效率较低。 | 较不理想。虽然它能找到最短路径，但其详尽的搜索对于大型建筑模型来说可能计算成本较高，尤其是在只关注单个起点和终点时。 | +| **A\*** | Dijkstra算法的扩展，使用启发式函数估计从当前节点到目标的成本，更直接地引导搜索。 | 通过探索更少的节点，在大型图上的目标导向路径规划中比Dijkstra显著更快，同时仍能保证最短路径（如果启发式函数是可容许且一致的）。 | 性能取决于启发式函数的质量；糟糕的启发式函数会降低性能，甚至比Dijkstra更差。 | **首选。** 其启发式驱动的效率使其非常适合在大型建筑模型中找到指定起点和终点之间的无碰撞路径，直接符合用户对减少计算量和自动化规划的需求。 | + +### **A\*算法在2.5D网格中的详细实现** + +#### **节点表示与网格图构建** + +路径规划算法在“节点”和“边缘”上操作 22。C\#中的 + +PathFinderNode被提及 17。节点需要坐标、成本和父指针 18。这定义了路径规划图的基本数据结构，将物理网格单元格映射到逻辑节点以供算法使用。 + +建议为网格中的每个单元格定义一个struct（而不是class）来表示PathNode（或GridCellNode）。这个struct应包含： + +* int X, Y: 网格坐标。 +* double GCost: 从起始节点到此节点的成本。 +* double HCost: 从此节点到结束节点的启发式估计成本。 +* double FCost: 总成本（GCost \+ HCost）。 +* PathNode Parent: 指向已找到的最短路径中前一个节点的引用。 +* bool IsObstacle: 指示单元格是否被阻塞。 +* bool IsDoor: 指示单元格是否为门，具有条件可通行性。 +* double BaseCost: 单元格固有的遍历成本（例如，开放空间为1，通道为0.5，门为5）。 + 网格本身将是一个PathNode\[,\]数组。 + +CodeProject文章 17 明确建议使用 + +struct而不是class来表示节点，以“减少垃圾回收开销”并提高性能，特别是对于大型网格。这是C\#特有的关键优化。struct是值类型，存储在栈上或数组中内联存储，减少了堆分配和垃圾回收压力，这对于大型网格上的路径规划等内存密集型操作的性能至关重要。 + +#### **启发式函数设计用于物流** + +启发式函数估计从当前位置到目标的距离 17。常见的启发式包括曼哈顿距离（ + +Math.Abs(a.x \- b.x) \+ Math.Abs(a.y \- b.y)）和欧几里得距离（DistanceFrom方法） 18。启发式应始终小于或等于实际距离 19 以确保最优性。 + +启发式是A\*比Dijkstra更快的原因。选择得当的启发式能有效引导搜索，减少探索的节点数量。 +实现细节： + +* 对于允许水平、垂直和对角线（8个方向）移动的2.5D网格，**欧几里得距离**通常是最合适且“可容许”的启发式：HCost \= Math.Sqrt(Math.Pow(node.X \- end.X, 2\) \+ Math.Pow(node.Y \- end.Y, 2))。 +* 如果只允许4方向（水平/垂直）移动，则**曼哈顿距离**是合适的：HCost \= Math.Abs(node.X \- end.X) \+ Math.Abs(node.Y \- end.Y)。 +* 启发式必须与GCost（实际成本）值保持一致的比例 18。 + +启发式函数的选择直接影响A\*的效率和路径的最优性。对于基于网格的路径规划，启发式应反映单元格之间移动的实际成本。如果允许对角线移动且成本均匀（例如，基数方向为1，对角线方向为sqrt(2)），则欧几里得距离是更准确的启发式。如果对角线移动受到惩罚或不允许，则曼哈顿距离更合适。对于物流车辆而言，通常允许对角线移动。因此，建议使用欧几里得距离作为启发式。启发式还在“破局”（tie-breaker）中发挥作用 17，以确保当多条路径具有相同成本时，生成更平滑的路径。 + +#### **成本计算** + +成本被分配给沿边缘移动 18。CodeProject文章 17 详细介绍了诸如“惩罚转向”（为转向增加少量成本，从而使路径更平滑）和“重对角线”（增加对角线成本以避免它们）等设置。 + +成本值允许路径规划算法优先考虑某些路径或避免其他路径，从而影响路线的“自然度”和效率，而不仅仅是寻求最短距离。 +实现细节： + +* **基本成本：** + * 开放空间：成本 \= 1.0 + * 指定通道：成本 \= 0.5（或更低，以强烈优先）。 + * 门（打开时）：成本 \= 5.0（较高成本以阻止不必要的遍历）。 + * 障碍物（或关闭的门）：成本 \= double.MaxValue（实际上是无限）。 +* **方向成本：** + * 基数（水平/垂直）移动：成本 \= BaseCost。 + * 对角线移动：成本 \= BaseCost \* Math.Sqrt(2)（如果允许对角线且不“重”）。 +* **“惩罚转向”：** 每当车辆从前一个路径段改变其基数方向时，增加少量额外成本（例如，0.1）。这鼓励更直的路径，这对于大型车辆通常更实用。 + +“惩罚转向”功能 17 直接解决了物流中的一个实际问题：车辆，特别是大型车辆，受益于更平滑、转弯更少的路径。此功能虽然可能增加绝对最短路径的长度，但会产生更“自然”且操作上可行的路线。这种成本调整与物流路径规划高度相关，因为它允许算法生成的路径不仅在几何上最短，而且在实践中对车辆操作而言是高效和安全的。 + +除了静态成本，更高级的系统可以根据实时交通（如果集成）、临时障碍物，甚至通道宽度（例如，较窄的通道会产生更高的成本）等因素动态调整成本。这允许“智能路由”，根据不断变化的条件或根据车辆类型（例如，大型车辆可能更喜欢更宽、成本更低的通道）优先选择路径。这需要持续更新网格的成本值。 + +#### **优先队列优化** + +“一个好的A\*实现不应使用标准的ArrayList或List来存储开放节点。如果使用标准的List，算法将花费大量时间搜索该列表中的节点。相反，应该使用优先队列。” 17。Python的 + +heapq被提及 18。C\#在.NET 6+中有一个内置的 + +PriorityQueue\ 18。较旧的C\#实现可能使用自定义二叉堆 18。 + +优先队列是高效检索A\*搜索期间具有最低FCost（总估计成本）的节点的数据结构。其效率对于算法的整体性能至关重要。 +实现细节： + +* **建议：** 利用.NET 6及更高版本中提供的System.Collections.Generic.PriorityQueue\类。这是一个高度优化的、基于堆的实现。 +* **对于较旧的.NET框架：** 如果目标是较旧的.NET框架（例如，Navisworks 2026的.NET Framework 4.7 13），则需要使用基于二叉堆的自定义优先队列实现（如游戏开发库或CodeProject示例中常见 17）。 +* put（入队）和get（出队）操作的复杂度应为O(log N)。 + +CodeProject文章 17 明确指出，用优先队列和“计算网格”（用于对节点的O(1)访问）替换标准列表，导致性能“快300到1500倍”。这不是一个小的改进；这是算法效率的根本性转变。这是在此上下文中A\*算法最关键的优化之一。一个天真的优先队列实现（例如，不断对 + +List进行排序）将严重影响大型网格的性能。开发人员*必须*使用高效的、基于堆的优先队列。 + +#### **处理动态障碍物和车辆尺寸** + +查询明确提到对“物流车辆、通道和障碍物”使用“包围盒的方式简化碰撞检测”。 + +路径规划算法通常作用于“点”代理。为了确保具有实际尺寸的车辆无碰撞路径，必须调整环境（障碍物）以考虑车辆的尺寸。 +实现细节： + +* **障碍物膨胀（Minkowski Sum）：** 在运行A\*算法之前，将网格上的所有静态障碍物膨胀车辆最大尺寸的一半（例如，其宽度或对角线的一半）。这意味着如果一个网格单元格被障碍物占据，或者在障碍物包围盒的某个半径内，它也应被标记为障碍物。这有效地将非点车辆的路径规划问题转换为在“膨胀”地图上为点进行路径规划。 +* **车辆包围盒用于路径验证：** 虽然网格是膨胀的，但车辆的实际包围盒将在碰撞检测阶段用于根据障碍物的原始、未膨胀几何体验证生成的路径，确保不会因网格近似而产生误报或漏报。 + +通过在A\*路径规划算法运行之前，将障碍物膨胀以考虑车辆尺寸，而不是在算法的每一步都执行复杂的车辆与障碍物包围盒交叉检查，可以简化运行时碰撞逻辑，使其仅需检查网格单元格是否可通行。这种“Minkowski和”方法显著降低了A\*搜索期间的计算负担，直接支持了“减少计算量”的目标。路径规划算法随后只需考虑一个点是否可以通过膨胀的网格移动。 + +虽然包围盒膨胀处理了车辆的整体占地面积，但它并未固有地考虑车辆的*方向*或*最小转弯半径*。在膨胀网格上找到的路径可能在几何上是清晰的，但由于急转弯而无法由实际车辆执行。对于需要更高保真度（例如，非常狭窄、蜿蜒的路径）的场景，这种简化方法可能需要增强。这可能涉及为急转弯增加额外的成本惩罚（如“惩罚转向” 17），或者在高级情况下，使用包含运动学约束的更复杂路径规划算法。对于当前的2.5D简化目标，包围盒膨胀是一种实用且高效的解决方案。 + +## **V. 碰撞检测策略** + +插件的核心目的是确保无碰撞路径。本节详细介绍了所选的简化包围盒方法，并将其与Navisworks的原生碰撞检测工具（Clash Detective）进行对比，解释了为何前者更适用于实时路径验证。 + +### **2.5D场景的简化包围盒碰撞检测** + +ModelItem.BoundingBox() 2 提供了任何模型项的轴对齐包围盒。 + +BoundingBox3D类具有Intersects方法 24，用于检查两个包围盒之间的交集。 + +BoundingBoxIntersectsFilter 6 可用于过滤。 + +这种方法直接满足了用户对“包围盒的方式简化碰撞检测”以“减少计算量”的要求。它是一种计算开销较小的方法，适用于路径规划过程中频繁的检查。 +实现细节： + +1. **车辆包围盒：** 为每个路径段检查创建一个代表车辆尺寸的BoundingBox3D。其位置将更新以匹配计算路径上的当前点。 +2. **障碍物包围盒缓存：** 在“模型数据准备”阶段（第三节），所有静态障碍物（墙壁、柱子、固定设备）的BoundingBox3D将使用ModelItem.BoundingBox()提取并存储在可访问的集合或空间索引中。 +3. **交集测试：** 对于路径的每个建议步骤（或段），将检查车辆当前的BoundingBox3D是否与所有相关静态障碍物的包围盒发生交集，使用BoundingBox3D.Intersects()。如果检测到交集，则该路径段（或整个路径，取决于验证阶段）被视为无效。 +4. **2.5D简化：** 由于规划是2.5D的，包围盒的Z轴尺寸（高度）可以简化或忽略，主要关注X-Y平面交集。然而，确保车辆高度能通过上方障碍物（例如，低梁、风管）可能仍需要Z轴检查。 + +BoundingBox3D.Intersects()方法 24 是Navisworks核心API的一部分。这种方法很可能是在优化的原生代码中实现的，因此比任何涉及迭代几何图元的C\#自定义交集逻辑要快得多（如COM API几何体提取的性能差异所示 13）。利用这个原生API方法是执行所需碰撞检查最有效的方式，直接符合“减少计算量”的目标。它避免了复杂几何计算的开销。 + +尽管高效，但包围盒碰撞检测是一种近似方法。车辆的轴对齐包围盒可能与障碍物的包围盒相交，即使它们的实际几何体并未碰撞（例如，车辆穿过U形柱包围盒内的“空隙”）。反之，对于复杂的、非轴对齐的几何体，包围盒可能无法完全包围对象，导致遗漏碰撞。本报告应明确承认这种权衡。对于2.5D简化场景和减少计算量的目标，这种近似通常是可接受的。然而，对于要求绝对精度的应用，可能需要更复杂的基于几何体的交集测试 25，但由于其高计算成本，这些明确超出了当前项目的范围。 + +### **利用Navisworks碰撞检测API进行预计算或验证（可选高级用途）** + +Navisworks提供了广泛的碰撞检测API 11。它允许程序化创建 + +ClashTest 11，设置 + +SelectionA和SelectionB 11，定义碰撞的 + +PrimitiveTypes 12，运行测试（ + +TestsRunTest 12），并检索 + +ClashResult 11。 + +碰撞检测工具是Navisworks的原生、强大的干扰识别工具。尽管功能强大，但其设计主要用于静态碰撞分析和报告，不适用于路径规划算法所需的实时、迭代检查。运行ClashTest是一个相对繁重的操作，涉及复杂的几何计算（13暗示了这一点，显示碰撞的几何体提取可能很慢）。在A\*路径规划循环中，对每个潜在的车辆位置重复运行碰撞测试将导致计算量过大，并直接违背“减少计算量”的要求。 + +因此，碰撞检测API不应用于A\*路径规划过程中的实时碰撞检查。相反，其效用在于预计算或后验证。如果ClashTest作为预处理步骤*一次性*运行，它可以识别车辆包围盒（甚至其实际几何体，如果配置了更精确的碰撞测试）将与静态建筑元素永久碰撞的区域。此类预计算碰撞测试的结果可用于优化路径规划网格。例如，如果ClashResult指示特定区域存在干扰，则网格上的该区域（或更大的周围区域）可以被标记为不可通行的“禁行区”，即使初始包围盒分析未将其标记为主要障碍物。这使得能够利用Navisworks强大的碰撞检测功能来创建更准确的初始网格地图。或者，碰撞检测工具可以用作生成路径的*最终验证步骤*，对车辆（沿其整个路径）与所有障碍物运行一次碰撞测试，以捕获简化包围盒检查遗漏的任何细微干扰。 + +## **VI. 路径可视化与导航地图输出** + +本节详细介绍了如何在Navisworks中直观地呈现计算出的路径，以及如何将其导出以供外部使用。 + +### **视口路径可视化** + +用户已完成“视口路径绘制”。Navisworks API提供了OverlayRenderModel 3 用于自定义绘图， + +Graphics类提供了Line()和Cuboid() 3 等方法用于渲染形状。 + +Application.ActiveDocument.ActiveView.RequestDelayedRedraw() 3 用于触发视图更新。 + +视觉反馈对于用户理解和验证规划路径至关重要。现有功能是一个很好的基础。 +实现细节： + +1. **自定义ToolPlugin或RenderPlugin：** 路径可视化逻辑将驻留在自定义ToolPlugin或RenderPlugin的重写OverlayRenderModel方法中。 +2. **绘制路径段：** 遍历计算出的Point3D坐标列表（即路径）。使用graphics.Line()绘制连接连续点的线，形成路径。可以使用不同的颜色或线型来区分路径。 +3. **车辆表示：** 可选地，可以在起点、终点或沿路径绘制一个graphics.Cuboid() 3 来表示车辆的包围盒，清晰地显示其占地面积。 +4. **动态更新：** 路径计算后，应调用RequestDelayedRedraw()以更新视口。对于交互式元素（例如，手动门状态更改），应重新计算并重新绘制路径。 + +对于非常长的路径或频繁的路径重新计算，在OverlayRenderModel中持续重绘每个段可能会影响Navisworks的响应能力。RequestDelayedRedraw 3 意味着重绘是受管理的。可视化优化策略可能包括： + +* 在交互式更新期间仅绘制路径的简化版本（例如，更少的段），并在最终显示时才绘制完整路径。 +* 尽可能批量处理绘图命令。 +* 确保OverlayRenderModel方法尽可能轻量，避免在渲染循环中进行复杂计算。 + +### **生成导航地图数据** + +#### **导出路径坐标到JSON格式** + +C\#提供了System.Text.Json和Newtonsoft.Json库用于将列表序列化为JSON 30。 + +JsonSerializer.Serialize()是System.Text.Json中的主要方法 30。 + +JsonSerializerOptions可用于格式化（例如，WriteIndented \= true, PropertyNamingPolicy \= JsonNamingPolicy.CamelCase） 30。 + +为了将计算出的路径数据导出为外部系统可用的格式，JSON是一种理想的选择，因为它具有广泛的兼容性和可读性。 +实现细节： + +1. **数据结构定义：** 定义一个C\#类或结构体来表示路径中的每个点，例如PathPoint，包含X、Y、Z坐标（Navisworks的Point3D可以直接使用）。 +2. **路径对象封装：** 创建一个顶层对象来封装整个路径，例如NavigationMap，它将包含一个List\以及其他元数据。 +3. **序列化：** 使用System.Text.Json.JsonSerializer.Serialize()方法将NavigationMap对象序列化为JSON字符串。为了提高可读性，应配置JsonSerializerOptions，将WriteIndented设置为true，并将PropertyNamingPolicy设置为JsonNamingPolicy.CamelCase 30。 +4. **文件写入：** 将生成的JSON字符串写入一个.json文件，供外部系统消费。 + +System.Text.Json库在性能方面表现出色，其Serialize()方法在基准测试中显示出最快的速度和最低的内存使用率 30。这对于处理大型路径数据至关重要，因为它确保了高效的数据导出，避免了因序列化过程而导致的性能瓶颈。 + +#### **输出导航地图详情** + +除了原始路径坐标，导航地图还应包含有助于外部系统理解和利用路径的元数据。 +实现细节： + +* **起点和终点：** 明确包含规划路径的起始和结束坐标。 +* **总距离：** 计算并包含路径的总长度，这对于物流车辆的里程估算至关重要。 +* **估计旅行时间：** 根据路径长度和预设的车辆平均速度（或可配置的速度）计算估计的旅行时间。 +* **障碍物和通道信息：** 可选地，可以包含沿路径遇到的主要障碍物或通过的通道的简化信息，例如它们的ID或类型，以便外部系统进行更丰富的上下文理解。 +* **其他相关属性：** 根据外部系统的具体需求，可以添加其他属性，如路径ID、规划日期等。 + +这些附加信息使得导出的JSON文件不仅仅是简单的坐标列表，而是一个功能齐全的导航地图，能够直接集成到物流管理系统、车辆调度系统或数字孪生平台中，从而实现更高级的分析和决策。 + +## **VII. 插件架构与用户界面考虑** + +### **插件结构（AddInPlugin）** + +Navisworks插件通常继承自AddInPlugin基类 32。 + +Execute方法是插件的入口点，当用户从Navisworks界面调用插件时，该方法会被执行。插件的加载和配置通过Navisworks的插件管理器进行管理，通常涉及一个.addin文件，该文件定义了插件的元数据和入口点。这种标准化的结构确保了插件与Navisworks环境的无缝集成和生命周期管理。 + +### **WPF用户界面集成** + +为了提供丰富的用户交互体验，插件应利用Windows Presentation Foundation (WPF) 来构建其用户界面。由于Navisworks的.NET控件本质上是Windows Forms控件，因此需要使用ElementHost来将WPF控件嵌入到Navisworks插件中 33。 + +**实现细节：** + +1. **项目设置：** 创建一个WPF应用程序项目，并添加对Autodesk.Navisworks.Api、Autodesk.Navisworks.Controls和WindowsFormsIntegration程序集的引用 33。 +2. **XAML设计：** 使用XAML定义用户界面布局，例如按钮、文本框、列表视图等，用于输入起点/终点、显示路径信息和配置参数。WindowsFormsHost控件将用于承载Navisworks的ViewControl，以便在插件UI中显示模型或路径 34。 +3. **C\#代码后台逻辑：** 在XAML的C\#代码后台文件中，实现与Navisworks API的交互逻辑，处理用户输入、调用路径规划算法、更新视口可视化并执行数据导出。ApplicationControl.Initialize()应在应用程序启动时调用，并在应用程序关闭时进行清理 34。 + +### **与Navisworks文档交互** + +插件将通过Application.ActiveDocument属性访问当前打开的Navisworks文档。ModelItemCollection用于表示和操作当前选择的项 1。通过这些API，插件可以获取用户选择的起点和终点，以及遍历模型层次结构以识别障碍物和通道。 + +### **用户交互流程** + +典型的用户交互流程将包括： + +1. **插件启动：** 用户从Navisworks界面启动插件。 +2. **起点/终点选择：** 用户通过在Navisworks视口中点击或通过输入坐标来指定物流车辆的起点和终点。插件将捕获这些点。 +3. **参数配置：** 用户可以在插件UI中配置路径规划参数，例如车辆尺寸、网格分辨率、门和通道的成本设置、以及手动补充的障碍物或通道SelectionSet。 +4. **路径计算：** 用户触发路径计算。插件执行模型数据准备、网格构建和A\*路径规划算法。 +5. **路径可视化：** 计算出的路径自动在Navisworks视口中高亮显示，供用户审查。 +6. **导航地图导出：** 用户可以选择将计算出的路径及其元数据导出为JSON文件。 + +## **VIII. 结论与建议** + +本报告详细阐述了在Navisworks 2026中开发C\#物流路径规划插件的全面方案。通过结合智能模型数据提取、高效的A\*路径规划算法、简化的包围盒碰撞检测以及直观的WPF用户界面，该插件能够解决BIM模型中物流属性缺失的痛点，实现大型建筑内部物流车辆的自动化、无碰撞导航。 + +**核心结论包括：** + +* **A\*算法的优越性：** A\*算法因其启发式引导搜索的特性，在路径质量和计算效率之间提供了最佳平衡，使其成为此场景中优于Dijkstra算法的首选。 +* **包围盒碰撞检测的实用性：** 采用简化的包围盒碰撞检测方法，结合障碍物膨胀预处理，显著降低了计算负荷，同时满足了无碰撞路径规划的核心需求。 +* **多策略元素识别的鲁棒性：** 结合包围盒尺寸分析、属性推断和用户手动SelectionSet，确保了即使在原生模型属性不足的情况下，也能准确识别和分类与物流相关的模型元素。 +* **WPF的交互优势：** 利用WPF与ElementHost集成，为用户提供了灵活且响应迅速的界面，支持参数配置、手动干预和路径可视化。 + +**本插件的价值体现在：** + +* **自动化路径规划：** 减少了人工规划的时间和错误，提高了效率。 +* **无碰撞保障：** 通过精确的碰撞检测，确保物流车辆安全运行，降低了事故风险。 +* **计算效率优化：** 采用轻量级算法和预处理技术，确保在大型复杂模型中也能实现流畅的用户体验。 +* **可操作的导航地图：** 导出的JSON数据可无缝集成到其他物流或导航系统中，实现更高级的自动化和分析。 + +未来工作的建议： +为进一步增强插件的功能和性能，建议考虑以下方向： + +* **分层路径规划（HPA\*）：** 对于极其庞大和复杂的建筑模型，可以研究并实现HPA\*算法，以在更高层次上进行路径规划，从而实现显著的性能提升。 +* **动态障碍物处理：** 引入对临时障碍物（例如，临时施工区域、停放的车辆）的动态识别和路径调整能力，以适应实时变化的建筑环境。 +* **车辆运动学约束：** 在路径规划中融入更复杂的车辆运动学模型，例如最小转弯半径和速度限制，以生成更符合实际车辆行驶特性的路径。 +* **多楼层路径规划：** 扩展插件功能，支持跨楼层（例如，通过电梯或坡道）的路径规划，以满足更复杂的物流场景需求。 +* **与外部系统集成：** 探索与实时定位系统（RTLS）或仓库管理系统（WMS）的更深层次集成，以实现路径规划的自动化触发和反馈循环。 + +#### **引用的著作** + +1. Navisworks · Selections and Collections of ModelItem \- ApiDocs.co, 访问时间为 八月 14, 2025， [https://apidocs.co/apps/navisworks/2018/87317537-2911-4c08-b492-6496c82b3edb.htm](https://apidocs.co/apps/navisworks/2018/87317537-2911-4c08-b492-6496c82b3edb.htm) +2. Navisworks · ModelItem.BoundingBox Method \- ApiDocs.co, 访问时间为 八月 14, 2025， [https://apidocs.co/apps/navisworks/2018/M\_Autodesk\_Navisworks\_Api\_ModelItem\_BoundingBox.htm](https://apidocs.co/apps/navisworks/2018/M_Autodesk_Navisworks_Api_ModelItem_BoundingBox.htm) +3. Navisworks \- AEC DevBlog, 访问时间为 八月 14, 2025， [https://adndevblog.typepad.com/aec/navisworks/page/4/](https://adndevblog.typepad.com/aec/navisworks/page/4/) +4. Navisworks · ModelItem.Geometry Property \- ApiDocs.co, 访问时间为 八月 14, 2025， [https://apidocs.co/apps/navisworks/2018/P\_Autodesk\_Navisworks\_Api\_ModelItem\_Geometry.htm](https://apidocs.co/apps/navisworks/2018/P_Autodesk_Navisworks_Api_ModelItem_Geometry.htm) +5. Navisworks · ModelGeometry Class \- ApiDocs.co, 访问时间为 八月 14, 2025， [https://apidocs.co/apps/navisworks/2018/T\_Autodesk\_Navisworks\_Api\_ModelGeometry.htm](https://apidocs.co/apps/navisworks/2018/T_Autodesk_Navisworks_Api_ModelGeometry.htm) +6. BoundingBoxIntersectsFilter Class \- Revit API Docs, 访问时间为 八月 14, 2025， [https://www.revitapidocs.com/2019/1fbe1cff-ed94-4815-564b-05fd9e8f61fe.htm](https://www.revitapidocs.com/2019/1fbe1cff-ed94-4815-564b-05fd9e8f61fe.htm) +7. Find features in the tree by type and/or name pattern using SOLIDWORKS API \- CodeStack, 访问时间为 八月 14, 2025， [https://www.codestack.net/solidworks-api/document/features-manager/find-features/](https://www.codestack.net/solidworks-api/document/features-manager/find-features/) +8. Navisworks Help | Selection Tree Window | Autodesk, 访问时间为 八月 14, 2025， [https://help.autodesk.com/view/NAV/2024/ENU/?guid=GUID-AF4CFA5C-1455-4444-982A-34FBA2AE4608](https://help.autodesk.com/view/NAV/2024/ENU/?guid=GUID-AF4CFA5C-1455-4444-982A-34FBA2AE4608) +9. ApiDocs.co · Navisworks · SelectionSet Class, 访问时间为 八月 14, 2025， [https://apidocs.co/apps/navisworks/2018/T\_Autodesk\_Navisworks\_Api\_SelectionSet.htm](https://apidocs.co/apps/navisworks/2018/T_Autodesk_Navisworks_Api_SelectionSet.htm) +10. Add Search or Selection Set to Timeliner Task \- AEC DevBlog \- TypePad, 访问时间为 八月 14, 2025， [https://adndevblog.typepad.com/aec/2014/03/add-search-or-selection-set-to-timeliner-task.html](https://adndevblog.typepad.com/aec/2014/03/add-search-or-selection-set-to-timeliner-task.html) +11. AEC DevBlog: Navisworks, 访问时间为 八月 14, 2025， [https://adndevblog.typepad.com/aec/navisworks/page/15/](https://adndevblog.typepad.com/aec/navisworks/page/15/) +12. Clash Detective \- Navisworks \- ApiDocs.co, 访问时间为 八月 14, 2025， [https://apidocs.co/apps/navisworks/2018/87317537-2911-4c08-b492-6496c82b3ee5.htm](https://apidocs.co/apps/navisworks/2018/87317537-2911-4c08-b492-6496c82b3ee5.htm) +13. Navisworks \- AEC DevBlog, 访问时间为 八月 14, 2025， [https://adndevblog.typepad.com/aec/navisworks/](https://adndevblog.typepad.com/aec/navisworks/) +14. ApiDocs.co · Navisworks · ClashTest Class, 访问时间为 八月 14, 2025， [https://apidocs.co/apps/navisworks/2018/T\_Autodesk\_Navisworks\_Api\_Clash\_ClashTest.htm](https://apidocs.co/apps/navisworks/2018/T_Autodesk_Navisworks_Api_Clash_ClashTest.htm) +15. Search model items within a volume and apply transformation \- AEC DevBlog \- TypePad, 访问时间为 八月 14, 2025， [https://adndevblog.typepad.com/aec/2012/05/search-model-items-within-a-volume-and-apply-transformation.html](https://adndevblog.typepad.com/aec/2012/05/search-model-items-within-a-volume-and-apply-transformation.html) +16. Selecting all the objects \- Autodesk Community, 访问时间为 八月 14, 2025， [https://forums.autodesk.com/t5/navisworks-api-forum/selecting-all-the-objects/td-p/9280086](https://forums.autodesk.com/t5/navisworks-api-forum/selecting-all-the-objects/td-p/9280086) +17. A\* algorithm implementation in C\# \- CodeProject, 访问时间为 八月 14, 2025， [https://www.codeproject.com/Articles/15307/A-algorithm-implementation-in-C-](https://www.codeproject.com/Articles/15307/A-algorithm-implementation-in-C-) +18. Implementation of A\* \- Red Blob Games, 访问时间为 八月 14, 2025， [https://www.redblobgames.com/pathfinding/a-star/implementation.html](https://www.redblobgames.com/pathfinding/a-star/implementation.html) +19. Path-finding \- Gamelogic, 访问时间为 八月 14, 2025， [https://gamelogic.co.za/grids/documentation-contents/quick-start-tutorial/path-finding-grids-for-unity/](https://gamelogic.co.za/grids/documentation-contents/quick-start-tutorial/path-finding-grids-for-unity/) +20. Get primitive from solid of Navisworks \- AEC DevBlog \- TypePad, 访问时间为 八月 14, 2025， [https://adndevblog.typepad.com/aec/2012/05/get-primitive-from-solid-of-navisworks.html](https://adndevblog.typepad.com/aec/2012/05/get-primitive-from-solid-of-navisworks.html) +21. shortest-pathfinding-algorithm · GitHub Topics, 访问时间为 八月 14, 2025， [https://github.com/topics/shortest-pathfinding-algorithm](https://github.com/topics/shortest-pathfinding-algorithm) +22. Pathfinding Algorithms in C\# \- CodeProject, 访问时间为 八月 14, 2025， [https://www.codeproject.com/Articles/1221034/Pathfinding-Algorithms-in-Csharp](https://www.codeproject.com/Articles/1221034/Pathfinding-Algorithms-in-Csharp) +23. astar-pathfinding · GitHub Topics · GitHub, 访问时间为 八月 14, 2025， [https://github.com/topics/astar-pathfinding](https://github.com/topics/astar-pathfinding) +24. Navisworks · BoundingBox2D.Intersect Method \- ApiDocs.co, 访问时间为 八月 14, 2025， [https://apidocs.co/apps/navisworks/2018/M\_Autodesk\_Navisworks\_Api\_BoundingBox2D\_Intersect\_1\_8233cba9.htm](https://apidocs.co/apps/navisworks/2018/M_Autodesk_Navisworks_Api_BoundingBox2D_Intersect_1_8233cba9.htm) +25. Intersection Between Elements \- The Building Coder \- TypePad, 访问时间为 八月 14, 2025， [https://thebuildingcoder.typepad.com/blog/2010/06/intersection-between-elements.html](https://thebuildingcoder.typepad.com/blog/2010/06/intersection-between-elements.html) +26. Collision testing in Navisworks \- Catenda Help Center, 访问时间为 八月 14, 2025， [https://support.catenda.com/en/articles/7120422-collision-testing-in-navisworks](https://support.catenda.com/en/articles/7120422-collision-testing-in-navisworks) +27. Navisworks® Coordination Issues Add-In \- Autodesk App Store, 访问时间为 八月 14, 2025， [https://apps.autodesk.com/NAVIS/en/Detail/Index?id=5155805354033590972\&appLang=en\&os=Win64](https://apps.autodesk.com/NAVIS/en/Detail/Index?id=5155805354033590972&appLang=en&os=Win64) +28. Navisworks API \- Create Clash test? : r/bim \- Reddit, 访问时间为 八月 14, 2025， [https://www.reddit.com/r/bim/comments/1l5494a/navisworks\_api\_create\_clash\_test/](https://www.reddit.com/r/bim/comments/1l5494a/navisworks_api_create_clash_test/) +29. Accessing Clash Report information using .Net API \- AEC DevBlog \- TypePad, 访问时间为 八月 14, 2025， [https://adndevblog.typepad.com/aec/2012/05/accessing-clash-report-information-using-net-api.html](https://adndevblog.typepad.com/aec/2012/05/accessing-clash-report-information-using-net-api.html) +30. How to Serialize a List to JSON in C\# \- Code Maze, 访问时间为 八月 14, 2025， [https://code-maze.com/serialize-list-to-json-csharp/](https://code-maze.com/serialize-list-to-json-csharp/) +31. CSV To Json file in c\# \- Microsoft Q\&A, 访问时间为 八月 14, 2025， [https://learn.microsoft.com/en-us/answers/questions/1135337/csv-to-json-file-in-c](https://learn.microsoft.com/en-us/answers/questions/1135337/csv-to-json-file-in-c) +32. Navisworks · CustomPlugin Class \- ApiDocs.co, 访问时间为 八月 14, 2025， [https://apidocs.co/apps/navisworks/2018/T\_Autodesk\_Navisworks\_Api\_Plugins\_CustomPlugin.htm](https://apidocs.co/apps/navisworks/2018/T_Autodesk_Navisworks_Api_Plugins_CustomPlugin.htm) +33. NavisWorks .Net ExecuteCommand() Method \- House of BIM, 访问时间为 八月 14, 2025， [https://www.houseofbim.com/posts/naviworks-net-executecommand-method/](https://www.houseofbim.com/posts/naviworks-net-executecommand-method/) +34. Use Navisworks API with WPF \- Create a .NET control application of WPF \- AEC DevBlog, 访问时间为 八月 14, 2025， [https://adndevblog.typepad.com/aec/2013/03/use-navisworks-api-with-wpf-create-a-net-control-application-of-wpf.html](https://adndevblog.typepad.com/aec/2013/03/use-navisworks-api-with-wpf-create-a-net-control-application-of-wpf.html) \ No newline at end of file diff --git a/doc/working/第一阶段MVP实施计划_20250114.md b/doc/working/第一阶段MVP实施计划_20250114.md new file mode 100644 index 0000000..c7d91fc --- /dev/null +++ b/doc/working/第一阶段MVP实施计划_20250114.md @@ -0,0 +1,463 @@ +# 第一阶段（MVP）详细实施计划 + +**自动路径规划核心功能实现** +**创建日期**: 2025年1月14日 +**项目**: NavisworksTransport - 自动路径规划功能 +**阶段**: 第一阶段 (MVP - 最小可行产品) +**计划版本**: v1.0 + +## **实施目标** + +在现有手工路径规划基础上，添加A*算法自动路径规划功能，快速验证技术可行性。 + +## **实施策略** + +采用**最小侵入式**开发，充分利用现有基础设施，降低集成风险。 + +--- + +## **任务1：创建路径规划核心模块** ✅ **[已完成 - 2025-08-14]** + +**预计时间**: 3-4天 +**实际时间**: 已完成 +**完成状态**: 100% - 包含重大突破性修复 + +### 1.1 创建网格地图数据结构 ✅ + +**新文件**: `src/PathPlanning/GridMap.cs` +**完成状态**: ✅ 已实现 + 2.5D增强（Z坐标插值系统） + +```csharp +public class GridMap +{ + public int Width { get; set; } + public int Height { get; set; } + public double CellSize { get; set; } + public Point3D Origin { get; set; } + public GridCell[,] Cells { get; set; } +} + +public struct GridCell +{ + public bool IsWalkable { get; set; } + public double Cost { get; set; } + public ElementType CellType { get; set; } +} + +public enum ElementType +{ + OpenSpace = 0, + Obstacle = 1, + Door = 2, + Channel = 3 +} +``` + +### 1.2 创建网格地图生成器 ✅ + +**新文件**: `src/PathPlanning/GridMapGenerator.cs` +**完成状态**: ✅ 已实现，支持障碍物识别和车辆膨胀 + +```csharp +public class GridMapGenerator +{ + public GridMap GenerateFromBIM(Document document, BoundingBox3D bounds, double cellSize = 0.5) + public List GetObstacleItems(Document document, BoundingBox3D bounds) + public void ApplyVehicleInflation(GridMap gridMap, double vehicleRadius) + private void MarkObstacleCells(GridMap gridMap, List obstacles) +} +``` + +### 1.3 创建A*路径查找器 ✅ + +**新文件**: `src/PathPlanning/AutoPathFinder.cs` +**完成状态**: ✅ 已实现 + 重大单位转换修复（RoyT.AStar集成） + +```csharp +public class AutoPathFinder +{ + public List FindPath(Point3D start, Point3D end, GridMap gridMap) + private Grid ConvertToAStarGrid(GridMap gridMap) + private List ConvertPathToWorldCoordinates(Path astarPath, GridMap gridMap) + private Point2D WorldToGrid(Point3D worldPos, GridMap gridMap) + private Point3D GridToWorld(Point2D gridPos, GridMap gridMap) +} +``` + +--- + +## **任务2：集成到现有路径规划管理器** ✅ **[已完成 - 2025-08-14]** + +**预计时间**: 2-3天 +**实际时间**: 已完成 +**完成状态**: 100% - 包含可视化优化 + +### 2.1 扩展PathPlanningManager ✅ + +**修改文件**: `src/Core/PathPlanningManager.cs` +**完成状态**: ✅ 已集成AutoPlanPath方法 + 橙色路径可视化 + +**新增方法**: + +```csharp +/// +/// 自动规划路径 +/// +public PathRoute AutoPlanPath(Point3D startPoint, Point3D endPoint, double vehicleSize = 1.0) +{ + // 1. 生成网格地图 + // 2. 调用A*算法 + // 3. 转换为PathRoute格式 + // 4. 设置可视化 +} + +/// +/// 获取当前模型的边界框 +/// +private BoundingBox3D GetModelBounds() + +/// +/// 创建自动规划的PathRoute +/// +private PathRoute CreateAutoPathRoute(List pathPoints, string routeName) +``` + +### 2.2 简化障碍物识别 ✅ + +**扩展现有**: `src/Core/Properties/CategoryAttributeManager.cs` +**完成状态**: ✅ 已实现物流属性识别和障碍物分类 + +**新增方法**: + +```csharp +/// +/// 获取指定区域内的障碍物 +/// +public static List GetObstaclesInBounds(Document document, BoundingBox3D bounds) +{ + // 利用现有LogisticsElementType.障碍物分类 + // 基于包围盒尺寸启发式识别墙体、柱子 + // 暂时忽略门状态，简化逻辑 +} + +/// +/// 基于几何特征识别障碍物 +/// +private static bool IsLikelyObstacle(ModelItem item) +``` + +--- + +## **任务3：UI集成和用户交互** ✅ **[已完成 - 2025-08-14]** + +**预计时间**: 2-3天 +**实际时间**: 已完成 +**完成状态**: 100% - 完整UI交互流程 + +### 3.1 扩展路径编辑界面 + +**修改文件**: `src/UI/WPF/Views/PathEditingView.xaml` + +**新增UI元素**: + +```xml +