Transform Geometry Configuration

The transformCoordinates and matchPoints functions can be used to transform the input 3D model from one coordinate system to another.

transformCoordinates Configuration:

The transformCoordinates parameters allow you to translate, rotate and scale the geometry in the 3D model:

• Translation: Moves the model from one location to another without changing its size, shape, or orientation.

• Rotation: Rotates all the points in the model about its origin separately in X, Y, and Z dimensions.

• Scaling: Changes the size of the model by multiplying it with a scale factor, same for each axis.

Each action in transformCoordinates is applied in the configured order. This can impact the accuracy of the overall transformation. For example, if both a rotation and a large offset are required, then it is usually more accurate to apply the translation and then the rotation. Note also that if the rotation was done first then the translation would need to be defined relative to the new rotated coordinate system.

Example of transformCoordinates:

<transformGeometry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" sourceProductName="AVEVA Gateway for 3D Data" componentName="TransformGeometry" componentVersion="2.12.0.0"
<transformCoordinates leaveOriginalModel="false" objectsTypes="3D">
<action type="scale" factor="0.05” />
<action type="translate" x="10.0” y=”10.0” z =”0.0"/>
<action type="rotate" x="45.0” y=”10.0” z=”0.0"/>
</transformCoordinates>

</transformGeometry>

Note: Transformations are applied in the order they are configured.

matchPoints Configuration

The matchPoints node is an alternative method for transforming the coordinates that simply relies on defining the coordinates of three points in common between the source model (that is the input IFC file) and a target model that may have been previously imported into AIM but has a different coordinate system to the source model. The Gateway then automatically applies the coordinate transformation that will then align the source model with the target model. The matchPoints example configuration should define the coordinates of the same three points in the source and target models. Ideally these should be well-separated and in different planes to improve the accuracy of the transformation.

<matchPoints leaveOriginalModel="false" objectsTypes="3D">
<sourceCoords>
<point1 x="0.0” y=”0.0” z=”0.0"/>
<point2 x="0.0” y=”100.0” z=”0.0"/>
<point3 x="0.0” y=”0.0” z=”100.0"/>
</sourceCoords>
<targetCoords>
<point1 x="10.0” y=”0.0” z=”0.0"/>
<point2 x="0.0” y=”110.0” z=”0.0"/>
<point3 x="10.0” y=”0.0” z=”100.0"/>

</targetCoords>
</matchPoints>

The effect of these three points would be to translate the source model by 10 units in the X direction and rotates it by 90 degrees in the XY plane.

The sequence of the points must be the same so that point 1 in the source system is equivalent to point 1 in the target system. An error is raised if the relative shapes of the triangles defined by the two sets of points are different.