You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copyright (C) 2015 -- 2019 by Nicola Giuliani (1), Andrea Mola (2) and Luca Heltai (2)
12
12
13
-
(1) Scuola Internazionale Superiore di Studi Avanzati E-mail: [email protected]
13
+
(1) Scuola Internazionale Superiore di Studi Avanzati E-mail: <[email protected]>
14
14
15
-
(2) Scuola Internazionale Superiore di Studi Avanzati E-mail: [email protected]
15
+
(2) Scuola Internazionale Superiore di Studi Avanzati E-mail: <[email protected]>
16
16
17
-
(3) Scuola Internazionale Superiore di Studi Avanzati E-mail: [email protected]
17
+
(3) Scuola Internazionale Superiore di Studi Avanzati E-mail: <[email protected]>
18
18
19
-
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](https://github.com/dealii/dealii) library for Finite Element Handling, the [METIS](http://glaros.dtc.umn.edu/gkhome/metis/metis/download) project and [Trilinos](https://trilinos.org/) library for automatic Workload balance, [OpenCASCADE](https://www.opencascade.com/) for CAD integration, and [deal2lkit](https://github.com/luca-heltai/deal2lkit) for parameter handling.
19
+
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](https://github.com/dealii/dealii) library for Finite Element Handling, the [METIS](http://glaros.dtc.umn.edu/gkhome/metis/metis/download) project and [Trilinos](https://trilinos.org/) library for automatic Workload balance, and [OpenCASCADE](https://www.opencascade.com/) for CAD integration.
20
20
21
21
## Provided features
22
22
@@ -32,131 +32,125 @@ We provide the following capabilities
32
32
- Hybrid Distributed (MPI) - Shared (Intel Threaded Building Block) memory parallelisation for the BEM-FMM code
33
33
- Recovery of both primal (potential) and dual (potential normal derivative) unknowns.
34
34
- L2 projection of the full 3D potential gradient for post processing.
35
-
- Extensive tuning via parameter file using the [deal2lkit](https://github.com/mathLab/deal2lkit) library
36
-
35
+
- Extensive tuning via parameter file using.
37
36
38
37
## Code Structure
38
+
39
39
We have subdivided the code in main classes to handle the many different aspects of a complete BEM simulation.
40
40
41
41
- 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.
42
42
- ComputationalDomain. This class handles, and provides to the other classes, ONLY the geometry of the problem. In particular
43
-
- it handles the domain decomposition using a graph partitioning tool (METIS);
44
-
- it reads the domain from an external file.
43
+
- it handles the domain decomposition using a graph partitioning tool (METIS);
44
+
- it reads the domain from an external file.
45
45
- BoundaryCondition. The class handles the boundary conditions. In particular
46
-
- it reads the boundary conditions for the potential and its normal derivative;
47
-
- given the peculiarities of the BEM, the boundary conditions represent the actual unknowns, thus it creates the vectors containing the two variables and fills them with the proper data;
48
-
- it performs the error analysis on both unknowns.
46
+
- it reads the boundary conditions for the potential and its normal derivative;
47
+
- given the peculiarities of the BEM, the boundary conditions represent the actual unknowns, thus it creates the vectors containing the two variables and fills them with the proper data;
48
+
- it performs the error analysis on both unknowns.
49
49
50
50
- BEMProblem. This class is the core of the BEM simulation
51
-
- it receives the variables vector filled in with the proper boundary condition;
52
-
- it creates the codimension 1 functional space setting up the BEM;
53
-
- it solves the system using a preconditioned parallel GMRES solver;
54
-
- it eventually interacts with the FMM accelerator.
51
+
- it receives the variables vector filled in with the proper boundary condition;
52
+
- it creates the codimension 1 functional space setting up the BEM;
53
+
- it solves the system using a preconditioned parallel GMRES solver;
54
+
- it eventually interacts with the FMM accelerator.
55
55
- BEMFMA. This class handles the accelerator, in particular
56
-
- it sets up an hierarchical 3D space subdivision (octree);
57
-
- it receives two distributed vectors representing the unknowns and performs a full FMM matrix vector product.
56
+
- it sets up an hierarchical 3D space subdivision (octree);
57
+
- it receives two distributed vectors representing the unknowns and performs a full FMM matrix vector product.
58
58
59
59
## Install Procedure using CANDI
60
+
60
61
To install from scratch all the needed library you can look to the automatic installation procedure provided by [CANDI](https://github.com/koecher/candi) developed Uwe Köcher.
61
62
62
63
## Install Procedure using spack
64
+
63
65
Just follow the [instructions](https://github.com/dealii/dealii/wiki/deal.II-in-Spack) to install dealii@develop using spack.
64
66
65
67
## Install Procedure using Docker
66
-
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](https://docs.docker.com/engine/installation/) provided by its authors. Then you can execute the following command line instruction
67
68
68
-
docker run -v `pwd`:/pwd_to_your_own_directory/ -i -t mathlab/deal2lkit:latest bash
69
+
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](https://docs.docker.com/engine/installation/) provided by its authors. Then you can execute the following command line instruction
70
+
71
+
docker run -v `pwd`:/pwd_to_your_own_directory/ -i -t dealii/dealii:v9.6.0-jammy bash
69
72
70
73
to retrieve the environment. In such a shell you can easily compile the pi-BEM library following its own instructions.
71
74
72
75
## Install Procedure from scratch
73
-
In order to successfully compile the code you need
74
-
75
-
- to install the Trilinos and Metis wrappers of the library, see the official [instructions](https://www.dealii.org/developer/readme.html)
76
-
- to install the [deal.II](https://github.com/dealii/dealii) library allowing both for multiprocessors and multithreaded environment.
77
-
- to install the [deal2lkit](https://github.com/mathLab/deal2lkit) library allowing both for multiprocessors and multithreaded environment.
78
76
77
+
In order to successfully compile the code you need
79
78
79
+
- to install the Trilinos and Metis wrappers of the library, see the official [instructions](https://www.dealii.org/developer/readme.html)
80
+
- to install the [deal.II](https://github.com/dealii/dealii) library allowing both for multiprocessors and multithreaded environment.
80
81
81
82
### deal.II Installation procedure
82
-
Follow the detailed [instruction](https://www.dealii.org/developer/readme.html) 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.
83
83
84
+
Follow the detailed [instruction](https://www.dealii.org/developer/readme.html) 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.
84
85
85
86
### OpenCASCADE Installation procedure
86
-
- Download the latest version at [OpenCASCADE](https://github.com/tpaviot/oce)
87
-
- Follow the instructions
88
87
88
+
- Download the latest version at [OpenCASCADE](https://github.com/tpaviot/oce)
89
+
- Follow the instructions
89
90
90
91
### METIS-PARMETIS Installation procedure
92
+
91
93
- Download the latest version at [METIS](http://glaros.dtc.umn.edu/gkhome/metis/metis/download)
92
94
- Follow the [instructions](http://glaros.dtc.umn.edu/gkhome/metis/metis/download) for the correct installation of the package
93
95
94
-
95
96
### Trilinos Installation procedure
97
+
96
98
- Download the latest version at [Trilinos](https://trilinos.org/download/)
0 commit comments