-SALOME platform
-GHS3DPRL meshing plugin
-------------------------------
+**************************************
+About SALOME MG-Tetra Parallel plug-in
+**************************************
-Contents:
+SALOME MG-Tetra Parallel plug-in adds DISTENE MG-Tetra Parallel (former GHS3DPRL)
+meshing algorithm to the SALOME Mesh module.
-1. Pre-requisites
-2. Installation
-3. Launch SALOME with GHS3DPRLPLUGIN
-4. GHS3DPRLPLUGIN plugin usage
+MG-Tetra Parallel plug-in is destined for:
+- Meshing of 3D geometric entities: volumes are split into tetrahedral (pyramidal)
+ elements.
+- Generating of 3D meshes from 2D meshes, working without geometrical objects.
------------------
-1. Pre-requisites
------------------
+For more information please visit the SALOME platform web site:
-The information in this file assumes that:
+ <http://www.salome-platform.org/>
-* The SALOME platform is installed to the directory <salome>
-* The GHS3DPRL (Tepal) product is installed to the directory <salome>/ghs3dprl
+=======
+License
+=======
----------------
-2. Installation
----------------
+SALOME platform is distributed under the GNU Lesser General Public License.
+See COPYING file for more details.
-2.1. Unpack GHS3DPRLPLUGIN module sources
+Also, additional information can be found at SALOME platform web site:
-cd <salome>
-tar zxf GHS3DPRLPLUGIN_SRC.tgz
+ <http://www.salome-platform.org/downloads/license/>
-2.2. Build GHS3DPRLPLUGIN module
+============
+Installation
+============
-* set environment
+--------------
+Pre-requisites
+--------------
-bash
-cd <salome>
-source env_build.sh
+SALOME platform relies on a set of third-party softwares; some of them are needed
+at build time only, while other ones are needed in runtime also.
-* cmake build procedure
+For more information about the pre-requisites please visit SALOME platform web
+site:
-mkdir GHS3DPRLPLUGIN_BUILD
-cd GHS3DPRLPLUGIN_BUILD
-cmake -DCMAKE_BUILD_TYPE=<Mode> -DCMAKE_INSTALL_PREFIX=<GHS3DPRLPLUGIN_INSTALL> ../GHS3DPRLPLUGIN_SRC
+* Check Release Notes and Software Requirements of the latest SALOME release at
-,where <Mode> is build mode (Release or Debug),
-<GHS3DPRLPLUGIN_INSTALL> is a destination folder to install
-GHS3DPRLPLUGIN module of SALOME.
+ <http://www.salome-platform.org/downloads/current-version/>
-Verify that all pre-requisites required for the successful compilation
-of GHS3DPRLPLUGIN module have been found.
+* Pre-requisites page at SALOME web site:
-* compile and install plugin module
+ <http://www.salome-platform.org/downloads/license/>
-make
-make install
+Note: SALOME MG-Tetra Parallel plug-in needs SALOME KERNEL, SALOME GUI,
+SALOME Geometry and SALOME Mesh as pre-requisites.
-exit
+------------------
+Basic Installation
+------------------
-If the compilation is finished successfully (make and make install
-steps are finished without errors) the GHS3DPRLPLUGIN meshing module
-should be installed in the directory <GHS3DPRLPLUGIN_INSTALL>.
+The build procedure of the SALOME platform is implemented with CMake.
+In order to build the plug-in you have to do the following actions:
-----------------------------------
-3. Launch SALOME with GHS3DPRLPLUGIN
-----------------------------------
+1. Set up environment for pre-requisites (see "Pre-requisites" section above).
-* set environment
+2. Create a build directory:
-bash
-cd <salome>
-source env_products.sh
+ % mkdir GHS3DPRLPLUGIN_BUILD
-export GHS3DPRLPLUGIN_ROOT_DIR=<GHS3DPRLPLUGIN_INSTALL>
-export SalomeAppConfig=${GHS3DPRLPLUGIN_ROOT_DIR}/share/salome/resources/ghs3dprlplugin
-export PATH=<salome>/ghs3dprl:${PATH
+3. Configure the build procedure:
-* run SALOME
+ % cd GHS3DPRLPLUGIN_BUILD
+ % cmake -DCMAKE_BUILD_TYPE=<mode> -DCMAKE_INSTALL_PREFIX=<installation_directory> <path_to_src_dir>
-runSalome
+ where
+ - <mode> is either Release or Debug (default: Release);
+ - <installation_directory> is a destination folder to install SALOME MG-Tetra
+ Parallel plug-in (default: /usr);
+ - <path_to_src_dir> is a path to the SALOME MG-Tetra Parallel plug-in sources
+ directory.
-----------------------------
-4. GHS3DPRLPLUGIN plugin usage
-----------------------------
+ Note: by default (if CMAKE_INSTALL_PREFIX option is not given), SALOME MG-Tetra
+ Parallel plug-in will be configured for installation to the /usr directory that
+ requires root permissions to complete the installation.
-* Create new study
+4. Build and install:
-* Activate Geometry module and create simple geometry object
+ % make
+ % make install
-* Activate Mesh module
+ This will install SALOME MG-Tetra Parallel plug-in to the <installation_directory>
+ specified to cmake command on the previous step.
-* Invoke menu "Mesh/Create Mesh"
+-------------------
+Custom installation
+-------------------
+
+SALOME MG-Tetra Parallel plug-in supports a set of advanced configuration options;
+for more details learn CMakeLists.txt file in the root source directory.
+
+You can also use other options of cmake command to customize your installation.
+Learn more about available options by typing
+
+ % cmake --help
+
+=====
+Usage
+=====
+
+* Start SALOME.
+
+* Create new study.
+
+* Activate Geometry module and create simple geometry object.
+
+* Activate Mesh module.
+
+* Invoke menu "Mesh/Create Mesh".
* Select previously created geometry object by clicking it with the
-mouse in the Object Browser
+ mouse in the Object Browser.
* In the "Create mesh" dialog box:
-- activate "3D" page
-- In the "Algorithm" combo box select "GHS3DPRL"
-- Click on the button at the right of the "Hypothesis" combo box and
-select "GHS3DPRL parameters" item in the drop-down menu
+ - activate "3D" page;
+ - In the "Algorithm" combo box select "MG-Tetra Parallel";
+ - Click on the button at the right of the "Hypothesis" combo box and
+ select "MG-Tetra Parallel Parameters" item in the drop-down menu.
-* In the "Hypothesis Construction" dialog box set parameters of GHS3DPRL
- meshing algorithm and click "OK" button
+* In the "Hypothesis Construction" dialog box set parameters of
+ meshing algorithm and click "OK" button.
* In the "Create mesh" dialog box Click "Apply & Close" button to
- define mesh and close the dialog box
+ define mesh and close the dialog box.
* In the Object Browser select "Mesh_1" object, invoke context popup
-menu for it by clicking right mouse button and select "Compute" item
+ menu for it by clicking right mouse button and select "Compute" item.
-The resulting mesh created with GHS3DPRL plugin will be shown in the 3D
+The resulting mesh created with MG-Tetra Parallel plugin will be shown in the 3D
viewer.
+
+=============
+Documentation
+=============
+
+The directory doc contains additional documentation file of SALOME MG-Tetra
+Parallel plug-in.
+
+===============
+Troubleshooting
+===============
+
+Please, send a mail to webmaster.salome@opencascade.com.
