Parallel Boundary Element Method solver
Copyright (C) 2015 -- 2019 by Nicola Giuliani (1), Andrea Mola (2) and Luca Heltai (2)
(1) Scuola Internazionale Superiore di Studi Avanzati E-mail: [email protected]
(2) Scuola Internazionale Superiore di Studi Avanzati E-mail: [email protected]
(3) Scuola Internazionale Superiore di Studi Avanzati E-mail: [email protected]
The library represents a parallel solver for the Laplace equation through Boundary Element Methods. We have developed the software in C++ on top of many high performance libraries, the deal.II library for Finite Element Handling, the METIS project and Trilinos library for automatic Workload balance, OpenCASCADE for CAD integration, and deal2lkit for parameter handling.
We provide the following capabilities
We have subdivided the code in main classes to handle the many different aspects of a complete BEM simulation.
Driver. This class is in charge of organising the overall BEM simulation. It has interfaces with all the other classes in order to perform a complete simulation.
ComputationalDomain. This class handles, and provides to the other classes, ONLY the geometry of the problem. In particular
it handles the domain decomposition using a graph partitioning tool (METIS);
it reads the domain from an external file.
BoundaryCondition. The class handles the boundary conditions. In particular
BEMProblem. This class is the core of the BEM simulation
BEMFMA. This class handles the accelerator, in particular
To install from scratch all the needed library you can look to the automatic installation procedure provided by CANDI developed Uwe Köcher.
Just follow the instructions to install dealii@develop using spack.
We provide the possibility of using Docker as a tool to provide a fully operational environment for our library. To use such tool you need to install Docker following the instructions provided by its authors. Then you can execute the following command line instruction
docker run -v `pwd`:/pwd_to_your_own_directory/ -i -t mathlab/deal2lkit:latest bash
to retrieve the environment. In such a shell you can easily compile the pi-BEM library following its own instructions.
In order to successfully compile the code you need
Follow the detailed instruction to install deal with METIS and Trilinos wrappers. We highlight that in order to fully exploit pi-BEM you need to properly install the following additional packages: MPI, TBB, METIS, TRILINOS ans OPENCASCADE. For more detailed instruction you can look to the the deal.ii install procedures. In the following we provide an example of the installation of all the proper packages.
Download the latest version at Trilinos
This is a possible configuration file
cmake -D Trilinos_ENABLE_OPTIONAL_PACKAGES:BOOL=ON \
-D Trilinos_ENABLE_ALL_PACKAGES:BOOL=ON \
-D CMAKE_CXX_FLAGS:STRING="-O3" \
-D CMAKE_C_FLAGS:STRING="-O3" \
-D CMAKE_VERBOSE_MAKEFILE:BOOL=FALSE \
-D Trilinos_VERBOSE_CONFIGURE:BOOL=FALSE \
-D TPL_ENABLE_MPI:BOOL=ON \
-D CMAKE_BUILD_TYPE:STRING=RELEASE \
-D Trilinos_ENABLE_Fortran:BOOL=ON \
-D BLAS_LIBRARY_NAMES:STRING="blas" \
-D BLAS_LIBRARY_DIRS:PATH=/usr/lib/libblas/ \
-D TPL_BLAS_LIBRARIES:PATH=/usr/lib/libblas/ \
-D Trilinos_WARNINGS_AS_ERRORS_FLAGS:STRING="" \
-D CMAKE_INSTALL_PREFIX:PATH=/usr/local/ \
-D BUILD_SHARED_LIBS:BOOL=ON ../
make install
if some packages create conflicts they can be disabled as seen on the Trilinos webpage
Follow the detailed instruction to install deal2lkit.
Then you can clone the repository and compile it
git clone https://github.com/mathLab/pi-BEM.git
cd pi-BEM
mkdir build
cd build
cmake ../
make -j4
After you have compiled your application, you can run
make test
or
ctest
to start the testsuite.
Take a look at https://www.dealii.org/developer/developers/testsuite.html for more information on how to create tests and add categories of tests.
If you want you can run a preliminary execution in the build library typing
mpirun -np 1 bem_fma_2d
this will automatically generate the parameter file for the bi-dimensional run while
mpirun -np 1 bem_fma_3d
will create a proper parameter file for a 3 dimensional simulation.
Before making a pull request, please make sure you run the script
./scripts/indent
from the base directory of this project, to ensure that no random white space changes are inserted in the repository.
The script requires Artistic Style Version 2.04 (astyle) to work properly.
If you use this software, please consider citing the following work:
@article{GiulianiMolaHeltai2018,
doi = {10.1016/j.advengsoft.2018.03.008},
url = {https://doi.org/10.1016/j.advengsoft.2018.03.008},
year = {2018},
month = {jul},
publisher = {Elsevier {BV}},
volume = {121},
pages = {39--58},
author = {Nicola Giuliani and Andrea Mola and Luca Heltai},
title = {$\uppi$ - {BEM} : A flexible parallel implementation for adaptive, geometry aware, and high order boundary element methods},
journal = {Advances in Engineering Software}
}
#Licence
Please see the file LICENSE for details