assets/samples/Samples/NetworkPressureLossReport/CS/README_extracted.txt

Application: NetworkPressureLossReport
Revit Platform: All
Revit Version: 2024.0
First Released For: 8.1
Programming Language: C#
Skill Level: Advanced
Category: MEP
Type: ExternalCommand

Subject: Add ExternalCommand to the Revit user interface.
Summary: 
This addin sample shows how to access the MEP analytical model data and traverse the network. The flow and pressure loss results are exported to a csv file or displayed in Analysis Visualization Framework (AVF).

Classes: 
Autodesk.Revit.DB.Analysis.MEPAnalyticalModelData
Autodesk.Revit.DB.Analysis.MEPAnalyticalSegment
Autodesk.Revit.DB.Analysis.MEPAnalyticalNode
Autodesk.Revit.DB.Analysis.MEPNetworkSegementId
Autodesk.Revit.DB.Analysis.MEPNetworkIterator
Autodesk.Revit.DB.Analysis.MEPNetworkSegmentData

Autodesk.Revit.DB.Analysis.SpatialFieldManager
Autodesk.Revit.DB.Analysis.AnalysisResultSchema
Autodesk.Revit.DB.Analysis.AnalysisDisplayStyle
Autodesk.Revit.DB.Analysis.AnalysisDisplayColorSettings
Autodesk.Revit.DB.Analysis.AnalysisDisplayVectorSettings
Autodesk.Revit.DB.Analysis.AnalyssiDisplayLegendSettings
Autodesk.Revit.DB.Analysis.FieldDomainPointsByXYZ
Autodesk.Revit.DB.Analysis.FieldValue

Autodesk.Revit.DB.ConnectorDomainType
Autodesk.Revit.DB.FabricationService
Autodesk.Revit.DB.ForgeTypeId
Autodesk.Revit.DB.FormatOptions
Autodesk.Revit.DB.MEPSystem
Autodesk.Revit.DB.OverrideGraphicSettings
Autodesk.Revit.DB.UnitFormatUtils
Autodesk.Revit.DB.SpecTypeId
Autodesk.Revit.DB.UnitUtils
Autodesk.Revit.DB.View

Autodesk.Revit.UI.IExternalCommand 

Project Files: 
�        
Command.cs
It contains the command interface to start the dialog.

�        
NetworkDialog.xaml
It contains the dialog window in the WPF xaml format.

�        
NetworkDialog.xaml.cs
It contains the dialog initialization and interface to other functions.

�        
NetworkInfo.cs
It contains the information of one network. The static method FindValidNetworks starts from all mechanical or terminal elements, iterates the connected analytical segments, and establishes the Network/Section/Segment information for later operations.

�        
SectionInfo.cs
A section contains multiple analytical segments that share the same size and velocity. The network is typically organized by sections in the pressure loss report.

�        
SegmentInfo.cs
This class contains all relevant information of analytical segment for pressure loss report, gathered from MEPAnalyticalModelData, MEPAnalyticalSegement, MEPAnalyticalNode, and MEPNetworkSegmentData.

�        
CSVExporter.cs
It wraps a few data objects relevant to the pressure loss report, including the StreamWriter that writes out the CSV file, and other convenient method to convert units.

�        
AVFViewer.cs
It wraps the data objects relevant to the AVF, including the SpatialFieldManager that oversees the visualization work.

Description: 
Run the command 
Pressure Loss Report
 under the Add-Ins once the dll is loaded into Revit. It finds all valid networks that show up in the dialog. 

pict001.png

The selected network can be exported into a csv file. It may be loaded into applications like Excel to better visualize the table, as shown below. Notice that the secton has the straight and fitting subtotal. If users want to have the breakdown of individual analytical segments, they may check the 
Itemized
 to export the table. 

pict002.png

Users may also click the View button on the dialog to display the flow direction and values. It is important to note that the flow vector length is scaled to the flow value. So is the color of these flow arrows. Since this is based on the AVF, the colors and other visualization settings can be modified in Revit. 

pict003.png