BioCMAMC-ST
api.hpp
1#ifndef __BIOMC_API_HPP__
2#define __BIOMC_API_HPP__
3
4#include <api/results.hpp>
5#include <common/execinfo.hpp>
6#include <common/logger.hpp>
7#include <core/case_data.hpp>
8#include <core/scalar_factory.hpp>
9#include <core/simulation_parameters.hpp>
10#include <cstdlib>
11#include <memory>
12#include <optional>
13#include <simulation/feed_descriptor.hpp>
14#include <simulation/mass_transfer.hpp>
15#include <string_view>
16#include <utility>
17
22namespace Api
23{
24 constexpr std::array<int, 3>
26 {
27 return { _BIOMC_VERSION_MAJOR, _BIOMC_VERSION_MINOR, _BIOMC_VERSION_DEV };
28 }
29
30 // concat 3*two bits
31 constexpr int
32 validate_version(int major, int minor, int dev)
33 {
34 auto cmp2 = [](int a, int b) -> int { return 1 + (a > b) - (a < b); };
35
36 return (cmp2(major, _BIOMC_VERSION_MAJOR) << 4)
37 | (cmp2(minor, _BIOMC_VERSION_MINOR) << 2)
38 | (cmp2(dev, _BIOMC_VERSION_DEV) << 0);
39 }
40
41 constexpr bool
42 version_is_compatible(int major, int minor, int dev)
43 {
44 // Reference value when all fields are equal
45 constexpr int VERSION_EQUAL = (1 << 4) | (1 << 2) | (1 << 0);
46 return validate_version(major, minor, dev) >= VERSION_EQUAL;
47 }
48
49 void finalise();
50
67 {
68 public:
86
96 static std::optional<std::unique_ptr<SimulationInstance>>
97 init(int argc,
98 char** argv,
99 std::optional<std::size_t> run_id = std::nullopt) noexcept;
100
101 static std::vector<std::string> get_model_list() noexcept;
102
111
119 ApiResult apply(bool to_load) noexcept;
120
126 ApiResult apply() noexcept;
127
134 ApiResult apply_load() noexcept;
135
143 register_parameters(Core::UserControlParameters&& params) noexcept;
144
151 bool register_result_path(std::string_view path);
152
154 register_initial_condition(Core::ScalarFactory::ScalarVariant&& type);
155 ApiResult register_initialiser_file_path(std::string_view path);
163 ApiResult register_cma_path(std::string_view path);
164
171 bool register_serde(std::string_view path);
172
179 ApiResult register_model_name(std::string_view path);
180
181 ApiResult add_feed(Simulation::Feed::FeedDescriptor feed_type, Phase phase);
182
183 ApiResult set_mtr(Simulation::MassTransfer::Type::MtrTypeVariant&& variant);
184
185 void set_auto_mtr();
186
188 register_scalar_initiazer(Core::ScalarFactory::ScalarVariant&& var);
189
195 [[nodiscard]] int get_id() const;
196
197 [[nodiscard]] const ExecInfo& get_exec_info() const;
198
204 ApiResult exec() noexcept;
205
206 void
207 set_logger(std::shared_ptr<IO::Logger> _logger)
208 {
209
210 logger = std::move(_logger);
211 }
212
213 [[nodiscard]] auto&
215 {
216 return logger;
217 }
218
219 private:
220 int id{};
221
230 SimulationInstance(int argc,
231 char** argv,
232 std::optional<std::size_t> run_id);
233
234 std::shared_ptr<IO::Logger> logger;
235
236 std::optional<Core::ScalarFactory::ScalarVariant> scalar_initializer_variant
237 = std::nullopt;
240 bool loaded = false;
241 bool applied = false;
242 bool registered = false;
243 std::optional<Simulation::Feed::SimulationFeed> feed
244 = std::nullopt;
245 std::optional<Simulation::MassTransfer::Type::MtrTypeVariant> mtr_type
246 = std::nullopt;
247
249 };
250
251} // namespace Api
252#endif
Api This namespace contains classes and functions related to the simulation API.
Definition api.hpp:23
constexpr std::array< int, 3 > get_version()
Definition api.hpp:25
void finalise()
Definition api.cpp:108
constexpr int validate_version(int major, int minor, int dev)
Definition api.hpp:32
constexpr bool version_is_compatible(int major, int minor, int dev)
Definition api.hpp:42
Core component to perform simulation.
Definition data_exporter.hpp:38
Definition impl_post_process.hpp:11
Namespace that contains classes and structures related to simulation handling.
Definition host_specific.hpp:12
Definition results.hpp:8
ApiResult register_model_name(std::string_view path)
Register the model name for the simulation.
Definition api.cpp:467
SimulationInstance(SimulationInstance &&)=default
Defaulted move constructor for efficient resource transfer.
std::optional< Core::ScalarFactory::ScalarVariant > scalar_initializer_variant
Definition api.hpp:237
bool register_result_path(std::string_view path)
Register a result output path.
Definition api.cpp:408
static std::vector< std::string > get_model_list() noexcept
Definition api.cpp:474
bool registered
Flag indicating if resources are registered.
Definition api.hpp:242
ApiResult apply(bool to_load) noexcept
Apply the simulation configuration and prepare for execution.
Definition api.cpp:374
const ExecInfo & get_exec_info() const
Definition api.cpp:480
ApiResult add_feed(Simulation::Feed::FeedDescriptor feed_type, Phase phase)
Definition api.cpp:131
ApiResult exec() noexcept
Execute the simulation.
Definition api.cpp:214
bool register_serde(std::string_view path)
Register a serialization/deserialization (serde) path.
Definition api.cpp:459
void set_logger(std::shared_ptr< IO::Logger > _logger)
Definition api.hpp:207
std::optional< Simulation::MassTransfer::Type::MtrTypeVariant > mtr_type
Definition api.hpp:246
void set_auto_mtr()
Definition api.cpp:293
SimulationInstance(const SimulationInstance &)=delete
Deleted copy constructor to prevent copying.
ApiResult register_initial_condition(Core::ScalarFactory::ScalarVariant &&type)
Definition api.cpp:451
auto & get_logger() const
Definition api.hpp:214
Core::CaseData _data
Case data for the simulation.
Definition api.hpp:238
bool auto_mtr
Definition api.hpp:248
SimulationInstance & operator=(SimulationInstance &&)=default
Defaulted move assignment operator for efficient resource transfer.
std::shared_ptr< IO::Logger > logger
Definition api.hpp:234
int get_id() const
Retrieve the simulation instance's unique identifier.
Definition api.cpp:125
static std::optional< std::unique_ptr< SimulationInstance > > init(int argc, char **argv, std::optional< std::size_t > run_id=std::nullopt) noexcept
Initialize a simulation instance.
Definition api.cpp:199
ApiResult register_cma_path(std::string_view path)
Register a path for CMA data.
Definition api.cpp:424
ApiResult apply_load() noexcept
Load ad apply the simulation configuration and prepare for execution based on file.
Definition api.cpp:248
ApiResult set_mtr(Simulation::MassTransfer::Type::MtrTypeVariant &&variant)
Definition api.cpp:283
ApiResult register_parameters(Core::UserControlParameters &&params) noexcept
Register user control parameters for the simulation.
Definition api.cpp:399
bool applied
Flag indicating if the configuration is applied.
Definition api.hpp:241
std::optional< Simulation::Feed::SimulationFeed > feed
Optional feed configuration.
Definition api.hpp:244
SimulationInstance & operator=(const SimulationInstance &)=delete
Deleted copy assignment operator to prevent copying.
Core::UserControlParameters params
User-defined control parameters.
Definition api.hpp:239
bool loaded
Flag indicating if the instance is loaded.
Definition api.hpp:240
ApiResult register_initialiser_file_path(std::string_view path)
Definition api.cpp:417
ApiResult register_scalar_initiazer(Core::ScalarFactory::ScalarVariant &&var)
Definition api.cpp:366
SimulationInstance()=delete
Default constructor.
Holds the data required to execute a simulation case.
Definition case_data.hpp:40
A structure to hold user-defined control parameters for simulation settings.
Definition simulation_parameters.hpp:24
Definition execinfo.hpp:21