Antares Xpansion
Investment simulations for Antares studies
Loading...
Searching...
No Matches
BendersBase.h
1#pragma once
2
3#include <antares-xpansion/benders/plugins/BendersPlugin.h>
4#include <execution>
5#include <filesystem>
6#include <mutex>
7#include <tbb/tbb.h>
8
9#include "BendersMathLogger.h"
10#include "BendersStructsDatas.h"
11#include "CriterionComputation.h"
12#include "ICommunicationStrategy.h"
13#include "SubproblemCut.h"
14#include "SubproblemWorker.h"
15#include "Worker.h"
16#include "WorkerMaster.h"
17#include "antares-xpansion/helpers/Timer.h"
18#include "antares-xpansion/xpansion_interfaces/ILogger.h"
19#include "common.h"
20
26template<class lambda>
27auto selectPolicy(lambda f, bool shouldParallelize)
28{
29 if (shouldParallelize)
30 {
31 return f(std::execution::par_unseq);
32 }
33 else
34 {
35 return f(std::execution::seq);
36 }
37}
38
40{
41public:
42 virtual ~BendersBase() = default;
44 Logger logger,
45 std::shared_ptr<Output::OutputWriter> writer,
46 std::shared_ptr<MathLoggerDriver> mathLoggerDriver,
47 std::shared_ptr<ICommunicationStrategy> communication_strategy = nullptr);
48 virtual void launch() = 0;
49 void set_solver_log_file(const std::filesystem::path& log_file);
50
51 double execution_time() const;
52 virtual std::string BendersName() const = 0;
53 // TODO rename to be consistent with data that it hold
54 // ref of value?
55 WorkerMasterDataVect AllCuts() const;
56 // BendersCuts CutsBestIteration() const;
57 // void Clean();
58 LogData GetBestIterationData() const;
59 void set_input_map(const CouplingMap& coupling_map);
60 int MasterRowIndex(const std::string& row_name) const;
61 void MasterChangeRhs(int id_row, double val) const;
62 // for test
63 void MasterGetRhs(double& rhs, int id_row) const;
64 void SetPlugin(std::shared_ptr<BendersPlugin> benders_plugin);
65
66 const VariableMap& MasterVariables() const
67 {
68 return master_variable_map_;
69 }
70
71 std::vector<double> MasterObjectiveFunctionCoeffs() const;
72 void MasterRowsCoeffs(std::vector<int>& mstart,
73 std::vector<int>& mclind,
74 std::vector<double>& dmatval,
75 int size,
76 std::vector<int>& nels,
77 int first,
78 int last) const;
79 int MasterGetNElems() const;
80 void MasterAddRows(const std::vector<char>& qrtype_p,
81 const std::vector<double>& rhs_p,
82 const std::vector<double>& range_p,
83 const std::vector<int>& mstart_p,
84 const std::vector<int>& mclind_p,
85 const std::vector<double>& dmatval_p,
86 const std::vector<std::string>& row_names = {}) const;
87 void MasterGetRowType(std::vector<char>& qrtype, int first, int last) const;
88 void ResetMasterFromLastIteration();
89 std::filesystem::path LastMasterPath() const;
90 bool MasterIsEmpty() const;
91
92 void DoFreeProblems(bool free_problems)
93 {
94 free_problems_ = free_problems;
95 }
96
97 int MasterGetnrows() const;
98 int MasterGetncols() const;
99 WorkerMasterData BestIterationWorkerMaster() const;
100 void SetMasterObjectiveFunctionCoeffsToZeros() const;
101 void SetMasterObjectiveFunction(const double* coeffs, int first, int last) const;
102 virtual void InitializeProblems() = 0;
103
104 void SetMaxIteration(int max_iteration)
105 {
106 _options.MAX_ITERATIONS = max_iteration;
107 }
108
109 BendersBaseOptions Options() const
110 {
111 return _options;
112 }
113
114 virtual void free() = 0;
115
116 int GetBendersRunNumber() const
117 {
118 return _data.criteria_current_iteration_data.benders_num_run;
119 }
120
121 void IncrementBendersRunNumber()
122 {
123 ++_data.criteria_current_iteration_data.benders_num_run;
124 }
125
126 CurrentIterationData GetCurrentIterationData() const;
127
128 CriteriaCurrentIterationData GetOuterLoopData() const;
129
130 std::vector<double> GetOuterLoopCriterionAtBestBenders() const;
131 virtual void init_data();
132 void init_data(double external_loop_lambda,
133 double external_loop_lambda_min,
134 double external_loop_lambda_max);
135 Output::SolutionData GetOuterLoopSolution() const;
136 void SaveOuterLoopSolutionInOutputFile() const;
137 void SaveCurrentOuterLoopIterationInOutputFile() const;
138 void SetBilevelBestub(double bilevel_best_ub);
139 void UpdateOuterLoopSolution();
140
141 bool isExceptionRaised() const;
142 void UpdateOverallCosts();
143 Logger _logger;
144 std::shared_ptr<Output::OutputWriter> _writer;
145 std::shared_ptr<MathLoggerDriver> mathLoggerDriver_;
146 std::once_flag variable_indice_once_flag;
147 void setCriterionComputationInputs(
148 const Benders::Criterion::CriterionInputData& criterion_input_data);
149
150protected:
151 bool exception_raised_ = false;
153 WorkerMasterDataVect workerMasterDataVect_;
154 WorkerMasterPtr _master;
155 std::shared_ptr<BendersPlugin> benders_plugin_;
156 // BendersCuts best_iteration_cuts_;
157 // BendersCuts current_iteration_cuts_;
158 VariableMap master_variable_map_;
159 CouplingMap coupling_map_;
160 VariableMap _problem_to_id;
161
163 bool init_data_ = true;
164 bool init_problems_ = true;
165 bool free_problems_ = true;
166 BendersBaseOptions _options;
167
168 std::vector<std::vector<double>> criteria_vector_for_each_iteration_;
169 bool is_bilevel_check_all_ = false;
170
171 virtual void Run() = 0;
172 void update_best_ub();
173 bool ShouldBendersStop();
174 bool is_initial_relaxation_requested() const;
175 bool SwitchToIntegerMaster(bool is_relaxed) const;
176 virtual void HandleInitialMasterRelaxation();
177 virtual void UpdateTrace();
178 virtual void ComputeXCut();
179 void roundXCut();
180 void ComputeInvestCost();
181 virtual void compute_ub();
182 virtual void get_master_value();
183 void GetSubproblemCut(SubProblemDataMap& subproblem_data_map);
184 void GetSubproblemCutFast(SubProblemDataMap& subproblem_data_map);
185 std::pair<std::vector<int>, std::vector<int>> GetProblemBasis(
186 const std::shared_ptr<SubproblemWorker>& worker) const;
187 std::shared_ptr<SubproblemWorker> BuildProblem(const std::pair<std::string, VariableMap>& kvp,
188 const std::string& name);
189 std::shared_ptr<SubproblemWorker> makeSubproblemWorker(
190 const std::pair<std::string, VariableMap>& kvp) const;
191 void SetBasisForSubproblem(const std::string& name,
192 const std::vector<int>& rstatus,
193 const std::vector<int>& cstatus);
194 void GetSubproblemCutCache(SubProblemDataMap& subproblem_data_map);
195 virtual void post_run_actions() const;
196 void BuildCutFull(const SubProblemDataMap& subproblem_data_map);
197 virtual void DeactivateIntegrityConstraints() const;
198 virtual void ActivateIntegrityConstraints() const;
199 virtual void SetDataPreRelaxation();
200 virtual void ResetDataPostRelaxation();
201 [[nodiscard]] std::filesystem::path GetSubproblemPath(const std::string& subproblem_name) const;
202 [[nodiscard]] double SubproblemWeight(int subproblem_count, const std::string& name) const;
203 [[nodiscard]] std::filesystem::path get_master_path() const;
204 [[nodiscard]] std::filesystem::path get_structure_path() const;
205 [[nodiscard]] LogData bendersDataToLogData(const CurrentIterationData& data) const;
206
207 template<typename T, typename... Args>
208 void reset_master(Args&&... args)
209 {
210 _master = std::make_shared<T>(std::forward<Args>(args)...);
211 master_is_empty_ = false;
212 }
213
214 void free_master();
215 void free_subproblems();
216 void AddSubproblem(const std::pair<std::string, VariableMap>& kvp);
217 [[nodiscard]] virtual WorkerMasterPtr get_master() const;
218 void MatchProblemToId();
219 void AddSubproblemName(const std::string& name);
220 [[nodiscard]] std::string get_master_name() const;
221 [[nodiscard]] std::string get_solver_name() const;
222 [[nodiscard]] int get_log_level() const;
223 [[nodiscard]] bool is_trace() const;
224 [[nodiscard]] Point get_x_cut() const;
225 void set_x_cut(const Point& x0);
226 [[nodiscard]] Point get_x_out() const;
227 void set_x_out(const Point& x0);
228 [[nodiscard]] double GetSubproblemCost() const;
229 void SetSubproblemCost(const double& subproblem_cost);
230 bool IsResumeMode() const;
231
232 std::filesystem::path LastIterationFile() const
233 {
234 return std::filesystem::path(_options.LAST_ITERATION_JSON_FILE);
235 }
236
237 void UpdateMaxNumberIterationResumeMode(int nb_iteration_done);
238 void SaveCurrentIterationInOutputFile() const;
239 void SaveSolutionInOutputFile() const;
240 void PrintCurrentIterationCsv();
241 void OpenCsvFile();
242 void CloseCsvFile();
243 void ChecksResumeMode();
244 virtual void SaveCurrentBendersData();
245 void ClearCurrentIterationCutTrace();
246 virtual void EndWritingInOutputFile() const;
247
248 [[nodiscard]] int GetNumIterationsBeforeRestart() const
249 {
250 return iterations_before_resume;
251 }
252
253 double GetBendersTime() const;
254 virtual void write_basis() const;
255
256 // SubproblemsMapPtr GetSubProblemsMapPtr() { return subproblem_map; }
257 SubproblemsMapPtr GetSubProblemMap() const
258 {
259 return subproblem_map;
260 }
261
262 StrVector GetSubProblemNames() const
263 {
264 return subproblems;
265 }
266
267 double AbsoluteGap() const
268 {
269 return _options.ABSOLUTE_GAP;
270 }
271
272 double RelativeGap() const
273 {
274 return _options.RELATIVE_GAP;
275 }
276
277 double RelaxedGap() const
278 {
279 return _options.RELAXED_GAP;
280 }
281
282 DblVector GetAlpha_i() const
283 {
284 return _data.single_subpb_costs_under_approx;
285 }
286
287 void SetAlpha_i(const DblVector& single_subpb_costs_under_approx)
288 {
289 _data.single_subpb_costs_under_approx = single_subpb_costs_under_approx;
290 }
291
292 int ProblemToId(const std::string& problem_name) const
293 {
294 return _problem_to_id.at(problem_name);
295 }
296
297 virtual void UpdateStoppingCriterion();
298 virtual bool ShouldRelaxationStop() const;
299
300 int GetNumOfSubProblemsSolvedBeforeResume()
301 {
302 return cumulative_number_of_subproblem_resolved_before_resume;
303 }
304
305 void BoundSimplexIterations(int subproblem_iteration);
306 void ResetSimplexIterationsBounds();
307
308 SubproblemsMapPtr subproblem_map;
309 SolverLogManager solver_log_manager_;
310
311 virtual void SolveSubproblem(PlainData::SubProblemData& subproblem_data,
312 const std::string& name,
313 const std::shared_ptr<SubproblemWorker>& worker);
314 void SetSubproblemVariablesIndices(const SubproblemWorker& subproblem);
315
316 Benders::Criterion::CriterionComputation criterion_computation_;
326 // Search for variables in sub problems that satisfy patterns
327 // var_indices is a vector(for each patterns p) of vector (var indices related
328 // to p)
330
331 void build_all_aggregated_cuts(const std::vector<SubProblemNamesInCut>& subproblem_names,
332 const std::vector<SubProblemDataMap>& gathered_subproblem_map);
333
334 int SetAggregation(int max_aggregation) const;
335
336private:
337 void print_master_and_cut(std::ostream& file,
338 int ite,
339 WorkerMasterData& trace,
340 const Point& xopt);
341 void print_master_csv(std::ostream& stream,
342 const WorkerMasterData& trace,
343 const Point& xopt) const;
344 void check_status(const SubProblemDataMap& subproblem_data_map) const;
345 [[nodiscard]] LogData build_log_data_from_data() const;
346 [[nodiscard]] Output::SolutionData solution() const;
347 [[nodiscard]] Output::SolutionData BendersSolution() const;
348 [[nodiscard]] std::string status_from_criterion() const;
349 void compute_cut_aggregate(const SubProblemDataMap& subproblem_data_map);
350 void compute_cut(const SubProblemDataMap& subproblem_data_map);
351 [[nodiscard]] std::map<std::string, int> get_master_variable_map(
352 const std::map<std::string, std::map<std::string, int>>& input_map) const;
353 [[nodiscard]] virtual bool shouldParallelize() const;
354
355 [[nodiscard]] const std::shared_ptr<ICommunicationStrategy>& GetCommunicationStrategy() const
356 {
357 return communication_strategy_;
358 }
359
360 Output::Iteration iteration(const WorkerMasterData& masterDataPtr_l) const;
361 LogData FinalLogData() const;
362 void FillWorkerMasterData(WorkerMasterData& data) const;
363 bool master_is_empty_ = true;
364 int _totalNbProblems = 0;
365 StrVector subproblems;
366 std::ofstream _csv_file;
367 std::filesystem::path _csv_file_path;
368 LogData best_iteration_data;
369 int iterations_before_resume = 0;
370 int cumulative_number_of_subproblem_resolved_before_resume = 0;
371 Timer benders_timer;
372 Output::SolutionData outer_loop_solution_data_;
373 std::unordered_map<std::string, std::pair<std::vector<int>, std::vector<int>>> basiss_;
374 std::shared_ptr<ICommunicationStrategy> communication_strategy_;
375};
376
377using pBendersBase = std::shared_ptr<BendersBase>;
Definition BendersBase.h:40
std::filesystem::path GetSubproblemPath(const std::string &subproblem_name) const
Get path to subproblem mps file from options.
Definition BendersBase.cpp:989
virtual void get_master_value()
Solve and get optimal variables of the Master Problem.
Definition BendersBase.cpp:374
void BoundSimplexIterations(int subproblem_iteration)
Definition BendersBase.cpp:1198
virtual void UpdateStoppingCriterion()
Update stopping criterion.
Definition BendersBase.cpp:237
void GetSubproblemCut(SubProblemDataMap &subproblem_data_map)
Solve and store optimal variables of all Subproblem Problems.
Definition BendersBase.cpp:478
std::shared_ptr< SubproblemWorker > BuildProblem(const std::pair< std::string, VariableMap > &kvp, const std::string &name)
Definition BendersBase.cpp:555
void SetSubproblemsVariablesIndices()
Definition BendersBase.cpp:653
virtual void init_data()
Initialize set of data used in the loop.
Definition BendersBase.cpp:43
std::filesystem::path get_master_path() const
Get path to master problem mps file from options.
Definition BendersBase.cpp:1021
void set_input_map(const CouplingMap &coupling_map)
set the input
Definition BendersBase.cpp:1068
virtual bool ShouldRelaxationStop() const
Check if initial relaxation should stop.
Definition BendersBase.cpp:225
double SubproblemWeight(int subproblem_count, const std::string &name) const
Return subproblem weight value.
Definition BendersBase.cpp:1001
virtual void UpdateTrace()
Update trace of the Benders for the current iteration.
Definition BendersBase.cpp:288
void update_best_ub()
Update best upper bound and best optimal variables.
Definition BendersBase.cpp:204
void roundXCut()
Definition BendersBase.cpp:1475
void BuildCutFull(const SubProblemDataMap &subproblem_data_map)
Add cuts in master problem.
Definition BendersBase.cpp:784
Definition CriterionComputation.h:10
this class contains all data read from user input file
Definition CriterionInputDataReader.h:83
Definition SolverAbstract.h:20
Class daughter of Worker Class, build and manage a subproblem.
Definition SubproblemWorker.h:16
Definition Timer.h:10
Class use to store trace information during the algorithm run.
Definition BendersStructsDatas.h:78
Definition launch.py:1
Definition common.h:205
Definition BendersStructsDatas.h:104
Definition BendersStructsDatas.h:9
Definition BendersStructsDatas.h:27
Definition ILogger.h:52
Definition OutputWriter.h:40
struct saves some entries to be later written to the json file
Definition OutputWriter.h:64
Definition SubproblemCut.h:12