doc/salome/gui/GEOM/input/partition_explanation.doc

   1 /*!
   2
   3 \page partition_explanation Fuse, Partition and Compound usage
   4
   5 \tableofcontents
   6
   7 It is frequently asked about the difference between the above mentioned operations. It is indeed simple. Let us take the example of a cylinder and a box that you want to join together.
   8
   9 \section sec1 Fuse
  10
  11 The \b fuse operation will make a <b>single solid</b> from two given solids. It allows you to build complex models by putting simple shapes together.
  12 \image html fuse.png
  13
  14 \section sec2 Partition
  15 The \b partition operation will also connect the solids but it will <b>keep a face at the frontier</b> (in brown in the picture below). The resulting shape will consist of <b>two connected solids</b> that share
  16 a face at their frontier. It means that this face is present only one time in the resulting shape and is a sub-shape of both the box and the cylinder.
  17
  18 \n This operation allows you to identify different areas in a shape (e.g. different materials) and to ensure a <b>conformal mesh</b> when meshing it later. Indeed the face at the frontier is meshed only once.
  19
  20 \image html partition.png
  21
  22
  23 \section sec3 Compound
  24 When you build a \b compound by using the Build -> Compound operation you just make <b>an object that contains two separate solids</b> like in a "bag".
  25 The two solids remain unconnected. The compound is just a set of shapes, no more.
  26
  27 \n The compound allows applying operations to a collection of shapes.
  28
  29 \image html compound2.png
  30
  31
  32 \section sec4 Summary
  33
  34 In the frame of this example we can summarize the following differences:
  35
  36 <ul>
  37 <li> \b Fuse
  38 <ul>
  39 <li> \a Result : A <b>single solid</b>. </li>
  40 <li> \a Purpose : Allows building complex models by putting simple shapes together.</li>
  41 </ul>
  42 <li> \b Partition
  43 <ul>
  44 <li>\a Result : Two <b>connected solids</b> sharing faces.</li>
  45 <li>\a Purpose : Useful to ensure a conformal mesh of separate areas of your model (fluid / solid , concrete / steel ...).</li>
  46 </ul>
  47 <li> \b Compound
  48 <ul>
  49 <li>\a Result : Two <b>unconnected solids</b>.</li>
  50 <li>\a Purpose : Allows applying operations to a collection of shapes.</li>
  51 </ul>
  52 </ul>
  53
  54
  55 */