Dynamo Nodes for Steel Connections
| Dynamo Node | Inputs | Outputs |
|---|---|---|
| Connection.ByType Creates connections; Loads the connection type if it is not already loaded in the current model. |
node A connection node or a list of connection nodes. indexes The order of the input elements in a connection, given as an array of integers. connectionType The connection type to be created. |
Connection A connection or a list of connections. Existing A connection node or a list of connection nodes where a connection already existed. |
| Connection.ConnectionType Returns the connection type with which the connection was created. |
connection The input connection instance. |
ConnectionType The connection type of this connection instance. |
| Connection.RevitHandle Returns the Revit handle of a connection. |
connection The input connection. |
RevitHandle The Revit handle as string. |
| ConnectionNode.FromStructure Groups structure data elements into connection nodes. |
objects A list of structure data elements. |
ConnectionNode[] A list of connection nodes. For more info, see grouping. |
| ConnectionNode.MatchTypeByRanges Returns the connection nodes where the structure data for elements passes range conditions. |
node The input connection nodes. indexes The order of the input elements in a connection, given as an array of integers. connectionTypes The connection types to be verified. analysisResult The analysis result identifier. Use the SteelConnections.Input.AnalysisResults dropdown node to select the identifier. |
accepted A list with two elements containing the connection node that has at least one applicable connection type, and the ordered list of connection types that pass the range conditions on the connection node. rejected The connection node that does not pass the filter. |
| ConnectionNode.RemoveDuplicates Finds all connection nodes that are permutations of one another { [beam1, beam2], [beam2, beam1] }, keeps only the first node { [beam1, beam2] } and removes null and empty items. |
nodes The nested lists of connection nodes (ConnectionNode[]). It is recommended to filter by geometric conditions beforehand. |
ConnectionNode[] A partially flattened and cleaned list containing only one connection node for each group of structure data elements. |
| ConnectionNode.SubNodesOfSize For connection nodes that have at least the specified number of elements or zones, it turns each input node into a list of subnodes, where each subnode is a different arrangement of the elements in the original connection node. |
node The connection node or a list of connection nodes. noOfZones The specified number of zones. |
ConnectionNode[] A list of connection subnodes. For more info, see arrangements. |
| ConnectionNode.Zones Returns the zones within each input connection node. |
connectionNode The connection node or a list of connection nodes. |
Zone[] A list of zones. |
| ConnectionType.ByNameAndType Gets a connection type with the given names from the specified Revit model. |
connectionName A string containing the name of the connection. typeName A string containing the name of the connection type. filePath The source file path for the connection types. If it is null, this node will use the current model as source. |
ConnectionType The resulting connection type. |
| ConnectionType.ByName Gets a list of connection types. |
connectionName The name of the connection. If it is null, this node will return all the connection types from the source model. filePath The source file path for listing the connection types. If it is null, this node will use the current model as source. |
ConnectionTypes A list of connection types. |
| ConnectionType.ConnectionName Returns the connection name from a connection type. |
connectionType The input connection type. |
string The output string containing the connection name. |
| ConnectionType.ListFromFile Lists the ConnectionTypes located in the specified file path, which are available for loading into the current document. |
filePath Source file path for the ConnectionTypes. If it is null this node will use the current model as source |
ConnectionTypes A list of connections |
| ConnectionType.LoadFromFile Loads a ConnectionType into the current document from an external .rvt file using a specified file path. |
filePath Provide the source file path for loading the ConnectionType. connectionName typeName |
ConnectionType A connection type |
| ConnectionType.SourceFile Returns the source file for the connection type. |
connectionType The input connection type. |
string The output string containing the source file. |
| ConnectionType.TypeName Returns the connection type name from a connection type. |
connectionType The input connection type. |
string The output string containing the connection type name. |
| ConnectionType.Validate Validates a connection type against a specific model situation. |
node Provide a specific connection node from the model for validation. uniqueIndexes The order of the input objects from the node. connectionTypes The connection types to be validated. analysisResult The analysis result identifier. Use SteelConnections.Input.AnalysisResults dropdown node to select the identifier. |
isValid A list of booleans. True = the range passed for the connection type. additionalInfo A list of dictionaries containing additional information from range check, for each case. |
| Filter.ByAnalysisResults Returns the connection nodes where the structure data element at a certain index has a force value within a certain range. The force value comes from structural analysis results or from Revit analytical model. |
node The input connection nodes. index The zero-based index of the structure data element to be compared. resultType The type of value to filter by: "Fx", "Fy"... analysisResult The analysis result identifier. Use SteelConnections.Input.AnalysisResults dropdown node to select the identifier" rangeStart Start range rangeEnd End range |
accepted The nodes that pass the filter. rejected The nodes that do not pass the filter. |
| Filter.ByAngleBetweenAxes Returns the connection nodes where certain axes of the Nth and Mth structure data elements in the node form an angle between within a certain range. N, M, the range, and the axes are specified by the user. |
node The input connection nodes. indexFirst The zero-based index of the first element to be compared. indexSecond The zero-based index of the second element to be compared. axisFirst The first structure data element's reference axis (can be X, Y or Z specified as a case insensitive string). axisSecond The second structure data element's reference axis (can be X, Y or Z specified as a case insensitive string). rangeStart A value between 0 and 90 degrees representing the start of the desired range. rangeEnd A value between 0 and 90 degrees representing the end of the desired range. |
accepted The nodes that pass the filter. rejected The nodes that do not pass the filter. |
| Filter.ByAngleBetweenBeams Returns the connection nodes where certain axes of the Nth and Mth structure data elements in the node form an angle between within a certain range. This is similar to ByAngleBetweenAxes except it only measures the angle using the X axis, and for the case where the structural elements meet end to end the angle can be between 0-180 degrees instead of 0-90 degrees. |
node The input connection nodes. indexFirst The zero-based index of the first structure data element to be compared. indexSecond The zero-based index of the second structure data element to be compared. rangeStart A value between 0 and 180 degrees representing the start of the desired range. rangeEnd A value between 0 and 180 degrees representing the end of the desired range. |
accepted The nodes that pass the filter. rejected The nodes that do not pass the filter. |
| Filter.ByMemberEndForces Obsolete: Use the Filter.ByAnalysisResults node. |
node The input connection nodes. index The zero-based index of the structure data element to be compared. resultType The type of value to filter by: "Fx", "Fy"... rangeStart Start range rangeEnd End range |
accepted The nodes that pass the filter. rejected The nodes that do not pass the filter. |
| Filter.BySectionProfile Returns the connection nodes where the structure data element at an index has a certain section profile. |
node The input connection nodes. index The zero-based index of the structure data element to be compared. profileToFind The profile that the structure data element must have to pass the filter. |
accepted The nodes that pass the filter. rejected The nodes that do not pass the filter. |
| Filter.BySectionShape Returns the connection nodes where the structure data element at a certain index has a certain section shape. |
node The input connection nodes. index The zero-based index of the structure data element to be compared. shapeToFind The shape that the structure data element must have to pass the filter. |
accepted The nodes that pass the filter. rejected The nodes that do not pass the filter. |
| Filter.IsItAWebFlangeSection Returns the connection nodes where the structure data element at a certain index is of a section shape that has web and flange(s). |
node The input connection nodes. index The zero-based index of the structure data element to be compared. |
accepted The nodes that pass the filter. rejected The nodes that do not pass the filter. |
| Filter.BySectionType Returns the connection nodes where the structure data element at an index has a certain section type. |
node The input connection nodes. index The zero-based index of the structure data element to be compared. nameToFind The type name that the structure data element must have to pass the filter. |
accepted The nodes that pass the filter. rejected The nodes that do not pass the filter. |
| Filter.BySlantAngle Returns the connection nodes where the structure data element at an index has a certain slant angle (angle between the axis of the element and the vertical axis). |
node The input connection nodes. index The zero-based index of the structure data element to be compared. rangeStart A value between 0 and 90 degrees representing the start of the desired range. rangeEnd A value between 0 and 90 degrees representing the end of the desired range. |
accepted The nodes that pass the filter. rejected The nodes that do not pass the filter. |
| Filter.BySlopeAngle Returns the connection nodes where the structure data element at an index has a certain slope angle (angle between the axis of the element and the horizontal plane). |
node The input connection nodes. index The zero-based index of the structure data element to be compared. rangeStart A value between 0 and 90 degrees representing the start of the desired range. rangeEnd A value between 0 and 90 degrees representing the end of the desired range. |
accepted The nodes that pass the filter. rejected The nodes that do not pass the filter. |
| Filter.ByVerticalPosition Filters an input element by its Top or by its Bottom position. |
node The input connection nodes. index The zero-based index of the structure data element to be compared. position The position to filter by: "Top" or "Bottom" |
accepted The nodes that pass the filter. rejected The nodes that do not pass the filter. |
| Filter.ByZoneType Returns the connection nodes where the structure data element at an index has a certain zone type for that node. |
node The input connection nodes. index The zero-based index of the structure data element to be compared. zoneType A case insensitive string representing the zone type (it can be end or body). |
accepted The nodes that pass the filter. rejected The nodes that do not pass the filter. |
| Input.AnalysisResults Provides a drop-down selection of a analysis results. |
(A drop down from where you can select any of the analysis results) | analysisResult The analysis result. |
| Input.ConnectionTypes Provides a drop-down selection of a connection type. |
(A drop down from where you can select any of the connection types loaded in the model). | connectionType The resulting connection type. |
| Input.ResultTypes Provides a drop-down selection of a type of analysis result. |
(A drop down from where you can select any of the Forces or Moments) | resultType The type of analysis result. |
| Input.SelectStructureData Provides a way to manually select model elements. |
(Selection button for model elements) | Elements The resulting list of elements. |
| Input.StructuralSectionShapes Provides a drop-down selection of a structure data element section shapes. |
(A drop down from where you can select any of the section shapes) | sectionShape The output section shape. |
| Input.StructuralDataFamilies Provides a drop-down selection of a structure data element family. |
(A drop down from where you can select any of the families loaded in the model) | familyName The output family name. |
| Input.StructuralDataTypes Provides a drop-down selection of a structure data element types. |
(A drop down from where you can select any of the types loaded in the model) | parentFamily The output family name. typeName The output type name. |
| Model.GetStructureData Returns the list of structure data elements selected in the model. |
(A selection made in Revit prior to the execution of the script) | StructureData[] A list of structure data elements that were selected in the model. |
| StructureData.End Returns the End point of a structure data element. |
structureData The input structure data. |
Point The end point of the structure data element. |
| StructureData.GetCoordinateSystem Returns the coordinate system of a structure data element. |
structureData The input structure data. |
CoordinateSystem The output coordinate system (X axis is red, Y axis is green, Z axis is blue) |
| StructureData.RevitHandle Returns the Revit handle of a structure data element. |
structureData The input structure data. |
RevitHandle The Revit handle as string. |
| StructureData.SectionProfile Returns the section profile of a structure data element. |
structureData The input structure data. |
string The output section profile, as string. |
| StructureData.SectionShape Returns the section shape of a structure data element. |
structureData The input structure data. |
string The output section shape, as string. |
| StructureData.SectionType Returns the section type of a structure data element. |
structureData The input structure data. |
string The output section type, as string. |
| StructureData.Start Returns the Start point of a structure data element. |
structureData The input structure data. |
Point The start point of the structure data element. |
| StructureData.XAxis Returns the X axis of a structure data element. |
structureData The input structure data. |
Vector The output X axis, as vector. |
| StructureData.YAxis Returns the Y axis of a structure data element. |
structureData The input structure data. |
Vector The output Y axis, as vector. |
| StructureData.ZAxis Returns the Z axis of a structure data element. |
structureData The input structure data. |
Vector The output Z axis, as vector. |
| Zone.GetAnalysisResults Returns the force value for a certain analysis result. The force value comes from structural analysis results or from Revit analytical model. |
zone The input zone. Note this only works with "End" zone types. resultType Type of result: "Fx", "Fy"... analysisResult The analysis result identifier. Use SteelConnections.Input.AnalysisResults dropdown node to select the identifier" |
analysisResultValue The value of the result at the specific structure data element end. |
| Zone.GetEndForces Obsolete: Use the Zone.GetAnalysisResults node. |
zone The input zone. Note this only works with "End" zone types. resultType Type of result: "Fx", "Fy"... |
endForceValue The value of the result at the specific structure data element end. |
| Zone.Parent Returns the parent of the zone, which is a structure data element. |
zone The input zone or zones. |
ModelObject The output structure data element. |
| Zone.ZoneType Returns the zone type for a zone. |
zone The input zone(s). |
string The output zone type (end or body), as string. |