Review the available Dynamo nodes to use with Steel Connections.
| Dynamo Node | Input | Output |
|---|---|---|
|
Connection.ByType Creates connections. |
node A connection node or a list of connection nodes. 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. ExistingA connection node or a list of connection nodes where a connection already existed. |
|
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 The Grouping Node |
|
ConnectionNode.RemoveDuplicates
Finds all the 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 the list of connection nodes. noOfZones The specified number of zones. |
ConnectionNode[] A list of connection subnodes. For more info, see The Arrangements Node. |
|
ConnectionNode.Zones Returns the zones within each input connection node. |
connectionNode The connection node, or the list of connection nodes. |
Zone[] A list of zones. |
|
ConnectionType.ByNames Gets a connection type from two strings. Note: The connection type must be loaded in the Revit model.
|
connectionName The name of the steel connection family, for example "Base plate" or "Apex haunch". typeName The name of the steel connection type, for example "Base plate small" or "Base plate robust". |
ConnectionType The resulting connection type. |
|
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 connection types located in the specified file path, which are available for loading into the current document. |
filePath Provide the source file path for listing the connection type. |
ConnectionTypes A list of connections. |
|
ConnectionType.LoadFromFile Loads a connection type into the current document from an external .rvt file using a specified file path. |
filePath Provide the source file path for loading the connection type. connectionName The name of the steel connection family, for example "Base plate" or "Apex haunch". typeName The name of the steel connection type, for example "Base plate small" or "Base plate robust". |
ConnectionType The connection type that has been loaded in the current model. |
|
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.UseCurrentOrLoadFromFile Returns a connection type with the specified name or loads it from a file path when it is not already present in the current document Note: This is a custom node.
|
connectionName The name of the steel connection family, for example "Base plate" or "Apex haunch". typeName The name of the steel connection type, for example "Base plate small" or "Base plate robust". filePath Provide the source file path for loading the connection type. |
ConnectionType The connection type that has been found or newly loaded in the current model. |
|
ConnnectionType.LoadOnDemand Returns a connection type with the specified name or loads it from a file path when it is not already present in the current document. If the connection type is not needed, it returns null. Note: This is a custom node.
|
nodes The list of connection nodes to see if this connection type will be used. connectionName The name of the steel connection family, for example "Base plate" or "Apex haunch". typeName The name of the steel connection type, for example "Base plate small" or "Base plate robust". filePath Provide the source file path for loading the connection type. |
ConnectionType The connection type that has been found or newly loaded in the current model, or null. |
|
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. |
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. This contains the model name, the package name and the load name (case, combination or envelope), separated by '|'. Example: "Model1|Analysis results|DL1" or "Model1|Analysis results|Envelope1|Min" 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 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 reference axis of the first structure data element (it can be X, Y or Z, specified as a case insensitive string). axisSecond The reference axis of the second structure data element (it 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 the Nth and Mth structure data elements in the node form an angle within a certain range. This is similar to ByAngleBetweenAxes, except it only measures the angle between the X axes, and for the case where the structural elements meet end to end, the angle can be between 0 and 180 degrees instead of between 0 and 90 degrees. |
node The input connection node or 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
Returns the connection nodes where the structure data element at a certain index has a force value within a certain range. |
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 node or 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 an index has a certain section shape. |
node The input connection node or 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.BySectionType Returns the connection nodes where the structure data element at an index has a certain section type. |
node The input connection node or 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 node or 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 node or 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 node or 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. |
|
Filter.ByBracingSectionShapes Filters by the section shapes of the diagonals in a gusset connection: angle, channel, or hollow section. Note: This is a custom node.
|
node The input connection node or nodes. index Number |
accepted The nodes that pass the filter. rejected The nodes that do not pass the filter. |
|
Filter.ByIOrCSectionShape Filters by all the I and C section shapes. Note: This is a custom node.
|
node The input connection node or nodes. index Number. |
accepted The nodes that pass the filter. rejected The nodes that do not pass the filter. |
|
Filter.ByTubularSection Filters by rectangular and circular hollow section shapes. Note: This is a custom node.
|
node The input connection node or nodes. index Number. |
accepted The nodes that pass the filter. rejected The nodes that do not pass the filter. |
|
Input.AnalysisResults
Provides a drop-down selection of 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 connection types. |
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 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 structure data element families. |
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 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 the 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 (the X axis is red, the Y axis is green, the Z axis is blue). |
|
StructureData.SectionProfile Returns the section profile of a structure data element. |
structureData The input structure data. |
string The output section profile, as a string. |
|
StructureData.SectionShape Returns the section shape of a structure data element. |
structureData The input structure data. |
string The output section shape, as a string. |
|
StructureData.SectionType Returns the section type of a structure data element. |
structureData The input structure data. |
string The output section type, as a 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 a vector. |
|
StructureData.YAxis Returns the Y axis of a structure data element. |
structureData The input structure data. |
Vector The output Y axis, as a vector. |
|
StructureData.ZAxis Returns the Z axis of a structure data element. |
structureData The input structure data. |
Vector The output Z axis, as a vector. |
|
Zone.GetAnalysisResults
Returns the force value for a certain analysis result. |
zone The input zone.
Note: This only works with "End" zone types.
resultType Type of result: "Fx", "Fy"... analysisResult The analysis result identifier. It contains the model name, the package name and the load name (case, combination or envelope), separated by '|'. Example: "Model1|Analysis results|DL1" or "Model1|Analysis results|Envelope1|Min". |
analysisResultValue The value of the result at the specific structure data element end. |
|
Zone.GetEndForces
Returns the end force value |
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 or zones. |
string The output zone type (end or body), as a string. |