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 and StrucuturalSurfaceMemeber 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.
|Structural proxy element is not structural analysis object and will not be considered in structural analysis calculation.
|It is just a geometrical reference object.
Sheet StrucutralProxyElement is a list of all StructuralProxyElements defined in the SAF file. Every row represents one solid object.
| Column header | Data type | Example / enum definition | Required | 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 |
| 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 |
Sheet StructuralProxyElementVertices is a list of all vertices that are used for defining the StrucutralProxyElements. Each row is one vertex of StructuralProxyElements.
| Column header | Data type | Example / enum definition | Required | 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 |
Sheet StructuralProxyElementFaces is used for defining faces of every StructuralProxyElement presented. Each row represents one face of StructuralProxyElements.
| Column header | Data type | Example / enum definition | Required | Description |
|---|---|---|---|---|
| Structural proxy element | String | SPE1 | Yes | Human readable unique name of the StructuralProxyElement |
| 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. |
Example of simple StrucutralProxyElement
vertices:
v0[0,0,0], v1[2,0,0], v2[1,2,0], v3[1,1,2]
faces:
f0(v0,v1,v3), f1(v2,v3,v1), f2(v3,v2,v0), f3(v1,v0,v2).
It is recommended to define the edge common for two faces with the opposite polygons.
Face f0 is in the picture defined as (v0,v1,v3) so the face f1 will be defined (v2,v3,v1). The common edge is defined as (v1,v3) for face f1 and (v3,v1) for face f2.
Maximum number of rows in excel is 1,048,575, this number is not a limitation for SAF though. If more space is required, the table can continue on the right side of the first table with one empty column in between. The headers are repeated as well.
:width: 800px