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 elements
      var 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);