MoCSI API Reference
Loading...
Searching...
No Matches
Albedo.h
Go to the documentation of this file.
1#ifndef ALBEDO_H
2#define ALBEDO_H
3
4#define ALBEDO_VERSION "5"
5
6#include <iostream>
7#include <memory>
8#include <string>
9#include <valarray>
10
11#include "../../src/GenericManagingModule.h"
12#include "../../src/ModuleFactory.h"
13
36template <typename T>
38{
39 private:
46 static bool m_registered;
47
53 std::string m_ini_filepath{"albedo/Albedo.ini"};
54
55 public:
64
73 bool setup(std::vector<std::shared_ptr<GenericSubmodule<T>>> all_submodules) override;
74
87 bool exec(std::string_view param) override; // main functionality of the module
88
96 bool init() override;
97
105 bool preTimeStep() override;
106
114 bool postTimeStep() override { return true; };
115
123 bool output() override { return true; };
124
130 void writeToSim();
131
140 std::vector<std::string> getChainInsertion() const override
141 {
142 return this->ini_file_data.getStringVectorParameters("chain_insertion");
143 };
144
153 static std::shared_ptr<GenericManagingModule<T>> createMethode(SimulationClassBase<T>* sim)
154 {
155 return std::make_shared<Albedo<T>>(sim);
156 };
157
163 static std::string getName() { return "Albedo"; };
164
170 std::string_view getNameLocal() const override { return "Albedo"; };
171};
172
173// ================= Implementation =================
174
175template <typename T>
177{
178 try
179 {
180 std::string ini_folder_path{
181 this->sim->m_simulation_config.getStringParameters("ini_folder_path")};
182 this->ini_file_data.loadUserInput(ini_folder_path + m_ini_filepath);
184 }
185 catch (const BadInput& e)
186 {
187 std::cerr << "[Albedo]: " << e.what() << '\n';
188 throw BadInput(static_cast<std::string>("[Albedo]: ") + static_cast<std::string>(e.what()));
189 }
190}
191
192template <typename T>
193bool Albedo<T>::setup(std::vector<std::shared_ptr<GenericSubmodule<T>>> all_submodules)
194{
195 try
196 {
197 this->sim->m_field_map.insert(
198 {"Albedo", std::valarray<T>(
199 this->sim->m_simulation_config.getIntParameters("number_of_facets"))});
200 this->module_field = std::make_shared<std::valarray<T>>(
201 this->sim->m_simulation_config.getIntParameters("number_of_facets"));
202 this->setSubmodules(all_submodules);
203 }
204 catch (const BadInput& e)
205 {
206 std::cerr << "[Albedo]: Failed to insert field map and/or local field!\n[Albedo]: "
207 << e.what() << '\n';
208 throw BadInput(static_cast<std::string>(
209 "[Albedo]: Failed to insert field map and/or local field!\n[Albedo]: ")
210 + static_cast<std::string>(e.what()));
211 }
212 return true;
213}
214
215template <typename T>
216bool Albedo<T>::exec(std::string_view param)
217{
218 if (param == "InitChain")
219 {
220 return init();
221 }
222 if (param == "PreTimeStepChain")
223 {
224 return preTimeStep();
225 }
226 if (param == "PostTimeStepChain")
227 {
228 return postTimeStep();
229 }
230 if (param == "OutputChain")
231 {
232 return output();
233 }
234 return false;
235}
236
237template <typename T>
239{
240 this->sim->m_field_map["Albedo"] = (*this->module_field);
241}
242
243template <typename T>
245{
246 this->sub_module_chain.runChain("InitChain");
247 writeToSim();
248 return true;
249}
250
251template <typename T>
253{
254 this->sub_module_chain.runChain("PreTimeStepChain");
255 writeToSim();
256 return true;
257}
258
259template <typename T>
260bool Albedo<T>::m_registered = ModuleFactory<T>::registerModule(getName(), createMethode);
261
262#endif // ALBEDO_H
Managing module that calculates and manages surface albedo.
Definition Albedo.h:38
static std::shared_ptr< GenericManagingModule< T > > createMethode(SimulationClassBase< T > *sim)
Factory method for creating an Albedo module.
Definition Albedo.h:153
bool exec(std::string_view param) override
Main execution method of the module.
Definition Albedo.h:216
std::vector< std::string > getChainInsertion() const override
Get chain insertion points.
Definition Albedo.h:140
Albedo(SimulationClassBase< T > *sim)
Construct the Albedo module.
Definition Albedo.h:176
void writeToSim()
Write the current albedo field to the simulation.
Definition Albedo.h:238
bool postTimeStep() override
Post-time-step processing.
Definition Albedo.h:114
bool preTimeStep() override
Pre-time-step processing.
Definition Albedo.h:252
std::string_view getNameLocal() const override
Get the localized name of the module.
Definition Albedo.h:170
bool setup(std::vector< std::shared_ptr< GenericSubmodule< T > > > all_submodules) override
Setup method called after construction.
Definition Albedo.h:193
bool output() override
Output stage.
Definition Albedo.h:123
bool init() override
Initialization step.
Definition Albedo.h:244
static std::string getName()
Get the name of the module.
Definition Albedo.h:163
This error class inherits from std::exception and marks faulty parameter or CL inputs....
Definition IniParser.h:71
const char * what() const noexcept override
Definition IniParser.h:78
Abstract base class for the managing modules. Managing modules are the highest tier of modules and ar...
Definition GenericManagingModule.h:29
InputManager ini_file_data
Definition GenericManagingModule.h:38
SimulationClassBase< T > * sim
Definition GenericManagingModule.h:31
std::vector< std::string > m_generic_submodules
Definition GenericManagingModule.h:36
Abstract base class for the submodules. Submodules are below managing modules and will only be run by...
Definition GenericSubmodule.h:25
std::vector< std::string > getStringVectorParameters(const std::string &key) const
Definition InputManager.cpp:508
void loadUserInput(const std::string &user_ini_file_path)
Public function to load and merge user supplied ini files with the already stored data.
Definition InputManager.cpp:45
std::string getStringParameters(const std::string &key) const
Getter function to access the m_parameters map and returns a string. Throws a BadInput error,...
Definition InputManager.cpp:498
static constexpr bool registerModule(std::string name, creation_method module) noexcept
Function that adds a module to the module registry map.
Definition ModuleFactory.h:75
Definition SimulationClassBase.h:19
InputManager m_simulation_config
Definition SimulationClassBase.h:29