aGrUM 2.3.2
a C++ library for (probabilistic) graphical models
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-2025 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-2025 *
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
64
65#include <condition_variable>
66
67namespace gum {
68
75 public:
76 // ############################################################################
78 // ############################################################################
80
82 explicit SchedulerParallel(Size max_nb_threads = 0, double max_megabyte_memory = 0.0);
83
86
89
91 SchedulerParallel* clone() const final;
92
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:
141 };
142
143} /* namespace gum */
144
145// include the inlined functions if necessary
146#ifndef GUM_NO_INLINE
148#endif /* GUM_NO_INLINE */
149
150#endif /* GUM_SCHEDULER_PARALLEL_H */
Class containing a schedule of operations to perform on multidims.
Definition schedule.h:80
SchedulerParallel(const SchedulerParallel &from)
copy constructor
SchedulerParallel(SchedulerParallel &&from)
move constructor
double nbOperations(const Schedule &) final
returns an estimation of the number of elementary operations needed to perform a given schedule
SchedulerParallel(Size max_nb_threads=0, double max_megabyte_memory=0.0)
default constructor
void setMaxMemory(double megabytes) final
sets an upper bound on the memory consumption admissible
std::pair< double, double > memoryUsage(const Schedule &) final
returns the memory consumption used during the execution of a schedule
SchedulerSequential _sequential_scheduler_
a scheduler used for computing the number of operations and memory usage
void execute(Schedule &) final
execute all the operations of a given schedule
void setNumberOfThreads(Size nb) final
sets the number of threads that can be used by the scheduler
SchedulerParallel * clone() const final
virtual copy constructor
Scheduler(Size nb_threads=0, double max_megabyte_memory=0.0)
default constructor
std::size_t Size
In aGrUM, hashed values are unsigned long int.
Definition types.h:74
gum is the global namespace for all aGrUM entities
Definition agrum.h:46
STL namespace.
priority queues (in which an element cannot appear more than once)
a parallel scheduler that executes available operations
a scheduler that executes any available operation (chosen arbitrarily)
The class to use to execute a function by several threads.