Salome HOME
0020565: EDF 1045 GEOM : Doc Partition Methodology
authorvsr <vsr@opencascade.com>
Tue, 7 Dec 2010 14:06:52 +0000 (14:06 +0000)
committervsr <vsr@opencascade.com>
Tue, 7 Dec 2010 14:06:52 +0000 (14:06 +0000)
doc/salome/gui/GEOM/Makefile.am
doc/salome/gui/GEOM/input/common_operation.doc
doc/salome/gui/GEOM/input/cut_operation.doc
doc/salome/gui/GEOM/input/fuse_operation.doc
doc/salome/gui/GEOM/input/index.doc
doc/salome/gui/GEOM/input/partition.doc
doc/salome/gui/GEOM/input/related_docs.doc [new file with mode: 0644]
doc/salome/gui/GEOM/input/section_operation.doc
doc/salome/gui/GEOM/input/using_boolean_operations.doc
doc/salome/gui/GEOM/static/SALOME_BOA_PA.pdf [new file with mode: 0755]

index 9740ec3ec02ea9b45604bfb19d3d80901670f6c2..02cfc0e0897024f299e835f555f3fa208c930fb4 100755 (executable)
@@ -27,7 +27,7 @@ include $(top_srcdir)/adm_local/unix/make_common_starter.am
 EXTRA_DIST += images input static/footer.html static/doxygen.css
 
 guidocdir = $(docdir)/gui/GEOM
-guidoc_DATA = images/head.png
+guidoc_DATA = images/head.png static/SALOME_BOA_PA.pdf
 
 usr_docs: doxyfile_tui doxyfile_py doxyfile
        echo "===========================================" ;                    \
index dfefce0dfd9799e5732548532f9ff245f772aa7d..15a3607ffa9aeaf47683888cd550be49b2135e66 100644 (file)
@@ -2,19 +2,25 @@
 
 \page common_operation_page Common
 
-\n To produce a \b Common operation in the <b>Main Menu</b> select <b>Operations - > Boolean - > Common</b>
+For detail description of the Boolean operations please refer to
+<a href="SALOME_BOA_PA.pdf">this document</a>. 
+It provides a general review of the Partition and Boolean
+operations algorithms, describes the usage methodology and highlighs
+major limitations of these operations.
 
-\n This operation cuts the common part of two shapes and transforms it into an independent geometrical object.
+To produce a \b Common operation in the <b>Main Menu</b> select <b>Operations - > Boolean - > Common</b>
 
-\n The \b Result will be any \b GEOM_Object.
-\n <b>TUI Command:</b> <em>geompy.MakeCommon(s1, s2)</em>
-\n <b>Arguments:</b> Name + 2 shapes.
-\n <b>Advanced option:</b>
-   \ref restore_presentation_parameters_page "Set presentation parameters and subshapes from arguments".
+This operation cuts the common part of two shapes and transforms it into an independent geometrical object.
+
+The \b Result will be any \b GEOM_Object.
+<b>TUI Command:</b> <em>geompy.MakeCommon(s1, s2)</em>
+<b>Arguments:</b> Name + 2 shapes.
+<b>Advanced option:</b>
+\ref restore_presentation_parameters_page "Set presentation parameters and subshapes from arguments".
 
 \image html bool2.png
 
-\n <b>Example:</b>
+<b>Example:</b>
 
 \image html fusesn1.png "The initial shapes"
 
index bab9ca7b80b9f837bc954f64e07177cf5d096570..3eee98514b2016a3ee594b2a8eae22dbcf927878 100644 (file)
@@ -2,19 +2,25 @@
 
 \page cut_operation_page Cut
 
-\n To produce a \b Cut operation in the <b>Main Menu</b> select <b>Operations - > Boolean - > Cut</b>
+For detail description of the Boolean operations please refer to
+<a href="SALOME_BOA_PA.pdf">this document</a>. 
+It provides a general review of the Partition and Boolean
+operations algorithms, describes the usage methodology and highlighs
+major limitations of these operations.
 
-\n This operation cuts a shape with another one.
-\n The \b Result will be any \b GEOM_Object.
-\n <b>Arguments:</b> Name + 2 shapes.
-\n <b>Advanced option:</b>
-   \ref restore_presentation_parameters_page "Set presentation parameters and subshapes from arguments".
+To produce a \b Cut operation in the <b>Main Menu</b> select <b>Operations - > Boolean - > Cut</b>
 
-\n <b>Dialog Box:</b>
+This operation cuts a shape with another one.
+The \b Result will be any \b GEOM_Object.
+<b>Arguments:</b> Name + 2 shapes.
+<b>Advanced option:</b>
+\ref restore_presentation_parameters_page "Set presentation parameters and subshapes from arguments".
+
+<b>Dialog Box:</b>
 
 \image html bool3.png
 
-\n <b>Example:</b>
+<b>Example:</b>
 
 \image html fusesn1.png "The initial shapes"
 
index ece199c5c3832c75a4bfce791340b69ceb37a126..42026ee9990e0cbe6af6000793df19ca17d6c545 100644 (file)
@@ -2,20 +2,26 @@
 
 \page fuse_operation_page Fuse
 
-\n To produce a \b Fuse operation in the <b>Main Menu</b> select
+For detail description of the Boolean operations please refer to
+<a href="SALOME_BOA_PA.pdf">this document</a>. 
+It provides a general review of the Partition and Boolean
+operations algorithms, describes the usage methodology and highlighs
+major limitations of these operations.
+
+To produce a \b Fuse operation in the <b>Main Menu</b> select
 <b>Operations - > Boolean - > Fuse</b>
 
-\n This operation creates a shape from two shapes.
+This operation creates a shape from two shapes.
 
-\n The \b Result will be any \b GEOM_Object.
-\n <b>TUI Command:</b> <em>geompy.MakeFuse(s1, s2)</em>
-\n <b>Arguments:</b> Name + 2 shapes.
-\n <b>Advanced option:</b>
-   \ref restore_presentation_parameters_page "Set presentation parameters and subshapes from arguments".
+The \b Result will be any \b GEOM_Object.
+<b>TUI Command:</b> <em>geompy.MakeFuse(s1, s2)</em>
+<b>Arguments:</b> Name + 2 shapes.
+<b>Advanced option:</b>
+\ref restore_presentation_parameters_page "Set presentation parameters and subshapes from arguments".
 
 \image html bool1.png
 
-\n <b>Example:</b>
+<b>Example:</b>
 
 \image html fusesn1.png "The initial shapes"
 
index 856e03a54dc607580b73ae862598fad27f7c6952..b4368cbcd8ee28ce3ea646ccd9cfc2d18b16a240 100644 (file)
@@ -27,5 +27,7 @@ Also it can be useful to have a look at the \subpage geompypkg_page "documentati
 
 \image html image3.png "Example of Geometry module usage for engineering tasks"
 
+There are also \subpage related_docs_page "additional reference documents"
+for Geometry module that can be useful.
 
 */
index c802d76118b98466db24643ad916561a55603f23..446d525afb642228bc9e36130452f449ea44aac1 100644 (file)
@@ -2,6 +2,12 @@
 
 \page partition_page Partition
 
+For detail description of the Partition operation please refer to
+<a href="SALOME_BOA_PA.pdf">this document</a>. 
+It provides a general review of the Partition and Boolean
+operations algorithms, describes the usage methodology and highlighs
+major limitations of these operations.
+
 To produce a \b Partition in the <b>Main Menu</b> select <b>Operations - > Partition</b>
 
 This operation builds a compound by intersection of several shapes
diff --git a/doc/salome/gui/GEOM/input/related_docs.doc b/doc/salome/gui/GEOM/input/related_docs.doc
new file mode 100644 (file)
index 0000000..fea4ba0
--- /dev/null
@@ -0,0 +1,10 @@
+/*!
+\page related_docs_page Related Documents
+
+Here you can find additional reference documents for Geometry module
+that can be useful for reading.
+
+<a href="SALOME_BOA_PA.pdf">General Fuse Algorithm, Partition
+Algorithm, Boolean Operations Algorithm. Backgrounds.</a>
+
+*/
index c4f450d3071cd9e2f759b172dd2886107be58ccb..6dd99f642c05766f433a56a38ae95348a00268eb 100644 (file)
@@ -2,20 +2,26 @@
 
 \page section_opeartion_page Section
 
-\n To produce a \b Section operation in the <b>Main Menu</b> select
+For detail description of the Boolean operations please refer to
+<a href="SALOME_BOA_PA.pdf">this document</a>. 
+It provides a general review of the Partition and Boolean
+operations algorithms, describes the usage methodology and highlighs
+major limitations of these operations.
+
+To produce a \b Section operation in the <b>Main Menu</b> select
 <b>Operations - > Boolean - > Section</b>
 
-\n This operation creates the section between 2 shapes.
+This operation creates the section between 2 shapes.
 
-\n The \b Result will be any \b GEOM_Object (EDGE or WIRE).
-\n <b>TUI Command:</b> <em>geompy.MakeSection(s1, s2)</em>
-\n <b>Arguments:</b> Name + 2 shapes.
-\n <b>Advanced option:</b>
-   \ref restore_presentation_parameters_page "Set presentation parameters and subshapes from arguments".
+The \b Result will be any \b GEOM_Object (EDGE or WIRE).
+<b>TUI Command:</b> <em>geompy.MakeSection(s1, s2)</em>
+<b>Arguments:</b> Name + 2 shapes.
+<b>Advanced option:</b>
+\ref restore_presentation_parameters_page "Set presentation parameters and subshapes from arguments".
 
 \image html neo-section.png
 
-\n <b>Example:</b>
+<b>Example:</b>
 
 \image html fusesn1.png "The initial shapes"
 
index c7fd67b75c75c6365be91f5d3a5e93094952a8b8..cfbb5f4446d3d7f612020c7d3df353ef1a31a8ba 100644 (file)
@@ -2,7 +2,13 @@
 
 \page using_boolean_operations_page Using Boolean Operations
 
-\n You can use the following boolean operations for construction of more
+For detail description of the Boolean operations please refer to
+<a href="SALOME_BOA_PA.pdf">this document</a>. 
+It provides a general review of the Partition and Boolean
+operations algorithms, describes the usage methodology and highlighs
+major limitations of these operations.
+
+You can use the following boolean operations for construction of more
 complex geometrical objects (2D & 3D elements):
 
 <ul>
@@ -38,7 +44,7 @@ Shape2 is the second argument of Cut operation;
 <em>geompy.MakeSection(Shape1, Shape2)</em>, where \em Shape1 and \em
 Shape2 is the second argument of Section operation;
 
-\n Our <b>TUI Scripts</b> provide you with useful examples of the use of 
+Our <b>TUI Scripts</b> provide you with useful examples of the use of 
 \ref tui_boolean_operations_page "Boolean Operations".
 
 */
diff --git a/doc/salome/gui/GEOM/static/SALOME_BOA_PA.pdf b/doc/salome/gui/GEOM/static/SALOME_BOA_PA.pdf
new file mode 100755 (executable)
index 0000000..f0da9b2
Binary files /dev/null and b/doc/salome/gui/GEOM/static/SALOME_BOA_PA.pdf differ