# README for GitHub # What is SAF? ## Welcome to SAF SAF is an initiative from the Nemetschek Group to improve the collaboration between structural engineers by developing an open exchange format for exchanging data between structural analysis software based on the Excel format. It is focusing on a practical, easy to use, format that can be used in daily practice by structural engineers. It is meant as an open format and we look forward to you joining this initiative. The structural analysis software companies participating in this initiative today are presented in chapter ["Who supports SAF?](/getting-started/who-supports-saf)["](/getting-started/who-supports-saf). The coordination is currently managed by SCIA. If you are interested in joining, please contact Herman Oogink, Director Product and Alliances at SCIA. Email: **** **You can visit the free web app to test the import of your own SAF!** [**Free SAF viewer**](https://autoconverter.structuraltoolkit.com/en-GB/saf-viewer) # Who supports SAF? {% hint style="info" %} **Last update: November 2021** **Note:**\ Information in the table is provided by involved partners them self. Author of the documentation is not taking any responsibility for correctness of given information. If you found a mistake or want to update the table content, please contact us via email on **** {% endhint %} {% hint style="info" %} Full size table available [here](https://saf.guide/#Company%20overview_master.htm%3FTocPath%3D_____2). {% endhint %} ## Native SAF support: See below overview tables which will give you an idea of who supports SAF and to which extend. If you have more questions about implementation or user-end usage of SAF import/expert per specific application, please contact their customer support team. ### SAF Implementation | **SAF implementation** |

1

SCIA

|

1

FRILO

|

1​

Graphisoft

|

1​

Risa

|

1​

Radimpex

|

1​

LIRA SAPR SAPHIR

|

1​

AxisVM

|

1​

FEM-Design

|

​

1​

Sofistik

| | ---------------------- | :------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------: | :----------------------------------------------------------------------: | :----------------------------------------------------------------: | :--------------------------------------------------------------------: | :----------------------------------------------------------------------------: | :------------------------------------------------------------------: | :----------------------------------------------------------------------: | :----------------------------------------------------------------------------: | | Supported version | 1.0.5 - 2.0.0 | 1.0.5 | 1.0.5 - 2.0.0 | 2.0.0 | 2.0.0 | 2.0.0 | 1.0.5 | 1.0.5 | 2.0.0 | | Import | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | | Export | Yes | Yes | Yes | Yes | Yes | No | Yes | No | No | |

Structural analysis
elements

|

1

SCIA

|

1

FRILO

|

1​

Graphisoft

|

1​

Risa

|

1​

Radimpex

|

1​

LIRA SAPR SAPHIR

|

1​

AxisVM

|

1​

FEM-Design

|

​

1​

Sofistik

| | ------------------------------------------------------------------------ | :------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------: | :----------------------------------------------------------------------: | :----------------------------------------------------------------: | :--------------------------------------------------------------------: | :----------------------------------------------------------------------------: | :------------------------------------------------------------------: | :----------------------------------------------------------------------: | :----------------------------------------------------------------------------: | | StructuralMaterial | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | | StructuralCrossSection | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | | CompositeShapeDef | Yes | Yes | Yes | Yes | Yes | Yes | Yes | No | No | | StructuralPointConnection | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | | StructuralCurveEdge | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | | StructuralCurveMember | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | | StructuralCurveMemberVarying | Yes | No | No | No | Yes | Yes | Yes | No | No | | StructuralCurveMemberRib | Yes | Yes | Yes | No | Yes | Yes | Yes | No | No | | StructuralSurfaceMember | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | | StructuralSurfaceMemberOpening | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | | StructuralSurfaceMemberRegion | Yes | Yes | Yes | No | Yes | Yes | Yes | No | Yes | | StructuralStorey | Yes | No | No | No | Yes | Yes | Yes | No | No | | StructuralProxyElement | Yes | No | No | Yes | No | No | No | No | No | ### Supports and hinges | Supports and hinges |

1

SCIA

|

1

FRILO

|

1​

Graphisoft

|

1​

Risa

|

1​

Radimpex

|

1​

LIRA SAPR SAPHIR

|

1​

AxisVM

|

1​

FEM-Design

|

​

1​

Sofistik

| | --------------------------- | :------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------: | :----------------------------------------------------------------------: | :----------------------------------------------------------------: | :--------------------------------------------------------------------: | :----------------------------------------------------------------------------: | :------------------------------------------------------------------: | :----------------------------------------------------------------------: | :----------------------------------------------------------------------------: | | StructuralPointSupport | Yes | Yes | Yes | No | Yes | No | Yes | Yes | Yes | | StructuralSurfaceConnection | Yes | Yes | Yes | No | Yes | No | Yes | Yes | Yes | | StructuralCurveConnection | Yes | Yes | Yes | No | Yes | No | Yes | Yes | Yes | | StructuralEdgeConnection | Yes | Yes | Yes | No | Yes | No | Yes | Yes | Yes | | RelConnectsStructuralMember | Yes | No | Yes | No | Yes | No | Yes | Yes | Yes | | RelConnectsSurfaceEdge | Yes | Yes | Yes | No | Yes | No | Yes | Yes | No | | RelConnectsRigidCross | No | No | Yes | No | Yes | No | Yes | No | No | | RelConnectsRigidLink | Yes | No | Yes | No | No | No | Yes | Yes | No | | RelConnectsRigidMember | No | No | Yes | No | No | No | Yes | Yes | No | ### Loads | **Loads** |

1

SCIA

|

1

FRILO

|

1​

Graphisoft

|

1​

Risa

|

1​

Radimpex

|

1​

LIRA SAPR SAPHIR

|

1​

AxisVM

|

1​

FEM-Design

|

​

1​

Sofistik

| | ----------------------------------- | :------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------: | :----------------------------------------------------------------------: | :----------------------------------------------------------------: | :--------------------------------------------------------------------: | :----------------------------------------------------------------------------: | :------------------------------------------------------------------: | :----------------------------------------------------------------------: | :----------------------------------------------------------------------------: | | StructuralLoadGroup | Yes | Yes | Yes | Yes | Yes | No | Yes | No | No | | StructuralLoadCase | Yes | Yes | Yes | Yes | Yes | Yes | Yes | No | No | | StructuralLoadCombination | Yes | No | Yes | Yes | No | Yes | Yes | No | No | | StructuralPointAction | Yes | Yes | Yes | Yes | Yes | Yes | Yes | No | No | | StructuralPointMoment | Yes | Yes | Yes | Yes | Yes | Yes | Yes | No | No | | StructuralCurveAction | Yes | Yes | Yes | Yes | Yes | Yes | Yes | No | No | | StructuralCurveMoment | Yes | Yes | Yes | Yes | Yes | Yes | Yes | No | No | | StructuralSurfaceAction | Yes | Yes | Yes | Yes | Yes | Yes | Yes | No | No | | StructuralSurfaceActionThermal | No | No | No | Yes | Yes | No | Yes | No | No | | StructuralCurveActionThermal | No | No | No | No | Yes | No | Yes | No | No | | StructuralPointActionFree | Yes | Yes | No | No | Yes | Yes | Yes | No | No | | StructuralCurveActionFree | Yes | Yes | No | No | Yes | Yes | Yes | No | No | | StructuralSurfaceActionFree | Yes | Yes | No | No | Yes | Yes | Yes | No | No | | StructuralSurfaceActionDistribution | No | No | No | No | No | No | No | No | No | ### Implementation in progress | **SAF implementation** |

1

Dlubal

|

1

D.I.E

|

1​

IDEA

| ![](/files/vCNah0fTvFaet1Zwqcsf) ConSteel | ![](/files/RkTzNRXVDU8fmMlgHFOS) mbAEC | ![](/files/RGsGNXG3BHS07MjfgSxS) InfoGraph | | ---------------------- | :--------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------: | :----------------------------------------------------------------: | :---------------------------------------: | :------------------------------------: | :----------------------------------------: | | | Yes | Yes | Yes | Yes | Yes | Yes | ## Support via SAF converter Tables below shows coverage of [SAF converter](https://safconverter.structuraltoolkit.com/rfem). Independent hub where dedicated tools and apps for specific conversion of CAE model to SAF are available. ### SAF Implementation | **SAF implementation** |

1

Dlubal

|

1

Robot

| | ---------------------- | :--------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------: | | Supported version | 1.0.5 | 1.0.5 | | Import | Yes | Yes | | Export | No | No | ### Structural analysis elements |

Structural analysis
elements

|

1

Dlubal

|

1

Robot

| | ------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------: | | StructuralMaterial | Yes | Yes | | StructuralCrossSection | Yes | Yes | | CompositeShapeDef | No | No | | StructuralPointConnection | Yes | Yes | | StructuralCurveEdge | Yes | Yes | | StructuralCurveMember | Yes | Yes | | StructuralCurveMemberVarying | No | No | | StructuralCurveMemberRib | Yes | Yes | | StructuralSurfaceMember | Yes | Yes | | StructuralSurfaceMemberOpening | Yes | Yes | | StructuralSurfaceMemberRegion | Yes | No | | StructuralStorey | No | No | | StructuralProxyElement | No | No | # SAF versions {% hint style="info" %} SAF documentation is going to follow semantic versioning of documentation from the upcoming version (releases after 2.0.0). Semantic versioning makes implementation easier and also states clearly future compatibility between versions.\ \ More about semantic versioning: [semver.org](https://semver.org) {% endhint %} Browse version history [2.0.0](https://saf.guide) [1.0.5](https://old.saf.guide/v1.0.5) # SAF Examples ## HOUSE SAF version 2.0.0.\ Global coordinate system: Z vertical\ System of units: Metric units ![](/files/41rdDywrRKSjJ3QobM0a) [SAF\_example\_HOUSE\_metric\_ZYX\_200\_saf.guide.xlsx](https://github.com/StructuralAnalysisFormat/gitbookdocumentation/files/7513947/SAF_example_HOUSE_metric_ZYX_200_saf.guide.xlsx) # Release Notes {% hint style="success" %} Current version 2.0.0 {% endhint %} ## Specification improvements Improvements in the specification are not changing the functionality or compatibility of SAF. These changes only improve the understandability of SAF documentation. 14.9.2021 Edge indexing issue: [GitHub](https://github.com/StructuralAnalysisFormat/gitbookdocumentation/discussions/15) - discussion * Clear specification provided for edge indexing ([StructuralEdgeConnection](/supports-and-hinges/structuraledgeconnection), [RelConnectsSurfaceEdge](/supports-and-hinges/relconnectssurfaceedge), [RelConnectsRigidMember](/supports-and-hinges/relconnectsrigidmember), [StructuralCurveAction](/loads/structuralcurveaction), [StructuralCurveMoment](/loads/structuralcurvemoment)) 15.7.2021 [StructuralLoadGroup](/loads/structuralloadgroup): * "Load type" string: condition moved from description (required only for "Load group type" = Variable) 15.7.2021 [StructuralSurfaceActionDistribution](/loads/structuralsurfaceactiondistribution-1): * "Load applied to" string: attribute is not required (required string was in contradiction with description) ​​​​​​​ ## Release notes ### 8.8.2021 - Fixing flaws in SAF spec v1.0.9 and v2.0.0 Following changes were done based on the proposal discussed on [GitHub](https://github.com/StructuralAnalysisFormat/gitbookdocumentation/discussions/7) - discussion, [GitHub](https://github.com/StructuralAnalysisFormat/gitbookdocumentation/issues/11) - issue. [StructuralSurfaceActionDistri](/loads/structuralsurfaceactiondistribution-1) (SAF 1.0.9) * Object renamed from StructuralSurfaceActionDistribution to StructuralSurfaceActionDistri. Original name exceeds the allowed number of characters for the name of an excel sheet. [S](/loads/structuralsurfaceaction)[tructuralSurfaceAction](/loads/structuralsurfaceaction) (SAF 1.0.9) * added new column: "2D member distribution" - reference to StructuralSurfaceActionDistri * added new column: "Force action" - enum defining on which object is load applies (On 2D member, On 2D member region, On 2D member distribution) * change of a rule: "2D member column" required only if Force action = "On 2D member" \ [StructuralCurveAction](/loads/structuralcurveaction) (SAF 2.0.0) * new column added for reference: "2D member region" - reference to StructuralSurfaceMemberRegion * new column added for reference: "2D member opening" - reference to StructuralSurfaceMemberOpening [StructuralCurveMoment](/loads/structuralcurvemoment) (SAF 2.0.0) * new column added for reference: "2D member region" - reference to StructuralSurfaceMemberRegion * new column added for reference: "2D member opening" - reference to StructuralSurfaceMemberOpening [StructuralEdgeConnection](/supports-and-hinges/structuraledgeconnection) (SAF 2.0.0) * new column added for reference: "2D member region" - reference to StructuralSurfaceMemberRegion * new column added for reference: "2D member opening" - reference to StructuralSurfaceMemberOpening ### 21.12.2020 - Version 2.0.0 In version 2.0.0: New attribute added: Project and model specification - Model sheet, National code added StructuralPointAction - Possible to input angled point force, Extended Direction enum, Added Vector attribute StructuralPointActionFree - Possible to input angled point force, Extended Direction enum, Added Vector attribute StructuralCurveAction * Possible to input angled line force, Extended Direction enum, Added Vector 1 and Vector 2 attribute * Extended Force action enum by "On subregion edge" and "On opening edge" StructuralEdgeConnection * Added enum attribute "Boundary condition" to allow input on different types of edges (2D member, 2D opening, 2D subregion) StructuralCurveMoment - Extended Force action enum by "On subregion edge" and "On opening edge" StructuralCurveFree - Possible to input angled line force, Extended Direction enum, Added Vector 1 and Vector 2 attribute We removed default column value. We included more attributes as required to ensure all important and structural engineering relevant data will be exchanged ### 11.12.2020 - Version 1.1.0 In version 1.1.0: New object added: Structural Proxy Element - object which allows to describe general solids ### 4.12.2020 - Version 1.0.9 In version 1.0.9: * LCS type is required value for StructuralCurveMember * Added ID for Model and Project sheet in Project and model specifications StructuralStorey StructuralCurveMemberVarying * New object StructuralSurfaceActionDistribution to describe load panels * Added detailed description for Global coordinate system property in Project and model specifications ### 26.11.2020 - Version 1.0.8 In version 1.0.8, few small formal changes was made * Thermal load for 2D members - removed delta T attribute, to specify single value for constant temperature change, use attribute "TempT " * Added Id attribute for Project and Model information * "Project nr." changed to "Project nr" (removed dot) in Project information * removed "V" in front of SAF version attribute at Model information ### 13.11.2020 - Version 1.0.7 In version 1.0.7, three major additions were added * Thermal load for 1D members StructuralCurveActionThermal * Thermal load for 2D members StructuralSurfaceActionThermal * New types of eccentricities (structural and analysis) for StructuralCurveMember and StructuralSurfaceMember ### 23.10.2020 - Version 1.0.6 In version 1.0.6, four major additions were added * "Parent ID" added for StructuralSurfaceMemberRegion StructuralSurfaceConnection StructuralEdgeConnection RelConnectsStructuralMember RelConnectsSurfaceEdge StructuralCurveAction StructuralSurfaceActionFree StructuralCurveMemberRib StructuralCurveConnection StructuralCurveMoment StructuralSurfaceActionThermal RelConnectsRigidCross StructuralCurveEdge StructuralCurveMember StructuralSurfaceMember StructuralSurfaceMemberOpening * "Area" attribute added for StructuralSurfaceMemberRegion StructuralSurfaceMember StructuralSurfaceMemberOpening * Formcodes description was updated Formcodes * Structural and Analysis eccentricity was introduced for: StructuralCurveMember StructuralSurfaceMember Changed objects: StructuralCrossSection * Form code is required value for CSS type "compound" StructuralCurveMember * Simplified System line alignment description ### 14.04.2020 - Version 1.0.5 In version 1.0.5, four major additions were added * "Parent ID" for StructuralCurveMember and StructuralSurfaceMember * new object StructuralCurveMemberVarying to define tapered, arbitrary, haunch beams * new object StructuralStorey to define storey levels * new enum describing cross section LCS type in StructuralCrossSection New objects: StructuralCurveMemberVarying * New object for description tapered, arbitrary, haunch beams StructuralStorey * New object for description structural storey, floor levels Changed objects: CompositeShapeDef * Added LCS explanation Geometry * Added SAF geometry strings column * Edited values for bezier, added further explanation Introduction * Added general LCS vector description * Updated pictures (LCS is now self explaining) Project and model specifications * Added description column * Added enum LCS of cross section * Added RigidCross in the list of objects * New feature for ignored groups and objects and add list of groups and objects RelConnectsStructuralMember * Added definition of fully rigid connection StructuralCrossSection * Formcode is now required for manufactured cross sections * Removed LCS of cross section enum * Added new enum "LCS of cross section" StructuralCurveAction * Specified rel vs abs StructuralCurveMember * Added Parent ID * LCS type "Standard" not used anymore * Added column "Arbitrary definition" to link to StructuralCurveMemberVarying * Fixed typos StructuralCurveMemberRib * Updated description column * New picture explaining LCS of the rib * Fixed typos StructuralCurveMoment * Specified rel vs abs StructuralMaterial * Quality and Name is recommended to set the same value StructuralPointAction * Specified rel vs abs StructuralPointMoment * Specified rel vs abs StructuralSurfaceActionThermal * Specified meaning of temperatures StructuralSurfaceMember * Added Parent ID column * Fixed typos StructuralSurfaceMemberOpening * Added all supported geometries StructuralSurfaceMemberRegion * Fixed typos Supported shapes of parametric cross section * Added missing parameter "s" for I Section with haunch Asymmetric ### 10.10.2019 - Version 1.0.4 In version 1.0.4, "Id" row was added to all supported objects. Changed objects: Project and model specifications * Attribute "ADM version" was deleted * Improved description in a manner that is clear that model and project sheets are defined in rows and not in columns like other objects * "Created" and "Last update" attributes have changed the format of the date and time * Added excel examples StructuralSurfaceActionThermal * added attribute "2D Member Region" StructuralSurfaceActionFree * C vertexes explained in detail, added images Introduction * Minor changes in formatting StructuralSurfaceMember * Description extended for the edges numbering of surface members RelConnectsRigidMember * Added link to StrucutralSurfacesMember for explanation of edges numbering * Enums for constrains sorted RelConnectsRigidLink * Added description about coordinate system of RigidLink * "Type" column deleted * Enums for constrains sorted * Added description to hinge position StructuralCurveMember * Bezier, Spline and Parabolic arc are supported StructuralCurveActionFree * Bezier, Spline and Parabolic arc are supported StructuralCurveMemberRib * Bezier, Spline and Parabolic arc are supported ### 19.8.2019 - Version 1.0.3 New objects: RelConnectsRigidCross RelConnectsRigidMember Changed objects: Introduction * Local Coordinate System of 1D and 2D members described in detail RelConnectsRigidLink * General update of all attributes: Functionality reduced on Nodes only (due to implementation of internal nodes), new enums for displacements * Added new properties Geometry * Edited size of pictures * Pictures updated StructuralSurfaceMember * Edited size of pictures StructuralEdgeConnection * Updated notes StructuralPointAction * Minor changes pages set up * Updated pictures StructuralCurveAction * Minor changes pages set up * Updated pictures StructuralSurfaceMemberRegion * Updated picture StructuralCurveMoment * Updated pictures ### 13.6.2019 - Version 1.0.2 New objects: Geometry ### 23.5.2019 - Version 1.0.1 New objects: CompositeShapeDef Changed objects: Supported shapes of parametric cross-section * Updated images of parametric cross-sections StructuralPointActionFree * Excel sheet link fixed StructuralPointMoment * Excel sheet link fixed Formcodes * Updated "Corresponding Description ID of the profile" for L section Supported shapes of compound section * Unification of terminology Supported shapes of parametric cross-section * Shape Enum correction: "I Section with haunch Asymmetric" StructuralEdgeConnection * Excel sheet link fixed RelConnectsStructuralMember * Excel sheet link fixed RelConnectsSurfaceEdge * Excel sheet link fixed StructuralLoadGroup * Excel sheet link fixed StructuralLoadCase * Added values for "Load type": Temperature, Wind, Snow, Maintenance, Fire, Moving, Seismic and Standard * Removed values for "Load type": Primary effect * "Specification" Enum replaced by "Duration" with following possible values: Short, Medium, Long and Instantaneous * Excel sheet link fixed StructuralPointAction * Excel sheet link fixed StructuralCurveAction * Excel sheet link fixed StructuralCurveActionFree * Excel sheet link fixed StructuralSurfaceActionFree * Notes updated * Excel sheet link fixed StructuralCurveMemberRib * Alignment description updated * Defined new value: "Eccentricity ez" * Extended description for "Type of connection" and "Layer" * Minor changes in table style StructuralCurveConnection * Defined new value as Enum: "Type" RelConnectsRigidLink * Redefined default value for "Hinges" StructuralLoadCombination * Added excel example sheet Project and model specifications * New value defined "SAF version" * Extended definition of the Values: Type of data, Value example or enum definition, Required value, Default value * Minor text changes StructuralMaterial * Excel sheet link fixed StructuralCrossSection * Defined new Enum for Cross-section type: "General" * For Cross-section type "General" is further specification moved to CompositeShapeDef * Excel sheet link fixed StructuralCurveEdge * Excel sheet link fixed StructuralCurveMember * Excel sheet link fixed StructuralSurfaceMember * Updated description for: "Edges" * Excel sheet link fixed Startup page * Major update of changes in Version 1.0.0 (Release Notes) StructuralPointConnection * Excel sheet link fixed StructuralSurfaceMemberOpening * Excel sheet link fixed StructuralSurfaceMemberRegion * Excel sheet link fixed StructuralPointSupport * Excel sheet link fixed StructuralSurfaceConnection * Excel sheet link fixed StructuralSurfaceAction * Excel sheet link fixed ### 19.3.2019 - Version 1.0.0 New objects: StructuralCurveConnection RelConnectsRigidLink StructuralLoadCombination StructuralCurveMoment StructuralCurveActionThermal StructuralSurfaceActionThermal Changed objects: StructuralCrossSection * Added new types to parametric shapes of Cross-section (I Section with haunch Asymetric, T Section with haunch, Trapezoid) - in annex * Added definition of general cross-section * Added support for compound cross-sections * Added attributes for analysis properties of the cross-section StructuralMaterial * Quality is required value * Added new design properties for timber material (in Annex) StructuralEdgeConnection * Coordinate system: added "Global" option StructuralPointSupport * Added parameters "Compression only", "Tension only" for three translation constraints (X, Y, Z) StructuralCurveConnection * Added parameters "Compression only", "Tension only" for three translation constraints (X, Y, Z) StructuralEdgeConnection * Added parameters "Compression only", "Tension only" for three translation constraints (X, Y, Z) StructuralCurveMemberRib * Alignment: add user defined value StructuralCurveMember * Behaviour in analysis: add new options for tension only and compression only StructuralSurfaceMember * Added support for variable thickness * LCS definition by vector * Support for circle slab (Circle by point, Circle by 3 points) StructuralPointAction Deleted attribute "extend" StructuralLoadGroup * Enum of "Load group type" attribute changed StructuralLoadCase * Deleted attribute "Specification" StructuralSurfaceActionFree * Added names of the vertexes of the polygon Model specification * Added attribute for SAF version # Introduction ## Excel Each list in excel represents one object definition. The name of the list must match the exact name of the object. Each list is divided into rows, columns and cells: The row represents one item (member) – node, beam, plate, support, etc… The column represents one property attribute of a member – name, type, colour, shape, etc… The cell represents one property value – 3m, layer 1, wall (80), etc … Excel screenshot examples: **Sheet:** ![](/files/kvfIu7x8FjfynQ4PvjDq) **Columns and rows:** ![](/files/jlGskZLipceIvP6h7du7) **Cell types:** **Double** - A floating point number\ **Integer** – A whole number which has a minimum value of 0.\ **Enum** - Ordered listing of all the items in a collection used for data validation. Only allowed values from the list can be inputted.\ **String** - A sequence of characters, Text. {% hint style="info" %} Any numeric value (Double, Integer) has to be formatted as a number in an excel sheet. {% endhint %} In SAF, supported units are **metric** and **imperial**. Units are defined in the "Model" sheet. {% hint style="info" %} Units can be optionally displayed in property headers.\ The unit system used in SAF file is given on [Model](https://saf.guide/Content/2_Project%20and%20model%20specifications.htm) sheet page by the user.\ Values given in SAF format should correspond to predefined values per system unit set. Table of predefined and expected units can be reviewed on [Project and specification page.](https://saf.guide/Content/2_Project%20and%20model%20specifications.htm)\*\*\*\* {% endhint %} {% hint style="info" %} The order of lists and columns does not matter, for import. Important is to consistently follow its naming. {% endhint %} ## **Coordinate systems** For all orientation of loads and coordinate system **right-handed rule** is valid. The system provides for: * unambiguous positioning of the member in space, * unambiguous definition of load and boundary conditions, * unambiguous interpretation of results. It may help you to determine the direction of the individual structural elements axis if you remember what you (probably) learnt at school. Take your right hand, position your thumb, index finger and middle finger so that they are perpendicular to each other. Then the following applies (see also the image below): ![](/files/YXGumV8nhbvzDd0LQPSd) * the thumb points in the direction of the x-axis, * the index finger points in the direction of the y-axis, * the middle finger points in the direction of the z-axis. ### **LCS - Local coordinate systems** Each structural entity, meaning each member, has got its own local co-ordinate system. This co-ordinate system is a three-dimensional right-handed Cartesian co-ordinate system. Each member has several possibilities of enums, defining the Local Coordinate System (LCS). For further understanding of enums defining the LCS of the [StrucutralCurveMember](https://saf.guide/Content/A_Objects/7_StructuralCurveMember.htm) and [StructuralSurfaceMember](https://saf.guide/Content/A_Objects/8_StructuralSurfaceMember.htm) see the following: For **1D members**, there are several options on how to define LCS of [StrucutralCurveMember](https://saf.guide/Content/A_Objects/7_StructuralCurveMember.htm): ### LCS enum set on **" by point"** When is LCS enum set on **" by point"** explanation is the following: * X-axis orientation is given by system line of the member * X-axis direction is defined by the start point and end point of the member * Z-axis orientation is given by the intersection of a plane perpendicular to x and a plane defined by x-axis and point * Z-axis direction follow the point * Y-axis orientation and direction is defined by the right-hand rule ![](/files/ECCk4FL70YCzh0leQdJd) ### LCS enum set on **"by vector"** When is LCS enum set on **"by vector"** explanation is the following: * X-axis orientation is given by system line of the member * X-axis direction is defined by the start point and end point of the member * Z-axis orientation and direction is given by vector coordinates * Y-axis orientation and direction is defined by right-hand rule ![](/files/6vG6rrFqnegrs1lsv6LB) ### General vector as LCS **"by vector"** User can set the LCS "by vector" with the vector which is not perpendicular to the centre line of the 1D member. Such a vector is projected to perpendicular as shown in animation below. The user-defined vector is the yellow one. The yellow vector is not in perpendicular plane to the centre line of the member, so blue and yellow vector are not parallel. ![](/files/qtytXnUF2lLs4tAFnyaj) The difference between definition of LCS **"axis** y **or** z **by point**" and **"axis** y **or** z **by vector"** is presented on the picture below. ![](/files/2k8sSd1BeeoF5LqmfHMS) \ For **2D members**, there are several options on how to define LCS of [StructuralSurfaceMember](/structural-analysis-elements/structuralsurfacemember): ### LCS enum set on **"axis** x **or** y **by vector" (2D members)** When is LCS enum set on **"axis** x **or** y **by vector"** explanation is similar to [StructuralCurveMember ](https://saf.guide/Content/A_Objects/8_StructuralSurfaceMember.htm)presented above with the following additional information: * For non-vertical 2D elements (slabs): * Y or X axis is given by the vector (depending on chosen option in the SAF excel file) * the Z axis direction is perpendicular to the plane of the slab, the orientation is always the same as the positive global Z-axis (in the other words, the local Z axis is always upwards) * For vertical 2D members (walls): * Y or X axis is given by the vector (depending on chosen option in the SAF excel file) * The Z axis direction is perpendicular to the plane of the wall and: * The orientation follows the positive half space defined by positive global X and plane defined by global Z and global Y. * In case, this is not possible (wall in plane/or parallel to global Y global X plane), then local Z follows the positive half space defined by positive global Y and plane defined by global X and global Z axis (See picture below) * The last axis of LCS is calculated by the right-hand rule ![](/files/57CZCnc4Y5m27Pu2qgMU) ### LCS enum set on "**Tilt of vector defined by point**" When is LCS enum set on "**Tilt of vector defined by point**" explanation is the following: The tilt of the vector defined by point is a special type of LCS for mesh elements of 2D members. You can define one point in global coordinates and all local x-axis (y-axis) of mesh elements follow this point. It is an analogy to LCS by point for 1D members. This special case is mostly used when you need to add data which are depending on LCS of meshes (e.g. reinforcement, results) and should follow radial layout (Circle slabs, silos, etc…). An example is presented below. ![](/files/MN4tc6BwkZ8BjA7IosJj) ## **Unique IDs** Unique IDs – Unique identifier number for each object in the project and the model level. If the IDs are available in project, model and each object could be recognized and tracked for revisions with a third party software. Filling the cells with ID is not mandatory for analytical exchange format. # Geometry ## Geometry Basic construction elements are simple geometry types, that are used for shape definition of structural members and geometrical object. With defining the further attributes to these elements from the lists Structural analysis elements, Supports and hinges and Loads the complete structural model is created. All values refer to the list [StrucutralPointConnection](https://saf.guide/Content/A_Objects/5_StructuralPointConnection.htm). Following geometrical types are available: | | Geometry type | Type definition | Insertion data explanation | SAF geometry strings | Notes | | --------------------------------- | ------------- | ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ![1](/files/vXSOjWEquBT65v2tJQ0W) | Line | Straight-line between two nodes |

Start point , End point

N1;N2

| Line | - | | ![1](/files/SMw1BLujQxGa6NAZWg5m) | Circular Arc | Arch defined with 3 nodes |

Start point, Intermediate point, End point

N3;N4;N5

| Circular Arc | - | | ![1](/files/EI5EsGE3WqVbg2XEalZG) | Parabolic Arc |

Parabolic arch defined with 3 nodes

|

Start point, Intermediate point, End point

N6;N7;N8

| Parabolic Arc | - | | ![1](/files/8XHI4DnlYkNZQyWEaBNK) | Bezier | Cubic Bezier curve |

Start point, 2nd point of control polygon (vertex), 3rd point of control polygon (vertex), End point

N9;Vertex\_B1\_1;

Vertex\_B1\_2;N10

| Bezier |

N9 and N10 stands for start and end node

Vertex\_B1\_1, Vertex\_B1\_2 define vertexes of bezier curve

All values refers to list StrucutralPointConnection

Bezier curve is parabolic, when 2nd and 3rd control points are the identical (values of coordinates are the same)

| | ![1](/files/Szb3RhU6FAyztxCYFnYF) | Spline | Curved line defined by polynomial function |

Start point, Set of mid points, End point

N11;N12;N13;N14;N15;N16;N17;N18

| Spline-8 | "Spline-*" where "*" stands for number of nodes defining the spline | | ![1](/files/4qh6rDo4fYewiz4dyryK) | Circle | Circle |

Center Point, Point on the perimeter

N36;N37

Or

Three point on perimeter

N36;N37;N38

|

Circle and Point

or

Circle by 3 points

|

Circle is not valid to define StrucutralCurveMember

| | ![1](/files/GSMJ3zpzWY2daO0SUZ6D) | Polyline |

Combination of in nodes connected geometric types

|

List of nodes

N21;N22;N23;N24;N25;N26;N27;N28;N29; N30;N31;N32;N33;Vertex\_B1\_1;VertexB\_1\_2;N34;N35

| Line;Line;Spline-7;Line;Circular Arc;Line;Bezier;Line |

Detail explanation can be found in notes below

| ## Notes {% hint style="info" %} **Mathematical definitions:** * Bezier $$Q(t)=\sum\_{i=0}^{3}P\_iB\_i(t)$$ ; $$t\epsilon<0,1>$$ $$B\_{0t}=(1-t)^3,B\_{1t}=3t(1-t)^2,B\_{2t}=3t^2(1-t),B\_{3t}=t^3$$ $$Q(t)$$ is for the Bezier curve $$P\_{i}$$ is for coodinates, and $$B\_{it}$$is for basis function * Spline $$Q(t)=\sum\_{i=0}^{m}P\_iN\_i^n(t)$$ ; $$t\epsilon\$$ $$N\_i^0(t)=1$$for$$t\epsilon\$$ $$N\_i^0(t)=0$$otherwise $$N{i}^{k}{(t)}=\frac{t-t\_i}{t\_{i+k}-t\_i}N\_{i}^{k-1}{(t)}+\frac{t\_{i+k+1}-t}{t\_{i+k+1}-t\_{i+1}}N\_{i+1}^{k-1}{(t)}$$ $$Q(t)$$is for the Spline curve $$P\_i$$is for the coordinates $$N\_i^n(t)$$is for basis function $$n$$is for the degree of curve $$m$$is for points of the control polygon **Polyline schematics:** {% endhint %} ![1](/files/bNg9oC8YijaqVm0QITNP) # Best practice for SAF implementation Best practice for SAF implementation This chapter is a list of collected proved and functional approaches for SAF implementation to your application. {% hint style="warning" %} **They are not obligatory but following these rules ensures smooth export/import of SAF file and you might avoid any un-foreseen issues.** {% endhint %} Please in case you want to: * explain any of the best practice * share best practice with us * challenge anything in this chapter Contact us via email: or send message directly to our MS team channel at - <99ef7709.scia.net@emea.teams.ms> ## Header strings As everybody should follow specified header names in documentation per version, We would also recommend to: * strip all headers from blank space, dot, comma, dash etc. when importing and base your import on stripped strings * make import case non-sensitive * ignore units information in header for import purposes, SAF should be possible to import without this information in header * when exporting, include units (for better readability of end user) according to unit setting and table of units provided in Project and model specifications ## Format of cells All numerical values (doubles, integers) should be exported as "Number" format in Excel * This rule should apply also for cells which could contain more values, in a case it will have only on. * Example: Thickness for StructuralSurfaceMember can contain single value in case of constant thickness type. In this case cell format should be number. In case of variable thickness type, string will be used ## Values in cells Empty and blank cells * On export side - do not export blank cells as empty strings, use null value instead * On import side - null should be standard indicator of blank cell, but make your solution prepared also to empty strings or blank space Numerical values (integer, double) * You should always read raw data from XML structure of XLS file * Rounding is not recommended Numerical chain values (string) * standard separator for more values in a cell is semicolon ## Culture invariant decimal separator On import and export side you should always use culture invariant decimal symbol - **dot** and **no thousands separator** ## Units in headers Import or export should be based on header without unit specification. Missing unit should not block import, either its presence. It is recommended though to include unit information to header for better user read-ability of SAF file. # Project and model specifications {% hint style="warning" %} Structure of sheets "Project" and "Model" is different from all the other sheets. Properties are oriented in columns not in rows as usual. {% endhint %} ## Project In the list called “Project”, you can specify basic information about your project. ### The specification in excel | Name of the row | Type of data | Value example or enum definition | Required value | Description | | :-------------: | :----------: | :----------------------------------: | :------------: | -------------------------------------------------------------------------------------------------------------------------- | | Name | String | Park Office | no | The name of the project | | Description | String | Administrative complex | no | The description of the project | | Project nr | String | 23/2019 | no | Project numerical designation | | Created | Date Time | 2018-12-16 15:48:50 | no | Creation time, in UTC, in format yyyy-mm-dd hh:mm | | Last update | Date Time | 2018-12-23 23:58:59 | no | Last update time, in UTC, in format yyyy-mm-dd hh:mm | | Project type | String | Building construction | no | The type of the project. The project type can be assigned to e.g. "Building construction" or "Infrastructure construction" | | Project kind | String | New building | no | The kind of the project. The project kind can be assigned to e.g. "Extension", "Finish", "New building", "Reconstruction" | | Building type | String | Business | no | Kind of use of the building such as Administrative, Residential, etc… | | Status | String | Planning stage | no | Status of the project | | Location | String | South Bohemia | no | Location of the designed project | | Id | String | bba1ede8-4106-47fd-b5e1-48637ab87f50 | no | ID of project. | ## Model In the list called “model” you can specify basic info about your project. ### The specification in excel | Name of the row | Type of data | Value example or enum definition | Required value | Description | | ------------------------ | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Name | String | Park Office - object A | no | The name of the model | | Description | String | Highrise | no | The description of the model | | Discipline | String | Load-bearing structure | no | Discipline can be set as Undefined, Architecture, HVAC, Load-bearing structure, Terrain, Facility etc. | | Level of detail | String | Draft | no | Describe level of detail of the model | | Status | String | Planning stage | no | Description of model status | | Owner | String | Person A | no | Define the owner of the model | | Revision number | String | rev.02 | no | Current revision number | | Created | Date Time | 2018-12-16 | no | Creation time, in UTC, in ISO format year-month-day | | Last update | Date Time | 2018-12-19 | no | Last update time, in UTC, in ISO format year-month-day | | Source type | String | Structural analysis model | no | Definition of the source data | | Source application | String | Scia Engineer | no | Definition of the source application | | SAF Version | String | 1.0.3 | yes | Definition of used version of the Structural Analysis Format | | Source company | String | Statical company | no | Define the author company of source data | | Global coordinate system | Enum |

X vertical

Y vertical

Z vertical

minus X vertical

minus Y vertical

minus Z vertical

| yes |

Define the space orientation of the coordinates system for model

Right hand rule applies all the time.

X vertical - X axis goes against gravity

Y vertical - Y axis goes against gravity

Z vertical - Z axis goes against gravity

minus X vertical - X axis goes in direction of gravity

minus Y vertical - Y axis goes in direction of gravity

minus Z vertical - Z axis goes in direction of gravity

\* For further explanation see notes below

| | LCS of cross-section | Enum |

ZYX

MinusYZX

MinusZMinusYX

YMinusZX

YZMinusX

MinusZYMinusX

MinusYMinusZMinusX

ZMinusYMinusX

| yes |

Define the LCS orientation of used cross-section.

With row "LCS of cross-section" the user is able to define, how the LCS of cross section is defined in his software. This will give opportunity to receiving application of SAF file to correctly interpret LCS of cross section with different standard. The x-axis is always in the centre line and all possible cases are described by this enum.

For further explanation see notes below

| | System of units | Enum |

Metric

Imperial

| yes | Define the type of units system used in model | | National code | Enum |

EC-Standard-EN

EC-ONORM-EN (Austrian NA)

EC-NBN-EN (Belgian NA)

EC-BS-EN (British NA)

EC-CYS-EN (Cypriot NA)

EC-CSN-EN (Czech NA)

EC-DS-EN (Danish NA)

EC-NEN-EN (Dutch NA)

EC-SFS-EN (Finnish NA)

EC-NF-EN (French NA)

EC-DIN-EN (German NA)

EC-ELOT-EN (Greek NA)

EC-IS-EN (Irish NA)

EC-UNI-EN (Italian NA)

EC-LU-EN (Luxembourgian NA)

EC-MS-EN (Malaysian NA)

EC-NS-EN (Norwegian NA)

EC-PN-EN (Polish NA)

EC-SR-EN (Romanian NA)

EC-SS-EN (Singaporean NA)

EC-STN-EN (Slovakian NA)

EC-SIST-EN (Slovenian NA)

EC-UNE-EN (Spanish NA)

EC-SS-EN (Swedish NA)

IBC

NBR

| yes | Sets national code used for structural analysis | | Ignored objects | String | StructuralCrossSection;StructuralPointAction | no |

Field used for update work-flow

Specify the object(s) that should be excluded from update

Multiple objects are divided by a semicolon

See notes for all SAF objects

| | Ignored groups | String | SupportsAndHinges;StructuralLoad | no |

Field used for update work-flow

Specify the groups(s) that should be excluded from update

Groups are parent to objects - each group consists of multiple objects

Multiple groups are divided by a semicolon

See notes for all SAF groups

| | Id | String | bba1ede8-4106-47fd-b5e1-48637ab87f47 | no | ID of model. | ## Notes {% hint style="info" %} #### **Global coordinate system:** {% endhint %} ![](/files/VBDN1HotJce0YD0RZyC1) {% hint style="info" %} #### **LCS of cross-section:** * The graphical interpretation of values for row "**LCS of cross-section**" is represented below. Please keep in mind that x-axis is always in centre-line of the member. "**LCS of cross-section**" desribes how is LCS of CSS library handled and how is CSS applied on the the member. * The first axis of the enum is the vertical one, positive direction is Zref. The second axis of the enum is the horizontal one, positive direction is Yref. Last is the axis in cente-line of the member, positive direction is Xref. {% endhint %} ![](/files/IL0XER6cnqaD379dYYbv) {% hint style="info" %} #### **System of units** * Column headers should respect this setting and change unit accordingly, also values should be in specified units * See [table](/getting-started/project-and-model-specifications/units) of units for headers #### **Ignored objects/groups:** * See [table](/getting-started/project-and-model-specifications/ignore) of units for headers {% endhint %} # Units table | Object | Attribute | Unit Metric | Unit Imperial | | ----------------------------------- | ------------------------------------- | ------------ | --------------- | | StructuralMaterial | Unit mass | \[kg/m3] | \[lb/ft3] | | StructuralMaterial | E modulus | \[MPa] | \[ksi] | | StructuralMaterial | G modulus | \[MPa] | \[ksi] | | StructuralMaterial | Thermal expansion | \[1/K] | \[1/°F] | | StructuralCrossSection | Parameters | \[mm] | \[in] | | StructuralCrossSection | A | \[m2] | \[ft2] | | StructuralCrossSection | Iy | \[m4] | \[ft4] | | StructuralCrossSection | Iz | \[m4] | \[ft4] | | StructuralCrossSection | It | \[m4] | \[ft4] | | StructuralCrossSection | Iw | \[m6] | \[ft6] | | StructuralCrossSection | Wply | \[m3] | \[ft3] | | StructuralCrossSection | Wplz | \[m3] | \[ft3] | | StructuralPointConnection | Coordinate X | \[m] | \[ft] | | StructuralPointConnection | Coordinate Y | \[m] | \[ft] | | StructuralPointConnection | Coordinate Z | \[m] | \[ft] | | StructuralCurveMember | Length | \[m] | \[ft] | | StructuralCurveMember | LCS Rotation | \[deg] | \[deg] | | StructuralCurveMember | Coordinate X | \[m] | \[ft] | | StructuralCurveMember | Coordinate Y | \[m] | \[ft] | | StructuralCurveMember | Coordinate Z | \[m] | \[ft] | | StructuralCurveMember | Eccentricity ey | \[mm] | \[in] | | StructuralCurveMember | Eccentricity ez | \[mm] | \[in] | | StructuralCurveMember | Structural Y Eccentricity of Beg Node | \[mm] | \[in] | | StructuralCurveMember | Structural Z Eccentricity of Beg Node | \[mm] | \[in] | | StructuralCurveMember | Structural Y Eccentricity of End Node | \[mm] | \[in] | | StructuralCurveMember | Structural Z Eccentricity of End Node | \[mm] | \[in] | | StructuralCurveMember | Analysis Y Eccentricity of Beg Node | \[mm] | \[in] | | StructuralCurveMember | Analysis Z Eccentricity of Beg Node | \[mm] | \[in] | | StructuralCurveMember | Analysis Y Eccentricity of End Node | \[mm] | \[in] | | StructuralCurveMember | Analysis Z Eccentricity of End Node | \[mm] | \[in] | | StructuralCurveMemberRib | Length | \[m] | \[ft] | | StructuralCurveMemberRib | Eccentricity ez | \[mm] | \[in] | | StructuralCurveMemberRib | Width left for check | \[mm] | \[in] | | StructuralCurveMemberRib | Width right for check | \[mm] | \[in] | | StructuralCurveMemberRib | Width left for internal forces | \[mm] | \[in] | | StructuralCurveMemberRib | Width right for internal forces | \[mm] | \[in] | | StructuralSurfaceMember | Thickness | \[mm] | \[in] | | StructuralSurfaceMember | Area | \[m2] | \[ft2] | | StructuralSurfaceMember | Coordinate X | \[m] | \[ft] | | StructuralSurfaceMember | Coordinate Y | \[m] | \[ft] | | StructuralSurfaceMember | Coordinate Z | \[m] | \[ft] | | StructuralSurfaceMember | LCS Rotation | \[deg] | \[deg] | | StructuralSurfaceMember | Eccentricity ez | \[mm] | \[in] | | StructuralSurfaceMember | Structural Z Eccentricity | \[mm] | \[in] | | StructuralSurfaceMember | Analysis Z Eccentricity | \[mm] | \[in] | | StructuralSurfaceMemberOpening | Area | \[m2] | \[ft2] | | StructuralSurfaceMemberRegion | Thickness | \[mm] | \[in] | | StructuralSurfaceMemberRegion | Area | \[m2] | \[ft2] | | StructuralSurfaceMemberRegion | Eccentricity ez | \[mm] | \[in] | | StructuralPointSupport | Stiffness X | \[MN/m] | \[kip/ft] | | StructuralPointSupport | Stiffness Y | \[MN/m] | \[kip/ft] | | StructuralPointSupport | Stiffness Z | \[MN/m] | \[kip/ft] | | StructuralPointSupport | Stiffness Fix | \[MNm/rad] | \[kipft/deg] | | StructuralPointSupport | Stiffness Fiy | \[MNm/rad] | \[kipft/deg] | | StructuralPointSupport | Stiffness Fiz | \[MNm/rad] | \[kipft/deg] | | StructuralEdgeConnection | Stiffness X | \[MN/m2] | \[kip/ft2] | | StructuralEdgeConnection | Stiffness Y | \[MN/m2] | \[kip/ft2] | | StructuralEdgeConnection | Stiffness Z | \[MN/m2] | \[kip/ft2] | | StructuralEdgeConnection | Stiffness Fix | \[MNm/rad/m] | \[kipft/deg/ft] | | StructuralEdgeConnection | Stiffness Fiy | \[MNm/rad/m] | \[kipft/deg/ft] | | StructuralEdgeConnection | Stiffness Fiz | \[MNm/rad/m] | \[kipft/deg/ft] | | StructuralEdgeConnection | Start point | \[m] | \[ft] | | StructuralEdgeConnection | End point | \[m] | \[ft] | | StructuralCurveConnection | Stiffness X | \[MN/m2] | \[kip/ft2] | | StructuralCurveConnection | Stiffness Y | \[MN/m2] | \[kip/ft2] | | StructuralCurveConnection | Stiffness Z | \[MN/m2] | \[kip/ft2] | | StructuralCurveConnection | Stiffness Fix | \[MNm/rad/m] | \[kipft/deg/ft] | | StructuralCurveConnection | Stiffness Fiy | \[MNm/rad/m] | \[kipft/deg/ft] | | StructuralCurveConnection | Stiffness Fiz | \[MNm/rad/m] | \[kipft/deg/ft] | | StructuralCurveConnection | Start point | \[m] | \[ft] | | StructuralCurveConnection | End point | \[m] | \[ft] | | StructuralSurfaceConnection | C1x | \[MN/m3] | \[kip/ft3] | | StructuralSurfaceConnection | C1y | \[MN/m3] | \[kip/ft3] | | StructuralSurfaceConnection | C1z | \[MN/m3] | \[kip/ft3] | | StructuralSurfaceConnection | C2x | \[MN/m] | \[kip/ft] | | StructuralSurfaceConnection | C2y | \[MN/m] | \[kip/ft] | | RelConnectsStructuralMember | Stiffness X | \[MN/m] | \[kip/ft] | | RelConnectsStructuralMember | Stiffness Y | \[MN/m] | \[kip/ft] | | RelConnectsStructuralMember | Stiffness Z | \[MN/m] | \[kip/ft] | | RelConnectsStructuralMember | Stiffness Fix | \[MNm/rad] | \[kipft/deg] | | RelConnectsStructuralMember | Stiffness Fiy | \[MNm/rad] | \[kipft/deg] | | RelConnectsStructuralMember | Stiffness Fiz | \[MNm/rad] | \[kipft/deg] | | RelConnectsRigidCross | Stiffness u1 | \[MN/m] | \[kip/ft] | | RelConnectsRigidCross | Resitance u1 | \[MN] | \[kip] | | RelConnectsRigidCross | Stiffness u2 | \[MN/m] | \[kip/ft] | | RelConnectsRigidCross | Resitance u2 | \[MN] | \[kip] | | RelConnectsRigidCross | Stiffness u | \[MN/m] | \[kip/ft] | | RelConnectsRigidCross | Resitance u | \[MN] | \[kip] | | RelConnectsRigidCross | Stiffness fi1 | \[MNm/rad] | \[kipft/deg] | | RelConnectsRigidCross | Resistance fi1 | \[MNm] | \[kipft] | | RelConnectsRigidCross | Stiffness fi2 | \[MNm/rad] | \[kipft/deg] | | RelConnectsRigidCross | Resistance fi2 | \[MNm] | \[kipft] | | RelConnectsRigidCross | Stiffness fi | \[MNm/rad] | \[kipft/deg] | | RelConnectsRigidCross | Resistance fi | \[MNm] | \[kipft] | | RelConnectsRigidLink | Stiffness X | \[MN/m] | \[kip/ft] | | RelConnectsRigidLink | Stiffness Y | \[MN/m] | \[kip/ft] | | RelConnectsRigidLink | Stiffness Z | \[MN/m] | \[kip/ft] | | RelConnectsRigidLink | Stiffness Fix | \[MNm/rad] | \[kipft/deg] | | RelConnectsRigidLink | Stiffness Fiy | \[MNm/rad] | \[kipft/deg] | | RelConnectsRigidLink | Stiffness Fiz | \[MNm/rad] | \[kipft/deg] | | RelConnectsRigidLink | Resistance X | \[MN] | \[kip] | | RelConnectsRigidLink | Resistance Y | \[MN] | \[kip] | | RelConnectsRigidLink | Resistance Z | \[MN] | \[kip] | | RelConnectsRigidLink | Resistance Fix | \[MNm] | \[kipft] | | RelConnectsRigidLink | Resistance Fiy | \[MNm] | \[kipft] | | RelConnectsRigidLink | Resistance Fiz | \[MNm] | \[kipft] | | RelConnectsRigidMember | Stiffness X | \[MN/m2] | \[kip/ft2] | | RelConnectsRigidMember | Stiffness Y | \[MN/m2] | \[kip/ft2] | | RelConnectsRigidMember | Stiffness Z | \[MN/m2] | \[kip/ft2] | | RelConnectsRigidMember | Stiffness Fix | \[MNm/rad/m] | \[kipft/deg/ft] | | RelConnectsRigidMember | Stiffness Fiy | \[MNm/rad/m] | \[kipft/deg/ft] | | RelConnectsRigidMember | Stiffness Fiz | \[MNm/rad/m] | \[kipft/deg/ft] | | RelConnectsRigidMember | Resistance X | \[MN/m] | \[kip/ft] | | RelConnectsRigidMember | Resistance Y | \[MN/m] | \[kip/ft] | | RelConnectsRigidMember | Resistance Z | \[MN/m] | \[kip/ft] | | RelConnectsRigidMember | Resistance Fix | \[MNm/m] | \[kipft/ft] | | RelConnectsRigidMember | Resistance Fiy | \[MNm/m] | \[kipft/ft] | | RelConnectsRigidMember | Resistance Fiz | \[MNm/m] | \[kipft/ft] | | RelConnectsSurfaceEdge | Stiffness X | \[MN/m2] | \[kip/ft2] | | RelConnectsSurfaceEdge | Stiffness Y | \[MN/m2] | \[kip/ft2] | | RelConnectsSurfaceEdge | Stiffness Z | \[MN/m2] | \[kip/ft2] | | RelConnectsSurfaceEdge | Stiffness Fix | \[MNm/rad/m] | \[kipft/deg/ft] | | RelConnectsSurfaceEdge | Stiffness Fiy | \[MNm/rad/m] | \[kipft/deg/ft] | | RelConnectsSurfaceEdge | Stiffness Fiz | \[MNm/rad/m] | \[kipft/deg/ft] | | RelConnectsSurfaceEdge | Start point | \[m] | \[ft] | | RelConnectsSurfaceEdge | End point | \[m] | \[ft] | | StructuralStorey | Height level | \[m] | \[ft] | | StructuralPointAction | Value | \[kN] | \[kip] | | StructuralPointAction | Vector (X;Y;Z) | \[kN] | \[kip] | | StructuralPointAction | Position x | \[m] | \[ft] | | StructuralPointAction | Delta x | \[m] | \[ft] | | StructuralPointActionFree | Validity from | \[m] | \[ft] | | StructuralPointActionFree | Validity to | \[m] | \[ft] | | StructuralPointActionFree | Value | \[kN] | \[kip] | | StructuralPointActionFree | Vector (X;Y;Z) | \[kN] | \[kip] | | StructuralPointActionFree | Coordinate X | \[m] | \[ft] | | StructuralPointActionFree | Coordinate Y | \[m] | \[ft] | | StructuralPointActionFree | Coordinate Z | \[m] | \[ft] | | StructuralCurveAction | Value 1 | \[kN/m] | \[kip/ft] | | StructuralCurveAction | Value 2 | \[kN/m] | \[kip/ft] | | StructuralCurveAction | Vector 1(X;Y;Z) | \[kN/m] | \[kip/ft] | | StructuralCurveAction | Vector 2(X;Y;Z) | \[kN/m] | \[kip/ft] | | StructuralCurveAction | Start point | \[m] | \[ft] | | StructuralCurveAction | End point | \[m] | \[ft] | | StructuralCurveAction | Eccentricity ey | \[mm] | \[in] | | StructuralCurveAction | Eccentricity ez | \[mm] | \[in] | | StructuralCurveActionFree | Validity from | \[m] | \[ft] | | StructuralCurveActionFree | Validity to | \[m] | \[ft] | | StructuralCurveActionFree | Value 1 | \[kN/m] | \[kip/ft] | | StructuralCurveActionFree | Value 2 | \[kN/m] | \[kip/ft] | | StructuralCurveActionFree | Vector 1(X;Y;Z) | \[kN/m] | \[kip/ft] | | StructuralCurveActionFree | Vector 2(X;Y;Z) | \[kN/m] | \[kip/ft] | | StructuralCurveActionFree | Coordinate X | \[m] | \[ft] | | StructuralCurveActionFree | Coordinate Y | \[m] | \[ft] | | StructuralCurveActionFree | Coordinate Z | \[m] | \[ft] | | StructuralSurfaceAction | Value | \[kN/m2] | \[kip/ft2] | | StructuralSurfaceActionFree | Coordinate X | \[m] | \[ft] | | StructuralSurfaceActionFree | Coordinate Y | \[m] | \[ft] | | StructuralSurfaceActionFree | Coordinate Z | \[m] | \[ft] | | StructuralSurfaceActionFree | q | \[kN/m2] | \[kip/ft2] | | StructuralCurveActionThermal | Start point | \[m] | \[ft] | | StructuralCurveActionThermal | End point | \[m] | \[ft] | | StructuralCurveActionThermal | deltaT | \[°C] | \[°F] | | StructuralCurveActionThermal | TempL | \[°C] | \[°F] | | StructuralCurveActionThermal | TempR | \[°C] | \[°F] | | StructuralCurveActionThermal | TempT | \[°C] | \[°F] | | StructuralCurveActionThermal | TempB | \[°C] | \[°F] | | StructuralSurfaceActionThermal | T1 | \[°C] | \[°F] | | StructuralSurfaceActionThermal | T2 | \[°C] | \[°F] | | StructuralSurfaceActionThermal | deltaT | \[°C] | \[°F] | | StructuralSurfaceActionThermal | TempT | \[°C] | \[°F] | | StructuralSurfaceActionThermal | TempB | \[°C] | \[°F] | | StructuralPointMoment | Value | \[kNm] | \[kipft] | | StructuralPointMoment | Position x | \[m] | \[ft] | | StructuralPointMoment | Delta x | \[m] | \[ft] | | StructuralCurveMoment | Value 1 | \[kNm/m] | \[kipft/ft] | | StructuralCurveMoment | Value 2 | \[kNm/m] | \[kipft/ft] | | StructuralCurveMoment | Start point | \[m] | \[ft] | | StructuralCurveMoment | End point | \[m] | \[ft] | | StructuralCurveMoment | Eccentricity ey | \[mm] | \[in] | | StructuralCurveMoment | Eccentricity ez | \[mm] | \[in] | | StructuralProxyElementVertices | X | \[m] | \[ft] | | StructuralProxyElementVertices | Y | \[m] | \[ft] | | StructuralProxyElementVertices | Z | \[m] | \[ft] | | StructuralSurfaceActionDistribution | Coordinate X | \[m] | \[ft] | | StructuralSurfaceActionDistribution | Coordinate Y | \[m] | \[ft] | | StructuralSurfaceActionDistribution | Coordinate Z | \[m] | \[ft] | | StructuralSurfaceActionDistribution | LCS Rotation | \[deg] | \[deg] | | ResultInternlForce1D | N | \[kN] | \[kip] | | ResultInternlForce1D | Vy | \[kN] | \[kip] | | ResultInternlForce1D | Vz | \[kN] | \[kip] | | ResultInternlForce1D | Mx | \[kNm] | \[kipft] | | ResultInternlForce1D | My | \[kNm] | \[kipft] | | ResultInternlForce1D | Mz | \[kNm] | \[kipft] | # Ignored objects and groups {% hint style="warning" %} **SAF TOC group name** is a term used for navigation in the table of contents of SAF documentation. Do not use it in "ignored groups" cells. Each group consist of multiple objects, ignoring the group is taken in to account as ignoring all objects in the group (groups are parent to objects) {% endhint %} | SAF TOC Group name | Group name | Object name | | ---------------------------- | ------------------ | ------------------------------ | | Structural analysis elements | StructuralElements | StructuralMaterial | | Structural analysis elements | StructuralElements | StructuralCrossSection | | Structural analysis elements | StructuralElements | CompositeShapeDef | | Structural analysis elements | StructuralElements | StructuralPointConnection | | Structural analysis elements | StructuralElements | StructuralCurveMember | | Structural analysis elements | StructuralElements | StructuralCurveEdge | | Structural analysis elements | StructuralElements | StructuralSurfaceMember | | Structural analysis elements | StructuralElements | StructuralSurfaceMemberOpening | | Structural analysis elements | StructuralElements | StructuralSurfaceMemberRegion | | Structural analysis elements | StructuralElements | StructuralCurveMemberRib | | Supports and hinges | SupportsAndHinges | StructuralPointSupport | | Supports and hinges | SupportsAndHinges | StructuralEdgeConnection | | Supports and hinges | SupportsAndHinges | StructuralCurveConnection | | Supports and hinges | SupportsAndHinges | StructuralSurfaceConnection | | Supports and hinges | SupportsAndHinges | RelConnectsStructuralMember | | Supports and hinges | SupportsAndHinges | RelConnectsRigidCross | | Supports and hinges | SupportsAndHinges | RelConnectsRigidLink | | Supports and hinges | SupportsAndHinges | RelConnectsRigidMember | | Supports and hinges | SupportsAndHinges | RelConnectsSurfaceEdge | | Loads | StructuralLoad | StructuralLoadGroup | | Loads | StructuralLoad | StructuralLoadCase | | Loads | StructuralLoad | StructuralLoadCombination | | Loads | StructuralLoad | StructuralPointAction | | Loads | StructuralLoad | StructuralPointActionFree | | Loads | StructuralLoad | StructuralCurveAction | | Loads | StructuralLoad | StructuralCurveActionFree | | Loads | StructuralLoad | StructuralSurfaceAction | | Loads | StructuralLoad | StructuralSurfaceActionFree | | Loads | StructuralLoad | StructuralSurfaceActionThermal | | Loads | StructuralLoad | StructuralPointMoment | | Loads | StructuralLoad | StructuralCurveMoment | | Results | Results | ResultInternlForce1D | # StructuralMaterial ## Material Material is the basic entity affecting the behaviour of the structure. It is subsequently applied to a chosen profile ([StructuralCrossSection](/structural-analysis-elements/structuralcrosssection)). The user can use a pre-defined material or change the properties to get a custom one. The predefined materials correspond to materials defined in particular technical codes.The specification in excel: ### Specification in excel: | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------- | ------------ | :----------------------------------------------------------------------------------------------------: | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | S235 | yes | Human readable unique name of the material \*see notes | | Type | Enum |

Concrete

Steel

Timber

Aluminium

Masonry

Other

| yes | The type of material | | Subtype | String | Hot rolled | no | The subtype of the material, e.g. hot rolled, cold formed, stainless steel, prestressed concrete, fiber-reinforced concrete, UHPC etc. | | Quality | String | S235 | yes |

The quality grade of the material. Use a commonly known naming of grades of specific structural material. Example:

Steel - S235, S275, S355...

Concrete - C16/20, C25/30, C30/35...

Timber - C18, C22, D18...

| | Unit mass \[kg/m3] | Double | 7850 | no | Self-weight of the material | | E modulus \[MPa] | Double | 210000 | no | Young's modulus of elasticity | | G modulus \[MPa] | Double | 12500 | no | Shear modulus | | Poisson Coefficient | Double | 0,2 | no | Poisson coefficient | | Thermal expansion \[1/K] | Double | 0,000012 | no | The coefficient of thermal expansion of the material | | Design properties | String | 1\|1.1; 2\|4.8; 9\|1100 | no | Custom design characteristics of the material. The format of the data has to follow this convention: "label of the design property" "\|" "value of the design property" The list of available properties with indexes can be found in Annex. | | Id | String | 6bbd256e-0225-4ee5-91e5-c7ef791a33cb | no | Unique attribute designation | ## Notes {% hint style="info" %} "**Name**" is recommended to set the same as the "**Quality**" of the defined material. {% endhint %} # StructuralCrossSection ## Cross-section A cross-section together with material ([StructuralMaterial](/structural-analysis-elements/structuralmaterial#material)) is a basic property of a 1D member. Various kinds of shapes can be defined, including steel rolled sections, timber specific cross-sections or general geometric sections. Supported shapes of cross-sections are defined in documents Formcodes and Description ID of the profile, in chapter Annexes in this document. ### Specification in excel: | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ----------------------------- | ------------ | :---------------------------------------------------------------------------: | --------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | CS1 | yes | Human readable unique name of the Cross-section | | Material | String | MAT1 | yes |

Name reference to the existing StructuralMaterial object.

The general type of cross-section can have more than one material.

Each material name is separated by a semicolon.

| | Cross-section type | Enum |

Parametric


Manufactured


Compound


General

| yes |

Define the type of profile library:

General: Serves to define any general shape of the cross-section consisting of one or more closed polygons including openings.
Shape of the cross-section (polygons) is defined on separate sheet "CompositeShapeDef"

Parametric: Cross-sections defined by shape and dimensions (parameters).

Manufactured: This option refers to the industrially manufactured cross-sections.

Compound: prepared for compounded section fom more manufactured profiles
e.g. for two I-sections. Example of compound cross-section input:
profile = IPE200 and parameters=10mm (distance between profiles).
All supported shapes of compound section can be found in Annex

| | Shape | Enum | T Section |

yes, if Cross-section type = Parametric

yes, if Cross-section type = Compound

|

This field defines geometrical shape of the cross-section, is required only if Cross-section type is not manufactured.

Complete list of supported shapes is attached in Supported shapes of cross-section.

| | Parameters \[mm] | String | 50; 80; 500; 450 |

yes, if Cross-section type = Parametric

yes, if Cross-section type = Compound

|

The parameters property is required only if Cross-section type is Parametric and it represents dimensions of the cross-section. The format of the parameters depends on cross-section shape.

Each parameter has to be divided by a semicolon.

Complete list of supported parameters is attached in Annex.

| | Profile | String | HEB180 |

yes, if Cross-section type = Manufactured

yes, if Cross-section type = Compound

yes, if Cross-section type = General

|

This field is required only if Cross-section type is Manufactured or Compound.

Defines name of the industrially manufactured profile in the globally common format (naming).

For Cross-section type = general, name reference to valid CompositeShapeDef object is required in the cell "Profile"

| | Form code | Enum | 1 | yes, if Cross-section type = Manufactured |

This field is valid only if profile type is Manufactured. It helps to define hot rolled or cold formed profiles.

The shape of the cross-section is uniquely identified by a so-called Formcode.

The Formcode defines the shape and in some cases also additional parameters like distance between bolt holes, unit warping coordinates etc.

Complete list of supported form codes is attached in Formcodes.

| | Description ID of the profile | Enum | 2 | no | This field is valid only if the cross-section type is Manufactured. The description of the hot rolled and cold formed cross-section referring to the source of manufacturer. Complete list is attached in Description ID of the profile. | | A \[m2] | Double | 0,075484 | no | Section area | | Iy \[m4] | Double | 0,000641 | no | Moment of inertia about y-axis | | Iz \[m4] | Double | 0,013319 | no | Moment of inertia about z-axis | | It \[m4] | Double | 0,0000591 | no | Torsion moment of inertia | | Iw\[m6] | Double | 0,00015548 | no | Warping constant | | Wply \[m3] | Double | 0,029497 | no | Plastic modulus about the y-axis | | Wplz \[m3] | Double | 0,029497 | no | Plastic modulus about the z-axis | | Id | String | 6bbd256e-0225-4ee5-91e5-c7ef791a33cb | no | Unique attribute designation | ## Notes {% hint style="info" %} The general cross-section shape definition and is represented as a separate sheet CompositeShapeDef in Excel. It is required when the cross-section type is "General". {% endhint %} # CompositeShapeDef ## Composite Shape Definition Composite Shape definition is **required** when the cross-section type in [StructuralCrossSection](/structural-analysis-elements/structuralcrosssection#cross-section) sheet is set as "General". For **manufactured** types of a cross-section, is Composite Shape Definition is **optional**, offering the possibility to share detailed shape definition, for better classification of the profile. ### Specification in excel: | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------- | ------------ | :---------------------------------------------------: | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | GEN\_1 | yes | Name of the profile from the [StructuralCrossSection](/structural-analysis-elements/structuralcrosssection#cross-section) object sheet | | Material name # | String | MAT\_1 | yes, if polygon is not opening | Name reference to the existing [StructuralMaterial](/structural-analysis-elements/structuralmaterial#material) object | | Polygon contour # | String | -75.0; 105.0\| -175.0; 5.0\| 175.0; 5.0\| 75.0; 105.0 | yes (at least one) |

This attribute is used to define the cross-section geometry as a polygon contour.

One cross-section shape can consist of more polygons.

Openings contour are defined clockwise.

Common polygons counterclockwise.

The format of the data is:

y1; z1

| | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | ## Notes {% hint style="info" %} The symbol "#" means indexing of the name columns, depends on how many polygons is used, starts from 1 The contour defined clockwise is opening The contour defined counter clockwise is polygon of the general cross-section (relation between LCS and counter clockwise direction is shown below) {% endhint %} ![](/files/xSOGM7g7V64bNXyoGMpZ) {% hint style="info" %} Each polygon has a defined material which is name reference to existing material in [StructuralMaterial](/structural-analysis-elements/structuralmaterial#material) sheet * The opening has no material definition * Each polygon contour has to be closed * The set of all polygons and openings defines one general cross-section (one row in the Excel table) * The number of polygons is limited to 99. The definition of the general shape has to consist of at least one polygon which is not the opening. * CompositeShapeDef example with opening is shown below. A,B,C,D are defining the contour of cross-section (counter clockwise polygon) and E,F,K,L are defining the opening (clockwise polygon). {% endhint %} ![](/files/9hLb87Osz5wOGIn4Helj) # StructuralPointConnection ## Node The basic object specifies the geometry of the analytical model and its members. The nodes define other entity types. Each node is defined by the position in the modeling space and by its name. For example, a 1D member ([StructuralCurveMember](/structural-analysis-elements/structuralcurvemember)) is defined primarily by its two end-points that are nothing else but two nodes. ![](/files/rvVLK2RPjXOLyhexL9dp) If required, special boundary conditions can be defined for the StructuralPointConnection by StructuralPointSupport. ### Specification in the excel | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | :-----------------------: | :----------: | :----------------------------------: | :------------: | ------------------------------------------------------- | | Name | String | N1 | yes | Human readable unique name of the node | | Coordinate X \[m] | Double | 0 | yes | Coordination of node in X direction. Coordinate in GCS. | | Coordinate Y \[m] | Double | 0 | yes | Coordination of node in Y direction. Coordinate in GCS. | | Coordinate Z \[m] | Double | 0 | yes | Coordination of node in Z direction. Coordinate in GCS. | | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | # StructuralCurveEdge ## Internal edge Internal edge (StructuralCurveEdge) is an object within a 2D Member ([StructuralSurfaceMember](/structural-analysis-elements/structuralsurfacemember)) on which the line force (StructuralCurveAction) can act. StructuralCurveEdge can be placed on [StructuralSurfaceMemberRegion](/structural-analysis-elements/structuralsurfacememberregion), but the relation is always to 2D member (StructuralSurfaceMember) where StructuralSurfaceMemberRegion is placed. {% hint style="warning" %} If StructuralCurveEdge does not geometrically fit to the StructuralSurfaceMember it is assigned to, it is considered a logically invalid input. Cases like this one have to be solved by validation during the import of excel data to the specific software. The validation has to be implemented together with the import/export of SAF. {% endhint %} ![](/files/nzUlHI4NAdxN0n5Y1fc9) ### Specification in the excel | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------- | ------------ | :-----------------------------------------------: | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | IE1 | yes | Human readable unique name of the internal edge | | 2D member | String | S2 | yes | The name of the [StructuralSurfaceMember](/structural-analysis-elements/structuralsurfacemember) (plate, wall) on which the internal edge is placed | | Nodes | String | N1; N2 | yes |

All nodes that belong to the curve edge and define its geometric shape.

The names of the nodes are separated by ; (semicolon) and space.

The order of the nodes has to be from beginning to end.

| | Segments | String | Line; Circular Arc; Bezier; Parabolic arc; Spline | yes |

Defines the shape of the curve between two next nodes.

Supported strings are:

Line; Circular Arc; Bezier; Parabolic arc; Spline. The names are separated by ; (semicolon) and space.

Internal edge consisting of multiple segments follows rule defined in Geometry

| | Parent ID | String | 67b35d84-3d04-47aa-aa4a-dc1263982320 | no |

Is filled for objects created be dividing curved geometry to series of straight line objects.

Parent ID will ensure that curved edge is imported as straight parts to nonsupporting application, and back to original supporting application as curved geometry. To ensure successful round trip of segmented objects and their related objects, Parent ID needs to be present in both directions.

| | Id | String | 36606732-25e0-4fd7-ae35-bb8cb1bdcf46 | no | Unique attribute designation | # StructuralCurveMember ## 1D Member (Beam, Column,…) A general 1D member is defined by its two end-points (or we can say nodes). Therefore, the 1D member position must be specified by two points: first, the starting or begin point and then the end point. A set of properties can also be defined. Each 1D member has got a unique local co-ordinate system, the origin of which is located in the starting point of a 1D member. The x-axis is always identical with the longitudinal beam axis and its direction is from the starting point towards the end point and is placed to centroid of the cross-section. By default, the y-axis is generally horizontal (unless the beam orientation prevents this) and the z-axis is generally vertical (again, unless the beam orientation in space prevents this configuration). In case of vertical members by default the local y-axis has the same direction as global y-axis. The local co-ordinate system can be rotated around its x-axis if required. In addition to this local co-ordinate system, also a principal (or main) co-ordinate system can be referred to on a 1D member. The principal co-ordinate system of a 1D member is related to the principal co-ordinate system of the cross-section of a 1D member. ![](/files/qLmIg3AsdNWEP1Pjl1qQ) ![](/files/tjoBo7bOYnQHeigIKRvH) ### Specification in the excel | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------------------------- | ------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------: | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | B1 | yes | Human readable unique name of the 1D member | | Type | String | General | no |

The type of the 1D member, used within the analytical model.

E.g. General, Beam, Column, GableColumn, SecondaryColumn, Rafter, Purlin, RoofBracing, WallBracing, Girt, TrussChord, TrussDiagonal, PlateRib, BeamSlab, HollowCoreSlab, CompositePlateRib, CompositeBeamRib

| | Cross section | String | CS1 | yes | The name reference to the existing, valid name of the StructuralCrossSection object | | Arbitrary definition | String | AD1 | no | The reference to Arbitrary/Tapered/Haunched beam definition StructuralCurveMemberVarying | | Nodes | String | N2; N3; N4 | yes |

All nodes that belong to the curve member and define its geometric shape.

The names of the nodes are separated by ; (semicolon) and space. The order of the nodes has to be from beginning to end.

| | Segments | String | Line; Circular Arc; Bezier; Parabolic arc; Spline | yes | Defines the shape of the curve between two next nodes. The names are separated by ; (semicolon) and space. | | Begin node | String | N1 | yes |

The starting node of the 1D member.

Has to be specified in the StructuralPointConnection sheet

| | End node | String | N2 | yes |

The end node of the 1D member.

Has to be specified in the StructuralPointConnection sheet

| | Internal nodes | String | N77; N78 | no |

Internal nodes belonging to StructuralCurveMember defined in StructuralPointConnection.

Internal nodes are not geometry defining The names of the nodes are separated by ; (semicolon) and space.

| | Length \[m] | Double | 6.425 | no | Distance between begin and end node of the curve member. | | Geometrical shape | Enum |

Line

Circular Arc

Parabolic Arc

Bezier

Spline

Polyline

| no | Description of the geometrical type of curve member in general. If the member consists of more than one segments, Geometrical shape is automatically set to Polyline. | | LCS | Enum |

y by vector

z by vector

y by point

z by point

| yes | Local coordinate system. This item specifies the way the local axes of the 1D member are determined. For further understanding see [Introduction](/getting-started/introduction) | | LCS Rotation \[deg] | Double | 45.00 | yes | This value defines the rotation of local axes of the 1D member around its x-axis | | Coordinate X \[m] | Double | 0,0 | yes | Coordinate of the point or vector defining the LCS in X direction | | Coordinate Y \[m] | Double | 0,1 | yes | Coordinate of the point or vector defining the LCS in Y direction | | Coordinate Z \[m] | Double | 0,0 | yes | Coordinate of the point or vector defining the LCS in Z direction | | System line | Enum |

Centre

Top


Bottom


Left

Right


Top left


Top right


Bottom left


Bottom right

| yes |

The system line is in fact the local x-axis of the member. The attribute of system line applies eccentricities to the member equal to the cross-section dimensions of the member in the specified direction.

Default position of the system line is in the centre of the gravity of the cross-section.

The position of the system line affects results in same way as eccentricities do.

Top - align top surface to center line

Bottom - align bottom surface to center line

Left - align left surface to center line

Right - align right surface to center line

For further explanation see notes below.

| | Structural Y Eccentricity of Beg Node \[mm] | Double | -150 | no |

Define the position difference between a physical element and its analytical member representation in Y direction (Beg node).

Used to build up physical (structural body from analysis member).

DOES NOT affect internal forces.

| | Structural Z Eccentricity of Beg Node \[mm] | Double | 75 | no |

Define the position difference between a physical element and its analytical member representation in Z direction (Beg node).

Used to build up physical (structural body from analysis member).

DOES NOT affect internal forces.

| | Structural Y Eccentricity of End Node \[mm] | Double | 75 | no |

Define the position difference between a physical element and its analytical member representation in Y direction (End node).

Used to build up physical (structural body from analysis member).

DOES NOT affect internal forces.

| | Structural Z Eccentricity of End Node \[mm] | Double | 75 | no |

Define the position difference between a physical element and its analytical member representation in Z direction (End node).

Used to build up physical (structural body from analysis member).

DOES NOT affect internal forces.

| | Analysis Y Eccentricity of Beg Node \[mm] | Double | 75 | yes |

Define the position difference between a physical element and its analytical member representation in Y direction (Beg node).

Used to build up physical (structural body from analysis member).

DO affects internal forces.

| | Analysis Z Eccentricity of Beg Node \[mm] | Double | 75 | yes |

Define the position difference between a physical element and its analytical member representation in Z direction (Beg node).

Used to build up physical (structural body from analysis member).

DO affects internal forces.

| | Analysis Y Eccentricity of End Node \[mm] | Double | 75 | yes |

Define the position difference between a physical element and its analytical member representation in Y direction (End node).

Used to build up physical (structural body from analysis member).

DO affects internal forces.

| | Analysis Z Eccentricity of End Node \[mm] | Double | 75 | yes |

Define the position difference between a physical element and its analytical member representation in Z direction (End node).

Used to build up physical (structural body from analysis member).

DO affects internal forces.

| | Layer | String | 1st floor | no |

Custom created layer.

The layer can thus comprise entities that have something in common (e.g. one floor, columns of one floor, columns of the same length, etc.)

| | Behaviour in analysis | Enum |

Standard


Axial force only


Compression only


Tension only

| yes | From the finite element analysis point of view, the 1D member can act like a standard 1D member or like a hinged (pinned) rod. The difference is that the standard 1D member is capable of transferring all the internal forces, while the latter variant only provides for transferring of the axial force. | | Color | String | #7FFFFF00 | no | Defines colour and transparency of the object. Colour is defined by Hex format #AARRGGBB. Transparency is controlled by the alpha channel AA. If no colour is set then default colour is used. | | Parent ID | String | 67b35d84-3d04-47aa-aa4a-dc1263982320 | no | Is filled for objects created be dividing curved geometry to series of straight line objects. Parent ID will ensure that curved edge is imported as straight parts to nonsupporting application, and back to original supporting application as curved geometry. To ensure successful round trip of segmented objects and their related objects, Parent ID needs to be present in both directions. | | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | ## Notes {% hint style="info" %} Complete enumeration of the Formcode, Supported shapes of cross-section and Description ID can be found in chapter Annexes. These properties are set in the object [StructuralCrossSection](/structural-analysis-elements/structuralcrosssection#cross-section). Rotation of local co-ordinate system is measured from origin position of local y-axis and the orientation follows positive rotation according to the right-handed rule. Reference to Alignment enums - examples of alignments. * pictures below represents view parallel to direction of center line (LCS respects right hand rule) {% endhint %} ![](/files/UhcOQCvqwpVFXBNPBhrt) {% hint style="info" %} An example of use of System line type Bottom right can be seen in the picture below. If the shape of the cross-section is not rectangular then boundary box of the cross-section is considered for position of the system line. The results take in count eccentricities, in example: ey=150 mm, ez=250 mm. {% endhint %} ![](/files/4Emd8H3uHmX6bXRgH4DY) {% hint style="danger" %} Axis reference is only to illustrate this example, your application can have different cross-section LCS than shown in this example. Alignment of system line should be reflected to your relevant eccentricities based on your cross section LCS. {% endhint %} # StructuralCurveMemberVarying ## 1D Member Varying (Arbitrary, Tapered, Haunch,…) StructuralCurveMemberVarying object describes changing cross section along the length (center line) of existing 1D member (StructuralCurveMember). ![](/files/0KUb9IEyQRTcyQzJhUSa) ### Specification in the excel | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------- | ------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------: | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | AD1 | yes | Human readable unique name of the Arbitrary definition | | Cross sections # | String | CS1,CS2 CS3 | yes |

The value refers to name of existing cross section.

Can be inputted as pairs or as single.

Pairs are separated by "," and first one refers to Cross section at the start of the segment, second to an end of the segment. Pairs indicates linear change of cross section. Therefore they need to be same type and shape.

Single reference indicates prismatic beam along the span.

# means indexing of the cross sections, e.g. Cross sections 1, Cross sections 2, … Cross sections 99. It depends on how many spans are defined in the StructuralCurveMemberVarying.

| | Span # | Double | 0,3 | yes |

Relative length of the segment.

Sum of all values per line has to be equal to 1,0.

# means indexing of the span, e.g. Span 1, Span 2, … Span 99. It depends on how many spans are defined in the in the StructuralCurveMemberVarying.

| | Alignment # | Enum |

Centre

Top

Bottom


Left


Right


Top left


Top right


Bottom left


Bottom right

| yes |

Alignment of each segment (span) can be defined here.

First span:

Centre - In plan view as well as in side view the midline of the 1D member remains straight and horizontal. Both left and right surface are inclined to allow the cross-section change its width. The centre line of the 1D member (i.e. the centroid axis) of the 1D member remains straight. Both top and bottom surface are symmetrically inclined to allow the cross-section change its height.

Top - The top surface of the 1D member remains flat and horizontal. The bottom surface is inclined in order to provide for the change of the height. Top surface is in direction of vertical axis of CSS. Bottom - The bottom surface of the 1D member remains flat and horizontal. The top surface is inclined in order to provide for the change of the height. Bottom surface is in opposite direction of vertical axis of CSS.

Left - The left surface of the 1D member remains flat and horizontal. The right surface is inclined in order to provide for the change of the width. Left surface is in direction of horizontal axis of CSS.

Right - The right surface of the 1D member remains flat and horizontal. The left surface is inclined in order to provide for the change of the width. Right surface is in opposite direction of horizontal axis of CSS.

Other than first span:

Same rules applies with respect to previous span. See pictures in notes section.

# means indexing of the Alignment, e.g. Alignment 1, Alignment 2, … Alignment 99. It depends on how many spans are defined in the arbitrary definition.

| | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | ![](/files/a0BYxM8OCOSSY8Drrtep) ## Notes {% hint style="info" %} Reference to Alignment enums - direction of alignment in respect of CSS (LCS respects right hand rule). {% endhint %} ![](/files/UhcOQCvqwpVFXBNPBhrt) {% hint style="info" %} Reference to Alignment enums - examples of alignments. (LCS independent) {% endhint %} ![](/files/nHHrqJlPPALoCdKgd8jd) # StructuralCurveMemberRib ## 2D member rib The 2D member rib is a 1D member related to slabs. The part of the slab which cooperates with the rib is called the effective width. Different values of effective widths can be considered for checks and for calculation of the internal forces. ![](/files/Q6udoFENy1PhVnLzQoJt) ### Specification in the excel: | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------------------- | ------------ | :------------------------------------------------------------------------------------------------------------------------------------: | ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | B1 | yes | Human readable unique name of the rib | | 2D member | String | S1 | yes | The name of the structural surface member on which the rib is placed | | Cross section | String | CS1 | yes | The name reference to the existing, valid name of the StructuralCrossSection object. | | Nodes | String | N1;N2 | yes | All nodes that belong to the curve member and define its geometric shape. The names of the nodes are separated by ; (semicolon) and space. The order of the nodes has to be from beginning to end. | | Segments | String | Line; Circular Arc | yes | Defines shape of the curve between two next nodes. Supported strings are: Line; Circular Arc; Parabolic arc; Bezier; Spline. The names are separated by ; (semicolon) and space. | | Begin node | String | N1 | yes | The starting node of the 1D member. Has to be specified in the StructuralPointConnection sheet | | End node | String | N2 | yes | The end node of the 1D member. Has to be specified in the StructuralPointConnection sheet | | Internal nodes | String | N17; N18 | no | Internal nodes belonging to StructuralCurveMemberRib defined in StructuralPointConnection Internal nodes are not geometry defining The names of the nodes are separated by ; (semicolon) and space | | Length \[m] | Double | 5,37 | no | Distance between begin and end node of the curve member in meters | | Geometrical shape | Enum |

Line

Circular Arc

Parabolic Arc

Bezier

Spline

Polyline

| yes | Description of the geometrical type of curve member in general. If the member consists of more than one segments, Geometrical shape is automatically set to Polyline. | | Alignment | Enum |

Bottom


Centre


Top

| yes | This property item determines the position of the system-lines on the cross-section of the rib. The user defined value - custom value defines position of the system line of the rib on local Z axis (ez). | | Eccentricity ez \[mm] | Double | 150 | yes | Eccentricity of the member system line in Z direction of the local coordinate system from the centre of the gravity of the cross-section | | Type of connection | Enum |

Full shear connection


Partial shear connection


Without Composite Action

User Defined Eccentricity

| yes | Determines the degree of shear connection between the rib and the plate Full shear connection - in this case, the composite beam is modelled as an eccentric plate rib (real eccentricity). The composite effect is taken into account directly through the real eccentricity of the 1D member Partial shear connection - In this case, the composite beam is modelled as a plate rib without eccentricity. In order to consider the composite action, the stiffness of the beam is adjusted to take into account the effect of the eccentricity and of the participating deck width. Without Composite Action - assumes that there is no longitudinal shear connection between the beam and the deck User Defined Eccentricity - serves for any plate rib linked to a non-composite deck | | Shape of the rib | Enum |

T Symmetric


Right


Left


T Non-symmetric

| yes | Determines the shape of the effective width of the rib | | Layer | String | Layer 1 | no | Custom created layer. The layer can thus comprise entities that have something in common (e.g. one floor, columns of one floor, columns of the same length, etc.) | | Behaviour in analysis | Enum |

Standard


Axial Force Only

| yes | From the finite element analysis point of view, the 1D member can act like a standard 1D member or like a hinged (pinned) rod. The difference is that the standard 1D member is capable of transferring all the internal forces, while the latter variant only provides for transferring of the axial force. | | Effective width | Enum |

Number Of Thickness


Width

| yes | Determines the method which is considered for specifying the effective width. Number of thickness - the multiple thickness of the slab to which is rib connected. The parametric way how to specify the effective width. Width - Direct numerical input of the effective width of the slab | | Width left for check \[mm] | Double | 500 | yes, if Shape of the rib is Right, Left or T Non-symmetric | Effective width on the left side (depends on LCS), used for check. If Effective width is set to "Number Of Thickness", then inputted value is considered as unitless multiplier | | Width right for check \[mm] | Double | 500 | yes, if Shape of the rib is Right, Left or T Non-symmetric | Effective width on the right side (depends on LCS), used for check. If Effective width is set to "Number Of Thickness", then inputted value is considered as unitless multiplier | | Width left for internal forces \[mm] | Double | 500 | yes, if Shape of the rib is Right, Left or T Non-symmetric | Effective width on the left side (depends on LCS), used for calculation of internal forces. If Effective width is set to "Number Of Thickness", then inputted value is considered as unitless multiplier | | Width right for internal forces \[mm] | Double | 500 | yes, if Shape of the rib is Right, Left or T Non-symmetric | Effective width on the right side (depends on LCS), used for calculation of internal forces. If Effective width is set to "Number Of Thickness", then inputted value is considered as unitless multiplier | | Color | String | #808080 | no | Defines color and transparency of the object. Color is defined by Hex format #AARRGGBB. Transparency is controlled by the alpha channel AA. If no color is set then default color is used. | | Parent ID | String | 67b35d84-3d04-47aa-aa4a-dc1263982320 | no | Is filled for objects created be dividing curved geometry to series of straight line objects. Parent ID will ensure that curved edge is imported as straight parts to nonsupporting application, and back to original supporting application as curved geometry. To ensure successful round trip of segmented objects and their related objects, Parent ID needs to be present in both directions. | | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | ## Notes {% hint style="info" %} **LCS of the rib** is set due to the following rules: X is set from the start node to the end node, Z is set in parallelly to Z LCS in the slab ([StructuralSurfaceMember](https://saf.guide/Content/A_Objects/8_StructuralSurfaceMember.htm)), Y is determined by right hand rule. {% endhint %} ![](/files/W3NAHhsFheB3D7JILRBl) {% hint style="info" %} Complete enumeration of the Formcode and Description ID can be found in chapter Annexes, in this documentation. {% endhint %} # StructuralSurfaceMember ## 2D member (Plate, Wall…) Instances of StructuralSurfaceMember describe face members, structural analysis idealizations of slabs, walls, shells. Surface members may be planar or curved with an arbitrary number of edges. The geometry of a 2D member is defined by nodes ([StructuralPointConnection](/structural-analysis-elements/structuralpointconnection))and edges. The edges define shape of the curve between two next nodes. ![](/files/HlvneNUktjFnuf143i0P) ![](/files/JnnXwggeS9G0fwNH9C49) ### Specification in the excel | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------------- | ------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | B1 | yes | Human readable unique name of the 2D member | | Type | String | Plate | no | The type of the 2D member, used within the model E.g. Plate, Wall, Shell. The type reflects the geometry or classification in the structure. Plate and Wall are expected to be planar (flat) geometry objects. Shell is expected to be non planar object. The type DOES NOT describes available internal forces for 2D finite element. | | Material | String | MAT\_1 | yes | The name reference to the existing, valid name of the StructuralMaterial object. | | Thickness type | Enum |

Constant

Variable in global X

Variable in global Y

Variable in global Z

Variable in local X

Variable in local Y

Variable in direction XY

Variable radially

| yes | Thickness of the slab can be defined as a constant - one thickness for whole 2D member or variable. Variability of the thickness can be defined in the global coordinate system (GCS) or in the local coordinate system (LCS) of the 2D member. For LCS are two more options: - Variable in two directions X and Y (three points have to be defined in thickness attribute ) - Variable radially, for circle slabs. Two points have to be defined, centre point and the point on the diameter. | | Thickness \[mm] | String | 200 N1:200; N2:250 | yes | The thickness of the structural surface member - For constant thickness: One number in millimetres (e.g. 200) - For variable thickness - type "Global X, Global Y, Global Z, Local X, Local Y and Radial: Two thicknesses in the following format N1:200; N2:250 . N1 means name of the existing StructuralPointConnection of the StructuralSurfaceMember and number is a thickness in this point. - For variable thickness type Direction XYThree thicknesses N1:200; N2:250; N3:280 have to be specified | | System plane at | Enum |

Bottom

Centre

Top

| yes | Defines the position of the system plane. | | Nodes | String | N81; N263; N659; N660 | yes | All nodes that belongs to surface member and defines its geometric shape. The names of the nodes are separated by ; (semicolon) and space. | | Internal nodes | String | N22; N23 | no | Internal nodes belonging to StructuralSurfaceMember defined in StructuralPointConnection Internal nodes are not geometry defining The names of the nodes are separated by ; (semicolon) and space | | Edges | String |

Line; Line; Circular Arc; Line

or

Line;Spline-5;Line;Parabolic Arc;Line

| yes |

Defines the shape of the curve between two next nodes (or more nodes depends on edge type). Supported strings are:

Line

Circular Arc

Circle by 3 points

Circle and Point

Parabolic arc

Bezier Spline-x

Where "x" number of nodes defining the spline

The names are separated by ; (semicolon) and space.

It is possible to also define circle geometry by using "Circle and Point" or "Circle by 3 points". In case of "Circle and point" two nodes have to be defined, centre of the circle and a point on a circle. The circle defined by two points is always horizontal.

| | Area \[m2] | Double | 2.359 | no | The value of the surface area of the StructuralSurfaceMember | | Layer | String | 1st floor | no | Custom created layer. The layer can thus comprise entities that have something in common (e.g. one floor, columns of one floor, columns of the same length, etc.) | | LCS Type | Enum |

x by vector

y by vector

Tilt of vector defined by point

| yes | Defines type of the local coordinate system of the StructuralSurfaceMember. Option “Tilt of vector defined by point” allows change of orientation of the LCS to one point (for all mesh elements). For this, you have to specify coordinates of the vector. For further understanding see Introduction | | Coordinate X \[m] | Double | 1 | yes | Coordinate of the vector of the LCS in X direction | | Coordinate Y \[m] | Double | 0 | yes | Coordinate of the vector of the LCS in Y direction | | Coordinate Z \[m] | Double | 1,2 | yes | Coordinate of the vector of the LCS in Z direction | | LCS Rotation \[deg] | Double | 45.00 | yes | This value defines the rotation of local axes of the 2D member | | Structural Z Eccentricity \[mm] | Double | -125 | no | Define the position difference between a physical element and its analytical member representation in Z direction (vertical movement of the center plane). Used to build up physical (structural body from analysis member). DO NOT affects internal forces. | | Analysis Z Eccentricity \[mm] | Double | -125 | yes | Define the position difference between a physical element and its analytical member representation in Z direction (vertical movement of the center plane). Used to build up physical (structural body from analysis member). DO affects internal forces. | | Shape | Enum |

Flat

Curved

| no | Specify the shape of the StructuralSurfaceMember in the sense of the planarity of the system plane. For Flat, all nodes have to be in the same plane. | | Behavior in analysis | Enum |

Isotropic

Orthotropic

Membrane

Press only

| yes | Isotropic: A normal isotropic slab with identical properties in all directions is used. Orthotropic: An orthotropic slab with different properties in two orthogonal directions is used Membrane: Special membrane elements are used for the analysis of the slab (only normal forces allowed) Press only: Special elements capable of resisting only compression stress are used for the analysis of the slab (no tension allowed) | | Color | String | #7FFFFF00 | no | Defines the colour and transparency of the object. Colour is defined by Hex format #AARRGGBB. Transparency is controlled by the alpha channel AA. | | Parent ID | String | 67b35d84-3d04-47aa-aa4a-dc1263982320 | no | Is filled for objects created be dividing curved geometry to series of straight line objects. Parent ID will ensure that curved edge is imported as straight parts to nonsupporting application, and back to original supporting application as curved geometry. To ensure successful round trip of segmented objects and their related objects, Parent ID needs to be present in both directions. | | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | ## Notes {% hint style="info" %} Rotation of LCS is measured from origin position of local x and y-axis and orientation follows positive rotation according to right-handed rule. An example of a definition of a curved wall defined in the StructuralSurfaceMember sheet can be seen below, nodes N1, N2, N3 define the first arc and N4, N5, N6 define the second arc. Edges shown below are important for RelConnectsRigidMember: {% endhint %} ![](/files/lgg3Jw5wlFmaSnPmjA5U) ![](/files/oOZ4U9C3gJp26IuGZEcv) # StructuralSurfaceMemberOpening ## Opening in surface member Instances of StructuralSurfaceMemberOpening describe openings in face members ([StructuralSurfaceMember](/structural-analysis-elements/structuralsurfacemember#2d-member-plate-wall)). The geometry of the opening object is defined in the same way as geometry of 2D members - may be planar or curved with an arbitrary number of edges. ![](/files/tMckl18TTzxpu92EveFk) ![](/files/jtFEU8slUtNI1O44fbzJ) ### Specification in the excel | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | :-----------------------: | :----------: | :----------------------------------: | :------------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | O1 | yes | Human readable unique name of the object | | 2D Member | String | S13 | yes | The name of the StructuralSurfaceMember to which is the opening situated. | | Nodes | String | N81; N263; N659; N660 | yes | All nodes that belong to the surface member and define its geometric shape. The names of the nodes are separated by ; (semicolon) and space. | | Edges | String | Line; Line; Line; Line | yes | Defines the shape of the curve between two next nodes. Supported strings are: Line; Bezier; Circular Arc; Parabolic arc; Spline; Circle and Point; Circle by 3 points. The names are separated by ; (semicolon) and space. | | Area \[m2] | Double | 1.259 | no | The value of the surface area of the StructuralSurfaceMemberOpening | | Parent ID | String | 67b35d84-3d04-47aa-aa4a-dc1263982320 | no | Is filled for objects created be dividing curved geometry to series of straight line objects. Parent ID will ensure that curved edge is imported as straight parts to nonsupporting application, and back to original supporting application as curved geometry. To ensure successful round trip of segmented objects and their related objects, Parent ID needs to be present in both directions. | | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | # StructuralSurfaceMemberRegion ## Region of different plate thickness This object defines particular areas of the StructuralSurfaceMember with different thicknesses. ![](/files/3KVZ7JNrD3IU1mISIt9f) ### Specification in the excel: | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------- | ------------ | :------------------------------------------: | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | R1 | yes | Human readable unique name of the object | | Material | String | MAT\_1 | yes | The name reference to the existing, valid name of the [StructuralMaterial](https://saf.guide/Content/A_Objects/3_StructuralMaterial.htm) object. | | Thickness \[mm] | Double | 200 | yes | The thickness of the StructuralSurfaceMemberRegion Thickness is considered in total. | | System plane at | Enum |

Bottom

Centre

Top

| yes | Defines position of the system plane (local x and y-axis) of the StructuralSurfaceMemberRegion and determines the alignment of the region. Top: the StructuralSurfaceMemberRegion is aligned with the top surface of the [StructuralSurfaceMember](https://saf.guide/Content/A_Objects/8_StructuralSurfaceMember.htm), Bottom: it is aligned with the bottom surface. | | 2D Member | String | S13 | yes | The name of the [StructuralSurfaceMember](https://saf.guide/Content/A_Objects/8_StructuralSurfaceMember.htm) to which is the region situated. | | Nodes | String | N81; N263; N659; N660 | yes | All nodes that belong to StructuralSurfaceMemberRegion and define its geometric shape. The names of the nodes are separated by ; (semicolon) and space. | | Edges | String | Line; Line; Line; Line | yes | Defines shape of the curve between two next nodes. Supported strings are: Line; Bezier; Circular Arc; Parabolic arc; Spline; Circle and Point; Circle by 3 points. The names are separated by ; (semicolon) and space. | | Eccentricity ez \[mm] | Double | -125 | yes | The eccentricity of the slab may be input. Eccentricity is measured from the system plane – local x and y-axis and the direction is in local z-axis. | | Area \[m2] | Double | 1.485 | no | The value of the surface area of the StructuralSurfaceMemberRegion | | Parent ID | String | 67b35d84-3d04-47aa-aa4a-dc1263982320 | no |

Is filled for objects created be dividing curved geometry to series of straight line objects.

Parent ID will ensure that curved edge is imported as straight parts to nonsupporting application, and back to original supporting application as curved geometry.

To ensure successful round trip of segmented objects and their related objects, Parent ID needs to be present in both directions.

| | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | ## Notes {% hint style="info" %} StructuralSurfaceMemberRegion examples of system-plane location and eccentricity effect. {% endhint %} ![](/files/ptnz1Jul5rmPyUSAKgMr) # StructuralStorey ## Storey, Floor levels... StructuralStorey object describes definition of floor levels/storeys in structural model. ![](/files/yNU1iINu3xLe8E6XEfmd) ![](/files/xtOvIG2rmsN7LXcEIrvN) ### Specification in the excel | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------- | ------------ | :----------------------------------: | -------------- | ------------------------------------------------------------------------------------------------------------------------ | | Name | String | FL1 | yes | Human readable unique name of the Arbitrary definition | | Height level \[m] | Double | -2.000 | yes |

Height level \[m] or \[m] of the floor.
Zero height level refers to horizontal plane of GCS (mostly XY plane).

| | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | # StructuralProxyElement ## General solids StrucutralProxyElements are solid objects described by their boundary representation (faces of objects). The common use for StrucutralProxyElements can be found for complex part of structures (garage ramps for example), which are difficult to describe with [StructuralCurveMember](/structural-analysis-elements/structuralcurvemember#1d-member-beam-column) and [StrucuturalSurfaceMemeber](/structural-analysis-elements/structuralsurfacemember#2d-member-plate-wall) or for massive parts of structures with difficult geometry such as foundations. With StrucuralProxyElement all important parts of the structure can be transferred via SAF format no matter the complexity. {% hint style="warning" %} Structural proxy element is not structural analysis object and will not be considered in structural analysis calculation. It is just a geometrical reference object. {% endhint %} ![](/files/frSaiCY8voqKBLcjEsaY) ### StructuralProxyElement Sheet StrucutralProxyElement is a list of all StructuralProxyElements defined in the SAF file. Every row represents one solid object. #### Specification in the excel | Name of the row | Type of data | Value example or enum definition | Required value | Description | | :-------------: | :----------: | :----------------------------------: | :------------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | SPE1 | Yes | Human readable unique name of the StructuralProxyElement | | Material | String | C20/25 | Yes | The reference to the "Name" of defined material in [StructuralMaterial](/structural-analysis-elements/structuralmaterial#material) | | Color | String | #FFFF00 | no | Defines colour and transparency of the object. Colour is defined by Hex format #AARRGGBB. Transparency is controlled by the alpha channel AA. If no colour is set then default colour is used. | | Layer | String | StructuralProxyElement | no | Custom created layer. The layer can thus comprise entities that have something in common (e.g. one floor, columns of one floor, columns of the same length, etc.) | | Id | String | bba1ede8-4106-47fd-b5e1-48637ab87f47 | no | Unique attribute designation | ### StructuralProxyElementVertices Sheet StructuralProxyElementVertices is a list of all vertices that are used for defining the StrucutralProxyElements. Each row is one vertex of StructuralProxyElements. #### Specification in the excel | Name of the row | Type of data | Value example or enum definition | Required value | Description | | :----------------------: | :----------: | :------------------------------: | :------------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Structural proxy element | String | SPE1 | Yes | Name reference to existing StructuralProxyElement in the sheet StructuralProxyElelement. | | Index | Integer | 0 | Yes |

The index of the vertex of the StrucutralProxyElement. The indexing is starting with 0. The Index is used as the reference for StructuralProxyElementFaces.

Every StructuralProxyElement has it owns set of vertecies indexed from 0 to n. Where n ∈ N (natural numbers)

Every StructuralProxyElement has at least 4 vertecies.

| | X \[m] | Double | 32.569 | Yes | Coordinates of vertex in X direction | | Y \[m] | Double | 12.761 | Yes | Coordinates of vertex in Y direction | | Z \[m] | Double | 7.200 | Yes | Coordinates of vertex in Z direction | ### StructuralProxyElementFaces Sheet StructuralProxyElementFaces is used for defining faces of every StructuralProxyElement presented. Each row represents one face of StructuralProxyElements. #### Specification in the excel | Name of the row | Type of data | Value example or enum definition | Required value | Description | | ------------------------ | ------------ | :------------------------------: | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Structural proxy element | String | SPE1 | yes | Name reference to existing StructuralProxyElement in the sheet StructuralProxyElelement. | | Index | Integer | 0 | yes |

The index of the face of the StrucutralProxyElement. The indexing is starting with 0. The Index is used as an identifier of faces among all faces of StructuralProxyElement.

Every StructuralProxyElement has it owns set of faces indexed from 0 to n. Where n ∈ N (natural numbers)

Face is defined with polygon consisting of at least 3 vertecies. These vertecies are defining a plane.

StrucutralProxyElement is defined with at least 4 faces. .

| | Definition | String | (11,8,1,2,13,12,5,6) | yes |

List of ordered vertecies defining the face. Face is defined with polygons.

Polygons are defined by set of vertices in brackets and vertices are divided by comma.

Openings in face is defined as:

(11,8,1,2,13,12,5,6)

| ## Notes {% hint style="info" %} Example of simple StrucutralProxyElement\ vertices:\ **v**0\[0,0,0], **v**1\[2,0,0], **v**2\[1,2,0], **v**3\[1,1,2]\ faces:\ f0(v0,v1,v3), **f**1(v2,v3,v1), **f**2(v3,v2,v0), f3(v1,v0,v2).\ ![](/files/jdQyTXUimUW1isKoD1lt) It is recommended to define the edge common for two faces with the opposite polygons. Face **f**0 is in the picture defined as (v0,**v**1,**v**3) so the face **f**1 will be defined (v2,**v**3,**v**1). The common edge is defined as (**v**1,**v**3) for face **f**1 and (**v**3,**v**1) for face **f**2. {% endhint %} # StructuralPointSupport ## Support in node StructuralPointSupport represents a support of the analytical model in a node. The support is defined by six separate parameters. Each parameter defines the constraint in one direction: translation in the direction of the X, Y, Z axis and rotation around the same axes. A nodal support is oriented in the global co-ordinate system. ![](/files/n0hEbD6pvoVuAmC4gJQp) ### Specification in the excel | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------- | ------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | -------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | Sn6 | yes | Human readable unique name of the support | | Type | Enum |

Fixed

Hinged

Sliding

Custom

| no | Type of constraint support in general. Has just informative value. Actual boundary conditions are set per transition/rotation per direction. | | Node | String | N5 | yes | The name of the node to which is point support related | | ux | Enum |

Rigid

Free


Flexible


Compression only


Tension only


Flexible
compression only


Flexible tension only


Non linear

| yes |

Translation in X direction.
Free - That is it imposes no constraint in the direction.

Rigid - The support in fully rigid in the specified direction.

Flexible - The support is flexible (elastic) in the specified direction. Parameter Flexible can be linear only, non-linearity is not supported. Compression only acts only under compression. If the support gets under tension it stops acting. Tension only support acts only under tension.

| | uy | Enum |

Rigid


Free


Flexible


Compression only


Tension only


Flexible compression only


Flexible tension only


Non linear

| yes |

Translation in Y direction.

Free - That is it imposes no constraint in the direction.

Rigid - The support in fully rigid in the specified direction.

Flexible - The support is flexible (elastic) in the specified direction. Parameter Flexible can be linear only, non-linearity is not supported. Compression only acts only under compression. If the support gets under tension it stops acting. Tension only support acts only under tension.

| | uz | Enum |

Rigid


Free


Flexible


Compression only


Tension only


Flexible compression
only


Flexible tension only


Non linear

| yes |

Translation in Z direction.

Free - That is it imposes no constraint in the direction.

Rigid - The support in fully rigid in the specified direction.

Flexible - The support is flexible (elastic) in the specified direction. Parameter Flexible can be linear only, non-linearity is not supported. Compression only acts only under compression. If the support gets under tension it stops acting. Tension only support acts only under tension.

| | fix | Enum |

Free


Rigid


Flexible


Non linear

| yes |

Rotational stiffness around X axis. Parameter

Flexible can be linear only, non-linearity is not supported.

| | fiy | Enum |

Free


Rigid


Flexible


Non linear

| yes | Rotational stiffness around Y axis. Parameter Flexible can be linear only, non-linearity is not supported. | | fiz | Enum |

Free


Rigid


Flexible


Non linear

| yes |

Rotational stiffness around Z axis.

Parameter Flexible can be linear only, non-linearity is not supported.

| | Stiffness X \[MN/m] | Double | 100 |

yes, if Translation X = Flexible

yes, if Translation X = Non linear

| The flexibility of the support in X direction | | Stiffness Y \[MN/m] | Double | 100 |

yes, if Translation Y = Flexible

yes, if Translation Y = Non linear

| The flexibility of the support in Y direction | | Stiffness Z \[MN/m] | Double | 100 |

yes, if Translation Z = Flexible

yes, if Translation Z = Non linear

| The flexibility of the support in Z direction | | Stiffness Fix \[MNm/rad] | Double | 50 |

yes, if Rx = Flexible

yes, if Rx = Non linear

| The flexibility in rotation of the connection around local X axis | | Stiffness Fiy \[MNm/rad] | Double | 50 |

yes, if Ry = Flexible

yes, if Ry = Non linear

| The flexibility in rotation of the connection around local Y axis | | Stiffness Fiz \[MNm/rad] | Double | 50 |

yes, if Rz = Flexible

yes, if Rz = Non linear

| The flexibility in rotation of the connection around local Z axis | | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | # StructuralSurfaceConnection ## Support on 2D member Instances of the objects StructuralSurfaceConnection are used to describe structural supports provided by planar elements. In most cases, it represents the interaction between the structure and the subsoil. The properties of such model are expressed by what is called interaction parameters marked C. These parameters are assigned directly to structural elements that are in contact with the subsoil and they influence the stiffness matrix in analysis calculation. To simplify the matter, we may imagine that C is the characteristic of elastic, more precisely pseudo-elastic, links, or surface spring constants that change according to the actual state of the analysed system. We may also use the professional slang that calls it "support on C parameters", which is the generalisation of standard Winkler idea of the supporting in the form of thick liquid g = C1 (MNm-3) or in the form of an infinitely dense system of vertical springs. The parameters of the interaction between the foundation and the subsoil depend on the distribution and loading level, or the contact stress between the structure surface and the surrounding subsoil, on the geometry of the footing surface and on mechanical properties of the soil. ![](/files/SZ3kl7QBroNoFvYfflVG) ### Specification in the excel | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------- | ------------ | :----------------------------------: | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | Sn6 | yes | Human readable unique name of the support | | 2D Member | String | S13 | yes | The name of the [StructuralSurfaceMember](/structural-analysis-elements/structuralsurfacemember#2d-member-plate-wall) to which is the surface support is related | | 2D Member Region | String | R1 | no | The name of the [StructuralSurfaceMemberRegion](/structural-analysis-elements/structuralsurfacememberregion#region-of-different-plate-thickness) to which is the surface support related if it is available on 2D member | | Subsoil | String | Gravel | yes | Type of the subsoil | | Description | String | Loam/Very sandy | no | Characteristics of the subsoil | | C1x \[MN/m3] | Double | 80,5 | yes |

Resistance of environment against xP (mm) \[C1x in MN/m3] (deformation in local x direction)

See notes for coordinates reference.

| | C1y \[MN/m3] | Double | 35,5 | yes |

Resistance of environment against yP (mm) \[C1y in MN/m3] (deformation in local y direction)

See notes for coordinates reference.

| | C1z Spring | String | Linear | no |

Resistance of environment against zP (deformation in local z direction).

Non-linear is not supported.

See notes for coordinates reference.

| | C1z \[MN/m3] | Double | 50 | yes |

Resistance of environment against zP (mm) \[C1z in MN/m3] (deformation in local z direction)

See notes for coordinates reference.

| | C2x \[MN/m] | Double | 15,5 | yes |

Resistance of environment against zP/xP (mm/m) \[C2x in MN/m]

See notes for coordinates reference.

| | C2y \[MN/m] | Double | 10,2 | yes |

Resistance of environment against zP/yP (mm/m) \[C2y in MN/m]

See notes for coordinates reference.

| | Parent ID | String | 67b35d84-3d04-47aa-aa4a-dc1263982320 | no |

Is filled for objects created be dividing curved geometry to series of straight line objects.

Parent ID will ensure that curved edge is imported as straight parts to nonsupporting application, and back to original supporting application as curved geometry.

To ensure successful round trip of segmented objects and their related objects, Parent ID needs to be present in both directions.

| | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | ## Notes {% hint style="info" %} Local coordination system is given by parent 2D object - [StructuralSurfaceMember](/structural-analysis-elements/structuralsurfacemember#2d-member-plate-wall) {% endhint %} # StructuralCurveConnection ## Supports on 1D members Object definition for a line support on a 1D member ([StructuralCurveMember](/structural-analysis-elements/structuralcurvemember#1d-member-beam-column)) or on a rib ([StructuralCurveMemberRib](/structural-analysis-elements/structuralcurvememberrib#2d-member-rib)). The support can be defined along the entire length of an edge or on its part only. This support is defined by six independent parameters. Each parameter defines the constraint in one direction: translation in X, Y, Z axis and rotation around the same axes. The parameters are the same as for line support on 2D memeber edge support ([StructuralEdgeConnection](/structural-analysis-elements/structuralcurveedge#internal-edge)). ### Specification in the excel | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | -------------------------- | ------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------: | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | Sn6 | yes | Human readable unique name of the support | | Type | Enum |

Fixed

Hinged

Sliding

Custom

| no | Type of constraint support in general. Has just informative value. Actual boundary conditions are set per transition/rotation per direction. | | Member | String | B1 | yes, if on Member | The name of the 1D member ([StructuralCurveMember](https://saf.guide/Content/A_Objects/7_StructuralCurveMember.htm)) to which is support related | | Member Rib | String | R1 | yes, if on Rib | The name of the 1D member Rib([StructuralCurveMemberRib](https://saf.guide/Content/A_Objects/25_StructuralCurveMemberRib.htm)) to which is support related | | ux | Enum |

Free


Rigid


Flexible


Compression
only


Tension only

| yes |

Translation in X direction.

Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Parameter Flexible can be linear only, non-linearity is not supported. Compression only acts only under compression. If the support gets under tension it stops acting. Tension only support acts only under tension.

| | uy | Enum |

Free


Rigid


Flexible


Compression only


Tension only

| yes |

Translation in Y direction.

Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Parameter Flexible can be linear only, non-linearity is not supported. Compression only acts only under compression. If the support gets under tension it stops acting. Tension only support acts only under tension.

| | uz | Enum |

Free


Rigid


Flexible


Compression only


Tension only

| yes |

Translation in Z direction.

Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Parameter Flexible can be linear only, non-linearity is not supported. Compression only acts only under compression. If the support gets under tension it stops acting. Tension only support acts only under tension.

| | fix | Enum |

Free


Rigid


Flexible

| yes | Rotational stiffness around X axis. Parameter Flexible can be linear only, non-linearity is not supported. | | fiy | Enum |

Free

Rigid

Flexible

| yes | Rotational stiffness around Y axis. Parameter Flexible can be linear only, non-linearity is not supported. | | fiz | Enum |

Free


Rigid


Flexible

| yes | Rotational stiffness around Z axis. Parameter Flexible can be linear only, non-linearity is not supported. | | Stiffness X \[MN/m2] | Double | 100 | yes, if Translation X = Flexible | The flexibility of the connection in X direction. Use this property only if the Translation X direction is Flexible. | | Stiffness Y \[MN/m2] | Double | 100 | yes, if Translation Y = Flexible | The flexibility of the connection in Y direction. Use this property only if the Translation Y direction is Flexible. | | Stiffness Z \[MN/m2] | Double | 100 | yes, if Translation Z = Flexible | The flexibility of the connection in Z direction. Use this property only if the Translation Z direction is Flexible. | | Stiffness Fix \[MNm/rad/m] | Double | 50 | yes, if Rx = Flexible | The flexibility in rotation of the connection around local X axis. Use this property only if the Rotational stiffness Rx is Flexible. | | Stiffness Fiy \[MNm/rad/m] | Double | 50 | yes, if Ry = Flexible | The flexibility in rotation of the connection around local Y axis. Use this property only if the Rotational stiffness Ry is Flexible. | | Stiffness Fiz \[MNm/rad/m] | Double | 50 | yes, if Rz = Flexible | The flexibility in rotation of the connection around local Z axis. Use this property only if the Rotational stiffness Rz is Flexible. | | Coordinate system | Enum |

Global


Local

| yes | Defines the co-ordinate system of the member in which the support is applied | | Coordinate definition | Enum |

Absolute


Relative

| yes | Selects the coordinate system that is used to define the length of the support. Relative means without units. For define length of the hinges in meters input absolute | | Origin | Enum |

From start


From end

| yes | Specifies the origin of the coordinate system used for the definition of the length of the hinge | | Start point \[m] | Double |

value in meters for Coordinate definition = Absolute

0,0


value in percentage for Coordinate definition = Relative

0,0

| yes | Defines the position of the start point of the support in relative or absolute coordinates \[m] | | End point \[m] | Double |

value in meters for Coordinate definition = Absolute

5,25


value in percentage for Coordinate definition = Relative

1,0

| yes | Defines the position of the end point of the support in relative or absolute coordinates \[m] | | Parent ID | String | 67b35d84-3d04-47aa-aa4a-dc1263982320 | no |

Is filled for objects created be dividing curved geometry to series of straight line objects.

Parent ID will ensure that curved edge is imported as straight parts to nonsupporting application, and back to original supporting application as curved geometry.

To ensure successful round trip of segmented objects and their related objects, Parent ID needs to be present in both directions.

| | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | # StructuralEdgeConnection ## Supports on 2D members edges Object definition for a line support on a 2D member ([StructuralSurfaceMember](/structural-analysis-elements/structuralsurfacemember#2d-member-plate-wall)) edge. The support can be defined along the entire length of an edge or on its part only. ![](/files/XZRZt09hXR1Nk9CDjGHf) ### Specification in the excel | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | -------------------------- | ------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------: | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | Sn6 | yes | Human readable unique name of the support | | Type | Enum |

Fixed


Hinged


Sliding


Custom

| no | Type of constraint support in general. Has just informative value. Actual boundary conditions are set per transition/rotation per direction. | | Boundary condition | Enum |

On edge


On subregion edge


On opening edge

| yes | Specifies on which type of object the force acts | | 2D Member | String | S3 | yes, if Boundary condition = On edge | The name of the [StructuralSurfaceMember](/structural-analysis-elements/structuralsurfacemember#2d-member-plate-wall) of affected edge. | | 2D Member Region | String | R1 | yes, if Boundary condition action = On subregion edge | The name of the [StructuralSurfaceMemberRegion](/structural-analysis-elements/structuralsurfacememberregion) on which is the load applied. | | 2D Member Opening | String | O1 | yes, if Boundary condition action = On opening edge | The name of the [StructuralSurfaceMemberOpening](/structural-analysis-elements/structuralsurfacememberopening) on which is the load applied. | | Edge | Integer | 1 | yes | The index of edge of the surface member. The index starting with 1. The order is according to order of “edges” property at [StructuralSurfaceMember](/structural-analysis-elements/structuralsurfacemember#2d-member-plate-wall), [StructuralSurfaceMemberRegion](/structural-analysis-elements/structuralsurfacememberregion) or [StructuralSurfaceMemberOpening](/structural-analysis-elements/structuralsurfacememberopening) | | ux | Enum |

Free


Rigid


Flexible

Compression only


Tension only

| yes |

Translation in X direction.

Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Parameter Flexible can be linear only, non-linearity is not supported. Compression only acts only under compression. If the support gets under tension it stops acting. Tension only support acts only under tension.

| | uy | Enum |

Free


Rigid


Flexible

Compression only


Tension only

| yes |

Translation in Y direction.

Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Parameter Flexible can be linear only, non-linearity is not supported. Compression only acts only under compression. If the support gets under tension it stops acting. Tension only support acts only under tension.

| | uz | Enum |

Free


Rigid


Flexible

Compression only


Tension only

| yes |

Translation in Z direction.

Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Parameter Flexible can be linear only, non-linearity is not supported. Compression only acts only under compression. If the support gets under tension it stops acting. Tension only support acts only under tension.

| | fix | Enum |

Free


Rigid


Flexible

| yes | Rotational stiffness around X axis. Parameter Flexible can be linear only, non-linearity is not supported. | | fiy | Enum |

Free


Rigid


Flexible

| yes | Rotational stiffness around Y axis. Parameter Flexible can be linear only, non-linearity is not supported. | | fiz | Enum |

Free


Rigid


Flexible

| yes | Rotational stiffness around Z axis. Parameter Flexible can be linear only, non-linearity is not supported. | | Stiffness X \[MN/m2] | Double | 100 | yes, if Translation X = Flexible | The flexibility of the connection in X direction. Use this property only if the Translation X direction is Flexible. | | Stiffness Y \[MN/m2] | Double | 100 | yes, if Translation Y = Flexible | The flexibility of the connection in Y direction. Use this property only if the Translation Y direction is Flexible. | | Stiffness Z \[MN/m2] | Double | 100 | yes, if Translation Z = Flexible | The flexibility of the connection in Z direction. Use this property only if the Translation Z direction is Flexible. | | Stiffness Fix \[MNm/rad/m] | Double | 50 | yes, if Rx = Flexible | The flexibility in rotation of the connection around local X axis. Use this property only if the Rotational stiffness Rx is Flexible. | | Stiffness Fiy \[MNm/rad/m] | Double | 50 | yes, if Ry = Flexible | The flexibility in rotation of the connection around local Y axis. Use this property only if the Rotational stiffness Ry is Flexible. | | Stiffness Fiz \[MNm/rad/m] | Double | 50 | yes, if Rz = Flexible | The flexibility in rotation of the connection around local Z axis. Use this property only if the Rotational stiffness Rz is Flexible. | | Coordinate system | Enum |

Global


Local

| yes | Defines the co-ordinate system of the member in which the support is applied | | Coordinate definition | Enum |

Absolute


Relative

| yes | Selects the coordinate system that is used to define the length of the hinge. Relative means without units. For define length of the hinges in meters input absolute | | Origin | Enum |

From start


From end

| yes | Specifies the origin of the coordinate system used for the definition of the length of the hinge | | Start point \[m] | Double |

value in meters for Coordinate definition = Absolute

0,0


value in percentage for Coordinate definition = Relative

0,0

| yes | Defines the position of the start point of the support in relative or absolute coordinates \[m] | | End point \[m] | Double |

value in meters for Coordinate definition = Absolute

5,25


value in percentage for Coordinate definition = Relative

1,0

| yes | Defines the position of the end point of the support in relative or absolute coordinates \[m] | | Parent ID | String | 67b35d84-3d04-47aa-aa4a-dc1263982320 | no |

Is filled for objects created be dividing curved geometry to series of straight line objects.

Parent ID will ensure that curved edge is imported as straight parts to nonsupporting application, and back to original supporting application as curved geometry.

To ensure successful round trip of segmented objects and their related objects, Parent ID needs to be present in both directions.

| | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | # RelConnectsStructuralMember ## Hinges on 1D member The entity RelConnectsStructuralMember allows users to release degrees of freedom between structural members (beams, columns) and structural connection objects (nodes or supports). When no RelConnectsStrucutralMember is defined, connections are taken into account as fully rigid. The defined connections may be rigid or free or anything in between. In each direction (translations along X, Y, and Z local 1D member axes, rotation around X, Y, and Z local 1D member axes) the condition may be: Free, Rigid, Flexible. ![](/files/BBkvwtytGO35RWrtTN2F) ### Specification in the excel: | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------- | ------------ | :--------------------------------------------: | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | H1 | yes | Human readable unique name of the RelConnectsStrucutralMember | | Member | String | Beam B54 | yes | The name of the curve member to which is hinge related | | Position | Enum |

Begin


End


Both

| yes | The position of the hinge on the curve member. \*see notes | | ux | Enum |

Free


Rigid


Flexible

| yes | Translation in X direction. Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Parameter Flexible can be linear only, non-linearity is not supported. | | uy | Enum |

Free


Rigid


Flexible

| yes | Translation in Y direction. Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Parameter Flexible can be linear only, non-linearity is not supported. | | uz | Enum |

Free


Rigid


Flexible

| yes | Translation in Z direction. Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Parameter Flexible can be linear only, non-linearity is not supported. | | fix | Enum |

Free


Rigid


Flexible

| yes | Rotational stiffness around X axis. Parameter Flexible can be linear only, non-linearity is not supported. | | fiy | Enum |

Free


Rigid


Flexible

| yes | Rotational stiffness around Y axis. Parameter Flexible can be linear only, non-linearity is not supported. | | fiz | Enum |

Free


Rigid


Flexible

| yes | Rotational stiffness around Z axis. Parameter Flexible can be linear only, non-linearity is not supported. | | Stiffness X \[MN/m] | Double | 100 | yes, if ux = Flexible | The flexibility of the connection in X direction | | Stiffness Y \[MN/m] | Double | 100 | yes, if uy = Flexible | The flexibility of the connection in Y direction | | Stiffness Z \[MN/m] | Double | 100 | yes, if uz = Flexible | The flexibility of the connection in Z direction | | Stiffness Fix \[MNm/rad] | Double | 50 | yes, if fix = Flexible | The flexibility in rotation of the connection around local X axis | | Stiffness Fiy \[MNm/rad] | Double | 50 | yes, if fiy = Flexible | The flexibility in rotation of the connection around local Y axis | | Stiffness Fiz \[MNm/rad] | Double | 50 | yes, if fiz = Flexible | The flexibility in rotation of the connection around local Z axis | | Parent ID | String | 67b35d84-3d04-47aa-aa4a-dc1263982320 | no |

Is filled for objects created be dividing curved geometry to series of straight line objects.

Parent ID will ensure that curved edge is imported as straight parts to nonsupporting application, and back to original supporting application as curved geometry.

To ensure successful round trip of segmented objects and their related objects, Parent ID needs to be present in both directions.

| | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | ## Notes {% hint style="info" %} **Hinge position** is used for allowing users to define where degrees of freedom are released (user defined constrains). When the fully rigid connection is desired - no RelConnectsStructuralMember is defined! {% endhint %} # RelConnectsSurfaceEdge ## Hinges on 2D member edge A connection of two slabs (2D members) may be modelled as a fixed one or a hinge may be inserted to create a pinned connection. Three configurations of slab hinge are allowed: rigid, free, flexible. Under any configuration, all translations are fully transferred from one slab to the other. If there is no hinge, the connection is rigid. {% hint style="warning" %} This object is referring to the edge of StructuralSurfaceMember. Only for this object the indexing of edges starts with "0". All other objects are referencing with "1" based indexing. {% endhint %} ![](/files/DTB8nYZkViTNlbcOiOAU) | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | -------------------------- | ------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------: | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Name | String | Sn6 | yes | Human readable unique name of the support | | 2D Member | String | S3 | yes | The name of the surface member to which is hinge related | | Edge | Integer | 0 | yes | The index of edge of the surface member. The index starting with 0. The order is according to order of “edges” property at [StrucutralSurfaceMember](/structural-analysis-elements/structuralsurfacememberopening). | | ux | Enum |

Free


Rigid


Flexible

| yes | Translation in X direction. Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Parameter Flexible can be linear only, non-linearity is not supported. | | uy | Enum |

Free


Rigid


Flexible

| yes | Translation in Y direction. Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Parameter Flexible can be linear only, non-linearity is not supported. | | uz | Enum |

Free


Rigid


Flexible

| yes | Translation in Z direction. Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Parameter Flexible can be linear only, non-linearity is not supported. | | fix | Enum |

Free


Rigid


Flexible

| yes | Rotational stiffness around X axis. Parameter Flexible can be linear only, non-linearity is not supported. | | fiy | Enum |

Free


Rigid


Flexible

| yes | Rotational stiffness around Y axis. Parameter Flexible can be linear only, non-linearity is not supported. | | fiz | Enum |

Free


Rigid


Flexible

| yes | Rotational stiffness around Z axis. Parameter Flexible can be linear only, non-linearity is not supported. | | Stiffness X \[MN/m2] | Double | 100 | yes, if ux = Flexible | The flexibility of the connection in X direction | | Stiffness Y \[MN/m2] | Double | 100 | yes, if uy = Flexible | The flexibility of the connection in Y direction | | Stiffness Z \[MN/m2] | Double | 100 | yes, if uz = Flexible | The flexibility of the connection in Z direction | | Stiffness Fix \[MNm/rad/m] | Double | 50 | yes, if fix = Flexible | The flexibility in rotation of the connection around local X axis | | Stiffness Fiy \[MNm/rad/m] | Double | 50 | yes, if fiy = Flexible | The flexibility in rotation of the connection around local Y axis | | Stiffness Fiz \[MNm/rad/m] | Double | 50 | yes, if fiz = Flexible | The flexibility in rotation of the connection around local Z axis | | Coordinate definition | Enum |

Absolute


Relative

| yes | Selects the coordinate system that is used to define the length of the hinge. Relative means without units. To define length of the hinges in meters input absolute | | Origin | Enum |

From start


From end

| yes | Specifies the origin of the coordinate system used for the definition of the length of the hinge | | Start point \[m] | Double |

value in meters for Coordinate definition = Absolute


0,0

value in percentage for Coordinate definition = Relative

0,0

| yes |

Defines the position of the start point of the hinge in relative or absolute coordinates

Units in meters \[m]

| | End point \[m] | Double |

value in meters for Coordinate definition = Absolute


5,25

value in percentage for Coordinate definition = Relative

1,0

| yes |

Defines the position of the end point of the hinge in relative or absolute coordinates

Units in meters \[m

| | Parent ID | String | 67b35d84-3d04-47aa-aa4a-dc1263982320 | no |

Is filled for objects created be dividing curved geometry to series of straight line objects.
Parent ID will ensure that curved edge is imported as straight parts to nonsupporting application, and back to original supporting application as curved geometry.

To ensure successful round trip of segmented objects and their related objects, Parent ID needs to be present in both directions.

| | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | # RelConnectsRigidCross ## Rigid Cross RigidCross is defining structural behavior of node ([StructuralPointConnection](/structural-analysis-elements/structuralpointconnection#node)), where two 1D elements ([StructuralCurveMember](/structural-analysis-elements/structuralcurvemember#1d-member-beam-column)) are being crossed. 1D members could be independent or dependency could be defined in following excel sheet. Rigid cross is often used for bracing of the structure. ![](/files/VfbVmzJI8xBmflhH9HlP) ### Specification in the excel | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------- | ------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | RC1 | yes | Human readable unique name of the object | | 1D Members | String | B1; B3 |

yes

value from (StructuralCurveMember)

|

The name from (StrucutralCurveMember)

Two 1D members should be defined

| | Type | Enum |

Fixed


Hinged


Custom

| no |

Constraint of the Rigid Cross

The way the Rigid Cross acts in individual directions. Has informative character.

When all constraints are set to Rigid = Fixed

When all constraints are set to Free = Hinge

Custom allows user defined behavior of Cross link and creating the Coupler

| | u1 | Enum |

Free


Rigid


Flexible

Compression only


Tension only


Flexible compression only


Flexible tension only


Non linear

| yes |

Displacement of first connected member

Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Non linear - resistance in specified direction could be defined

(Flexible) compression/tension only - acts rigid or flexible, only for defined strain (compression or tension)

| | u2 | Enum |

Free


Rigid


Flexible

Compression only


Tension only


Flexible compression only


Flexible tension only


Non linear

| yes |

Displacement of second connected member

Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Non linear - resistance in specified direction could be defined

(Flexible) compression/tension only - acts rigid or flexible, only for defined strain (compression or tension)

| | u | Enum |

Free


Rigid


Flexible

Compression only


Tension only


Flexible compression only


Flexible tension only


Non linear

| yes |

Displacement of RigidCross

Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Non linear - resistance in specified direction could be defined

(Flexible) compression/tension only - acts rigid or flexible, only for defined strain (compression or tension)

| | fi1 | Enum |

Free


Rigid


Flexible


Non linear

| yes |

Rotation for the first connected member

Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Non linear - resistance in specified direction could be defined

| | fi2 | Enum |

Free


Rigid


Flexible


Non linear

| yes |

Rotation for the second connected member

Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Non linear - resistance in specified direction could be defined

| | fi | Enum |

Free


Rigid


Flexible


Non linear

| yes |

Rotation for the RigidCross

Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Non linear - resistance in specified direction could be defined

| | Stiffness u1 \[MN/m] | Double | 3.0 | yes, if u1 = Flexible, Flexible compression/tension only or Non linear |

The flexibility in direction of first member

Use this property only if the u1 is set Flexible, Flexible compression/tension only or Non linear

| | Resitance u1 \[MN] | Double | 0.20 | yes, if u1 = Non linear |

The resistance in direction of first member

Use this property only if the u1 is set Non linear

| | Stiffness u2 \[MN/m] | Double | 3.0 | yes, if u2 = Flexible, Flexible compression/tension only or Non linear |

The flexibility in direction of second member

Use this property only if the u2 is set Flexible, Flexible compression/tension only or Non linear

| | Resitance u2 \[MN] | Double | 0.20 | yes, if u2 = Non linear |

The resistance in direction of second member

Use this property only if the u2 is set Non linear

| | Stiffness u \[MN/m] | Double | 5.0 | yes, if u = Flexible, Flexible compression/tension only or Non linear |

The flexibility of the RigidCross

Use this property only if the u is set Flexible, Flexible compression/tension only or Non linear

| | Resitance u \[MN] | Double | 0.35 | yes, if u = Non linear |

The resistance of the RigidCross

Use this property only if the u is set Non linear

| | Stiffness fi1 \[MNm/rad] | Double | 1.0 | yes, if fi1 = Flexible, Flexible compression/tension only or Non linear |

Torsional stiffness around the 1st member

Use this property only if the fi1 is set Flexible or Non linear

| | Resistance fi1 \[MNm] | Double | 0.05 | yes, if fi1 = Non linear |

Torsional resistance around the 1st member

Use this property only if the fi1 is set Non linear

| | Stiffness fi2 \[MNm/rad] | Double | 1.0 | yes, if fi2 = Flexible, or Non linear |

Torsional stiffness around the 2st member

Use this property only if the fi2 is set Flexible or Non linear

| | Resistance fi2 \[MNm] | Double | 0.05 | yes, if fi2 = Non linear |

Torsional resistance around the 2st member

Use this property only if the fi2 is set Non linear

| | Stiffness fi \[MNm/rad] | Double | 4.0 | yes, if fi = Flexible or Non linear |

Torsional stiffness of the RigidCross

Use this property only if the fi is set Flexible or Non linear

| | Resistance fi \[MNm] | Double | 0.25 | yes, if fi = Non linear |

Torsional resistance of the RigidCross

Use this property only if the fi is set Non linear

| | Parent ID | String | 67b35d84-3d04-47aa-aa4a-dc1263982320 | no |

Is filled for objects created be dividing curved geometry to series of straight line objects.

Parent ID will ensure that curved edge is imported as straight parts to nonsupporting application, and back to original supporting application as curved geometry.

To ensure successful round trip of segmented objects and their related objects, Parent ID needs to be present in both directions.

| | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | ## Notes {% hint style="info" %} **Resistance** is defined by the value of maximal strain. Until is the value of maximal strain reached, Rigid cross acts fully rigid. After the value exceeded, RigidCross acts flexibly due to defined Value of Stiffness. This is how non linear behavior is achieved. The axis of the connection is defined by the members of the RigidCross: * The first axis is assigned to the first member (i.e. the first member selected by the user during the definition of a new RigidCross - column "1D Members"). * The second axis is assigned to the second member (i.e. the second member selected by the user during the definition of a new RigidCross - column "1D Members"). * The third axis is perpendicular at the plane defined by member 1 and member 2. **Non linear** behavior of material is handled with "Resistance". The example is shown below. {% endhint %} ![](/files/h1PBcf396vRX6QdflcUM) # RelConnectsRigidLink ## Rigid Link A virtual connection of two nodes from([StructuralPointConnection](/structural-analysis-elements/structuralpointconnection#node)) for directly defined nodes, ([StructuralSurfaceMember](/structural-analysis-elements/structuralsurfacemember#2d-member-plate-wall)) or ([StructuralCurveMember](/structural-analysis-elements/structuralcurvemember#1d-member-beam-column))for internal nodes on 1D and 2D members, where structural behavior could be set. Master and slave node have to be defined. The rigid links are used for the connection, where you want to simulate infinite rigidity or user defined properties. ![](/files/KnInLJHKAaDrX5rkgUCl) ![](/files/nHg7LQ1EjuIZtDy7xZMI) ### Specification in the excel | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------- | ------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Name | String | RL1 | yes | Human readable unique name of the object | | Nodes | String | N3; N4 | yes |

The name of the valid existing node (StructuralPoinConnection), or (StructuralCurveMember, StructuralSurfaceMember) for internal nodes

Maximum of two nodes can be connected by RelConnectsRigitLink

First in node is seen as "master node", second in row is "slave node"

| | Hinge position | Enum |

None


Begin (master node)


End (slave node)


Both

| yes |

This attribute serves to indicate if hinges should be applied to rigid link and if so, than on which node.

Hinge position allows user to define constrains of selected node or nodes of RelConnectsRigidLink for translation (ui) and rotation (fii)

| | ux | Enum |

Free


Rigid


Flexible


Compression only


Tension only


Flexible compression only


Flexible tension only


Non linear

| yes |

Displacement in the direction X

Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Non linear - resistance in specified direction could be defined

(Flexible) compression/tension only - acts rigid or flexible, only for defined strain (compression or tension)

See notes for coordinates reference.

| | uy | Enum |

Free


Rigid


Flexible


Compression only


Tension only


Flexible compression only


Flexible tension only


Non linear

| yes |

Displacement in the direction Y

Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Non linear - resistance in specified direction could be defined

(Flexible) compression/tension only - acts rigid or flexible, only for defined strain (compression or tension)

See notes for coordinates reference.

| | uz | Enum |

Free


Rigid


Flexible


Compression only


Tension only


Flexible compression only


Flexible tension only


Non linear

| yes |

Displacement in the direction Z

Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Non linear - resistance in specified direction could be defined

(Flexible) compression/tension only - acts rigid or flexible, only for defined strain (compression or tension)

See notes for coordinates reference.

| | fix | Enum |

Free


Rigid


Flexible


Non linear

| yes |

Rotation around X axis

Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Non linear - resistance in specified direction could be defined

See notes for coordinates reference.

| | fiy | Enum |

Free


Rigid


Flexible


Non linear

| yes |

Rotation around Y axis

Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Non linear - resistance in specified direction could be defined

See notes for coordinates reference.

| | fiz | Enum |

Free


Rigid


Flexible


Non linear

| yes |

Rotation around Z axis

Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Non linear - resistance in specified direction could be defined

See notes for coordinates reference.

| | Stiffness X \[MN/m] | Double | 3.00 | yes, if ux = Flexible, Flexible compression/tension only or Non linear |

The flexibility in direction X

Use this property only if the ux is set Flexible, Flexible compression/tension only or Non linear

See notes for coordinates reference.

| | Resistance X \[MN] | Double | 0.25 | yes, if ux = Non linear |

The resistance in direction X

Use this property only if the ux is set to Non linear

See notes for coordinates reference.

| | Stiffness Y \[MN/m] | Double | 2.50 | yes, if uy = Flexible, Flexible compression/tension only or Non linear |

The flexibility in direction Y

Use this property only if the uy is set Flexible, Flexible compression/tension only or Non linear

See notes for coordinates reference.

| | Resistance Y \[MN] | Double | 0.30 | yes, if uy = Non linear |

The resistance in direction Y

Use this property only if the uy is set Non linear

See notes for coordinates reference.

| | Stiffness Z \[MN/m] | Double | 2.00 | yes, if uz = Flexible, Flexible compression/tension only or Non linear |

The flexibility in direction Z

Use this property only if the uz is set Flexible, Flexible compression/tension only or Non linear

See notes for coordinates reference.

| | Resistance Z \[MN] | Double | 0.75 | yes, if uz = Non linear |

The resistance in direction Z

Use this property only if the uz is set Non linear

See notes for coordinates reference.

| | Stiffness Fix \[MNm/rad] | Double | 5.00 | yes, if fix = Flexible or Non linear |

The flexibility in rotation around X axis

Use this property only if the Rotational stiffness fix is Flexible or Non linear

See notes for coordinates reference.

| | Resistance Fix \[MNm] | Double | 1.00 | yes, if fix = Non linear |

The resistance in rotation around Y axis

Use this property only if the Rotational stiffness fix is Non linear

See notes for coordinates reference.

| | Stiffness Fiy \[MNm/rad] | Double | 6.25 | yes, if fiy = Flexible or Non linear |

The flexibility in rotation around Y axis

Use this property only if the Rotational stiffness fiy is Flexible or Non linear

See notes for coordinates reference.

| | Resistance Fiy \[MNm] | Double | 0.80 | yes, if fiy = Non linear |

The resistance in rotation around Y axis

Use this property only if the Rotational stiffness fiy is Non linear

See notes for coordinates reference.

| | Stiffness Fiz \[MNm/rad] | Double | 3.00 | yes, if fiz = Flexible or Non linear |

The flexibility in rotation around Z axis

Use this property only if the Rotational stiffness fiz is Flexible or Non linear

See notes for coordinates reference.

| | Resistance Fiz \[MNm] | Double | 0.10 | yes, if fiz = Non linear |

The resistance in rotation around Z axis

Use this property only if the Rotational stiffness fiz is Non linear

See notes for coordinates reference.

| | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | ## Notes {% hint style="info" %} For constrains, the LCS of RelConnectsRigidLink is taken into account. Local coordination system is given by master node and its parent object. **Non linear** behavior of material is handled with "Resistance". The example is shown below. {% endhint %} ![](/files/h1PBcf396vRX6QdflcUM) # RelConnectsRigidMember ## Rigid Member A rigid connection between two entities. Rigid Member allows to create connections between nodes ([StructuralPoinConnection](/structural-analysis-elements/structuralpointconnection#node)), 1D members ([StructuralCurveMember](/structural-analysis-elements/structuralcurvemember#1d-member-beam-column)) and edges of 2D members ([StructuralSurfaceMember](/structural-analysis-elements/structuralsurfacemember#2d-member-plate-wall)). Connection could be infinitely rigid or with user defined properties. Maximum of two entities could be connected with one **RelConnectsRigidMember**. ![](/files/gnxqKs0zOGFw4uNcVzsG) ### Specification in the excel | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | -------------------------- | ------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Name | String | RM1 | yes | Human readable unique name of the object | | Node | String | N3 |

yes

,if is connection between node and other entity is desired

otherwise no

|

The name of the valid existing node (StructuralPoinConnection)

Fiil in node indication, when connection between node, 2D member edge, 1D member or internal edge is desired

| | 2D Members | String | S1; S2 |

yes

,if connection between 2D member edge and other entity is desired

otherwise no

|

The name of the valid existing 2D member (StructuralSurfaceMember)

Maximum of two 2D members can be connected by RelConnectsRigitMember

Fiil in one 2D member indication, when connection with node, 1D member or internal edge is desired

| | Edges | String | 3; 1 |

yes

,if column "2D Members" is filled

otherwise no

|

This attribute defines edges that should be connected with RelConnectsRigidMember

One value for every value set in column "2D Member"

The index starting with 1.

The order is according to order of “edges” property at StructuralSurfaceMember

| | Internal edge | String | IE2; IE6 |

yes

,if connection between internal edges and other entity is desired

otherwise no

|

The name of the valid existing internal edge (StructuralCurveEdge)

Maximum of two internal edges can be connected by RelConnectsRigitMember

Fiil in one internal edge indication, when connection with node, 1D member or 2D member edge is desired

| | 1D Members | String | B1; B3 |

yes

,if connection between 1D member and other entity is desired

otherwise no

|

The name of valid existing 1D member (StructuralCurveMember)

Maximum of two 1D members can be sonnected by StrucutralRigidMember

Fill in one 1D member indication, when connection with node, 2D member edge or internal edge is desired

| | Type | Enum |

Fixed

Custom

| yes |

Constraint of the Rigid Member

The way the RigidMemberk acts in individual directions

Fixed value automaticly defines displacements and rotations constrains

Custom allows user defined behavior of Rigid Member

| | ux | Enum |

Free


Rigid


Flexible


Compression only


Tension only


Flexible compression only


Flexible tension only


Non linear

| yes |

Displacement in the direction X

Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Non linear - resistance in specified direction could be defined

(Flexible) compression/tension only - acts rigid or flexible, only for defined strain (compression or tension)

See notes for coordinates reference.

| | uy | Enum |

Free


Rigid


Flexible


Compression only


Tension only


Flexible compression only


Flexible tension only


Non linear

| yes |

Displacement in the direction Y

Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Non linear - resistance in specified direction could be defined

(Flexible) compression/tension only - acts rigid or flexible, only for defined strain (compression or tension)

See notes for coordinates reference.

| | uz | Enum |

Free


Rigid


Flexible


Compression only


Tension only


Flexible compression
only


Flexible tension only


Non linear

| yes |

Displacement in the direction Z

Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Non linear - resistance in specified direction could be defined

(Flexible) compression/tension only - acts rigid or flexible, only for defined strain (compression or tension)

See notes for coordinates reference.

| | fix | Enum |

Free


Rigid


Flexible


Non linear

| yes |

Rotation around X axis

Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Non linear - resistance in specified direction could be defined

See notes for coordinates reference.

| | fiy | Enum |

Free


Rigid


Flexible


Non linear

| yes |

Rotation around Y axis

Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Non linear - resistance in specified direction could be defined

See notes for coordinates reference.

| | fiz | Enum |

Free


Rigid


Flexible


Non linear

| yes |

Rotation around Z axis

Free - That is it imposes no constraint in the direction. Rigid - The connection in fully rigid in the specified direction. Flexible - The connection is flexible (elastic) in the specified direction. Non linear - resistance in specified direction could be defined

See notes for coordinates reference.

| | Stiffness X \[MN/m2] | Double | 3.00 | yes, if ux = Flexible, Flexible compression/tension or Non linear |

The flexibility in direction X

Use this property only if the ux is set Flexible, Flexible compression/tension or Non linear

See notes for coordinates reference.

| | Resistance X \[MN/m] | Double | 0.25 | yes, if ux = Non linear |

The resistance in direction X

Use this property only if the ux is set to Non linear

See notes for coordinates reference.

| | Stiffness Y \[MN/m2] | Double | 2.50 | yes, if uy = Flexible, Flexible compression/tension or Non linear |

The flexibility in direction Y

Use this property only if the uy is set Flexible, Flexible compression/tension or Non linear

See notes for coordinates reference.

| | Resistance Y \[MN/m] | Double | 0.30 | yes, if uy = Non linear |

The resistance in direction Y

Use this property only if the uy is set Non linear

See notes for coordinates reference.

| | Stiffness Z \[MN/m2] | Double | 2.00 | yes, if uz = Flexible, Flexible compression/tension or Non linear |

The flexibility in direction Z

Use this property only if the uz is set Flexible, Flexible compression/tension or Non linear

See notes for coordinates reference.

| | Resistance Z \[MN/m] | Double | 0.75 | yes, if uz = Non linear |

The resistance in direction Z

Use this property only if the uz is set Non linear

See notes for coordinates reference.

| | Stiffness Fix \[MNm/rad/m] | Double | 5.00 | yes, if fix = Flexible or Non linear |

The flexibility in rotation around X axis

Use this property only if the Rotational stiffness fix is Flexible or Non linear

See notes for coordinates reference.

| | Resistance Fix \[MNm/m] | Double | 1.00 | yes, if fix = Non linear |

The resistance in rotation around Y axis

Use this property only if the Rotational stiffness fix is Non linear

See notes for coordinates reference.

| | Stiffness Fiy \[MNm/rad/m] | Double | 6.25 | yes, if fiy = Flexible or Non linear |

The flexibility in rotation around Y axis

Use this property only if the Rotational stiffness fiy is Flexible or Non linear

See notes for coordinates reference.

| | Resistance Fiy \[MNm/m] | Double | 0.80 | yes, if fiy = Non linear |

The resistance in rotation around Y axis

Use this property only if the Rotational stiffness fiy is Non linear

See notes for coordinates reference.

| | Stiffness Fiz \[MNm/rad/m] | Double | 3.00 | yes, if fiz = Flexible or Non linear |

The flexibility in rotation around Z axis

Use this property only if the Rotational stiffness fiz is Flexible or Non linear

See notes for coordinates reference.

| | Resistance Fiz \[MNm/m] | Double | 0.10 | yes, if fiz = Non linear |

The resistance in rotation around Z axis

Use this property only if the Rotational stiffness fiz is Non linear

See notes for coordinates reference.

| | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | ## Notes {% hint style="info" %} Local coordination system is given by first node and its related object. **Non linear** behavior of material is handled with "Resistance". The example is shown below. {% endhint %} ![](/files/swtPTNBLvjSEmvw60M2O) # StructuralLoadGroup ## Load group Load groups define "how the individual load cases may be combined together" if inserted into a load case combination. Thanks to the load groups, the user can easily specify which load cases MUST, MUST NOT, or CAN act together. Each load group may be used either for permanent loads or for variable loads. Permanent and variable loads cannot appear in the same group. ### Specification in the excel | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------- | ------------ | :---------------------------------------------------------------------------------------------------------: | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | LG1 | yes | Human readable unique name of the object | | Load group type | Enum |

Permanent

Variable

Accidental

Seismic

Moving

Tensioning

Fire

| yes |

This parameters tell whether the load group is used for permanent or variable loads.

Applicable Load group types for:

Permanent load case: Permanent

Variable load case: Variable, Seismic, Moving, Tensioning, Fire

Accidental load case: Accidental

| | Relation | Enum |

Exclusive

Standard

Together

| yes |

The relation tells what the relation of load cases in the particular load group is.

Exclusive: Two load cases from the same load group of this type will never appear in the same combination.
Applicable for Load group types: Variable, Accidental, Seismic, Moving, Tensioning, Fire

Standard: It allows the user to sort load cases but it does not affect the process of generation of load case combinations.

Applicable for Load group types: All

Together: All load cases in the same load group of this type are always inserted into every new load case combination

Applicable for Load group types: Permanent

| | Load type | String | Domestic | yes, if Load group type = Variable |

Define type of variable load, E.g. Domestic,

Offices,

Congregation,

Shopping,

Storage,

Vehicle < 30kN,

Vehicle > 30kN,

Roofs,

Snow,

Wind,

Temperature

| | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | # StructuralLoadCase ## Load case Individual loads are not defined "freely". They must be included in load cases. A load case is a group, commonly used to group loads from the same action source. The load cases correspond with the professional terminology specified in national technical standards dealing with loads of civil engineering structures. The application of load cases follows the load management procedures that are usual and also obligatory in civil engineering practice. ### Specification in the excel | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------- | ------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Name | String | LC1 | yes | Human readable unique name of the object | | Description | String | Offices – Cat.B | no | Description of the load case | | Action type | Enum |

Permanent

Variable

Accidental

| yes | Type of load in general. Other parameters depend on the adjustment of the load case type | | Load group | String | LG 1 | yes | Name reference to existing [StructuralLoadGroup](/loads/structuralloadgroup#load-group) object with appropriate settings of Load group type | | Load type | Enum |

Self weight

Others

Prestress

Dynamic

Static

Temperature

Wind

Snow

Maintenance

Fire

Moving

Seismic

Standard

| yes |

Define subtype of load. Depends on Action type property.

Subtypes for Permanent:

Self weight; Others ;Prestress; Standard

Use value "Self weight" only for cases of automatically generated load.

If your app is exporting self weight load as load objects, use type "Standard" and use field "Description" to carry the information it is Self weight (example: "Self weight load impulses")

Subtypes for Variable:

Others; Dynamic; Static; Temperature; Wind; Snow; Maintenance; Fire; Moving; Seismic; Standard

Subtypes for Accidental:

Others; Dynamic; Static; Temperature; Wind; Snow; Maintenance; Fire; Moving; Seismic; Standard

| | Duration | Enum |

Long

Medium


Short


Instantaneous

| yes, if Action type = Variable | For static standard loads, the duration of the load impact can be specified | | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | # StructuralLoadCombination ## Load Combination Object serves for definition a load combination. The combination is created from the existing load cases in the model, in [StructuralLoadCase](/loads/structuralloadcase#load-case) sheet. ### Specification in the excel | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------- | ------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | COM1 | yes | Human readable unique name of the object | | Description | String | varibale\_1 + dead load | no | The description of the load combination | | Category | Enum |

ULS (Ultimate Limit State)

SLS (Serviceability Limit State)

ALS (Accidental Limit State)

According national standard

Not defined

| yes | The category of the load combination | | National standard | Enum |

EN-ULS(STR/GEO) Set B

EN-ULS (STR/GEO) Set C

EN-Accidental 1

EN-Accidental 2

EN-Seismic

EN-SLS

Characteristic

EN-SLS Frequent

EN-SLS Quasi-permanent

IBC-LRFD ultimate

IBC-ASD ultimate

IBC-ASD
serviceability

IBC-ASD seismic

IBC-LRFD seismic

| Yes, If Category =According national standard | The National code application | | Load factor # | double | 1,35 | yes, If Category in not "According national standard" | Load factor of the load case. # means indexing of the Load factor column, e.g. Load factor 1, Load factor 2, … Load factor 99. It depends on how many load case is considered in combination. | | Multiplier # | double | 0,9 | yes | A multiplier for e.g. increase the selfweight of the structure . # means indexing of the Multiplier column, e.g. Multiplier 1, Multiplier 2, … Multiplier 99. It depends on how many load case is considered in combination. | | Load case name # | String | LC1 | yes | Valid name of the load case ([StructuralLoadCase](/loads/structuralloadcase#load-case)). # means indexing of the load case name column, e.g. Load case name 1, Load case name 2, … load case name 99. It depends on how many load case is considered in combination. | | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | # StructuralPointAction ## Point force Instances of StructuralPointAction define a point load applied to the node ([StructuralPointConnection](/structural-analysis-elements/structuralpointconnection#node)) and also the location of the point load on a 1D member ([StructuralCurveMember](/structural-analysis-elements/structuralcurvemember#1d-member-beam-column)). The point force can be defined in three main directions (global or local coordinate system). Every point force has to be assigned to a load case. ![](https://github.com/StructuralAnalysisFormat/StructuralAnalysisFormat-Doc/blob/backup/gitbook-2.0.0/loads/broken-reference) ### Specification in the excel | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------- | ------------ | :---------------------------------------------------------------------------------------------------------------------------------------------: | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | F3 | yes | Human readable unique name of the force | | Type | String | Standard | no | This property defines what the load is caused by, E.g. Standard, Wind, Snow, Self weight, Hoar Frost, Predefined, Plane Load, Water Pond, Water Pressure, Soil Pressure, Generated Water, Generated Soil | | Direction | Enum |

X

Y

Z

Vector

| yes |

Specifies the base direction of the load

X, Y, Z - action will be applied in one of these directions

Vector - size and direction calculated from vector

| | Force action | Enum |

On beam

In node

| yes | Specifies on which type of object the force acts | | Reference node | String | N3 | yes, if Force action = In node | The name of the reference node | | Reference member | String | B1 | yes, if Force action = On beam | The name of the reference member | | Value \[kN] | Double | -150 | yes, if Direction = X,Y or Z | Specifies the size of the load in, acts in one direction | | Vector (X;Y;Z) \[kN] | String | (10;10;0) | yes, if Direction = Vector | Specifies the size of the load in , direction by vector | | Load case | String | LC2 | yes | The name of the load case to which the force belongs | | Coordinate system | Enum |

Global

Local

| yes |

Defines the co-ordinate system of the member in which the load is applied

For " Local", coordinate system is defined by node or 1D member

| | Origin | Enum |

From start

From end

| yes, if Force action = On beam | Specifies where the origin for the position co-ordinate measurement is | | Coordinate definition | Enum |

Absolute

Relative

| yes, if Force action = On beam | Specifies the definition of the position. It may be absolute or relative | | Position x \[m] | Double |

value in meters for Coordinate definition = Absolute

5,25

value in percentage for Coordinate definition = Relative

1,0

| yes, if Force action = On beam | Defines the position of the load on the 1D member in local coordinate system in relative or in absolute coordinates \[m] | | Repeat (n) | Integer | 0 | yes, if Force action = On beam | Defines the number of forces acting on the beam. If the number is greater than 1, the forces are distributed uniformly over the 1D member | | Delta x \[m] | Double | 0,3 | yes, if Repeat (n) > 1 |

Defines the distance between forces acting on the 1D member in relative or in absolute coordinates \[m]

(only applicable when ForceAction = OnBeam)

| | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | ## Notes {% hint style="info" %} An example of use of Repeat (n) is given below. The forces are distributed uniformly meaning that the value Delta x is used for uniform distribution along the 1D member for multiple point forces. {% endhint %} ![](/files/NCFxYoT3ZqYDkobBbwx6) # StructuralPointMoment ## Moment force in node/on beam A node or a beam of the structure may be subject to a moment load. The load is defined by the direction and size of the moment and in case of the moment force on beam it can be repeated along the member. ![](/files/OWXHMREtKkJM6eGGGIGO) ### Specification in the excel | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------- | ------------ | :---------------------------------------------------------------------------------------------------------------------------------------------: | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | PF3 | yes | Human readable unique name of the force | | Type | String | Standard | no | This property defines what the load is caused by, E.g. Standard, Wind, Snow, Self weight, Hoar Frost, Predefined, Plane Load, Water Pond, Water Pressure, Soil Pressure, Generated Water, Generated Soil | | Direction | Enum |

Mx

My

Mz

| yes | Specifies the base direction of the load | | Force action | Enum |

On beam

In node

| yes | Specifies on which type of object the force acts | | Reference node | String | N3 | yes if Force action = In node | The name of the reference node | | Reference member | String | B1 | yes if Force action =On beam | The name of the reference beam | | Value \[kNm] | Double | -10 | yes | Specifies the size of the load in kiloNewtonmeters. | | Load case | String | LC5 | yes | The name of the load case to which the force belongs | | Coordinate system | Enum |

Global

Local

| yes | Defines co-ordinate system in which the load is applied | | Origin | Enum |

From start

From end

| yes, if Force action = On beam | Specifies where the origin for the position co-ordinate measurement is | | Coordinate definition | Enum |

Absolute

Relative

| yes, if Force action = On beam | Specifies the definition of the position. It may be absolute or relative | | Position x \[m] | Double |

value in meters for Coordinate definition = Absolute

5,25

value in percentage for Coordinate definition = Relative

1,0

| yes, if Force action = On beam | Defines the position of the load on the 1D member in local coordinate system in relative or in absolute coordinates \[m] | | Repeat (n) | Integer | 1 | yes, if Force action = On beam | Defines the number of forces acting on the beam. If the number is greater than 1, the forces are distributed uniformly over the 1D member | | Delta x \[m] | Double | 0,3 | yes, if Repeat (n) > 1 |

Defines the distance between forces acting on the 1D member in relative or in absolute coordinates \[m]

(only applicable when ForceAction=OnBeam)

| | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | # StructuralCurveAction ## Line force on the beam The Line force load models load distributed over a 1D member or on a slab edge. It may be action along the whole 1D member or only on its part. It can be constant or trapezoidal, acting in three main directions X, Y, Z (global or local coordinate system). ![](/files/J2eCx0HgaEZLYAWDtPfv) | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------- | ------------ | :---------------------------------------------------------------------------------------------------------------------------------------------: | -------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | F3 | yes | Human readable unique name of the force | | Type | String | Standard | no | This property defines what the load is caused by, E.g. Standard, Wind, Snow, Self weight, Hoar Frost, Predefined, Plane Load, Water Pond, Water Pressure, Soil Pressure, Generated Water, Generated Soil | | Force action | Enum |

On beam

On edge

On subregion edge

On opening edge

On rib

| yes | Specifies on which type of object the force acts | | Distribution | Enum |

Uniform

Trapez

| yes | The load may be either constant along the 1D member or linearly variable (trapezoidal). | | Direction | Enum |

X

Y

Z

Vector

| yes |

Specifies the base direction of the load

X, Y, Z - action will be applied in one of these directions

Vector - size and direction calculated from vector

| | Value 1 \[kN/m] | Double | -150 | yes, if Direction = X,Y or Z |

Specifies the first size of the load in, acts in one direction

Value1 is always closer to origin (see notes)

| | Value 2 \[kN/m] | Double | -180 |

yes, if Direction = X,Y or Z

yes, if Distribution = Trapez

|

Specifies the second size of the load in, acts in one direction

Value2 is always further from origin (see notes)

| | Vector 1(X;Y;Z) \[kN/m] | String | (10;10;0) | yes, if Direction = Vector |

Specifies the first size of the load in, direction by vector

Note: Vector1 and Vector2 needs to be in same direction

| | Vector 2(X;Y;Z) \[kN/m] | String | (20;20;0) |

yes, if Direction = Vector

yes, if Dsitribution = Trapez

|

Specifies the second size of the load in, direction by vector

Note: Vector1 and Vector2 needs to be in same direction

| | Member | String | B11 | yes, if Force action = On beam | The name of the [StructuralCurveMember](https://saf.guide/Content/A_Objects/7_StructuralCurveMember.htm) on which the load is applied | | Member Rib | String | B11 | yes, if Force action = On rib | The name of the [StructuralCurveMemberRib](https://saf.guide/Content/A_Objects/25_StructuralCurveMemberRib.htm) on which the load is applied | | 2D Member | String | S1 | yes, if Force action = On edge |

The name of the StructuralSurfaceMember which the load is applied.
StructuralCurveAction can act either on a 2D member edge or on internal edge.

| | 2D Member Region | String | R1 | yes, if Force action = On subregion edge | The name of the [StructuralSurfaceMemberRegion](/structural-analysis-elements/structuralsurfacememberregion) on which is the load applied. | | 2D Member Opening | String | O1 | yes, if Force action = On opening edge | The name of the [StructuralSurfaceMemberOpening](/structural-analysis-elements/structuralsurfacememberopening) on which is the load applied. | | Edge | Integer | 1 | yes, if Force action acts on edge of 2D Member edge or 2D member region or 2D member opening | The index starting with 1. The order is according to order of “edges” property at [StructuralSurfaceMember](/structural-analysis-elements/structuralsurfacemember), [StructuralSurfaceMemberRegion](/structural-analysis-elements/structuralsurfacememberregion) or [StructuralSurfaceMemberOpening](/structural-analysis-elements/structuralsurfacememberopening) on which the load is applied | | Internal edge | String | ES2 | yes, if Force action = On edge | The name of the [StructuralCurveEdge](https://saf.guide/Content/A_Objects/6_StructuralCurveEdge.htm) on which is the load applied. [StructuralCurveAction](https://saf.guide/Content/A_Objects/19_StructuralCurveAction.htm#) can act either on a 2D member edge or on internal edge. | | Load case | String | LC1 | yes | The name of the load case to which the force belongs | | Coordinate system | Enum |

Global

Local

| yes |

Defines the co-ordinate system of the member in which the load is applied

For " Local", coordinate system is defined by the member where is load applied

| | Location | Enum |

Length

Projection

| yes | Specifies whether the load is "put directly on an inclined 1D member" or whether the "projection on plan" is defined. | | Coordinate definition | Enum |

Absolute

Relative

| yes | Selects the coordinate system that is used to define the length of the line load. Relative means without units. To define length of the load in meters input absolute | | Origin | Enum |

From start

From end

| yes | Specifies the origin of the coordinate system used for the definition of the length of the force | | Extent | Enum |

Full

Span

| yes | Defines if a load is extended just over a span instead of the whole 1D member, it is used if a 1D member consists of more than one span. This feature is not fully supported, only two spans are supported in the moment. | | Start point \[m] | Double |

value in meters for Coordinate definition = Absolute

0,0

value in percentage for Coordinate definition = Relative

0,0

| yes | Defines the position of the start point of the force in relative or absolute coordinates \[m] | | End point \[m] | Double |

value in meters for Coordinate definition = Absolute

5,25

value in percentage for Coordinate definition = Relative

1,0

| yes | Defines the position of the end point of the force in relative or absolute coordinates \[m] | | Eccentricity ey \[mm] | Double | -150 | yes | Eccentricity of the force system line in Y direction of the local coordinate system | | Eccentricity ez \[mm] | Double | 75 | yes | Eccentricity of the force system line in Z direction of the local coordinate system | | Parent ID | String | 67b35d84-3d04-47aa-aa4a-dc1263982320 | no |

Is filled for objects created be dividing curved geometry to series of straight line objects.

Parent ID will ensure that curved edge is imported as straight parts to nonsupporting application, and back to original supporting application as curved geometry.

To ensure successful round trip of segmented objects and their related objects, Parent ID needs to be present in both directions.

| | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | ## Notes {% hint style="info" %} Difference between Location type Length and Projection can be seen in the picture. Location is used only if Coordinate system is Global. {% endhint %} ![](/files/iULIMFL16y5w0YNDjdA7) {% hint style="info" %} An example of use of parameter Extent is in the in the picture below. In case of Span the load acts only on the span which is defined by internal nodes {% endhint %} ![](/files/yY81OSFFAHvXejYtYf8z) {% hint style="info" %} An example with Distribution type Trapez and with different values 1 and 2 can be seen in the following picture. Coordinate definition is relative, start point 0 and end point 0,3. StructuralCurveAction 1 has origin "From start" and StructuralCurveAction 2 has origin "From end". In this case the parameter extent doesn’t make any difference, only in case of beams consisting of more parts. {% endhint %} ![](/files/huh598jLfunzBBjOjkww) # StructuralCurveMoment ## Line Moment on the beam The Line moment load models load distributed over a 1D member ([StructuralCurveMember](/structural-analysis-elements/structuralcurvemember#1d-member-beam-column)), 1D member Rib ([StructuralCurveMemberRib](/structural-analysis-elements/structuralcurvememberrib#2d-member-rib)) or on a slab edge ([StructuralSurfaceMember](/structural-analysis-elements/structuralsurfacemember#2d-member-plate-wall)). It may be action along the whole 1D member or only on its part. It can be constant or trapezoidal, acting in three main directions X, Y, Z (global or local coordinate system). ### Specification in the excel | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------- | ------------ | :---------------------------------------------------------------------------------------------------------------------------------------------: | -------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | LMS1 | yes | Human readable unique name of the force | | Type | String | Standard | no | This property defines what the load is caused by, E.g. Standard, Wind, Snow, Self weight, Hoar Frost, Predefined, Plane Load, Water Pond, Water Pressure, Soil Pressure, Generated Water, Generated Soil | | Force action | Enum |

On beam

On edge

On subregion

edge

On opening edge

On rib

| yes | Specifies on which type of object the force acts | | Distribution | Enum |

Uniform

Trapez

| yes | The line moment may be either constant along the 1D member or linearly variable (trapezoidal). | | Direction | Enum |

Mx

My

Mz

| yes | Specifies the base direction of the load | | Value 1 \[kNm/m] | Double | -150 | yes |

Specifies the first size of the moment in kilonewton meters per meter

Value1 is always closer to origin (see notes)

| | Value 2 \[kNm/m] | Double | -180 | yes |

Specifies the second size of the load in kilonewton meters per meter

Value1 is always further from origin (see notes)

| | Member | String | B11 | yes, if Force action = On beam | The name of the [StructuralCurveMember](/structural-analysis-elements/structuralcurvemember#1d-member-beam-column) on which the load is applied | | Member Rib | String | B11 | yes, if Force action = On rib | The name of the [StructuralCurveMemberRib](/structural-analysis-elements/structuralcurvememberrib#2d-member-rib) on which the load is applied | | 2D Member | String | S1 |

yes, if Force action = On edge

| The name of the [StructuralSurfaceMember](/structural-analysis-elements/structuralsurfacemember#2d-member-plate-wall) on which the load is applied. [StructuralCurveAction](/loads/structuralcurveaction#line-force-on-the-beam) can act either on a 2D member edge or on internal edge. | | 2D Member Region | String | R1 | yes, if Force action = On subregion edge | The name of the [StructuralSurfaceMemberRegion ](/structural-analysis-elements/structuralsurfacememberregion)on which is the load applied. | | 2D Member Opening | String | O1 | yes, if Force action = On opening edge | The name of the [StructuralSurfaceMemberOpening](/structural-analysis-elements/structuralsurfacememberopening) on which is the load applied. | | Edge | Integer | 1 | yes, if Force action acts on edge of 2D Member edge or 2D member region or 2D member opening | The index starting with 1. The order is according to order of “edges” property at [StructuralSurfaceMember](/structural-analysis-elements/structuralsurfacemember#2d-member-plate-wall), [StructuralSurfaceMemberRegion](/structural-analysis-elements/structuralsurfacememberregion) or [StructuralSurfaceMemberOpening](/structural-analysis-elements/structuralsurfacememberopening) on which the load is applied | | Internal edge | String | ES2 | yes, if Force action = On edge | The name of the [StructuralCurveEdge](/structural-analysis-elements/structuralcurveedge#internal-edge) on which is the load applied. StructuralCurveMoment can act either on a 2D member edge or on internal edge. | | Load case | String | LC1 | yes | The name of the load case to which the force belongs | | Coordinate system | Enum |

Global

Local

| yes | Defines the co-ordinate system of the member in which the load is applied | | Location | Enum |

Length

Projection

| yes | Specifies whether the load is "put directly on an inclined 1D member" or whether the "projection on plan" is defined. | | Coordinate definition | Enum |

Absolute

Relative

| yes | Selects the coordinate system that is used to define the length of the line load. Relative means without units. To define length of the load in meters input absolute | | Origin | Enum |

From start

From end

| yes | Specifies the origin of the coordinate system used for the definition of the length of the force | | Extent | Enum |

Full

Span

| yes | Defines if a load is extended just over a span instead of the whole 1D member, it is used if a 1D member consists of more than one span. This feature is not fully supported, only two spans are supported in the moment. | | Start point \[m] | Double |

value in meters for Coordinate definition = Absolute

0,0

value in percentage for Coordinate definition = Relative

0,0

| yes | Defines the position of the start point of the moment in relative or absolute coordinates \[m] | | End point \[m] | Double |

value in meters for Coordinate definition = Absolute

5,25

value in percentage for Coordinate definition = Relative

1,0

| yes | Defines the position of the end point of the moment in relative or absolute coordinates \[m] | | Parent ID | String | 67b35d84-3d04-47aa-aa4a-dc1263982320 | no |

Is filled for objects created be dividing curved geometry to series of straight line objects.

Parent ID will ensure that curved edge is imported as straight parts to nonsupporting application, and back to original supporting application as curved geometry.

To ensure successful round trip of segmented objects and their related objects, Parent ID needs to be present in both directions.

| | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | ## Notes {% hint style="info" %} Difference between Location type Length and Projection can be seen in the picture. Location is used only if Coordinate system is Global. {% endhint %} ![](/files/iULIMFL16y5w0YNDjdA7) {% hint style="info" %} An example of use of parameter Extent is in the in the picture below. In case of Span the load acts only on the span which is defined by internal nodes {% endhint %} ![](/files/yY81OSFFAHvXejYtYf8z) {% hint style="info" %} An example with Distribution type Trapez and with different values 1 and 2 can be seen in the following picture. Coordinate definition is relative, start point 0 and end point 0,3. StructuralCurveAction 1 has origin "From start" and StructuralCurveAction 2 has origin "From end". In this case the parameter extent doesn’t make any difference, only in case of beams consisting of more parts. {% endhint %} ![](/files/huh598jLfunzBBjOjkww) # StructuralSurfaceAction ## Surface load Defines actions on surfaces – plates, walls. The surface load is defined on the whole slab automatically. If only a part of the main slab is supposed to be subject to this load, a subregion ([StructuralSurfaceMemberRegion](/structural-analysis-elements/structuralsurfacememberregion#region-of-different-plate-thickness)) must be defined inside the main slab. ![](/files/tMCIk4kYOASY4MnUdRAH) ### Specification in the excel | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------- | ------------ | :---------------------------------------------------------------------------: | --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | PF3 | yes | Human readable unique name of the force | | Direction | Enum |

X

Y

Z

| yes | Specifies the base direction of the load | | Type | String | Standard | no | This property defines what the load is caused by, E.g. Standard, Wind, Snow, Self weight, Hoar Frost, Predefined, Plane Load, Water Pond, Water Pressure, Soil Pressure, Generated Water, Generated Soil | | Force action | Enum |

On 2D member

On 2D member region

On 2D member distribution

| yes | Specifies on which type of object the load acts | | Value \[kN/m2] | Double | -10 | yes | Specifies the size of the load in kiloNewtons per square meter. | | 2D Member | String | S15 | yes, if Force action = On 2D member | The name of the [StructuralSurfaceMember](https://saf.guide/Content/A_Objects/8_StructuralSurfaceMember.htm) to which is the surface load related to | | 2D Member Region | String | R1 | yes, if Force action = On 2D member region | The name of the [StructuralSurfaceMemberRegion](https://saf.guide/Content/A_Objects/10_StructuralSurfaceMemberRegion.htm) to which is the surface load related to | | 2D Member Distribution | String | FL1 | yes, if Force action = 2D Member Distribution | The name of the [StructuralSurfaceActionDistri](/loads/structuralsurfaceactiondistribution-1) to which is the surface load related to. | | Load case | String | LC5 | yes | The name of the load case to which the force belongs | | Coordinate system | Enum |

Global

Local

| yes | Defines the co-ordinate system of the member in which the load is applied | | Location | Enum |

Length

Projection

| yes | Specifies whether the load is "put directly on an inclined 2D member" or whether the "projection on plan" is defined. | | Parent ID | String | 67b35d84-3d04-47aa-aa4a-dc1263982320 | no |

Is filled for objects created be dividing curved geometry to series of straight line objects.

Parent ID will ensure that curved edge is imported as straight parts to nonsupporting application, and back to original supporting application as curved geometry.

To ensure successful round trip of segmented objects and their related objects, Parent ID needs to be present in both directions.

| | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | # StructuralSurfaceActionThermal ## Thermal load on surface elements The thermal load on the surface elements ([StructuralSurfaceMember](/structural-analysis-elements/structuralsurfacemember#2d-member-plate-wall)). The variation of the thermal load can be constant or linear over the cross-section of the beam. ### Specification in the excel | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------- | ------------ | :----------------------------------: | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | LT1 | yes | Human readable unique name of the load | | Variation | Enum |

Constant

Linear

| yes |

Specifies how the temperature varies

Constant: The load is defined by means of a single value T1. The value specifies the change in temperature of the 2D member (straight ΔT). Temperature change is constant along the cross-section.

Linear: The load is defined by means of a set of two values T1 and T2. The individual values specify the temperature at individual surfaces - top, bottom of the 2D member.

| | TempT \[°C] | Double | 18 |

yes

|

Specifies the first size of the load in Celsius/Fahrenheit.

For constant: Delta temperature on the center plane

For linear: Temperature of top surface (LCS direction +z) of 2D member

| | TempB \[°C] | Double | 18 | yes, if Variation = Linear |

Specifies the second size of the load in Celsius/Fahrenheit.

For linear: Temperature of bottom surface (LCS direction -z) of 2D member

| | 2D Member | String | S15 | yes | The name of the [StructuralSurfaceMember](/structural-analysis-elements/structuralcurvemember#1d-member-beam-column) or [StructuralSurfaceActionDistribution](/loads/structuralsurfaceactionthermal)which is the surface load related to. | | 2D Member Region | String | R1 | yes, if on region | The name of the [StructuralSurfaceMemberRegion](/structural-analysis-elements/structuralsurfacememberregion#region-of-different-plate-thickness) to which is the surface action related if it is available on 2D member. | | Load case | String | LC1 | yes | The name of the load case to which the load belongs | | Parent ID | String | 67b35d84-3d04-47aa-aa4a-dc1263982320 | no |

Is filled for objects created be dividing curved geometry to series of straight line objects.

Parent ID will ensure that curved edge is imported as straight parts to nonsupporting application, and back to original supporting application as curved geometry.

To ensure successful round trip of segmented objects and their related objects, Parent ID needs to be present in both directions.

| | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | # StructuralCurveActionThermal ## Thermal load on the beam The thermal load on the line elements ([StructuralCurveMember](/structural-analysis-elements/structuralcurvemember#1d-member-beam-column), [StructuralCurveMemberRib](/structural-analysis-elements/structuralcurvememberrib#2d-member-rib)). The variation of the thermal load can be constant or linear over the cross-section of the beam. ### Specification in the excel | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------- | ------------ | :---------------------------------------------------------------------------------------------------------------------------------------------: | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | LT1 | yes | Human readable unique name of the load | | Force action | Enum |

On beam

On rib

| yes | Specifies on which type of object the load acts. | | Variation | Enum |

Constant

Linear

| yes |

Specifies how the temperature varies

Constant: The load is defined by means of a single value deltaT. The value specifies the warming to which the 1D member is subject to.

Linear: The load is defined by means of a set of four values. The individual values specify the temperature at individual sides (left, right, top, bottom) of the 1D member.

| | deltaT \[°C] | Double | 5 | yes; if Variation = Constant |

Temperature delta in Celsius/Fahrenheit on the centre line of the member.

\*See note to clarify the position.

| | TempL \[°C] | Double | 5 | yes, if Variation = Linear |

The temperature on the left side of the beam surface in Celsius/Fahrenheit. Refers to LCS of 1D member.

\*See note to clarify the position.

| | TempR \[°C] | Double | 18 | yes, if Variation = Linear |

Temperature on right side of the beam surface in Celsius/Fahrenheit. Refers to LCS of 1D member.

\*See note to clarify the position.

| | TempT \[°C] | Double | 5 | yes, if Variation = Linear |

Temperature on top side of the beam surface in Celsius/Fahrenheit. Refers to LCS of 1D member.

\*See note to clarify the position.

| | TempB \[°C] | Double | 5 | yes, if Variation = Linear |

Temperature on bottom side of the beam surface in Celsius/Fahrenheit. Refers to LCS of 1D member.

\*See note to clarify the position.

| | Member | String | B11 | yes, if Force action = On beam | The name of the [StructuralCurveMember](/structural-analysis-elements/structuralcurvemember#1d-member-beam-column) on which the load is applied | | Member Rib | String | B10 | yes, if Force action = On rib | The name of the [StructuralCurveMemberRib](/structural-analysis-elements/structuralcurvememberrib#2d-member-rib) on which the load is applied | | Load case | String | LC1 | yes | The name of the load case to which the load belongs | | Coordinate definition | Enum |

Absolute

Relative

| yes | Selects the coordinate system that is used to define the length of the line load. Relative means without units. To define length of the load in meters input absolute | | Origin | Enum |

From start

From end

| yes | Specifies the origin of the coordinate system used for the definition of the length of the load | | Start point \[m] | Double |

value in meters for Coordinate definition = Absolute

0,0

value in percentage for Coordinate definition = Relative

0,0

| yes | Defines the position of the start point of the load in relative or absolute coordinates | | End point \[m] | Double |

value in meters for Coordinate definition = Absolute

5,25

value in percentage for Coordinate definition = Relative

1,0

| yes | Defines the position of the end point of the load in relative or absolute coordinates | | Parent ID | String | 67b35d84-3d04-47aa-aa4a-dc1263982320 | no |

Is filled for objects created be dividing curved geometry to series of straight line objects.

Parent ID will ensure that curved edge is imported as straight parts to nonsupporting application, and back to original supporting application as curved geometry.

To ensure successful round trip of segmented objects and their related objects, Parent ID needs to be present in both directions.

| | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | ## Notes {% hint style="info" %} Reference to surfaces of cross-section where linear temperature can be applied. View is towards the direction of center axis (looking from end point towards start point). {% endhint %} # StructuralPointActionFree ## Free point load The Free point load is related to slabs. The load is not defined by the entity it acts on, but by a specific load point. Free loads are defined by means of "loading entities" that may overlap or affect one or more slabs. ![](/files/nrJUnanGFYX0uxOzCVYr) ### Specification in the excel | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------- | ------------ | :-----------------------------------: | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | FF1 | yes | Human readable unique name of the force | | Type | String | Standard | no | This property defines what the load is caused by, E.g. Standard, Wind, Snow, Self weight, Hoar Frost, Predefined, Plane Load, Water Pond, Water Pressure, Soil Pressure, Generated Water, Generated Soil | | Direction | Enum |

X

Y

Z

Vector

| yes |

Specifies the base direction of the load

X, Y, Z - action will be applied in one of these directions

Vector - size and direction calculated from vector

| | Value \[kN] | Double | -1 | yes, if Direction = X,Y or Z | Specifies the size of the load | | Vector (X;Y;Z) \[kN] | String | (10;10;0) | yes, if Direction = Vector | Specifies the size of the load in , direction by vector | | Load case | String | LC2 | yes | The name of the load case to which the force belongs | | Coordinate X \[m] | Double | -1,000 | yes | The X coordinate of the point force | | Coordinate Y \[m] | Double | 1,000 | yes | The Y coordinate of the point force | | Coordinate Z \[m] | Double | 3,250 | yes | The Z coordinate of the point force | | Coordinate system | String | Global | yes | Defines the co-ordinate system of the member in which the load is applied. Only global coordinate system is supported for free point loads | | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | # StructuralCurveActionFree ## Free line force The Free line load is related to slabs. The load is not defined by the entity it acts on, but by a specific load border. Free loads are defined by means of "loading entities" that may overlap or affect one or more slabs. ![](/files/PNQqH8TzK0HJvLMi8FeZ) ### Specification in the excel: | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------- | ------------ | :-----------------------------------------------: | ----------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | LF5 | yes | Human readable unique name of the force | | Type | String | Standard | no | This property defines what the load is caused by, E.g. Standard, Wind, Snow, Self weight, Hoar Frost, Predefined, Plane Load, Water Pond, Water Pressure, Soil Pressure, Generated Water, Generated Soil | | Distribution | Enum |

Uniform

Trapez

| yes | The load may be either constant along its length or linearly variable (trapezoidal). | | Direction | Enum |

X

Y

Z

Vector

| yes |

Specifies the base direction of the load

X, Y, Z - action will be applied in one of these directions

Vector - size and direction calculated from vector

| | Value 1 \[kN/m] | Double | -150 | yes, if Direction = X,Y or Z | Specifies the first size of the load in kiloNewtons per meter | | Value 2 \[kN/m] | Double | -180 |

yes, if Direction = X,Y or Z

yes, if Dsitribution = Trapez

| Specifies the second size of the load in kiloNewtons per meter | | Vector 1(X;Y;Z) \[kN/m] | String | (10;10;0) | yes, if Direction = Vector |

Specifies the first size of the load in, direction by vector

Note: Vector1 and Vector2 needs to be in same direction

| | Vector 2(X;Y;Z) \[kN/m] | String | (20;20;0) |

yes, if Direction = Vector

yes, if Dsitribution = Trapez

|

Specifies the second size of the load in, direction by vector

Note: Vector1 and Vector2 needs to be in same direction

| | Load case | String | LC1 | yes | The name of the load case to which the force belongs | | Coordinate X \[m] | String | 0.000; 2.050; 4.850; -2.000 | yes | The list of X coordinates of the nodes which define the geometry of the line free load. Each coordinate is separated by semicolon and space. | | Coordinate Y \[m] | String | 0.500; 1.050; 2.650; -1.500 | yes | The list of Y coordinates of the nodes which define the geometry of the line free load. Each coordinate is separated by semicolon and space. | | Coordinate Z \[m] | String | 0.000; 0.000; 0.000; 0.000 | yes | The list of Z coordinates of the nodes which define the geometry of the line free load. Each coordinate is separated by semicolon and space. | | Segments | String | Line; Circular Arc; Bezier; Parabolic arc; Spline | yes | List of the shape of each segment which is part of the curve, separated by semicolon if there are multiple | | Coordinate system | Enum |

Global

Local

| yes | Defines co-ordinate system of the member in which the load is applied | | Location | Enum |

Length

Projection

| yes | Specifies whether the load is "put directly on an inclined 1D member" or whether the "projection on plan" is defined. | | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | # StructuralSurfaceActionFree ## Free surface load The Free surface load is related to slabs. The load is not defined by the entity it acts on, but by a specific load border. Free loads are defined by means of "loading entities" that may overlap or affect one or more slabs. ![](/files/0qcoMVk202vaCsbkoSAl) ### Specification in the excel: | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------- | ------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | FF1 | yes | Human readable unique name of the force | | Direction | Enum |

X

Y

Z

| yes | Specifies the base direction of the load | | Type | String | Standard | no | This property defines what the load is caused by, E.g. Standard, Wind, Snow, Self weight, Hoar Frost, Predefined, Plane Load, Water Pond, Water Pressure, Soil Pressure, Generated Water, Generated Soil | | Distribution | Enum |

Uniform

DirectionX

DirectionY

DirectionXY

| yes |

The load may be either constant across the slab or linearly variable

"DirectionX" and "DirectionY" enums are defining that, the value of the surface load is linearly variable according to the one of the user-selected axis

"DirectionXY" value inclination of surface load is defined in both directions well

| | q \[kN/m2] | String |

-10

(for "Distribution" set to "Uniform")

or

C1:-5; C2:-7

(for "Distribution" set to "Direction\*")

or

C1:-3; C2:-2; C3:-1

(for "Distribution" set to "DirectionXY")

| yes |

Specifies the size of the load in kiloNewtons per square meter.

if Distribution is Direction X, Direction Y or Direction XY then the vertexes of the polygon of the free load have to be specified. For distribution Direction X and Direction Y two vertexes, for distribution in Direction XY, three vertexes. The format have to be following:

C"number of vertex of the load polygon" : "value of the load in this vertex"

The number of the vertex corresponds to the coordinate order. So the first coordinate means C1, the second C2 and so on

For further understanding of "C" attributes see notes below table

| | Load case | String | LC5 | yes | The name of the load case to which the force belongs | | Coordinate X \[m] | Double | 0.000; 2.050; 4.850; -2.000 | yes | The list of X coordinates of the nodes which define the geometry of the surface free load. Each coordinate is separated by semicolon and space. | | Coordinate Y \[m] | Double | 0.500; 1.050; 2.650; -1.500 | yes | The list of Y coordinates of the nodes which define the geometry of the surface free load. Each coordinate is separated by semicolon and space. | | Coordinate Z \[m] | Double | 0.000; 0.000; 0.000; 0.000 | yes | The list of Z coordinates of the nodes which define the geometry of the surface free load. Each coordinate is separated by semicolon and space. | | Edges | String | Line; Line; Line; Line | yes | Defines shape of the curve between two next nodes. Supported strings are: Line; Bezier; Circle arc; Parabolic arc; Spline. The names are separated by ; (semicolon) and space. | | Coordinate system | Enum |

Global

Local

| yes | Defines co-ordinate system of the member in which the load is applied | | Location | Enum |

Length

Projection

| yes | Specifies whether the load is "put directly on an inclined 2D member" or whether the "projection on plan" is defined. | | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | ## Notes {% hint style="info" %} When is "Distribution" set to "DirectionX" or "DirectionY" the system is the same, but only two C values have to be defined. When "Distribution" is set to "DirectionXY" is necessary to define 3 "C" vertexes. These Vertexes are defining projection onto slab and Value of the load as well. According to position and load value of "C" vertexes is load plane defined and every other vertex of the surface load is calculated. See example below. {% endhint %} ![](/files/SA2SV2NPcPkIKW8ZAVo3) # StructuralSurfaceActionDistri ## Load panels, Load distribution StructuralSurfaceActionDistribution object describes how surface load can be distributed to other members. ![](/files/79aDnPzQX57Xv2J9AW9c) ### Specification in the excel | Name of the column header | Type of data | Value example or enum definition | Required value | Description | | ------------------------- | ------------ | :----------------------------------------------------------------------------------------: | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | String | FL1 | yes | Human readable unique name of the Arbitrary definition | | Type | Enum |

Nodes

Edges

Beams and edges

| yes |

Defines where the load should be distributed.

Nodes - load is expected to be distributed to nodes of StructuralSurfaceActionDistribution

Edges - load is expected to be distributed to edges of StructuralSurfaceActionDistribution

Beams and edges - load is expected to be distributed to edges and specified beams of StructuralSurfaceActionDistribution

| | Nodes | String | N81; N263; N659; N660 | yes | All nodes that belongs to StructuralSurfaceActionDistribution member and defines its geometric shape. The names of the nodes are separated by ; (semicolon) and space. | | Edges | String |

Line; Line; Circular Arc; Line

or

Line;Spline-5;Line;Parabolic Arc;Line

| yes |

Defines the shape of the curve between two next nodes (or more nodes depends on edge type). Supported strings are:

  • Line
  • Circular Arc
  • Circle by 3 points
  • Circle and Point
  • Parabolic arc
  • Bezier
  • Spline-x

Where "x" number of nodes defining the spline

The names are separated by ; (semicolon) and space. It possible to also define circle geometry by using "Circle and Point" or "Circle by 3 points". In case of "Circle and point" two nodes have to be defined, centre of the circle and a point on a circle. The circle defined by two points is always horizontal.

| | Layer | String | Load panel | no | Custom created layer. The layer can thus comprise entities that have something in common (e.g. one floor, columns of one floor, columns of the same length, etc.) | | LCS Type | Enum |

x by vector

y by vector

Tilt of vector defined by point

| yes |

Defines type of the local coordinate system of the StructuralSurfaceActionDistribution. Option “Tilt of vector defined by point” allows change of orientation of the LCS to one point. For this, you have to specify coordinates of the vector.

For further understanding see Introduction

| | Coordinate X \[m] | Double | 1 | yes | Coordinate of the vector of the LCS in X direction | | Coordinate Y \[m] | Double | 0 | yes | Coordinate of the vector of the LCS in Y direction | | Coordinate Z \[m] | Double | 1,2 | yes | Coordinate of the vector of the LCS in Z direction | | LCS Rotation \[deg] | Double | 45.00 | yes |

This value defines the rotation of local axes of the StructuralSurfaceActionDistribution member.

It is angle around Z axis (axis which is perpendicular to plane) and defines distribution angle.

Positive value = anti clock wise.

| | Distribution to | Enum |

One way - X

One way - Y

Two way

| yes |

Defines how the load will be distributed.

One way - X - Load will be distributed only to members parallel with X direction (X axis of LCS)

One way - Y - Load will be distributed only to members parallel with Y direction (Y axis of LCS)

Two way - Load will be distributed equally to both directions

| | Load applied to | String | B1 ; B2 ; B3 ; B5 | no |

Allows to define the subset of loaded beams.

Taken into account only if Type = Beams and edges

If blank = all beams are loaded

| | Id | String | 39f238a5-01d0-45cf-a2eb-958170fd4f39 | no | Unique attribute designation | # Formcodes Formcode is defining the shape of cross-section and how it is oriented according to used LCS. Due to defining the formcode for CSS, exchange of SAF files between applications that are differently handling LCS is possible. {% hint style="info" %} Formcode of manufactured cross-section, together with the attribute "**LCS of cross-section**" from the sheet [Project and model specification](/getting-started/project-and-model-specifications#project) is defining the exact orientation of cross-section in the model. Formocode set to "**0**" means that receiving application won't do any action ensuring the proper positioning of CSS. {% endhint %} | Formcode number | Name | Description | Examples of corresponding profiles | Corresponding Description ID of the profile | | :-------------: | :------------------------: | :------------------------------------------------------------------------------------------------: | :--------------------------------: | -------------------------------------------------------------------------------------------------------------------------- | | 0 | - | Provisional formcode | - | not available | | 1 | I-section | Profiles symmetrical around the vertical and horizontal axes (typically I-Sections) | ![](/files/rhOebf6TU56p3e4MO4cQ) | 1, 2, 3, 4, 5, 11, 12, 13, 29, 33, 34, 35, 36, 37, 38, 39, 40, 55, 63, 64, 68, 69, 71, 72, 91, 96, 102, 105, 106, 109, 110 | | 2 | Rectangular Hollow Section | Rectangular Hollow Section | ![](/files/LKaLkxP0DCxcBFr95uD4) | 25, 27, 49, 50, 74, 75, 82, 83, 84, 85, 86, 87, 93, 94 | | 3 | Circular Hollow Section | Circular Hollow Section | ![](/files/V6uoK6JmtAiy4C0PS12u) | 20, 21, 51, 52, 53, 54,88, 89, 90, 95, 103 | | 4 | L-section | Equal and unequal L-sections | ![](/files/LcTkE1ezpcLFWSoWJ1fK) | 8, 9, 10, 16, 45, 46, 65, 73, 98, 99 | | 5 | Channel Section | Profiles symmetrical around the horizontal axes Opening oriented to the right (typically channels) | ![](/files/iCN5oqVPiEO8QzdgEBKG) | 6, 7, 15, 18, 28, 41, 42, 43, 44, 57, 62, 66, 67, 70, 76, 97, 101, 107, 108, 111, 112, 113, 114, 115, 118 | | 6 | T-section | Profiles symmetrical around vertical axes Flange at the bottom (typically T-section) | ![](/files/yOMxnJ005HTV3YU6VR52) | 23, 31, 47, 48, 77, 78, 80, 81, 92 | | 7 | Full Rectangular Section | Full Rectangular Section | ![](/files/8VqrsqWwJLemGrJlGP3w) | 14, 22, 30, 79 | | 8 | Full Circular Section | Full Circular Section | ![](/files/H1lkmgRjHU8HrKdmXLf0) | 26 | | 9 | T-section Up | Profiles symmetrical around vertical axes Flange at the top (typically T-section) | ![](/files/v5dQTpFyUnVC2qcYMsvp) | 23, 31, 47, 48, 77, 78, 80, 81, 92 | | 10 | L-section III | Equal and unequal L-sections | ![](/files/yXFyh7fBzjqGdKMoJtnr) | 8, 9, 10, 16, 45, 46, 65, 73, 98, 99 | | 11 | L-section I | Equal and unequal L-sections | ![](/files/CgaHr0tcNMZeZFe5WsQ4) | 8, 9, 10, 16, 45, 46, 65, 73, 98, 99 | | 12 | L-section IV | Equal and unequal L-sections | ![](/files/YYDNkvKO7n8AenAPAOS8) | 8, 9, 10, 16, 45, 46, 65, 73, 98, 99 | | 13 | Channel Section Left | Profiles symmetrical around the horizontal axes Opening oriented to the left (typically channels) | ![](/files/Ep6KwhtCaCIUJA4hDhIL) | 6, 7, 15, 18, 28, 41, 42, 43, 44, 57, 62, 66, 67, 70, 76, 97, 101, 107, 108, 111, 112, 113, 114, 115, 118 | | 14 | Asymmetric I-Section | I-sections symmetrical around vertical axis only (typically asymmetric I-Section) | ![](/files/gAWU3mD8WK53mAGBQSDH) | 24 | | 15 | Asymmetric I-Section Up | I-sections symmetrical around vertical axis only (typically asymmetric I-Section) | ![](/files/xtS5XRAr75N2u0t1mbyK) | 24 | | 16 | Z-section | Z-sections with equal or unequal flanges Top flange to the left | ![](/files/S2P9Sz1YeBSzBsvKgEuA) | 19, 32, 56, 100 | | 17 | Z-section Right | Z-sections with equal or unequal flanges Top flange to the right | ![](/files/5O7APtmTpwzQGdV9kwyG) | 19, 32, 56, 100 | | 18 | Omega Section | Omega sections Opening is oriented to the bottom | ![](/files/cUaAxuzSiR7Y90URws5S) | 17 | | 19 | Omega Section Down | Omega sections Opening is oriented to the top | ![](/files/X6rOL5hliqmaI50gDoyy) | 17 | | 20 | Sigma Section | Sigma sections Opening is oriented to the right Top flanges are unequal or inclined | ![](/files/GhbrfXulrLVGrhn6KnmP) | 58, 104 | | 21 | Sigma Section III | Sigma sections Opening is oriented to the left Top flanges are unequal or inclined | ![](/files/q0II47IQIKLpGZrNmUoR) | 58, 104 | | 22 | Sigma Section IV | Sigma sections Opening is oriented to the left Bottom flanges are unequal or inclined | ![](/files/EHZgXaFsJPmVCjmoMr2D) | 58, 104 | | 23 | Sigma Section I | Sigma sections Opening is oriented to the right Bottom flanges are unequal or inclined | ![](/files/2vCSXIHOualdPlOrHwF3) | 58, 104 | # Description ID of the profile The description of the cross-section List of the supported description types for rolled steel profiles: | ID | Description | | --- | ------------------------------------------------------------------------------------ | | 0 | not specified | | 1 | European I beam | | 2 | European standard beam | | 3 | European wide flange beam | | 4 | Wide flange column | | 5 | Wide flange bearing pile | | 6 | Channel with parallel flanges | | 7 | European standard channel | | 8 | Equal leg angle | | 9 | Unequal leg angle | | 10 | Leg angle | | 11 | British universal beam | | 12 | British universal column | | 13 | British universal bearing pile with wide flanges | | 14 | Wide flat bar | | 15 | Cold formed C section | | 16 | Cold formed angle | | 17 | Cold formed Omega section | | 18 | Cold formed channel section | | 19 | Cold formed Z section | | 20 | Circular hollow section | | 21 | Cold formed circular hollow section | | 22 | Flat bar | | 23 | Structural Tee cut from I shape | | 24 | Asymmetrical I section | | 25 | Rectangular hollow section | | 26 | Round bar | | 27 | Cold formed rectangular hollow section | | 28 | Channel section | | 29 | British joist | | 30 | Rail section | | 31 | Tee shape | | 32 | Z section | | 33 | American wide flange beam - metric naming convention | | 34 | American wide flange beam - imperial naming convention | | 35 | American miscellaneous beam - metric naming convention | | 36 | American miscellaneous beam - imperial naming convention | | 37 | American bearing pile - metric naming convention | | 38 | American bearing pile - imperial naming convention | | 39 | American standard beam - metric naming convention | | 40 | American standard beam - imperial naming convention | | 41 | American standard channel - metric naming convention | | 42 | American standard channel - imperial naming convention | | 43 | American miscellaneous channel - metric naming convention | | 44 | American miscellaneous channel - imperial naming convention | | 45 | American single angle - metric naming convention | | 46 | American single angle - imperial naming convention | | 47 | American structural Tee cut from I shape - metric naming convention | | 48 | American structural Tee cut from I shape - imperial naming convention | | 49 | American rectangular & square hollow structural section - metric naming convention | | 50 | American rectangular & square hollow structural section - imperial naming convention | | 51 | American round hollow structural section - metric naming convention | | 52 | American round hollow structural section - imperial naming convention | | 53 | American steel pipe - metric naming convention | | 54 | American steel pipe - imperial naming convention | | 55 | Japanese H section | | 56 | Cold formed ZED section | | 57 | Cold formed Sigma section | | 58 | Cold formed section - eave beam | | 59 | Integrated floor beam | | 60 | Slim floor Beam | | 61 | Top hat beam | | 62 | Indian Standard Light weight Channels | | 63 | Indian Standard Column Sections | | 64 | Indian Standard Wide flange Beams | | 65 | Indian standard Unequal Leg angles | | 66 | Indian Standard Medium weight Parallel flange Channels | | 67 | Indian Standard Medium weight Channels | | 68 | Indian Standard Medium weight Beams | | 69 | Indian Standard Light weight Beams | | 70 | Indian Standard Junior Channels | | 71 | Indian Standard Junior Beams | | 72 | Indian Standard Heavy Weight Beams | | 73 | Indian Standard Equal Angles | | 74 | Cold formed square and rectangular hollow section | | 75 | Square and rectangular hollow section | | 76 | Channel section with inclined flanges | | 77 | T section with high web | | 78 | T section with wide flange | | 79 | Square bar | | 80 | Structural Tee cut from universal beam | | 81 | Structural Tee cut from universal column | | 82 | Jumbo355 Square hollow section | | 83 | Celsius355 Square hollow section | | 84 | Hybox355 Cold formed Square hollow section | | 85 | Jumbo355 Rectangular hollow section | | 86 | Celsius355 Rectangular hollow section | | 87 | Hybox355 Cold formed Rectangular hollow section | | 88 | Jumbo355 Circular hollow section | | 89 | Celsius355 Circular hollow section | | 90 | Hybox355 Cold formed Circular hollow section | | 91 | Chinese H-shape | | 92 | Chinese Cut T-section | | 93 | Chinese Cold formed Square pipe | | 94 | Chinese Cold formed Rectangular tube | | 95 | Chinese Cold formed Round pipe | | 96 | Chinese I-beam | | 97 | Chinese Channel steel | | 98 | Chinese Equal leg angle steel | | 99 | Chinese Unequal leg angle steel | | 100 | ICEC Z Purlin | | 101 | ICEC C Purlin | | 102 | Brazilian I and H section | | 103 | Celsius Large Circular hollow section | | 104 | Cold formed Asymmetric Sigma section | | 105 | Cold formed I-plus section | | 106 | Cold formed IS-plus section | | 107 | SSMA Stud - Cold formed C section with lips | | 108 | SSMA Track - Cold formed C section without lips | | 109 | European extra wide flange beam | | 110 | Russian hot rolled beam | | 111 | British parallel flange channel | | 112 | British channel with taper flanges | | 113 | Cold formed section METfloor | | 114 | Cold formed channel section METframe | | 115 | Cold formed C section METframe | | 116 | Virtual Joist | | 117 | Virtual Joist Girder | | 118 | Cold formed Sigma+ section | # Supported shapes of parametric cross-section {% hint style="info" %} Examples below are presented for "**LCS of cross-section**" set as **ZYX** in the sheet [Project and model specification](/getting-started/project-and-model-specifications#project). For the other types, adjust the axis of the coordinate system of cross-section to the defined value of "**LCS of cross-section**" . {% endhint %} | Pattern | Shape | Parameters \[mm] | | :------------------------------: | :------------------------------: | ------------------------------ | | ![](/files/J7U1PcJG1NqYjAiMXQqh) | Circle | D | | ![](/files/YlakEUQon122il7eoRox) | Rectangle | H; B | | ![](/files/n4riXJ3x3a7L5AYrrVxw) | Double rectangle | tha; Ba; a | | ![](/files/lSJukYEIjJtl6YV62OC5) | Triple rectangle | tha; Ba; a | | ![](/files/wUxPiGsfmakaoydSzh6d) | Rectangle with plates | tha; Ba; thb; Bb | | ![](/files/37Ir2RZEMbptBmlHk8Lf) | Double rectangle with plates | Ba; ha; Bb; hb | | ![](/files/ktZQoHdoseTMjDn4xqeL) | I Section | H; Bh; Bs; ts; th; s | | ![](/files/txqLvvoxVolvUGQrbdLZ) | I Section with haunch | H; B; ta; s; ts; th | | ![](/files/m3lclhtnTOQNlYNYWdz4) | I Section with haunch Asymmetric | H; Bt; tt; tth; Bb; tb; tbh; s | | ![](/files/HHnexBYD1gg5J8Z5kGWg) | T Section | H; B; th; sh | | ![](/files/QXan7Gh0yT5tJ5NwGYOs) | T Section with haunch | H; Bh; Bs; Bw; th | | ![](/files/NGJdwf4eVgpAs2DTVS8O) | C Section | A; tha1; tha2; B; thb1; thb2 | | ![](/files/SRbv1HRjZhoZRy1J4oJ0) | L Section | H; B; th; sh | | ![](/files/bIBFvryDFoL3yjRgih8R) | L Section opposite | H; B; th; sh | | ![](/files/n4ZQ2IX2NSdr5lzlSxRN) | U Section | H; B; th; sh | | ![](/files/tFMzeniLbMfchcLwpU0u) | Oval | H; B | | ![](/files/WdP2UQTyKswu4IcFPtFP) | Pipe | D; t | | ![](/files/i3dg5Q68lPkYfjhpKG4Y) | Polygon | R; n | | ![](/files/dfFQKEOb3EVUn1HXDoRt) | Trapezoid | H; Bh; Bs | | ![](/files/4meWMWx3e9ubAnuJtwAH) | X Section | A; tha; B; thb | | ![](/files/69zFlwhKXKcIMulMh904) | Z Section | A; tha; B; thb1; thb2; C | | ![](/files/RvOa8FqjGOHHvWkMAEAK) | Box | A; tha; B; thb1; thb2 | | ![](/files/tlQedfGb0Cle9b4BFfe2) | Double box | Ba; ha; Bb; hb | | ![](/files/u38y4ylz2d4VUuO37vBA) | I rolled | H; B; t; s; R | | ![](/files/zOofaAVpUuaOAFVvRfTN) | I rolled asymmetric | H; s; Bt; Bb; tt; tb; R | | ![](/files/ANxL3dvwz0Nf3Hii7zEZ) | Tube | H; B; s; R; r1 | | ![](/files/08opkY0nKyh5dNaUV7F0) | Angle | H; B; t; R; R1 | | ![](/files/UmUnk4DzmH1Mg551MIhX) | Channel | H; B; t; s; R | | ![](/files/oRJclgMhFCBMslv9s5lp) | T tee | H; B; t; s; R | | ![](/files/6m9exRe9wHhjU4RiNwWG) | Z zee | H; B; t; s; R; R1 | | ![](/files/hpbXQnCU6rVoKN0Vosz1) | Cold formed Channel | H; B; s; r | | ![](/files/Sp24yHOcMS6syuZcqhfB) | Cold formed Channel with lips | H; B; s; r; c | | ![](/files/F4oxp1XWGt6DuzyKmNFS) | Cold formed Zee | H; B; s; r | # Supported shapes of compound section | Pattern | Shape | Parameters \[mm] | | -------------------------------- | ------------------------------------------------------------------- | ---------------- | | ![](/files/XNVYqkvMtbcrrlfhKwAC) | Double I section | a | | ![](/files/unjUpSk43Anyn0A5zw49) |

Double Channel FtF

(face to face position)

| a | | ![](/files/X4531dXQOSdGyNaUpQ5j) |

Double Channel BtB

(back to back position)

| a | | ![](/files/d59WKEz4jV8TIhU5O5CJ) |

Starred Angle

(diagonal position)

| a | | ![](/files/f5sZ8tHyF8fGJXefNvCZ) |

Double Angle BtB

(back to back position)

| a | | ![](/files/SmbooBHOcoMP5IGOy4e0) |

Double Angle FtF

(face to face position)

| a | | ![](/files/koKaexHDyLS6Uv79p1bF) |

Double Angle BtB LL

(long leg - back to back position)

| a | | ![](/files/YiZXUJH9TIdjvBqXNmIl) |

Double Angle FtF LL

(long leg - face to face position)

| a | | ![](/files/2nhVvZnjjKOa81UJFAbT) |

Four Angle BtB

(back to back position)

| a; b | | ![](/files/1GaG1PDCqgSDafKjzZ25) |

Four Angle FtF

(face to face position)

| a; b | | ![](/files/Tk1upvf1nSkuv653O6Og) | Four Angle I | a; b | | ![](/files/zoDdMQedZFywd0XQqg6c) | Double pipe | a | # Supported design properties of the materials ## Steel Specific Material Properties | Index | Design property | Unit | Description | | ----- | --------------- | ---- | -------------------------------------------------------------------------------------- | | 1 | fy | Mpa | Yield strength | | 2 | fu | Mpa | Ultimate strength | | 3 | fu(minimum) | MPa | The specified minimum tensile strength | | 4 | Ry | - | The ratio of the expected yield stress to the specified minimum yield stress | | 5 | Rt | - | value used to calculate the expected tensile strength for the seismic detailing checks | ## Concrete Specific Material Properties | Index | Design property | Unit | Description | | ----- | --------------- | ---- | ----------------------------------------------------------------------- | | 6 | fck | Mpa | Characteristic compressive cylinder strength | | 7 | fcm | Mpa | Mean compressive strength | | 8 | fctm | Mpa | Mean tensile strength | | 9 | fctk 05 | Mpa | Five percent quantile of tensile strength | | 10 | fctk 95 | Mpa | Ninety five percent quantile of tensile strength | | 11 | eps c2 | - | Strain at reaching maximum strength for calculation of bearing capacity | | 12 | eps cu2 | - | Ultimate strain for calculation of bearing capacity | | 13 | eps c3 | - | Strain at reaching maximum strength for calculation of load effect | | 14 | eps cu3 | - | Ultimate strain for calculation of load effect | ## Timber Specific Material Properties | Index | Design property | Unit | Description | | ----- | --------------- | ---- | ---------------------------------------------------------- | | 15 | E0.05 | Mpa | 5% Modulus of elasticity parallel to grain | | 16 | E90, mean | Mpa | Mean modulus of elasticity perpendicular to grain | | 17 | fmk | Mpa | Characteristic bending strength | | 18 | ft0k | Mpa | Characteristic tensile strength parallel to grain | | 19 | ft90k | Mpa | Characteristic tensile strength perpendicular to grain | | 20 | fc0k | Mpa | Characteristic compressive strength parallel to grain | | 21 | fc90k | Mpa | Characteristic compressive strength perpendicular to grain | | 22 | fvk | Mpa | Characteristic shear strength |