aGrUM
3.2.0
a C++ library for (probabilistic) graphical models
Toggle main menu visibility
schedulerParallel.h
Go to the documentation of this file.
1
/****************************************************************************
2
* This file is part of the aGrUM/pyAgrum library. *
3
* *
4
* Copyright (c) 2005-2026 by *
5
* - Pierre-Henri WUILLEMIN(_at_LIP6) *
6
* - Christophe GONZALES(_at_AMU) *
7
* *
8
* The aGrUM/pyAgrum library is free software; you can redistribute it *
9
* and/or modify it under the terms of either : *
10
* *
11
* - the GNU Lesser General Public License as published by *
12
* the Free Software Foundation, either version 3 of the License, *
13
* or (at your option) any later version, *
14
* - the MIT license (MIT), *
15
* - or both in dual license, as here. *
16
* *
17
* (see https://agrum.gitlab.io/articles/dual-licenses-lgplv3mit.html) *
18
* *
19
* This aGrUM/pyAgrum library is distributed in the hope that it will be *
20
* useful, but WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, *
21
* INCLUDING BUT NOT LIMITED TO THE WARRANTIES MERCHANTABILITY or FITNESS *
22
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE *
23
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER *
24
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, *
25
* ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR *
26
* OTHER DEALINGS IN THE SOFTWARE. *
27
* *
28
* See LICENCES for more details. *
29
* *
30
* SPDX-FileCopyrightText: Copyright 2005-2026 *
31
* - Pierre-Henri WUILLEMIN(_at_LIP6) *
32
* - Christophe GONZALES(_at_AMU) *
33
* SPDX-License-Identifier: LGPL-3.0-or-later OR MIT *
34
* *
35
* Contact : info_at_agrum_dot_org *
36
* homepage : http://agrum.gitlab.io *
37
* gitlab : https://gitlab.com/agrumery/agrum *
38
* *
39
****************************************************************************/
40
41
47
48
#ifndef GUM_SCHEDULER_PARALLEL_H
49
#define GUM_SCHEDULER_PARALLEL_H
50
51
#include <algorithm>
52
#include <atomic>
53
#include <chrono>
54
#include <memory>
55
#include <mutex>
56
#include <thread>
57
#include <vector>
58
59
#include <
agrum/agrum.h
>
60
61
#include <
agrum/base/core/priorityQueue.h
>
62
#include <
agrum/base/core/threads/threadExecutor.h
>
63
#include <
agrum/base/graphicalModels/inference/scheduler/schedulerSequential.h
>
64
65
#include <condition_variable>
66
67
namespace
gum
{
68
74
class
SchedulerParallel
:
public
Scheduler
{
75
public
:
76
// ############################################################################
78
// ############################################################################
80
82
explicit
SchedulerParallel
(
Size
max_nb_threads = 0,
double
max_megabyte_memory = 0.0);
83
85
SchedulerParallel
(
const
SchedulerParallel
& from);
86
88
SchedulerParallel
(
SchedulerParallel
&& from);
89
91
[[nodiscard]]
SchedulerParallel
*
clone
() const final;
92
94
~
SchedulerParallel
() override;
95
97
98
// ############################################################################
100
// ############################################################################
102
104
108
void
setNumberOfThreads
(
Size
nb) final;
109
111
116
void
setMaxMemory
(
double
megabytes) final;
117
119
void
execute
(
Schedule
&) final;
120
123
double
nbOperations
(const
Schedule
&) final;
124
126
133
std
::pair<
double
,
double
>
memoryUsage
(const
Schedule
&) final;
134
136
137
138
private:
140
SchedulerSequential
_sequential_scheduler_
;
141
};
142
143
}
/* namespace gum */
144
145
// include the inlined functions if necessary
146
#ifndef GUM_NO_INLINE
147
# include <
agrum/base/graphicalModels/inference/scheduler/schedulerParallel_inl.h
>
148
#endif
/* GUM_NO_INLINE */
149
150
#endif
/* GUM_SCHEDULER_PARALLEL_H */
agrum.h
gum::Schedule
Class containing a schedule of operations to perform on multidims.
Definition
schedule.h:79
gum::SchedulerParallel::SchedulerParallel
SchedulerParallel(const SchedulerParallel &from)
copy constructor
gum::SchedulerParallel::SchedulerParallel
SchedulerParallel(SchedulerParallel &&from)
move constructor
gum::SchedulerParallel::nbOperations
double nbOperations(const Schedule &) final
returns an estimation of the number of elementary operations needed to perform a given schedule
gum::SchedulerParallel::SchedulerParallel
SchedulerParallel(Size max_nb_threads=0, double max_megabyte_memory=0.0)
default constructor
gum::SchedulerParallel::setMaxMemory
void setMaxMemory(double megabytes) final
sets an upper bound on the memory consumption admissible
gum::SchedulerParallel::memoryUsage
std::pair< double, double > memoryUsage(const Schedule &) final
returns the memory consumption used during the execution of a schedule
gum::SchedulerParallel::_sequential_scheduler_
SchedulerSequential _sequential_scheduler_
a scheduler used for computing the number of operations and memory usage
Definition
schedulerParallel.h:140
gum::SchedulerParallel::execute
void execute(Schedule &) final
execute all the operations of a given schedule
gum::SchedulerParallel::setNumberOfThreads
void setNumberOfThreads(Size nb) final
sets the number of threads that can be used by the scheduler
gum::SchedulerParallel::clone
SchedulerParallel * clone() const final
virtual copy constructor
gum::SchedulerSequential
Definition
schedulerSequential.h:60
gum::Scheduler::Scheduler
Scheduler(Size nb_threads=0, double max_megabyte_memory=0.0)
default constructor
gum::Size
std::size_t Size
In aGrUM, hashed values are unsigned long int.
Definition
types.h:74
gum
gum is the global namespace for all aGrUM entities
Definition
agrum.h:46
std
STL namespace.
priorityQueue.h
priority queues (in which an element cannot appear more than once)
schedulerParallel_inl.h
a parallel scheduler that executes available operations
schedulerSequential.h
a scheduler that executes any available operation (chosen arbitrarily)
threadExecutor.h
The class to use to execute a function by several threads.
aGrUM
3.2.0
© PHW&CG&others - 2022
DoXyGeN 1.18.0