// // (C) Copyright 2003-2023 by Autodesk, Inc. // // Permission to use, copy, modify, and distribute this software in // object code form for any purpose and without fee is hereby granted, // provided that the above copyright notice appears in all copies and // that both that copyright notice and the limited warranty and // restricted rights notice below appear in all supporting // documentation. // // AUTODESK PROVIDES THIS PROGRAM "AS IS" AND WITH ALL FAULTS. // AUTODESK SPECIFICALLY DISCLAIMS ANY IMPLIED WARRANTY OF // MERCHANTABILITY OR FITNESS FOR A PARTICULAR USE. AUTODESK, INC. // DOES NOT WARRANT THAT THE OPERATION OF THE PROGRAM WILL BE // UNINTERRUPTED OR ERROR FREE. // // Use, duplication, or disclosure by the U.S. Government is subject to // restrictions set forth in FAR 52.227-19 (Commercial Computer // Software - Restricted Rights) and DFAR 252.227-7013(c)(1)(ii) // (Rights in Technical Data and Computer Software), as applicable. // using System; using System.Collections.Generic; using System.Text; using Autodesk.Revit.DB; using Autodesk.Revit.UI; using Autodesk.Revit; using Autodesk.Revit.ApplicationServices; using Autodesk.Revit.DB.Plumbing; using Autodesk.Revit.DB.Mechanical; using System.Diagnostics; using Element = Autodesk.Revit.DB.Element; using System.Collections; namespace Revit.SDK.Samples.AvoidObstruction.CS { /// /// This class implement the algorithm to detect the obstruction and resolve it. /// class Resolver { /// /// Revit Document. /// private Document m_rvtDoc; /// /// Revit Application. /// private Application m_rvtApp; /// /// Detector to detect the obstructions. /// private Detector m_detector; PipingSystemType m_pipingSystemType; /// /// Constructor, initialize all the fields of this class. /// /// Revit ExternalCommandData from external command entrance public Resolver(ExternalCommandData data) { m_rvtDoc = data.Application.ActiveUIDocument.Document; m_rvtApp = data.Application.Application; m_detector = new Detector(m_rvtDoc); FilteredElementCollector collector = new FilteredElementCollector(m_rvtDoc); var pipingSystemTypes = collector.OfClass(typeof(PipingSystemType)).ToElements(); foreach (PipingSystemType pipingSystemType in pipingSystemTypes) { if (pipingSystemType.SystemClassification == MEPSystemClassification.SupplyHydronic || pipingSystemType.SystemClassification == MEPSystemClassification.ReturnHydronic) { m_pipingSystemType = pipingSystemType; break; } } } /// /// Detect and resolve the obstructions of all Pipes. /// public void Resolve() { List pipes = new List(); FilteredElementCollector collector = new FilteredElementCollector(m_rvtDoc); pipes.AddRange(collector.OfClass(typeof(Pipe)).ToElements()); foreach (Element pipe in pipes) { Resolve(pipe as Pipe); } } /// /// Calculate the uniform perpendicular directions with inputting direction "dir". /// /// Direction to calculate /// How many perpendicular directions will be calculated /// The calculated perpendicular directions with dir private List PerpendicularDirs(Autodesk.Revit.DB.XYZ dir, int count) { List dirs = new List(); Plane plane = Plane.CreateByNormalAndOrigin(dir, Autodesk.Revit.DB.XYZ.Zero); Arc arc = Arc.Create(plane, 1.0, 0, 6.28); double delta = 1.0 / (double)count; for (int i = 1; i <= count; i++) { Autodesk.Revit.DB.XYZ pt = arc.Evaluate(delta * i, true); dirs.Add(pt); } return dirs; } /// /// Detect the obstructions of pipe and resolve them. /// /// Pipe to resolve private void Resolve(Pipe pipe) { var parameter = pipe.get_Parameter(BuiltInParameter.RBS_START_LEVEL_PARAM); var levelId = parameter.AsElementId(); var systemTypeId = m_pipingSystemType.Id; // Get the centerline of pipe. Line pipeLine = (pipe.Location as LocationCurve).Curve as Line; // Calculate the intersection references with pipe's centerline. List obstructionRefArr = m_detector.Obstructions(pipeLine); // Filter out the references, just allow Pipe, Beam, and Duct. Filter(pipe, obstructionRefArr); if (obstructionRefArr.Count == 0) { // There are no intersection found. return; } // Calculate the direction of pipe's centerline. Autodesk.Revit.DB.XYZ dir = pipeLine.GetEndPoint(1) - pipeLine.GetEndPoint(0); // Build the sections from the intersection references. List
sections = Section.BuildSections(obstructionRefArr, dir.Normalize()); // Merge the neighbor sections if the distance of them is too close. for (int i = sections.Count - 2; i >= 0; i--) { Autodesk.Revit.DB.XYZ detal = sections[i].End - sections[i + 1].Start; if (detal.GetLength() < pipe.Diameter * 3) { sections[i].Refs.AddRange(sections[i + 1].Refs); sections.RemoveAt(i + 1); } } // Resolve the obstructions one by one. foreach (Section sec in sections) { Resolve(pipe, sec); } // Connect the neighbor sections with pipe and elbow fittings. // for (int i = 1; i < sections.Count; i++) { // Get the end point from the previous section. Autodesk.Revit.DB.XYZ start = sections[i - 1].End; // Get the start point from the current section. Autodesk.Revit.DB.XYZ end = sections[i].Start; // Create a pipe between two neighbor section. Pipe tmpPipe = Pipe.Create(m_rvtDoc, systemTypeId, pipe.PipeType.Id, levelId, start, end); // Copy pipe's parameters values to tmpPipe. CopyParameters(pipe, tmpPipe); // Create elbow fitting to connect previous section with tmpPipe. Connector conn1 = FindConnector(sections[i - 1].Pipes[2], start); Connector conn2 = FindConnector(tmpPipe, start); FamilyInstance fi = m_rvtDoc.Create.NewElbowFitting(conn1, conn2); // Create elbow fitting to connect current section with tmpPipe. Connector conn3 = FindConnector(sections[i].Pipes[0], end); Connector conn4 = FindConnector(tmpPipe, end); FamilyInstance f2 = m_rvtDoc.Create.NewElbowFitting(conn3, conn4); } // Find two connectors which pipe's two ends connector connected to. Connector startConn = FindConnectedTo(pipe, pipeLine.GetEndPoint(0)); Connector endConn = FindConnectedTo(pipe, pipeLine.GetEndPoint(1)); Pipe startPipe = null; if (null != startConn) { // Create a pipe between pipe's start connector and pipe's start section. startPipe = Pipe.Create(m_rvtDoc, pipe.PipeType.Id, levelId, startConn, sections[0].Start); } else { // Create a pipe between pipe's start point and pipe's start section. startPipe = Pipe.Create(m_rvtDoc, systemTypeId, pipe.PipeType.Id, levelId, sections[0].Start, pipeLine.GetEndPoint(0)); } // Copy parameters from pipe to startPipe. CopyParameters(pipe, startPipe); // Connect the startPipe and first section with elbow fitting. Connector connStart1 = FindConnector(startPipe, sections[0].Start); Connector connStart2 = FindConnector(sections[0].Pipes[0], sections[0].Start); FamilyInstance fii = m_rvtDoc.Create.NewElbowFitting(connStart1, connStart2); Pipe endPipe = null; int count = sections.Count; if (null != endConn) { // Create a pipe between pipe's end connector and pipe's end section. endPipe = Pipe.Create(m_rvtDoc, pipe.PipeType.Id, levelId, endConn, sections[count - 1].End); } else { // Create a pipe between pipe's end point and pipe's end section. endPipe = Pipe.Create(m_rvtDoc, systemTypeId, pipe.PipeType.Id, levelId, sections[count - 1].End, pipeLine.GetEndPoint(1)); } // Copy parameters from pipe to endPipe. CopyParameters(pipe, endPipe); // Connect the endPipe and last section with elbow fitting. Connector connEnd1 = FindConnector(endPipe, sections[count - 1].End); Connector connEnd2 = FindConnector(sections[count - 1].Pipes[2], sections[count - 1].End); FamilyInstance fiii = m_rvtDoc.Create.NewElbowFitting(connEnd1, connEnd2); // Delete the pipe after resolved. m_rvtDoc.Delete(pipe.Id); } /// /// Filter the inputting References, just allow Pipe, Duct and Beam References. /// /// Pipe /// References to filter private void Filter(Pipe pipe, List refs) { for (int i = refs.Count - 1; i >= 0; i--) { Reference cur = refs[i].GetReference(); Element curElem = m_rvtDoc.GetElement(cur); if (curElem.Id == pipe.Id || (!(curElem is Pipe) && !(curElem is Duct) && curElem.Category.BuiltInCategory != BuiltInCategory.OST_StructuralFraming)) { refs.RemoveAt(i); } } } /// /// This method will find out a route to avoid the obstruction. /// /// Pipe to resolve /// Pipe's one obstruction /// A route which can avoid the obstruction private Line FindRoute(Pipe pipe, Section section) { // Perpendicular direction minimal length. double minLength = pipe.Diameter * 2; // Parallel direction jump step. double jumpStep = pipe.Diameter; // Calculate the directions in which to find the solution. List dirs = new List(); Autodesk.Revit.DB.XYZ crossDir = null; foreach (ReferenceWithContext gref in section.Refs) { Element elem = m_rvtDoc.GetElement(gref.GetReference()); Line locationLine = (elem.Location as LocationCurve).Curve as Line; Autodesk.Revit.DB.XYZ refDir = locationLine.GetEndPoint(1) - locationLine.GetEndPoint(0); refDir = refDir.Normalize(); if (refDir.IsAlmostEqualTo(section.PipeCenterLineDirection) || refDir.IsAlmostEqualTo(-section.PipeCenterLineDirection)) { continue; } crossDir = refDir.CrossProduct(section.PipeCenterLineDirection); dirs.Add(crossDir.Normalize()); break; } // When all the obstruction are parallel with the centerline of the pipe, // We can't calculate the direction from the vector.Cross method. if (dirs.Count == 0) { // Calculate perpendicular directions with dir in four directions. List perDirs = PerpendicularDirs(section.PipeCenterLineDirection, 4); dirs.Add(perDirs[0]); dirs.Add(perDirs[1]); } Line foundLine = null; while (null == foundLine) { // Extend the section interval by jumpStep. section.Inflate(0, jumpStep); section.Inflate(1, jumpStep); // Find solution in the given directions. for (int i = 0; null == foundLine && i < dirs.Count; i++) { // Calculate the intersections. List obs1 = m_detector.Obstructions(section.Start, dirs[i]); List obs2 = m_detector.Obstructions(section.End, dirs[i]); // Filter out the intersection result. Filter(pipe, obs1); Filter(pipe, obs2); // Find out the minimal intersections in two opposite direction. ReferenceWithContext[] mins1 = GetClosestSectionsToOrigin(obs1); ReferenceWithContext[] mins2 = GetClosestSectionsToOrigin(obs2); // Find solution in the given direction and its opposite direction. for (int j = 0; null == foundLine && j < 2; j++) { if (mins1[j] != null && Math.Abs(mins1[j].Proximity) < minLength || mins2[j] != null && Math.Abs(mins2[j].Proximity) < minLength) { continue; } // Calculate the maximal height that the parallel line can be reached. double maxHight = 1000 * pipe.Diameter; if (mins1[j] != null && mins2[j] != null) { maxHight = Math.Min(Math.Abs(mins1[j].Proximity), Math.Abs(mins2[j].Proximity)); } else if (mins1[j] != null) { maxHight = Math.Abs(mins1[j].Proximity); } else if (mins2[j] != null) { maxHight = Math.Abs(mins2[j].Proximity); } Autodesk.Revit.DB.XYZ dir = (j == 1) ? dirs[i] : -dirs[i]; // Calculate the parallel line which can avoid obstructions. foundLine = FindParallelLine(pipe, section, dir, maxHight); } } } return foundLine; } /// /// Find a line Parallel to pipe's centerline to avoid the obstruction. /// /// Pipe who has obstructions /// Pipe's one obstruction /// Offset Direction of the parallel line /// Maximum offset distance /// Parallel line which can avoid the obstruction private Line FindParallelLine(Pipe pipe, Section section, Autodesk.Revit.DB.XYZ dir, double maxLength) { double step = pipe.Diameter; double hight = 2 * pipe.Diameter; while (hight <= maxLength) { Autodesk.Revit.DB.XYZ detal = dir * hight; Line line = Line.CreateBound(section.Start + detal, section.End + detal); List refs = m_detector.Obstructions(line); Filter(pipe, refs); if (refs.Count == 0) { return line; } hight += step; } return null; } /// /// Find out two References, whose ProximityParameter is negative or positive, /// And Get the minimal value from all positive reference, and get the maximal value /// from the negative reference. if there are no such reference, using null instead. /// /// References /// Reference array private ReferenceWithContext[] GetClosestSectionsToOrigin(List refs) { ReferenceWithContext[] mins = new ReferenceWithContext[2]; if (refs.Count == 0) { return mins; } if (refs[0].Proximity > 0) { mins[1] = refs[0]; return mins; } for (int i = 0; i < refs.Count - 1; i++) { if (refs[i].Proximity < 0 && refs[i + 1].Proximity > 0) { mins[0] = refs[i]; mins[1] = refs[i + 1]; return mins; } } mins[0] = refs[refs.Count - 1]; return mins; } /// /// Resolve one obstruction of Pipe. /// /// Pipe to resolve /// One pipe's obstruction private void Resolve(Pipe pipe, Section section) { // Find out a parallel line of pipe centerline, which can avoid the obstruction. Line offset = FindRoute(pipe, section); // Construct a section line according to the given section. Line sectionLine = Line.CreateBound(section.Start, section.End); // Construct two side lines, which can avoid the obstruction too. Line side1 = Line.CreateBound(sectionLine.GetEndPoint(0), offset.GetEndPoint(0)); Line side2 = Line.CreateBound(offset.GetEndPoint(1), sectionLine.GetEndPoint(1)); // // Create an "U" shape, which connected with three pipes and two elbows, to round the obstruction. // PipeType pipeType = pipe.PipeType; Autodesk.Revit.DB.XYZ start = side1.GetEndPoint(0); Autodesk.Revit.DB.XYZ startOffset = offset.GetEndPoint(0); Autodesk.Revit.DB.XYZ endOffset = offset.GetEndPoint(1); Autodesk.Revit.DB.XYZ end = side2.GetEndPoint(1); var parameter = pipe.get_Parameter(BuiltInParameter.RBS_START_LEVEL_PARAM); var levelId = parameter.AsElementId(); // Create three side pipes of "U" shape. var systemTypeId = m_pipingSystemType.Id; Pipe pipe1 = Pipe.Create(m_rvtDoc, systemTypeId, pipeType.Id, levelId, start, startOffset); Pipe pipe2 = Pipe.Create(m_rvtDoc, systemTypeId, pipeType.Id, levelId, startOffset, endOffset); Pipe pipe3 = Pipe.Create(m_rvtDoc, systemTypeId, pipeType.Id, levelId, endOffset, end); // Copy parameters from pipe to other three created pipes. CopyParameters(pipe, pipe1); CopyParameters(pipe, pipe2); CopyParameters(pipe, pipe3); // Add the created three pipes to current section. section.Pipes.Add(pipe1); section.Pipes.Add(pipe2); section.Pipes.Add(pipe3); // Create the first elbow to connect two neighbor pipes of "U" shape. Connector conn1 = FindConnector(pipe1, startOffset); Connector conn2 = FindConnector(pipe2, startOffset); m_rvtDoc.Create.NewElbowFitting(conn1, conn2); // Create the second elbow to connect another two neighbor pipes of "U" shape. Connector conn3 = FindConnector(pipe2, endOffset); Connector conn4 = FindConnector(pipe3, endOffset); m_rvtDoc.Create.NewElbowFitting(conn3, conn4); } /// /// Copy parameters from source pipe to target pipe. /// /// Coping source /// Coping target private void CopyParameters(Pipe source, Pipe target) { double diameter = source.get_Parameter(BuiltInParameter.RBS_PIPE_DIAMETER_PARAM).AsDouble(); target.get_Parameter(BuiltInParameter.RBS_PIPE_DIAMETER_PARAM).Set(diameter); } /// /// Find out a connector from pipe with a specified point. /// /// Pipe to find the connector /// Specified point /// Connector whose origin is conXYZ private Connector FindConnector(Pipe pipe, Autodesk.Revit.DB.XYZ conXYZ) { ConnectorSet conns = pipe.ConnectorManager.Connectors; foreach (Connector conn in conns) { if (conn.Origin.IsAlmostEqualTo(conXYZ)) { return conn; } } return null; } /// /// Find out the connector which the pipe's specified connector connected to. /// The pipe's specified connector is given by point conxyz. /// /// Pipe to find the connector /// Specified point /// Connector whose origin is conXYZ private Connector FindConnectedTo(Pipe pipe, Autodesk.Revit.DB.XYZ conXYZ) { Connector connItself = FindConnector(pipe, conXYZ); ConnectorSet connSet = connItself.AllRefs; foreach (Connector conn in connSet) { if (conn.Owner.Id != pipe.Id && conn.ConnectorType == ConnectorType.End) { return conn; } } return null; } } }