REXS Spezifikation

In der Schnittstellendatei werden Komponenten mit dem XML-Tag <component></component> beschrieben.

Der Inhalt des Tags sind die der Komponente zugehörigen Attribute:

Beispiel Komponenten | XML-Syntax

<components>
	<component id="4" type="cylindrical_gear" name="Pinion">
		<attribute id="attr1"> .. </attribute>
		<attribute id="attr2"> .. </attribute>
		...
	</component >
	<component id="6" type="cylindrical_gear" name="Wheel">
		<attribute id="attr1"> .. </attribute>
		<attribute id="attr2"> .. </attribute>
		...
	</component >
</components>

Überschreiten Arrays und Matrizen eine gewissen Größe, kann es aus Performancegründen sinnvoll sein diese in Binärform in der REXS-Datei abzulegen.

Ein Array wird dazu zunächst in Binärform gebracht. Die Byte-Reihenfolge ist „Little Endian“. Im zweiten Schritt wird dieses byte-Array dann per base64-Kodierung in einen String gewandelt. Dieser steht dann in der REXS-Datei. Zusätzlich muss das verwendete Binärformat (int32, float64, oder float32) gekennzeichnet werden.

Bei der Codierung einer Matrix wird folgendermaßen vorgegangen: Zunächst wird die 2d-Matrix spaltenweise in ein 1d-Array überführt ( array = [spalte1, spalte2, ...]). Dieses wird dann wie oben beschrieben in Binärform gebracht (Byte-Reihenfolge ist „Little Endian“) und schließlich per base64-Kodierung in einen String gewandelt. Neben der Angabe des Binärformats (int32, float64, float32) ist die Angabe der Anzahl der Spalten und Zeilen der Matrix notwendig.

Für weitere Informationen zur Kennzeichnung von base64-kodierten Attributen in der REXS Datei siehe auch XML-Syntax, bzw. JSON-Syntax, sowie Code Beispiele

Beispiel String-Attribut | XML-Syntax

<attribute id="name">30203-A</attribute>

Beispiel Double-Attribut mit Maßeinheit | XML-Syntax

<attribute id="normal_module" unit="mm">23.5</attribute>

Beispiel Double-Attribut ohne Maßeinheit | XML-Syntax

<attribute id="addendum_modification_coefficient" unit="none">0.5</attribute>

Beispiel Attribut mit origin="user_defined" | XML-Syntax

<attribute id=addendum_modification_coefficient" unit="none" origin="user_defined">0.5</attribute>

Besipiel Attribut mit origin="calculated" | XML-Syntax

<attribute id=addendum_modification_coefficient" unit="none" origin="calculated">0.5</attribute>

Beispiel Integer-Attribut ohne Maßeinheit | XML-Syntax

<attribute id="number_of_teeth" unit="none">8</attribute>

Beispiel Boolean-Attribut | XML-Syntax

<attribute id="is_driving_gear">false</attribute>

Beispiel Enum-Attribut | XML-Syntax

<attribute id="axial_force_absorption">both_directions</attribute>

Beispiel Array-Attribut | XML-Syntax

<attribute id="support_vector" unit="mm">
	<array>
		<c>1.0</c>
		<c>1.0</c>
		<c>0.0</c>
	</array>
</attribute>

Beispiel Matrix-Attribut | XML-Syntax

<attribute id="matrix_correction" unit="mm">
	<matrix>
		<r>
			<c>0.0</c>
			<c>0.0</c>
			<c>0.0</c>
			<c>0.0</c>
			<c>0.0</c>
			<c>0.0</c>
			<c>0.0</c>
			<c>0.0</c>
			<c>0.0</c>
		</r>
		<r>
			<c>0.0</c>
			<c>0.0</c>
			<c>0.0</c>
			<c>0.0</c>
			<c>0.0</c>
			<c>0.0</c>
			<c>0.0</c>
			<c>0.0</c>
			<c>0.0</c>
		</r>
			...
		<r>
			<c>0.0</c>
			<c>0.0</c>
			<c>0.0</c>
			<c>0.0</c>
			<c>0.0</c>
			<c>0.0</c>
			<c>0.0</c>
			<c>0.0</c>
			<c>0.0</c>
		</r>
	</matrix>
</attribute>

Beispiel Array-Attribut in Binärform | XML-Syntax

<attribute id="example_attribute_id" unit="mm">
	<array code="float64"/>62wRNhgQS0AAAAAAAAAAANgPsyG1MXDA=<array/>
</attribute>

Beispiel Matrix-Attribut in Binärform | XML-Syntax

<attribute id="example_matrix_coded" unit="mm">
        <matrix code="float64" columns="3" rows="2">AAAAAAAA8D8AAAAAAAAQQAAAAAAAAABAAAAAAAAAFEAAAAAAAAAIQAAAAAAAABhA</matrix>
</attribute>

Beispiel array_of_integer_arrays-Attribut | XML-Syntax

<attribute id="element_structure" unit="none">
	<array_of_arrays>
		<array><c>108</c><c>2</c><c>1</c><c>107</c></array>
		<array><c>109</c><c>3</c><c>2</c><c>108</c></array>
		<array><c>8</c><c>114</c><c>115</c></array>
	</array_of_arrays>
</attribute>

Dass "attributes" Array enthält eine Liste von Objekten mit den folgenden Namen-Wert-Paaren: "id" (Attribut-Id), "unit" (Einheit, bei bestimmten Datentypen notwendig), "origin" (optional, kennzeichnet das Attribut als "calculated" oder "user_defined"), sowie dem Attributwert. Um eine JSON-Validierung zu ermöglichen wird dabei je nach Datentyp ein unterschiedlicher Kenner verwendet. Die verfügbaren Kenner werden im folgenden aufgelistet. Für Details zu binärcodierten Arrays und Matrizen siehe auch Anmerkung und Anmerkung.

Beispiel Attributliste | JSON-Syntax

"attributes":[
	{"id": "name", "string": "30203-A"},
	{"id": "normal_module", "unit": "mm", "floating_point": 2.0},
	{"id": "addendum_modification_coefficient", "unit": "none", "floating_point": 0.1},
	{"id": "addendum_modification_coefficient", "unit": "none", "origin":"user_defined", "floating_point": 0.1},
	{"id": "addendum_modification_coefficient", "unit": "none", "origin":"calculated", "floating_point": 0.1},
	{"id": "number_of_gears", "integer": 3},
	{"id": "is_driving_gear", "boolean": false},
	{"id": "axial_force_absorption", "enum": "both_directions" },
	{"id": "u_axis_vector", "unit": "mm","floating_point_array": [1.0,0.0,0.0]},
	{"id": "matrix_correction", "unit": "mm", "floating_point_matrix": [[1.0,0.0,0.0],[0.0,1.0,0.0],[0.0,0.0,1.0]] },
	{"id": "example_array_coded", "unit": "mm", "floating_point_array_coded": {"code": "float64", "value": "62wRNhgQS0AAAAAAAAAAANgPsyG1MXDA"}},
	{"id": "example_matrix_coded", "unit": "mm", "floating_point_matrix_coded": {"code": "float64", columns="3", rows="2", "value": "AAAAAAAA8D8AAAAAAAAQQAAAAAAAAABAAAAAAAAAFEAAAAAAAAAIQAAAAAAAABhA62wRNhgQS0AAAAAAAAAAANgPsyG1MXDA"}},
	{"id": "element_structure", "array_of_integer_arrays": [[108,2,1,107,7],[0,1,0],[0,7,0,1]]},
]