Salome HOME
Update documentation
[modules/geom.git] / doc / salome / gui / GEOM / input / section_operation.doc
1 /*!
2
3 \page section_opeartion_page Section
4
5 \b Section operation creates an edge or a wire representing the intersection of surfaces of two shapes.
6
7 To produce it, select in the main menu <b>Operations - > Boolean - > Section</b>
8
9 \image html neo-section.png "Section dialog"
10
11 In this dialog:
12 - Input or accept the default \b Name of the resulting shape. 
13 - Click the arrow button and select in the Object Browser or in the Viewer the intersecting <b>Objects</b>.
14 - Activate the corresponding check-box if you wish to <b> Detect Self-intersections </b>.
15 - Activate \ref restore_presentation_parameters_page "Advanced options" if required.
16 - Press "Apply" or "Apply & Close" button to get the result (EDGE or WIRE).
17
18 \note This algorithm does not find all types of self-intersections. It is tuned
19       to detect vertex/vertex, vertex/edge, edge/edge, vertex/face and edge/face
20       intersections. Face/face intersections detection is switched off as it
21       is a time-consuming operation that gives an impact on performance. To find
22       all self-intersections use \ref check_self_intersections_page
23       "Detect Self-intersection tool".
24           
25 This operation can be performed using a <b>TUI Command:</b> 
26
27 <em>geompy.MakeSection(s1, s2, checkSelfInte)</em>
28
29 <b>Arguments:</b> Name + 2 shapes + an optional flag for self-intersection check.
30
31 <b>Example:</b>
32
33 \image html fusesn1.png "The initial shapes"
34
35 \image html sectionsn.png "The resulting object"
36
37 Our <b>TUI Scripts</b> provide you with useful examples of the use of
38 \ref tui_section "Boolean Operations".
39
40 <b> More details </b>
41
42 Please refer to <a href="SALOME_BOA_PA.pdf">this document</a> for a detailed description of Boolean operations. 
43 It provides a general review of the Partition and Boolean
44 operations algorithms, describes the usage methodology and highlights
45 major limitations of these operations.
46
47 */