Node Reference#
This page describes all Dynamo nodes provided by SOFiSTiK Analysis + Design’s package.
Group Analyze#
- Analyze.CalculateSubsystems(List{String}, Boolean, Int32, Boolean, Boolean)#
Performs a calculation for the given list of subsystems
- Parameters:
viewNames –
planar2D – Create 2D planar slab system (instead of 3D system)
selfWeightNo – Activate self weight for given loadcase number. If == 0, self weight will not be considered
loadTransfer – Activate Load-Transfer between each subsystem
calculateImmediately – Immediately starts calculation of exported Analysis.Data. If false, creates only SOFiSTiK input files *.dat
- Returns:
datFiles: List of generated SOFiStiK input (*.dat) files
- Analyze.CalculateMainSystem(.String, Int32, Boolean, Boolean, String)#
Performs a analysis for the structural model of the given view. Parameters not available here will be taken from the analysis dialog of the given view.
- Parameters:
viewName – Name of the view displaying the structural model
selfWeightNo – Activate self weight for given loadcase number. If == 0, self weight will not be considered
analyzeLoads – Activate analysis of load cases
calculateImmediately – Immediately starts calculation of exported data. If false, creates only SOFiSTiK input files *.dat
additionalIncludeFile – Optional SOFiSTiK input *.dat file being performed after the calculation
- Returns:
datFile: The generated *.dat file on successful calculation
Group Model#
Analysis Model contains all SOFiSTiK structural elements
- Model.CreateByPath(String)#
Create SOFiSTiK Model based on SOFiSTiK Database *.cdb. If there is no SOFiSTiK Database, then first analyse the main system
- Parameters:
filePath – File path to SOFiSTiK Database *.cdb
- Model.CreateByViewName(String)#
Create SOFiSTiK Model based on given view name. View should correspond to a SOFiSTiK main or subsystem
- Parameters:
viewName – Name of View
- Model.CreateByActiveView()#
Create SOFiSTiK Model based on currently active view. If there is no SOFiSTiK Database, then first analyse the main system
- Model.GetMaterialIds()#
Returns a list of all Material Ids in the SOFiSTiK database
- Returns:
Ids : Id
- Model.GetMaterialProperties(List{Int32})#
- Provides Properties of Materials in SOFiSTiK Database, i.e.E: Young’s modulus [kN/m2]G: Shear modulus [kN/m2]mue: Poisson’s ratio [-]gamma: Nominal weight [kN/m3]fy: Effective Strength [kN/m2]
- Parameters:
material_ids – List of Material Ids (pass empty list to obtain all materials)
- Returns:
Materials: Material Id(0), Material Type(1), Designation(2), E-Modulus [kN/m2](3), G-Modulus [kN/m2](4), Poisson Ratio(5), Weight [kN/m3](6), Effective Strength [kN/m2](7)
- Model.GetAllStructuralElements()#
Provides all SOFiSTiK Structural Element Information
- Returns:
StructuralElements: Id(0), Guid(1), Title(2)
- Model.GetStructuralColumns()#
Provides all SOFiSTiK Structural Column Information A: Area [m2] gamma: Nominal weight [kN/m3]
- Returns:
StructuralColumns: Id(0), Guid(1), Title(2), SectionId(3), StartNode(4), EndNode(5), Area(6), gamma(7)
- Model.GetDesignElements()#
Provides all Design Elements and Properties from the SOFiSTiK Database Id: Design Element Id
- Returns:
Design Elements: Id(0), Guid(1), Title(2), SectionId(3), Length(4), LocalZ(x,y,z)(5)
- Returns:
Member Guids: Guid
- Returns:
Design Sections: Sections are represented with xi, which is the normalized length and goes from 0.0 to 1.0
- Model.GetStructuralBeams()#
- Provides all SOFiSTiK Structural Beam InformationA: Area [m2]gamma: Nominal weight [kN/m3]
- Returns:
StructuralBeams: Id(0), Guid(1), Title(2), SectionId(3),StartNode(4), EndNode(5), Area(6), gamma(7)
- Model.GetStructuralWalls()#
Provides all SOFiSTiK Structural Wall Information Geometry unit is in meters
- Returns:
StructuralWalls: Id(0), Guid(1), Title(2), Thickness(3), Width(4), Height(5)
- Model.GetStructuralSlabs()#
Provides all SOFiSTiK Structural Slab Information Geometry unit is in meter
- Returns:
StructuralSlabs: Id(0), Guid(1), Title(2), Thickness(3), Width(4), Height(5)
- Model.GetSectionIds()#
Returns a list of all Cross Section Ids in the SOFiSTiK database
- Returns:
Ids: Id
- Model.GetSectionProperties(List{Int32})#
- Provides properties of Cross-Sections in SOFiSTiK Database, i.e.A: Area [m2]Ay, Az: Shear areas [m2]It: Torsional moment inertia [m4]Iy,Iz,Iyz: Moment of Inertia of area [m4]ys,zs: Ordinate of elastic centroid [m]ycs, zcs: Ordinate of shear centre [m]E: Elasticity modulus [MPa]G: Shear modulus [MPa]gamma: Nominal weight [kN/m3]
- Parameters:
sectionIds – List of Section Ids (pass empty list to obtain all sections)
- Returns:
Properties: Section Id(0), Section Name(1), Material Id(2), Reinforcement Id(3), A(4), Ay(5), Az(6), It(7), Iy(8), Iz(9), Iyz(10), ys(11), zs(12), ysc(13), zsc(14), E(15), G(16), gamma(17)
- Model.GetSectionGeometry(Int32)#
Provides all outerBound, innerBounds geometry and reinforcement of the cross section
- Parameters:
sectionId – Section Id
- Returns:
OuterBounds: Autodesk.DesignScript.Geometry.Line
- Returns:
InnerBounds: Autodesk.DesignScript.Geometry.Line
- Returns:
Reinforcements: LayerId(0), BarDiameter(1), Autodesk.DesignScript.Geometry.Point as position(2)
- Model.GetMeshPointsIndices(String)#
Provides the mesh geometry with points and IndexGroup.ByIndices(a,b,c,d) It always uses 4 Indices A,B,C,D for the mesh.
- Parameters:
guid –
- Returns:
Points: Autodesk.DesignScript.Geometry.Point(x,y,z)
- Returns:
Indices: Autodesk.DesignScript.Geometry.IndexGroup.ByIndices(a,b,c,d)
- Model.GetTendons()#
Provides general information for all tendons
- Returns:
TendonGeometry: Id(0), Name(1), IdPrestressingSystem(2), TendonType(3)
- Returns:
GeometryDefinitionPoints: s(0), u(1), v(2), dus(3), dvs(4), dl(5), dr(6), position(x,y,z)(7), type(8) {TopPoint, JackingPoint, Coupling, FixedAnchor}
- Returns:
TendonData: Id(0), Name(1), IdGeometry(2), reserved(3), reserved(4), ElongationLengthStart(5), ElongationLengthEnd(6)
- Model.GetPrestressingSystems()#
Provides information of all prestressing systems in the SOFiSTiK database
- Returns:
GeneralInformation: Id(0), Name(1), MaterialId(2)
- Returns:
TendonProperties: Area[m2](0), Wires(1), NominalForce[kN](2), UnintendedAngle [1/m](3)
- Returns:
DuctGeometryData: DistanceToAxis[mm](0), DistanceToEdge[mm](1),innerDiameterDuct[mm](2),outerDiameterDuct[mm](3),Friction Coeff. Stressing(4), Friction Coeff. Release(5),Min.Radius of Curvature [m](6), AnchorSlip[mm](7)
Group Reinforcement#
Reinforcement for each structural reinforced element
- Reinforcement.GetDesignCases(Model)#
Provides all design cases for each structural member
- Parameters:
model – model
- Returns:
DesignCase: Id(0),Title(1),Type(2)
- Reinforcement.GetAreaReinforcement(Model, List{Int32})#
Provides all reinforcement for areas
- Parameters:
model – model
designCases – design case ids
- Returns:
Reinforcement: Guid(0), DesignCase(1), Id(2), Node(3), TopMajor(4), TopMinor(5), BottomMajor(6), BottomMinor(7), Shear(8), AreaDeterminant(9)
- Reinforcement.GetBeamReinforcement(Model, List{Int32})#
Provides all reinforcement for all beam elements
- Parameters:
model – model
designCases – Design Case Id
- Returns:
Reinforcement: Guid(0), DesignCaseId(1), Id(2), Xi(3), LongitudinalBottom(4), LongitudinalTop(5), LongitudinalLateral(6), ShearReinforcement(7), Influence(8)
- Reinforcement.GetColumnReinforcement(Model, List{Int32})#
Provdes all reinforcement for all column elements
- Parameters:
model – model
designCases – Design Case Ids
- Returns:
Reinforcement: Guid(0), DesignCaseId(1), Id(2), Xi(3), Longitudinal(4), Constructive(5), ShearReinforcement(6), Influence(7)
- Reinforcement.GetDesignElementReinforcement(Model, List{Int32})#
Provdes all reinforcement for all design elements
- Parameters:
model –
designCases – Design Case Ids
- Returns:
Reinforcement: Guid(0), DesignCaseId(1), Id(2), Xi(3), LongitudinalAs1(4), LongitudinalAs2(5), ShearReinforcement(6), Influence(7)
Group Results#
Analysis Result provides all load cases and the forces in [kN].
- Results.GetLoadCases(Model, String)#
Provides all loadcase information The return values start and end describe the construction stages
- Parameters:
model – SOFiSTiK model
type – Type of Loadcase: All, Linear, Nonlinear, Superposition, InfluenceLine, NaturalFrequency, BucklingMode, TrainLoadDefinition
- Returns:
Loadcases: LoadcaseId(0), Name(1), Action(2), Type(3), FactorDeadLoad(4),start(5),end(6)
- Results.GetColumnResults(Model, List{Int32}, String)#
Provides all results with a normalized length form [0,1]
- Parameters:
model – SOFiSTiK model
loadCaseIds – A list of requested loadcase ids
locations – StartPoints, EndPoints, StartEndPoints, StartEndMaxPoints, AllPoints
- Returns:
Results: LoadcaseId(0), Guid(1), structuralId(2), Xi(3), N(4), My(5), Mz(6), Vz(7), Vy(8)
- Results.GetBeamResults(Model, List{Int32}, String)#
Provides all results with a normalized length form [0,1]
- Parameters:
model – SOFiSTiK model
loadCaseIds – A list of requested loadcase ids
locations – StartPoints, EndPoints, StartEndPoints, StartEndMaxPoints, AllPoints
- Returns:
Results: LoadcaseId(0), Guid(1), structuralId(2), Xi(3), N(4), My(5), Mz(6), Vz(7), Vy(8)
- Results.GetWallResultants(Model, List{Int32}, String)#
Provides all result forces in [kN] with a normalized length form [0,1]
- Parameters:
model – SOFiSTiK model
loadCaseIds – A list of requested loadcase ids
locations – StartPoints, EndPoints, StartEndPoints, StartEndMaxPoints, AllPoints
- Returns:
Resultants: Id(0), Guid(1), structuralId(2), Xi(3), N(4), My(5), Mz(6), Vz(7), Vy(8)
- Results.GetAreaResults(Model, List{Int32}, String)#
- Provides all forces for each arealocalX = Vector[x,y,z]localZ = Vector[x,y,z]
- Parameters:
model –
loadCaseIds –
type – NodalValues
- Returns:
Results: Guid(0), LoadcaseId(1), structuralId(2), NXX(3), NYY(4), NXY(5), MXX(6), MYY(7), MXY(8), VX(9), VY(10), center(11), localX(12), localZ(13)
- Results.GetSupportPointForces(Model, List{Int32})#
- Provides all support forcesPX, PY, PZ: Forces [kN]LocalZ: Vector [x, y, z]
- Parameters:
model – SOFiSTiK model
loadCaseIds – Loadcase Ids
- Returns:
SupportPointForces: LoadcaseId(0), Guid(1), structuralId(2), PX(3), PY(4), PZ(5), MX(6), MY(7), MZ(8), position(9), localZ(10)
- Results.GetSupportLineForces(Model, List{Int32}, String)#
Provides all line support forces [kN] and support moments [kNm]
- Parameters:
model – SOFiSTiK model
loadCaseIds – Loadcase Ids
forceType – NodalForces [kN/m], Resultants [kN], PartialResultants [kN], Distributed [kN/m], Averaged [kN/m]
- Returns:
SupportLineForces: LoadcaseId(0), Guid(1), structuralId(2), xi(3), PX(4), PY(5), PZ(6), MX(7), MY(8), Mz(9), LocalZ(10)
- Results.GetSupportAreaForces(Model, List{Int32}, String)#
Provides all area support forces [kN] and support moments [kNm]
- Parameters:
model –
loadCaseIds – Loadcase Ids
forceType – NodalForces, Distributed
- Returns:
SupportAreaForces: LoadcaseId(0), Guid(1), structuralId(2), PX(3), PY(4), PZ(5), MX(6), MY(7), MZ(8)
- Results.GetDesignElementsResults(Model, List{Int32}, String)#
Provides force results in [kN],[kNm] for each design element The xi [0,1] represents the normalized length.
- Parameters:
model – SOFiSTiK model
locations – StartPoints, EndPoints, StartEndPoints, StartEndMaxPoints, AllPoints
loadCaseIds – Loadcase Ids
- Returns:
Results: DesignElementId(0), loadcaseId(1), Guid(2), SectionId(3), xi(4), N(5), My(6), Mz(7), Vz(8), Vy(9)
- Results.GetPunchingResults(Model)#
Provides results for punching design locations
- Parameters:
model – SOFiSTiK Model
- Returns:
PunchingNodes: NodeId(0), Force[kN](1), Perimeter_u0(2), ReductionFactor(3), SlabGuid(4), SlabThickness(5), ConnectedMemberGuid(6), Beta(7), Type(8)
Group Utils#
The Export write the load transfer in to Microsof.Excel file
- Utils.GetProjectPath(String)#
Returns the path of the currently active Revit document Optional file name can be provided which will be added to the path
- Returns:
Path to current Revit document
- Utils.GetSubsystemViewNames()#
Returns a list of all subsystem views in the currently active Revit document in alphabetical order
- Returns:
List of subsystem views
- Utils.GetMainSystemViewName()#
Returns the view name of the currently active main system
- Utils.GetPhysicalCounterpart(List{Revit.Elements.Element})#
Returns the physical counterpart of a given analytical element
- Parameters:
elements – List of analytical elements
- Returns:
List of counterparts
- Utils.TableLeftJoin(IList{IList{Object}}, IList{IList{Object}}, Int32, Int32)#
Joins two 2D-lists based on a common key. Combines the two lists by comparing a common key in both lists. The left join keeps all elements of the left list (and keeps their order) and adds to a row the first element of the right list which matches the common key.
- Parameters:
left – List of lists
right – List of lists
key_left – Index of column containing the key in the first list
key_right – Index of column containing the key in the second list
- Returns:
New list
- Utils.TableRightJoin(IList{IList{Object}}, IList{IList{Object}}, Int32, Int32)#
Joins two 2D-lists based on a common key. Combines the two lists by comparing a common key in both lists. The right join keeps all elements of the right list (and keeps their order) and adds to a row the first element of the left list which matches the common key.
- Parameters:
left – List of lists
right – List of lists
key_left – Index of column containing the key in the first list
key_right – Index of column containing the key in the second list
- Returns:
New list
- Utils.TableInnerJoin(IList{IList{Object}}, IList{IList{Object}}, Int32, Int32)#
Joins two 2D-lists based on a common key. Combines the two lists by comparing a common key in both lists. The inner join adds an entry to the new list only if an item with a common key is contained within both lists. The order of the resulting elements is defined by the left input list.
- Parameters:
left – List of lists
right – List of lists
key_left – Index of column containing the key in the first list
key_right – Index of column containing the key in the second list
- Returns:
New list
Group Export#
The Export prepares Lists for direct Export to Excel
- Export.ResultsToExcel(.String, String, Boolean, Boolean, Boolean, Boolean, Boolean)#
Export results of active analysis system to Microsoft Excel
- Parameters:
dataBasePath – path to SOFiSTiK database
pathToExcelFile – Path to Excel File
beams – Export results for Beams
columns – Export results for Columns
walls – Export results for Walls
supports – Export results for Supports
allSOFiSTiKLoadcases – Export all SOFiSTiK loadcases or all Revit loadcases