Salome HOME
0022745: [EDF] Improvement of Sewing operation
[modules/geom.git] / doc / salome / gui / GEOM / input / sewing_operation.doc
1 /*!
2
3 \page sewing_operation_page Sewing
4
5 \b Sewing operation allows uniting several faces (possibly contained
6 in a shell, solid or compound) into one shell while geometrically
7 coincident (within a specified tolerance) edges (or parts of edges) of
8 different faces are replaced by one edge thus producing a shell of
9 faces with shared boundaries.<p> 
10 This operation is similar to <b>New Entity - > Build - > Shell</b>
11 operation, the difference is that with \b Sewing you can specify the
12 tolerance and can get a non-manifold result. <p>
13 Possibility to create a non-manifold shell can be used e.g. to create a
14 shell forming several closed domains and then to create several solids
15 with shared boundaries from this shell.
16
17 \note Geometrically coincident faces (or part of faces) won't be
18 replaced by one face during \b Sewing.
19
20 To produce a \b Sewing operation in the <b>Main Menu</b> select <b>Repair - > Sewing</b>.
21
22 The \b Result will be a \b GEOM_Object (shell). 
23
24 \image html repair6.png
25
26 In this dialog: 
27 - Click on the "Arrow" button and select in the Object Browser or in the viewer one or more \b Shapes (faces or shells) to be sewn.
28 - Activate <b>Allow Non Manifold </b> check-box to produce non-manifold sewing, if required.
29 - Define precision for sewing in \b Tolerance field.
30 - Activate <b> Detect Free boundaries</b> button to display the number of free boundaries in the shape:
31 \image html neo-detect2.png 
32 - Click \b Apply or <b>Apply and Close</b> button.
33
34 This operation can be also launched using a <b>TUI Command:</b>
35
36 <em>geompy.MakeSewing(ListOfShape, Precision, AllowNonManifold=False),</em>
37
38 where \em ListOfShape is a list of faces or shells to be sewn, \em Precision is a
39 precision for sewing, \em AllowNonManifold is a flag that allows non-manifold sewing.
40
41 <b>Example:</b>
42
43 \image html image112.png "The initial faces"
44
45 \image html image113.png "The sewn faces"
46
47 Our <b>TUI Scripts</b> provide you with useful examples of the use of
48 \ref tui_sewing "Repairing Operations".
49
50 */