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