0028189: Result of Boolean operation is non-manifold wire

1. The result of Boolean operation on the arguments of collection type, containers WIRE/SHELL/COMPSOLID, is also a collection.
The containers of type WIRE included into result should now also (as the SHELLs) have coherent orientation of its sub-shapes.
For that the new method has been implemented (BOPTools_AlgoTools::OrientEdgesOnWire(TopoDS_Shape&)) which reorients edges for correct ordering.
The duplicating containers, i.e. containers with the contents completely included in other containers, are now avoided in the result of BOP.
2. The result of Fuse operation on Compsolids is now also will be Compsolid.
3. Documentation has been updated.
4. New test cases for the issue.
5. Adjusting test cases to current behavior.

Correction of test case bugs/modalg_4/bug726_2 according to the new behavior

tests/boolean/bcommon_2d/F3

@@ -3,7 +3,7 @@ restore [locate_data_file offset_wire_034.brep] b
 
 bcommon result b a
 
-checkprops result -l 691.95
+checkprops result -l 345.975
 checksection result
 checknbshapes result -vertex 8 -edge 7 -t
 

tests/boolean/bcommon_2d/F4

@@ -3,7 +3,7 @@ restore [locate_data_file case_3_wire2.brep] b
 
 bcommon result b a
 
-checkprops result -l 691.95
+checkprops result -l 345.975
 checksection result
 checknbshapes result -vertex 14 -edge 13 -t
 

tests/boolean/bcommon_2d/F5

@@ -3,7 +3,7 @@ restore [locate_data_file case_3_wire5.brep] b
 
 bcommon result b a
 
-checkprops result -l 132.732
+checkprops result -l 66.3661
 checksection result
 checknbshapes result -vertex 2 -edge 1 -t
 

tests/boolean/bcommon_2d/N8

@@ -3,7 +3,7 @@ restore [locate_data_file case_9_wire1.brep] b
 
 bcommon result b a
 
-checkprops result -l 287.575
+checkprops result -l 143.787
 checksection result
 checknbshapes result -vertex 2 -edge 1 -t
 

tests/boolean/bcommon_2d/N9

@@ -3,7 +3,7 @@ restore [locate_data_file case_9_wire2.brep] b
 
 bcommon result b a
 
-checkprops result -l 287.575
+checkprops result -l 143.787
 checksection result
 checknbshapes result -vertex 2 -edge 1 -t
 

tests/boolean/bcommon_2d/O1

@@ -3,7 +3,7 @@ restore [locate_data_file case_9_wire3.brep] b
 
 bcommon result b a
 
-checkprops result -l 159.8
+checkprops result -l 79.9002
 checksection result
 checknbshapes result -vertex 2 -edge 1 -t
 

tests/boolean/bcommon_2d/O7

@@ -3,7 +3,7 @@ restore [locate_data_file case_9_wire1.brep] b
 
 bcommon result b a
 
-checkprops result -l 287.575
+checkprops result -l 143.787
 checksection result
 checknbshapes result -vertex 2 -edge 1 -t
 

tests/boolean/bopcommon_2d/F3

@@ -4,7 +4,7 @@ restore [locate_data_file offset_wire_034.brep] b
 bop a b
 bopcommon result
 
-checkprops result -l 691.95
+checkprops result -l 345.975
 checksection result
 checknbshapes result -vertex 8 -edge 7 -t
 

tests/boolean/bopcommon_2d/F4

@@ -4,7 +4,7 @@ restore [locate_data_file case_3_wire2.brep] b
 bop a b
 bopcommon result
 
-checkprops result -l 691.95
+checkprops result -l 345.975
 checksection result
 checknbshapes result -vertex 14 -edge 13 -t
 

tests/boolean/bopcommon_2d/F5

@@ -4,7 +4,7 @@ restore [locate_data_file case_3_wire5.brep] b
 bop a b
 bopcommon result
 
-checkprops result -l 132.732
+checkprops result -l 66.3661
 checksection result
 checknbshapes result -vertex 2 -edge 1 -t
 

tests/boolean/bopcommon_2d/N8

@@ -4,7 +4,7 @@ restore [locate_data_file case_9_wire1.brep] b
 bop a b
 bopcommon result
 
-checkprops result -l 287.575
+checkprops result -l 143.787
 checksection result
 checknbshapes result -vertex 2 -edge 1 -t
 

tests/boolean/bopcommon_2d/N9

@@ -4,7 +4,7 @@ restore [locate_data_file case_9_wire2.brep] b
 bop a b
 bopcommon result
 
-checkprops result -l 287.575
+checkprops result -l 143.787
 checksection result
 checknbshapes result -vertex 2 -edge 1 -t
 

tests/boolean/bopcommon_2d/O1

@@ -4,7 +4,7 @@ restore [locate_data_file case_9_wire3.brep] b
 bop a b
 bopcommon result
 
-checkprops result -l 159.8
+checkprops result -l 79.9002
 checksection result
 checknbshapes result -vertex 2 -edge 1 -t
 

tests/boolean/bopcommon_2d/O7

@@ -4,7 +4,7 @@ restore [locate_data_file case_9_wire1.brep] b
 bop a b
 bopcommon result
 
-checkprops result -l 287.575
+checkprops result -l 143.787
 checksection result
 checknbshapes result -vertex 2 -edge 1 -t
 

tests/boolean/bopcommon_complex/L3

@@ -4,5 +4,5 @@ restore [locate_data_file sh2a] b2
 bop b1 b2
 bopcommon result
 
-checkprops result -s 700
+checkprops result -s 350
 checkview -display result -2d -otherwise { b1 b2 } -s -path ${imagedir}/${test_image}.png

tests/boolean/bopcommon_complex/L6

@@ -4,5 +4,5 @@ restore [locate_data_file sh7] b2
 bop b1 b2
 bopcommon result
 
-checkprops result -s 200
+checkprops result -s 100
 checkview -display result -2d -otherwise { b1 b2 } -s -path ${imagedir}/${test_image}.png

tests/boolean/bopcommon_complex/L7

@@ -4,5 +4,5 @@ restore [locate_data_file sh8] b2
 bop b1 b2
 bopcommon result
 
-checkprops result -s 191.421
+checkprops result -s 95.7107
 checkview -display result -2d -otherwise { b1 b2 } -s -path ${imagedir}/${test_image}.png

tests/boolean/bopcommon_complex/L8

@@ -4,5 +4,5 @@ restore [locate_data_file sh9] b2
 bop b1 b2
 bopcommon result
 
-checkprops result -s 800
+checkprops result -s 400
 checkview -display result -2d -otherwise { b1 b2 } -s -path ${imagedir}/${test_image}.png

tests/boolean/bopcommon_complex/L9

@@ -4,5 +4,5 @@ restore [locate_data_file shx] b2
 bop b1 b2
 bopcommon result
 
-checkprops result -s 662.742
+checkprops result -s 331.371
 checkview -display result -2d -otherwise { b1 b2 } -s -path ${imagedir}/${test_image}.png

tests/boolean/bopcommon_complex/M3

@@ -4,5 +4,5 @@ restore [locate_data_file sg2] b2
 bop b1 b2
 bopcommon result
 
-checkprops result -s 4188.79
+checkprops result -s 2094.4
 checkview -display result -2d -otherwise { b1 b2 } -s -path ${imagedir}/${test_image}.png

tests/boolean/bopcommon_complex/M4

@@ -4,5 +4,5 @@ restore [locate_data_file sf5] b2
 bop b1 b2
 bopcommon result
 
-checkprops result -s 3221.73
+checkprops result -s 1610.86
 checkview -display result -2d -otherwise { b1 b2 } -s -path ${imagedir}/${test_image}.png

tests/boolean/bopcommon_complex/M5

@@ -4,5 +4,5 @@ restore [locate_data_file sf3] b2
 bop b1 b2
 bopcommon result
 
-checkprops result -s 3221.73
+checkprops result -s 1610.86
 checkview -display result -2d -otherwise { b1 b2 } -s -path ${imagedir}/${test_image}.png

tests/boolean/bopcommon_complex/M6

@@ -4,5 +4,5 @@ restore [locate_data_file sf55] b2
 bop b1 b2
 bopcommon result
 
-checkprops result -s 75398.2
+checkprops result -s 37699.1
 checkview -display result -2d -otherwise { b1 b2 } -s -path ${imagedir}/${test_image}.png

tests/boolean/bopfuse_complex/O2

@@ -4,5 +4,5 @@ restore [locate_data_file sf5] b2
 bop b1 b2
 bopfuse result
 
-checkprops result -s 64442.7
+checkprops result -s 62831.9
 checkview -display result -2d -otherwise { b1 b2 } -s -path ${imagedir}/${test_image}.png

tests/boolean/bopfuse_complex/O3

@@ -4,5 +4,5 @@ restore [locate_data_file sf3] b2
 bop b1 b2
 bopfuse result
 
-checkprops result -s 64442.7
+checkprops result -s 62831.9
 checkview -display result -2d -otherwise { b1 b2 } -s -path ${imagedir}/${test_image}.png