OSE Piping Workbench Ports - Versionsgeschichte

Ruslan am 2. Dezember 2018 um 07:26 Uhr

2018-12-02T07:26:49Z

Ruslan: /* Adjust two fittings */

2018-12-02T07:24:23Z

Adjust two fittings

Ruslan am 2. Dezember 2018 um 07:21 Uhr

2018-12-02T07:21:14Z

Ruslan: /* Adjust two fittings */

2018-12-01T18:37:24Z

Adjust two fittings

Ruslan am 1. Dezember 2018 um 17:53 Uhr

2018-12-01T17:53:16Z

Ruslan: /* Ports */

2018-12-01T17:42:43Z

Ports

Ruslan am 1. Dezember 2018 um 16:59 Uhr

2018-12-01T16:59:20Z

Ruslan am 27. November 2018 um 05:07 Uhr

2018-11-27T05:07:39Z

Ruslan am 26. November 2018 um 20:19 Uhr

2018-11-26T20:19:09Z

Ruslan am 26. November 2018 um 20:18 Uhr

2018-11-26T20:18:33Z

← Abfassung vorher		Version vom 2. Dezember 2018, 07:26 Uhr
Zeile 50:		Zeile 50:
	== Ports in Python ==		== Ports in Python ==
	In ''OsePiping.Port'' class the port position and orientation are stored in the ''Port.placement'' attribute as a ''FreeCAD.Placement'' object.		In ''OsePiping.Port'' class the port position and orientation are stored in the ''Port.placement'' attribute as a ''FreeCAD.Placement'' object.
		+
		+	The matrix <math>A_r</math> can be expressed as 180° rotation along the y axis: ''FreeCAD.Rotation(0, 180, 0)''.

@@ Zeile 36: / Zeile 36: @@
 </math>
-We want to find a rotation matrix <math>B</math>, such that applying it to adjusting fitting the new orientation of its port *in relating to global coordinate* has following properties:
+We want to find a rotation matrix <math>B</math> of the moved fitting, such that the new orientation of its port *in relating to global coordinate* has following properties:
 * Its normal vector looks to opposite direction as the normal of the other fitting: <math>Bn'=-n_g</math>.
 * Its zero-degree reference points to the same direction <math>Br'=r_g</math>

@@ Zeile 43: / Zeile 43: @@
 * <math>A'^{-1}</math> rotates the fitting in such a way that its port points to x-direction, and 0 reference to y-direction.
 * <math>A_r</math> rotates the fitting opposite to x-direction, but its 0 reference still points to y-direction.
-* <math>R\cdot A</math> gives to the rotated fitting the same orientation as the port of the other fitting in glbal coordinates.
+* <math>A</math> rotate oposite rotated port to the same direction as the port of the other fitting.
+* <math>R</math> rotate to corresponding global rotation.
-We have <math display="block">B:=A'^{-1}\cdot A_r \cdot R\cdot A</math>.
+Note. Rotation operations are not commutative and we need to perform all the rotation from right to left.
 == Ports in Python ==
 In  ''OsePiping.Port'' class the port position and orientation are stored  in the ''Port.placement'' attribute as a ''FreeCAD.Placement'' object.

@@ Zeile 43: / Zeile 43: @@
 * <math>A'^{-1}</math> rotates the fitting in such a way that its port points to x-direction, and 0 reference to y-direction.
 * <math>A_r</math> rotates the fitting opposite to x-direction, but its 0 reference still points to y-direction.
-* <math>A</math> gives to the rotated fitting the same orientation as the port of the other fitting.
+* <math>R\cdot A</math> gives to the rotated fitting the same orientation as the port of the other fitting in glbal coordinates.
-We have <math display="block">B:=A'^{-1}\cdot A_r \cdot A</math>.
+We have <math display="block">B:=A'^{-1}\cdot A_r \cdot R\cdot A</math>.
 == Ports in Python ==
 In  ''OsePiping.Port'' class the port position and orientation are stored  in the ''Port.placement'' attribute as a ''FreeCAD.Placement'' object.

@@ Zeile 19: / Zeile 19: @@
 [[Datei:Port-orientation.svg|mini|Orientation of port 2 in a tee fitting.]]
 ==Adjust two fittings==
@@ Zeile 48: / Zeile 46: @@
 We have <math display="block">B:=A'^{-1}\cdot A_r \cdot A</math>.

@@ Zeile 4: / Zeile 4: @@
 Every port is described by:
-* Its position <math>a \in \mathbb{R}^3</math>
+* Its position <math>a \in \mathbb{R}^3</math>.
 * A normal vector <math>n \in \mathbb{R}^3</math> which points out of the fitting and it is perpendicular to the port plane.
 * A 0 reference angle vector <math>r \in \mathbb{R}^3</math> it shows where is the degree 0°. <math>r</math> must lie in the port plane.
 All three vectors refer to local coordinates.
-Instead of using three separate vectors, we represent the port by its position and its orientation <math>A</math>.
+Instead of using three separate vectors, we represent the port by its position <math>A</math> and its orientation <math>A</math>.
 The position is a FreeCAD Vector <math>a \in \mathbb{R}^3</math>. The orientation is a FreeCAD rotation matrix. When we apply matrix <math>A</math> on vectors <math>x = (1,0,0)</math>, <math>y = (0,1,0)</math>, <math>y = (1,0,0)</math>,  it creates vectors <math>x^*</math>, <math>y^*</math>, <math>y^*</math> such that
 * <math>x^*</math> points in the same direction as the port's normal, <math>x^* = n</math>.
@@ Zeile 17: / Zeile 18: @@
 [[Datei:Port-orientation.svg|mini|Orientation of port 2 in a tee fitting.]]
 ==Adjust two fittings==

@@ Zeile 7: / Zeile 7: @@
 * A normal vector <math>n \in \mathbb{R}^3</math> which points out of the fitting and it is perpendicular to the port plane.
 * A 0 reference angle vector <math>r \in \mathbb{R}^3</math> it shows where is the degree 0°. <math>r</math> must lie in the port plane.
 Instead of using three separate vectors, we represent the port by its position and its orientation <math>A</math>.
@@ Zeile 19: / Zeile 20: @@
 ==Adjust two fittings==
 When we adjust one fitting to another we want rotate the first fitting in such a way that its socket points in opposite directions as a socket of the other fitting.
-Let us assume that the port of the adjusting fitting has position <math>a'</math>, orientation <math>A'</math> with normal <math>n'</math> and 0 degree reference  <math>r'</math>.
+Let us assume that the port of the adjusting fitting has position <math>a'</math>, orientation <math>A'</math> with normal <math>n'</math> and 0 degree reference  <math>r'</math>. Everything refering to the local coordinates of the fitting.
-The port of the other fitting has position <math>a</math>, orientation <math>A</math> normal <math>n</math> and 0 degree reference  <math>r</math>.
 We want to find a rotation matrix <math>B</math>, such that applying it to adjusting fitting the new orientation of its port *in relating to global coordinate* has following properties:
-* Its normal vector looks to opposite direction as the normal of the other fitting: <math>Bn'=-n</math>.
+* Its normal vector looks to opposite direction as the normal of the other fitting: <math>Bn'=-n_g</math>.
-* Its zero-degree reference points to the same direction <math>Br'=r</math>
+* Its zero-degree reference points to the same direction <math>Br'=r_g</math>
 We compose the matrix from three matrices <math>A'^{-1}</math><math>A_r</math> and <math>A</math>.
@@ Zeile 30: / Zeile 43: @@
 * <math>A</math> gives to the rotated fitting the same orientation as the port of the other fitting.
-We have <math>B:=A'^{-1}\cdot A_r \cdot A</math>.
+We have <math display="block">B:=A'^{-1}\cdot A_r \cdot A</math>.

@@ Zeile 1: / Zeile 1: @@
 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.
 [[Datei:Ports.svg|mini|Ports of a tee in OSE Piping workbench.]]
@@ Zeile 15: / Zeile 16: @@
 [[Datei:Port-orientation.svg|mini|Orientation of port 2 in a tee fitting.]]

@@ Zeile 12: / Zeile 12: @@
 * <math>y^*</math> shows in the same direction as the angular reference, <math>y^* = r</math>.
-For example in a tee fitting, the matrix <math>A</math> is a rotation along y-axis by <math>\phi = 90^{\circ}</math>, and then a rotation along z axis by <math>\psi = -90^{\circ}</math>. See [https://www.freecadweb.org/wiki/Placement FreeCAD Rotation] for more details. Pictures (see [[#Port-orientation.svg]])
+For example in a tee fitting, the matrix <math>A</math> is a rotation along y-axis by <math>\phi = 90^{\circ}</math>, and then a rotation along z axis by <math>\psi = -90^{\circ}</math>. See [https://www.freecadweb.org/wiki/Placement FreeCAD Rotation] for more details about rotation.
 [[Datei:Port-orientation.svg|mini|Orientation of port 2 in a tee fitting.]]

← Abfassung vorher		Version vom 26. November 2018, 20:18 Uhr
Zeile 1:		Zeile 1:
	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.		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.
	[[Datei:Ports.svg\|mini\|Ports of a tee in OSE Piping workbench.]]		[[Datei:Ports.svg\|mini\|Ports of a tee in OSE Piping workbench.]]
		+
		+	Every port is described by:
		+	* Its position <math>a \in \mathbb{R}^3</math>
		+	* A normal vector <math>n \in \mathbb{R}^3</math> which points out of the fitting and it is perpendicular to the port plane.
		+	* A 0 reference angle vector <math>r \in \mathbb{R}^3</math> it shows where is the degree 0°. <math>r</math> must lie in the port plane.
		+
		+	Instead of using three separate vectors, we represent the port by its position and its orientation <math>A</math>.
		+	The position is a FreeCAD Vector <math>a \in \mathbb{R}^3</math>. The orientation is a FreeCAD rotation matrix. When we apply matrix <math>A</math> on vectors <math>x = (1,0,0)</math>, <math>y = (0,1,0)</math>, <math>y = (1,0,0)</math>, it creates vectors <math>x^</math>, <math>y^</math>, <math>y^*</math> such that
		+	* <math>x^</math> points in the same direction as the port's normal, <math>x^ = n</math>.
		+	* <math>y^</math> shows in the same direction as the angular reference, <math>y^ = r</math>.
		+
		+	For example in a tee fitting, the matrix <math>A</math> is a rotation along y-axis by <math>\phi = 90^{\circ}</math>, and then a rotation along z axis by <math>\psi = -90^{\circ}</math>. See [https://www.freecadweb.org/wiki/Placement FreeCAD Rotation] for more details. Pictures (see [[#Port-orientation.svg]])
		+
		+	[[Datei:Port-orientation.svg\|mini\|Orientation of port 2 in a tee fitting.]]