SAF Documentation
v2.0.0
Search…
⌃K

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 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.

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
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

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.