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)|(5,4,3,2)

- second set of brackets

- separated by |

- line defining the an opening has clockwise orientation

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.