This is an old revision of the document!
Data format for interfaces
This document describes the data structure for transferring measurement data to other applications.
CSV format
Download: Excel
| Hauptobjekt | roomData | Daten für ein Raumaufmaß. Ohne Raumhöhe ist dies ein Bodenaufmaß. |
|---|---|---|
| Eigenschaft | Datentyp | Beschreibung |
| name | string | Name des Raums/Objekts |
| angles | Array<number> | Die Innenwinkel der Raumecken in Grad. |
| areaFloor | number | Berechnete Grundfläche des Raums. |
| areaWalls | number | Gesamte Wandfläche des Raums. |
| circumference | number | Gesamtumfang des Raumes auf dem Boden. |
| clockwise | number | Indikator für die Zeichenrichtung (z. B. 1 für im Uhrzeigersinn). |
| cutOutData | Array<Object> | Liste aller Abzugskörper oder Ausschnitte im Raum (z. B. Fenster, Nischen, Säulen). |
| height | number | Höhe des Raums. |
| points | Array<Point3D> | Liste aller Punktkoordinaten der Raumecken. |
| pointCount | number | Anzahl der Eckpunkte, die den Raum definieren. |
| volume | number | Berechnetes Raumvolumen. |
| wallData | Array<Object> | Liste aller Wände (Segmente) des Raums. |
| Unterobjekt | wallData | Daten je Wand/Strecke von Messpunkt zu Messpunkt. |
| Eigenschaft | Datentyp | Beschreibung |
| angle | number | Winkel der Wand zur vorherigen Wand. |
| width | number | Breite der Wand. |
| from | number | Start-Index des Wandsegments (referenziert einen Punkt). |
| to | number | End-Index des Wandsegments (referenziert einen Punkt). |
| wall | string | Wandbezeichnung (z.B. "p1-p2"). |
| Unterobjekt | cutOutData | Daten für Ausschnitte oder zusätzliche Elemente. |
| Eigenschaft | Datentyp | Beschreibung |
| name | string | Name des Ausschnitts/Objekts |
| angles | Array<number> | (Optional) Die Innenwinkel der Geometrie in Grad. |
| areaFloor | number | Berechnete Grundfläche der Geometrie. |
| areaWalls | number | Gesamte Wandfläche der Geometrie. |
| center | Point3D | Der berechnete Mittelpunkt des Objekts. |
| centerProjection | Object | Details zur Projektion des Objekt-Mittelpunkts auf die nächste Wand. |
| circumference | number | Gesamtumfang der Geometrie. |
| depth | number | Tiefe der Geometrie. |
| geometry | string | Geometrische Form des Ausschnitts ("plane", "polygon", "circle"). |
| pointProjections | Array<Object> | (Optional) Projektionsdaten für jeden einzelnen Eckpunkt auf die Wände. |
| points | Array<Point3D> | Die 3D-Koordinaten der Eckpunkte bzw. Kantenpunkte. |
| radius | number | (Optional) Radius, falls geometry auf "circle" gesetzt ist. |
| rotation | Euler | Rotationswerte des Objekts in X-, Y- und Z-Richtung. |
| volume | number | Berechnetes Volumen der Geometrie. |
| Unterobjekt | projectionData | centerProjection/pointProjections (immer zum nächstgelegenen Wandsegment) |
| Eigenschaft | Datentyp | Beschreibung |
| closestPoint | Point3D | Die Koordinate des nächstgelegenen Eckpunkts. |
| closestPointDistance | number | Distanz zwischen dem nächstgelegenen Eckpunkt und der Projektion. |
| projectedPoint | Point3D | Die Koordinate der Projektion auf das Wandsegment. |
| projectionDistance | number | Distanz zwischen dem Originalpunkt und dem projizierten Punkt. |
| wall | string | Bezeichnung der Zielwand (z. B. "p1-p2"). |
JSON format
Download: json
{
"angles": [
90,
90,
90,
90
],
"areaFloor": 12.0,
"areaWalls": 35.0,
"circumference": 14.0,
"clockwise": 1,
"height": 2.5,
"points": [
{ "x": 0, "y": 0, "z": 0 },
{ "x": 4, "y": 0, "z": 0 },
{ "x": 4, "y": 0, "z": 3 },
{ "x": 0, "y": 0, "z": 3 }
],
"pointCount": 4,
"volume": 30.0,
"wallData": [
{
"angle": 90,
"width": 4.0,
"from": 1,
"to": 2,
"wall": "p1-p2"
},
{
"angle": 90,
"width": 3.0,
"from": 2,
"to": 3,
"wall": "p2-p3"
},
{
"angle": 90,
"width": 4.0,
"from": 3,
"to": 4,
"wall": "p3-p4"
},
{
"angle": 90,
"width": 3.0,
"from": 4,
"to": 1,
"wall": "p4-p1"
}
],
"cutOutData": [
{
"geometry": "polygon",
"depth": 0.3,
"points": [
{ "x": 1.5, "y": 0.0, "z": 1.0 },
{ "x": 2.5, "y": 0.0, "z": 1.0 },
{ "x": 2.5, "y": 0.0, "z": 2.0 },
{ "x": 1.5, "y": 0.0, "z": 2.0 }
],
"angles": [90, 90, 90, 90],
"areaFloor": 1.0,
"areaWalls": 1.2,
"center": { "x": 2.0, "y": 0.0, "z": 1.5 },
"circumference": 4.0,
"rotation": { "x": 0, "y": 0, "z": 0 },
"volume": 0.3,
"centerProjection": {
"closestPoint": { "x": 0.0, "y": 0.0, "z": 0.0 },
"closestPointDistance": 2.0,
"projectedPoint": { "x": 2.0, "y": 0.0, "z": 0.0 },
"projectionDistance": 1.5,
"wall": "p1-p2"
},
"pointProjections": [
{
"closestPoint": { "x": 0.0, "y": 0.0, "z": 0.0 },
"closestPointDistance": 1.5,
"projectedPoint": { "x": 1.5, "y": 0.0, "z": 0.0 },
"projectionDistance": 1.0,
"wall": "p1-p2"
},
{
"closestPoint": { "x": 4.0, "y": 0.0, "z": 0.0 },
"closestPointDistance": 1.5,
"projectedPoint": { "x": 2.5, "y": 0.0, "z": 0.0 },
"projectionDistance": 1.0,
"wall": "p1-p2"
},
{
"closestPoint": { "x": 4.0, "y": 0.0, "z": 3.0 },
"closestPointDistance": 1.5,
"projectedPoint": { "x": 2.5, "y": 0.0, "z": 3.0 },
"projectionDistance": 1.0,
"wall": "p3-p4"
},
{
"closestPoint": { "x": 0.0, "y": 0.0, "z": 3.0 },
"closestPointDistance": 1.5,
"projectedPoint": { "x": 1.5, "y": 0.0, "z": 3.0 },
"projectionDistance": 1.0,
"wall": "p3-p4"
}
]
}
]
}