1#ifndef __BIOMC_API_HPP__
2#define __BIOMC_API_HPP__
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>
13#include <simulation/feed_descriptor.hpp>
14#include <simulation/mass_transfer.hpp>
24 constexpr std::array<int, 3>
27 return { _BIOMC_VERSION_MAJOR, _BIOMC_VERSION_MINOR, _BIOMC_VERSION_DEV };
34 auto cmp2 = [](
int a,
int b) ->
int {
return 1 + (a > b) - (a < b); };
36 return (cmp2(major, _BIOMC_VERSION_MAJOR) << 4)
37 | (cmp2(minor, _BIOMC_VERSION_MINOR) << 2)
38 | (cmp2(dev, _BIOMC_VERSION_DEV) << 0);
45 constexpr int VERSION_EQUAL = (1 << 4) | (1 << 2) | (1 << 0);
96 static std::optional<std::unique_ptr<SimulationInstance>>
99 std::optional<std::size_t> run_id = std::nullopt)
noexcept;
195 [[nodiscard]]
int get_id() const;
210 logger = std::move(_logger);
232 std::optional<std::size_t> run_id);
243 std::optional<Simulation::Feed::SimulationFeed>
feed
245 std::optional<Simulation::MassTransfer::Type::MtrTypeVariant>
mtr_type
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
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 &¶ms) 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