1#ifndef __BIOMC_API_HPP__
2#define __BIOMC_API_HPP__
4#include "common/execinfo.hpp"
5#include "core/scalar_factory.hpp"
6#include <api/results.hpp>
7#include <core/case_data.hpp>
8#include <core/simulation_parameters.hpp>
13#include <simulation/feed_descriptor.hpp>
69 static std::optional<std::unique_ptr<SimulationInstance>>
70 init(
int argc,
char** argv, std::optional<std::size_t> run_id = std::nullopt)
noexcept;
157 std::span<
double> _concentration,
158 std::span<std::
size_t> _position,
159 std::span<std::
size_t> _species,
161 bool fed_batch = false);
164 std::vector<
double>&& _target,
165 std::vector<std::
size_t>&& _position,
166 std::vector<std::
size_t>&& _species,
168 bool fed_batch = false);
177 [[nodiscard]]
int get_id() const;
210 std::optional<Simulation::Feed::SimulationFeed>
feed =
Api This namespace contains classes and functions related to the simulation API.
Definition api.hpp:22
void finalise()
Definition api.cpp:69
Core component to perform simulation.
Definition data_exporter.hpp:18
Represents an instance of a simulation with customizable parameters and behaviors.
Definition api.hpp:41
ApiResult register_model_name(std::string_view path)
Register the model name for the simulation.
Definition api.cpp:296
SimulationInstance(SimulationInstance &&)=default
Defaulted move constructor for efficient resource transfer.
std::optional< Core::ScalarFactory::ScalarVariant > scalar_initializer_variant
Definition api.hpp:204
bool register_result_path(std::string_view path)
Register a result output path.
Definition api.cpp:258
bool set_feed_constant_from_rvalue(double _f, std::vector< double > &&_target, std::vector< std::size_t > &&_position, std::vector< std::size_t > &&_species, bool gas=false, bool fed_batch=false)
Definition api.cpp:87
bool registered
Flag indicating if resources are registered.
Definition api.hpp:209
const ExecInfo & get_exec_info() const
Definition api.hpp:179
ApiResult exec() noexcept
Execute the simulation.
Definition api.cpp:161
bool register_serde(std::string_view path)
Register a serialization/deserialization (serde) path.
Definition api.cpp:289
bool register_cma_path(std::string_view path, bool recursive=false)
Register a path for CMA data.
Definition api.cpp:274
SimulationInstance(const SimulationInstance &)=delete
Deleted copy constructor to prevent copying.
ApiResult register_initial_condition(Core::ScalarFactory::ScalarVariant &&type)
Definition api.cpp:283
Core::CaseData _data
Case data for the simulation.
Definition api.hpp:205
bool set_feed_constant(double _flow, std::span< double > _concentration, std::span< std::size_t > _position, std::span< std::size_t > _species, bool gas=false, bool fed_batch=false)
Configure feed constants for the simulation.
Definition api.cpp:97
SimulationInstance & operator=(SimulationInstance &&)=default
Defaulted move assignment operator for efficient resource transfer.
int get_id() const
Retrieve the simulation instance's unique identifier.
Definition api.cpp:77
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:147
ApiResult apply_load() noexcept
Load ad apply the simulation configuration and prepare for execution based on file.
Definition api.cpp:182
ApiResult register_parameters(Core::UserControlParameters &¶ms) noexcept
Register user control parameters for the simulation.
Definition api.cpp:250
bool applied
Flag indicating if the configuration is applied.
Definition api.hpp:208
~SimulationInstance()
Default destructor.
Definition api.cpp:139
std::optional< Simulation::Feed::SimulationFeed > feed
Optional feed configuration.
Definition api.hpp:210
SimulationInstance & operator=(const SimulationInstance &)=delete
Deleted copy assignment operator to prevent copying.
Core::UserControlParameters params
User-defined control parameters.
Definition api.hpp:206
ApiResult apply() noexcept
Apply the simulation configuration and prepare for execution.
Definition api.cpp:201
bool loaded
Flag indicating if the instance is loaded.
Definition api.hpp:207
ApiResult register_initialiser_file_path(std::string_view path)
Definition api.cpp:267
ApiResult register_scalar_initiazer(Core::ScalarFactory::ScalarVariant &&var)
Definition api.cpp:234
SimulationInstance()=delete
Default constructor.
Holds the data required to execute a simulation case.
Definition case_data.hpp:28
ExecInfo exec_info
Information about the execution environment.
Definition case_data.hpp:61
A structure to hold user-defined control parameters for simulation settings.
Definition simulation_parameters.hpp:24
Definition execinfo.hpp:12