OSE Piping Workbench Ports

The OSE Piping Workbench creates fittings. It uses ports to describe the ends of the fittings. The Ports helps to fit the fittings together correctly.

Ports of a tee in OSE Piping workbench.

Every port is described by:

• Its position $a\in \mathbb {R} ^{3}$
• A normal vector $n\in \mathbb {R} ^{3}$ which points out of the fitting and it is perpendicular to the port plane.
• A 0 reference angle vector $r\in \mathbb {R} ^{3}$ it shows where is the degree 0°. $r$ must lie in the port plane.

Instead of using three separate vectors, we represent the port by its position and its orientation $A$. The position is a FreeCAD Vector $a\in \mathbb {R} ^{3}$. The orientation is a FreeCAD rotation matrix. When we apply matrix $A$ on vectors $x=(1,0,0)$, $y=(0,1,0)$, $y=(1,0,0)$, it creates vectors $x^{*}$, $y^{*}$, $y^{*}$ such that

• $x^{*}$ points in the same direction as the port's normal, $x^{*}=n$.
• $y^{*}$ shows in the same direction as the angular reference, $y^{*}=r$.

For example in a tee fitting, the matrix $A$ is a rotation along y-axis by $\phi =90^{\circ }$, and then a rotation along z axis by $\psi =-90^{\circ }$. See FreeCAD Rotation for more details. Pictures (see #Port-orientation.svg)

Orientation of port 2 in a tee fitting.