ug4
domain_distribution.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2011-2015: G-CSC, Goethe University Frankfurt
3  * Author: Sebastian Reiter
4  *
5  * This file is part of UG4.
6  *
7  * UG4 is free software: you can redistribute it and/or modify it under the
8  * terms of the GNU Lesser General Public License version 3 (as published by the
9  * Free Software Foundation) with the following additional attribution
10  * requirements (according to LGPL/GPL v3 §7):
11  *
12  * (1) The following notice must be displayed in the Appropriate Legal Notices
13  * of covered and combined works: "Based on UG4 (www.ug4.org/license)".
14  *
15  * (2) The following notice must be displayed at a prominent place in the
16  * terminal output of covered works: "Based on UG4 (www.ug4.org/license)".
17  *
18  * (3) The following bibliography is recommended for citation and must be
19  * preserved in all covered files:
20  * "Reiter, S., Vogel, A., Heppner, I., Rupp, M., and Wittum, G. A massively
21  * parallel geometric multigrid solver on hierarchically distributed grids.
22  * Computing and visualization in science 16, 4 (2013), 151-164"
23  * "Vogel, A., Reiter, S., Rupp, M., Nägel, A., and Wittum, G. UG4 -- a novel
24  * flexible software system for simulating pde based models on high performance
25  * computers. Computing and visualization in science 16, 4 (2013), 165-179"
26  *
27  * This program is distributed in the hope that it will be useful,
28  * but WITHOUT ANY WARRANTY; without even the implied warranty of
29  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
30  * GNU Lesser General Public License for more details.
31  */
32 
33 #ifndef __H__UG__domain_distribution__
34 #define __H__UG__domain_distribution__
35 
36 #include "lib_disc/domain.h"
39 
40 namespace ug
41 {
42 
43 class PartitionMap;
44 
46 template <typename TDomain>
47 static bool PartitionDomain_Bisection(TDomain& domain, PartitionMap& partitionMap,
48  int firstAxisToCut);
49 
51 template <typename TDomain>
52 static bool PartitionDomain_RegularGrid(TDomain& domain, PartitionMap& partitionMap,
53  int numCellsX, int numCellsY, int numCellsZ,
54  bool surfaceOnly);
55 
57 template <typename TDomain>
58 static bool
59 PartitionDomain_MetisKWay(TDomain& domain, PartitionMap& partitionMap,
60  int numPartitions, size_t baseLevel = 0,
61  int hWeight = 1, int vWeight = 1);
62 
64 
68 template <typename TDomain>
69 static bool
70 PartitionDomain_MetisKWay(TDomain& domain, PartitionMap& partitionMap,
71  int numPartitions, size_t baseLevel,
73 
75 
77 template <typename TDomain>
78 static bool
79 PartitionDomain_LevelBased(TDomain& domain, PartitionMap& partitionMap,
80  int numPartitions, size_t level);
81 
82 
84 template <typename TDomain>
85 static bool DistributeDomain(TDomain& domainOut,
86  PartitionMap& partitionMap,
87  bool createVerticalInterfaces);
88 
89 }// end of namespace
90 
92 // include implementation
94 
95 #endif
Definition: smart_pointer.h:108
Used to describe how a domain shall be distributed in a parallel environment.
Definition: partition_map.h:54
the ug namespace
static bool PartitionDomain_Bisection(TDomain &domain, PartitionMap &partitionMap, int firstAxisToCut)
partitions a domain by repeatedly cutting it along the different axis
static bool PartitionDomain_MetisKWay(TDomain &domain, PartitionMap &partitionMap, int numPartitions, size_t baseLevel=0, int hWeight=1, int vWeight=1)
partitions a domain by using graph-based partitioning by METIS
static bool PartitionDomain_LevelBased(TDomain &domain, PartitionMap &partitionMap, int numPartitions, size_t level)
Partitions a domain based on the elements of one level.
static bool PartitionDomain_RegularGrid(TDomain &domain, PartitionMap &partitionMap, int numCellsX, int numCellsY, int numCellsZ, bool surfaceOnly)
partitions a domain by sorting all elements into a regular grid
static bool DistributeDomain(TDomain &domainOut, PartitionMap &partitionMap, bool createVerticalInterfaces)
distributes a already distributed domain onto the specified processes