/**
* @file kernel/dsde/Executive.hpp
* @author The ARTIS Development Team
* See the AUTHORS or Authors.txt file
*/
/*
* ARTIS - the multimodeling and simulation environment
* This file is a part of the ARTIS environment
*
* Copyright (C) 2013-2019 ULCO http://www.univ-littoral.fr
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see .
*/
#ifndef DSDE_EXECUTIVE
#define DSDE_EXECUTIVE
#include
#include
namespace artis {
namespace dsde {
template
class ExecutiveSimulator;
template
class ExecutiveContext
{
typedef ExecutiveSimulator Simulator;
public:
ExecutiveContext(const Parameters ¶meters, const GraphParameters &graph_parameters,
Simulator *simulator)
:
_parameters(parameters), _graph_parameters(graph_parameters),
_simulator(simulator)
{}
virtual ~ExecutiveContext()
{}
const GraphParameters &graph_parameters() const
{ return _graph_parameters; }
const Parameters ¶meters() const
{ return _parameters; }
Simulator *simulator() const
{ return _simulator; }
private:
const Parameters &_parameters;
const GraphParameters &_graph_parameters;
Simulator *_simulator;
};
template
class ExecutiveSimulator : public common::Simulator
{
typedef ExecutiveSimulator type;
public :
ExecutiveSimulator(const Parameters ¶meters,
const GraphParameters &graph_parameters,
GraphManager &graph_manager)
:
common::Model("executive"),
common::Simulator("executive"),
_dynamics(ExecutiveContext(
parameters, graph_parameters, this), graph_manager)
{}
~ExecutiveSimulator()
{}
const Dynamics &dynamics() const
{ return _dynamics; }
virtual void restore(const common::context::State &state)
{
common::Simulator::restore(state);
_dynamics.restore(state);
}
virtual void save(common::context::State &state) const
{
common::Simulator::save(state);
_dynamics.save(state);
}
virtual std::string to_string(int level) const
{
std::ostringstream ss;
ss << common::String::make_spaces(level * 2) << "executive simulator \""
<< type::get_name() << "\"" << std::endl;
return ss.str();
}
virtual void finish(const typename Time::type &t)
{
#ifndef WITH_TRACE
(void) t;
#endif
#ifdef WITH_TRACE
common::Trace::trace()
<< common::TraceElement(type::get_name(), t,
common::FormalismType::DSDE,
common::FunctionType::FINISH,
common::LevelType::FORMALISM);
common::Trace::trace().flush();
#endif
}
typename Time::type start(const typename Time::type &t)
{
// When i-message(t)
// tl = t - e
// tn = tl + ta(s)
// End
#ifdef WITH_TRACE
common::Trace::trace()
<< common::TraceElement(type::get_name(), t,
common::FormalismType::DSDE,
common::FunctionType::I_MESSAGE,
common::LevelType::FORMALISM)
<< ": BEFORE => " << "tl = " << type::_tl << " ; tn = "
<< type::_tn;
common::Trace::trace().flush();
#endif
type::_tl = t;
type::_tn = type::_tl + _dynamics.start(t);
#ifdef WITH_TRACE
common::Trace::trace()
<< common::TraceElement(type::get_name(), t,
common::FormalismType::DSDE,
common::FunctionType::I_MESSAGE,
common::LevelType::FORMALISM)
<< ": AFTER => " << "tl = " << type::_tl << " ; tn = "
<< type::_tn;
common::Trace::trace().flush();
#endif
return type::_tn;
}
common::Value observe(const typename Time::type &t,
unsigned int index) const
{ return _dynamics.observe(t, index); }
void output(const typename Time::type &t)
{
// When *-message(t)
// if (t = tn) then
// y = lambda(s)
// send y-message(y,t) to parent
// End
#ifdef WITH_TRACE
common::Trace::trace()
<< common::TraceElement(type::get_name(), t,
common::FormalismType::DSDE,
common::FunctionType::OUTPUT,
common::LevelType::FORMALISM)
<< ": BEFORE";
common::Trace::trace().flush();
#endif
if (t == type::_tn) {
common::Bag bag = _dynamics.lambda(t);
if (not bag.empty()) {
for (auto &event : bag) {
event.set_model(this);
}
dynamic_cast < common::Coordinator * >(
type::get_parent())->dispatch_events(bag, t);
}
}
#ifdef WITH_TRACE
common::Trace::trace()
<< common::TraceElement(type::get_name(), t,
common::FormalismType::DSDE,
common::FunctionType::OUTPUT,
common::LevelType::FORMALISM)
<< ": AFTER";
common::Trace::trace().flush();
#endif
}
void post_event(const typename Time::type &t,
const common::ExternalEvent &event)
{
#ifndef WITH_TRACE
(void) t;
#endif
#ifdef WITH_TRACE
common::Trace::trace()
<< common::TraceElement(type::get_name(), t,
common::FormalismType::DSDE,
common::FunctionType::POST_EVENT,
common::LevelType::FORMALISM)
<< ": BEFORE => " << event.to_string();
common::Trace::trace().flush();
#endif
type::add_event(event);
#ifdef WITH_TRACE
common::Trace::trace()
<< common::TraceElement(type::get_name(), t,
common::FormalismType::DSDE,
common::FunctionType::POST_EVENT,
common::LevelType::FORMALISM)
<< ": AFTER => " << event.to_string();
common::Trace::trace().flush();
#endif
}
typename Time::type transition(const typename Time::type &t)
{
// When x-message(t)
// if (x is empty and t = tn) then
// s = delta_int(s)
// else if (x isn't empty and t = tn)
// s = delta_conf(s,x)
// else if (x isn't empty and t < tn)
// e = t - tl
// s = delta_ext(s,e,x)
// tn = t + ta(s)
// tl = t
// End
#ifdef WITH_TRACE
common::Trace::trace()
<< common::TraceElement(type::get_name(), t,
common::FormalismType::DSDE,
common::FunctionType::S_MESSAGE,
common::LevelType::FORMALISM)
<< ": BEFORE => " << "tl = " << type::_tl << " ; tn = "
<< type::_tn;
common::Trace::trace().flush();
#endif
assert(type::_tl <= t and t <= type::_tn);
if (t == type::_tn) {
if (type::event_number() == 0) {
_dynamics.dint(t);
} else {
_dynamics.dconf(t, t - type::_tl, type::get_bag());
}
} else {
_dynamics.dext(t, t - type::_tl, type::get_bag());
}
type::_tn = t + _dynamics.ta(t);
type::_tl = t;
type::clear_bag();
#ifdef WITH_TRACE
common::Trace::trace()
<< common::TraceElement(type::get_name(), t,
common::FormalismType::DSDE,
common::FunctionType::S_MESSAGE,
common::LevelType::FORMALISM)
<< ": AFTER => " << "tl = " << type::_tl << " ; tn = " << type::_tn;
common::Trace::trace().flush();
#endif
return type::_tn;
}
private :
Dynamics _dynamics;
};
template
class ExecutiveDynamics : public common::States
{
typedef dsde::ExecutiveSimulator Simulator;
public:
ExecutiveDynamics(
const ExecutiveContext &context)
:
_simulator(context.simulator()), _name("executive")
{}
virtual ~ExecutiveDynamics()
{}
virtual void dconf(typename Time::type /* t */, typename Time::type /* e */,
const common::Bag & /* bag */)
{}
virtual void dint(typename Time::type /* t */)
{}
virtual void dext(typename Time::type /* t */, typename Time::type /* e */,
const common::Bag & /* bag */)
{}
virtual typename Time::type
start(typename Time::type /* time */)
{ return Time::infinity; }
virtual typename Time::type
ta(typename Time::type /* time */) const
{ return Time::infinity; }
virtual common::Bag
lambda(typename Time::type /* time */) const
{ return common::Bag(); }
virtual common::Value observe(const typename Time::type & /* t */,
unsigned int /* index */) const
{ return common::Value(); }
const std::string &get_name() const
{ return _name; }
void restore(const common::context::State &state)
{
common::States::restore(static_cast(this), state);
}
void save(common::context::State &state) const
{
common::States::save(static_cast(this), state);
}
private:
Simulator *_simulator;
std::string _name;
};
template
class Executive : public dsde::ExecutiveDynamics
{
public:
Executive(const ExecutiveContext &context,
dsde::GraphManager &graph_manager)
:
dsde::ExecutiveDynamics(context),
_graph_manager(graph_manager)
{}
~Executive() override = default;
protected:
dsde::GraphManager &graph_manager()
{ return _graph_manager; }
private:
dsde::GraphManager &_graph_manager;
};
}
}
#endif