aGrUM 2.3.2
a C++ library for (probabilistic) graphical models
multiDimCombineAndProject_tpl.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#pragma once
41
42
48
49#ifndef DOXYGEN_SHOULD_SKIP_THIS
50
51# include <agrum/agrum.h>
52
53namespace gum {
54
55 // default constructor
56 template < class TABLE >
58 // for debugging purposes
59 GUM_CONSTRUCTOR(MultiDimCombineAndProject);
60 }
61
62 // copy constructor
63 template < class TABLE >
66 // for debugging purposes
67 GUM_CONS_CPY(MultiDimCombineAndProject);
68 }
69
70 // destructor
71 template < class TABLE >
73 // for debugging purposes
74 GUM_DESTRUCTOR(MultiDimCombineAndProject);
75 }
76
77 // add to a given schedule the set of operations needed
78 template < class TABLE >
80 Schedule& schedule,
81 const Set< const IScheduleMultiDim* >& original_tables,
82 const gum::VariableSet& del_vars,
83 const bool is_result_persistent) const {
84 // compute the set of operations to perform and insert them into the schedule
85 auto ops_res = operations(original_tables, del_vars, false);
86 for (const auto op: ops_res.first)
87 schedule.insertOperation(*op);
88
89 // get the results actually stored into the schedule
90 Set< const IScheduleMultiDim* > result(ops_res.second.size());
91 if (!is_result_persistent) {
92 for (const auto pot: ops_res.second)
93 result.insert(schedule.scheduleMultiDim(pot->id()));
94 } else {
95 for (const auto pot: ops_res.second) {
96 const IScheduleMultiDim* table = schedule.scheduleMultiDim(pot->id());
97 const auto creating_op = schedule.scheduleMultiDimCreator(table);
98 if (creating_op != nullptr) {
99 const_cast< ScheduleOperator* >(creating_op)->makeResultsPersistent(true);
100 }
101 result.insert(table);
102 }
103 }
104
105 // free memory
106 for (const auto op: ops_res.first)
107 delete op;
108
109 return result;
110 }
111
112} /* namespace gum */
113
114#endif /* DOXYGEN_SHOULD_SKIP_THIS */
The Table-agnostic base class of scheduleMultiDim.
A generic interface to combine and project efficiently MultiDim tables.
virtual ~MultiDimCombineAndProject()
destructor
Set< const IScheduleMultiDim * > schedule(Schedule &schedule, const Set< const IScheduleMultiDim * > &original_tables, const gum::VariableSet &del_vars, const bool is_result_persistent=false) const
add to a given schedule the set of operations needed to perform all the combinations and projections
MultiDimCombineAndProject()
default constructor
the base class for "low-level" operators used to schedule inferences
Class containing a schedule of operations to perform on multidims.
Definition schedule.h:80
Representation of a set.
Definition set.h:131
gum is the global namespace for all aGrUM entities
Definition agrum.h:46
Set< const DiscreteVariable * > VariableSet