Dynamo For Revit: RouteAnalysis Nodes

前言

本文介绍 Revit 2021.1 新加的 RouteAnalysis 节点以及相关概念。

内容

增加了 5 个节点：

• PathOfTravel.InsertWayPoint 在行进路线上插入一个点。
• PathOfTravel.RemoveWayPoint 移除行进路线上的一个点。
• PathOfTravel.SetWayPoint 更新行进路线上的一个点。
• PathOfTravel.GetWayPoints 获取行进路线上的点。
• PathOfTravel.LongestOfShortestExitPaths （没看明白想干嘛。。。）Calculate the longest Path(s) of Travel of all the shortest paths from rooms in a floor plan to the given exit points.

PathOfTravel.InsertWayPoint

顾名思义，就是在路上插入一个点，但是这个节点暴露了一个问题，通过UI，只能在路线上插入一个点，但是通过 Dynamo 节点，却可以在路线外加入一个点，然后再更新路线。如果选不合理的插入点，更新会失败。所以，这个节点要慎用。

PathOfTravel.RemoveWayPoint、PathOfTravel.SetWayPoint、PathOfTravel.GetWayPoints

• PathOfTravel.RemoveWayPoint 移除行进路线上的一个点。
• PathOfTravel.SetWayPoint 更新行进路线上的一个点。
• PathOfTravel.GetWayPoints 获取行进路线上的点。

下面这个节点图：

1. 设置了索引号为 0 的路径点；
2. 移除了所以好为 1 的路径点；
3. 用 PathOfTravel.GetWayPoints 获取各个时刻行进路线上点的状态。
   

PathOfTravel.LongestOfShortestExitPaths

没看明白想干嘛。。。
逻辑实现：

private static PathOfTravel[] InternalLongestOfShortestExitPaths(Rvt.View rvtView, IEnumerable<XYZ> endPoints)
{List<PathOfTravel> pathsOfTravel = new List<PathOfTravel>();TransactionManager.Instance.EnsureInTransaction(Document);try{IList<XYZ> startsOfLongestPathsFromRooms = RvtAnalysis.PathOfTravel.FindStartsOfLongestPathsFromRooms(rvtView,endPoints.ToList());if (startsOfLongestPathsFromRooms.Count() != 0){IList<XYZ> endsOfShortestPaths = RvtAnalysis.PathOfTravel.FindEndsOfShortestPaths(rvtView,endPoints.ToList(),startsOfLongestPathsFromRooms);IList<RvtAnalysis.PathOfTravel> newRvtPathOfTravels = RvtAnalysis.PathOfTravel.CreateMultiple(rvtView,startsOfLongestPathsFromRooms.ToList(),endsOfShortestPaths.ToList());foreach (RvtAnalysis.PathOfTravel rvtPathOfTravel in newRvtPathOfTravels){if (rvtPathOfTravel != null){pathsOfTravel.Add(new PathOfTravel(rvtPathOfTravel));}}ElementBinder.SetElementsForTrace(pathsOfTravel.Where(x => x != null).Select(x => x.InternalElement));} }catch (Exception e){//unregister the elements from the element life cycle manager and delete the elementsvar elementManager = ElementIDLifecycleManager<int>.GetInstance();if (pathsOfTravel != null){foreach (var path in pathsOfTravel){if (path != null){elementManager.UnRegisterAssociation(path.InternalElementId.IntegerValue, path);Document.Delete(path.InternalElementId);}}}throw e;}finally{TransactionManager.Instance.TransactionTaskDone();}return pathsOfTravel.ToArray();
}

疑点 ：通过方法 RvtAnalysis.PathOfTravel.FindStartsOfLongestPathsFromRooms 返回的点的数量不确定，没有输入房间，只有终点。从运行结果来看，不能判断这个节点是做什么用的。

public static IList<XYZ> FindStartsOfLongestPathsFromRooms(View DBView, IList<XYZ> destinationPoints);