time_integrator_subject.hpp

Go to the documentation of this file.

/*
 * Copyright (c) 2010-2020:  G-CSC, Goethe University Frankfurt
 * Author: Tim Schön
 * 
 * This file is part of UG4.
 * 
 * UG4 is free software: you can redistribute it and/or modify it under the
 * terms of the GNU Lesser General Public License version 3 (as published by the
 * Free Software Foundation) with the following additional attribution
 * requirements (according to LGPL/GPL v3 §7):
 * 
 * (1) The following notice must be displayed in the Appropriate Legal Notices
 * of covered and combined works: "Based on UG4 (www.ug4.org/license)".
 * 
 * (2) The following notice must be displayed at a prominent place in the
 * terminal output of covered works: "Based on UG4 (www.ug4.org/license)".
 * 
 * (3) The following bibliography is recommended for citation and must be
 * preserved in all covered files:
 * "Reiter, S., Vogel, A., Heppner, I., Rupp, M., and Wittum, G. A massively
 *   parallel geometric multigrid solver on hierarchically distributed grids.
 *   Computing and visualization in science 16, 4 (2013), 151-164"
 * "Vogel, A., Reiter, S., Rupp, M., Nägel, A., and Wittum, G. UG4 -- a novel
 *   flexible software system for simulating pde based models on high performance
 *   computers. Computing and visualization in science 16, 4 (2013), 165-179"
 * 
 * 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 Lesser General Public License for more details.
 */
 
#ifndef __H__UG__LIB_DISC__TIME_DISC__TIME_INTEGRATOR_SUBJECT
#define __H__UG__LIB_DISC__TIME_DISC__TIME_INTEGRATOR_SUBJECT
 
#include "./time_integrator_observers/time_integrator_observer_interface.h"
 
namespace ug {
 
 
template<class TDomain, class TAlgebra>
class TimeIntegratorSubject
{
public:
  typedef GridFunction<TDomain, TAlgebra> grid_function_type;
  typedef ITimeIntegratorObserver<TDomain, TAlgebra> process_observer_type;
  typedef ITimeIntegratorStageObserver_init<TDomain, TAlgebra> init_observer_type;
  typedef ITimeIntegratorStageObserver_rewind<TDomain, TAlgebra> rewind_observer_type;
  typedef ITimeIntegratorStageObserver_finalize<TDomain, TAlgebra> finalize_observer_type;
  typedef ITimeIntegratorStageObserver_preprocess<TDomain, TAlgebra> preprocess_observer_type;
  typedef ITimeIntegratorStageObserver_postprocess<TDomain, TAlgebra> postprocess_observer_type;
  typedef ITimeIntegratorStageObserver_start<TDomain, TAlgebra> start_observer_type;
  typedef ITimeIntegratorStageObserver_end<TDomain, TAlgebra> end_observer_type;
  typedef typename std::vector<SmartPtr<process_observer_type> > process_observer_container_type;
 
  enum observer_group_type {
    TIO_GROUP_INIT_STEP=0, 
    TIO_GROUP_REWIND_STEP, 
    TIO_GROUP_FINALIZE_STEP, 
    TIO_GROUP_PREPROCESS_STEP, 
    TIO_GROUP_POSTPROCESS_STEP, 
    TIO_GROUP_START, 
    TIO_GROUP_END, 
    TIO_GROUP_SIZE};
  enum observer_group_type {…};
 
protected:
  // process_observer_container_type m_vProcessObservers;
  process_observer_container_type m_vProcessObservers[TIO_GROUP_SIZE];
 
  // container for statically mapped observers
  std::vector<SmartPtr<init_observer_type> > m_vInitObservers;
  std::vector<SmartPtr<rewind_observer_type> > m_vRewindObservers;
  std::vector<SmartPtr<finalize_observer_type> > m_vFinalizeObservers;
  std::vector<SmartPtr<preprocess_observer_type> > m_vPreprocessObservers;
  std::vector<SmartPtr<postprocess_observer_type> > m_vPostprocessObservers;
  std::vector<SmartPtr<start_observer_type> > m_vStartObservers;
  std::vector<SmartPtr<end_observer_type> > m_vEndObservers;
 
 
protected:
  template<int tGroup>
  void attach_to_group(SmartPtr<process_observer_type> obs)
  {
    //UG_LOG("TimeIntegratorSubject::attach_observer[" << tGroup <<"]" << this << std::endl);
    m_vProcessObservers[tGroup].push_back(obs);
  }
  void attach_to_group(SmartPtr<process_observer_type> obs) {…}
 
  void attach_to_group(int tGroup, SmartPtr<process_observer_type> obs)
  {
    //UG_LOG("TimeIntegratorSubject::attach_observer[" << tGroup <<"]" << this << std::endl);
    m_vProcessObservers[tGroup].push_back(obs);
  }
  void attach_to_group(int tGroup, SmartPtr<process_observer_type> obs) {…}
public:
 
#define DECLARE_CHECK_STATIC_ATTACH(stage, container) \
  bool check_attach_##stage(SmartPtr<process_observer_type> obs)\
  {\
    SmartPtr<stage##_observer_type> sp_staticObs = obs.template cast_dynamic<stage##_observer_type>();\
    if (sp_staticObs.valid())\
    {\
      (container).push_back(sp_staticObs);\
      return true;\
    }\
    return false;\
  }
#define DECLARE_CHECK_STATIC_ATTACH(stage, container) \ …
 
  DECLARE_CHECK_STATIC_ATTACH(init, m_vInitObservers)
  DECLARE_CHECK_STATIC_ATTACH(rewind, m_vRewindObservers)
  DECLARE_CHECK_STATIC_ATTACH(finalize, m_vFinalizeObservers)
  DECLARE_CHECK_STATIC_ATTACH(preprocess, m_vPreprocessObservers)
  DECLARE_CHECK_STATIC_ATTACH(postprocess, m_vPostprocessObservers)
  DECLARE_CHECK_STATIC_ATTACH(start, m_vStartObservers)
  DECLARE_CHECK_STATIC_ATTACH(end, m_vEndObservers)
 
  
  void attach_observer(SmartPtr<process_observer_type> obs)
  {
    const bool isStaticallyAttached =
      check_attach_init(obs) ||
      check_attach_rewind(obs) ||
      check_attach_finalize(obs) ||
      check_attach_preprocess(obs) ||
      check_attach_postprocess(obs) ||
      check_attach_start(obs) ||
      check_attach_end(obs);
 
    if (!isStaticallyAttached)
      attach_finalize_observer(obs);
  }
  void attach_observer(SmartPtr<process_observer_type> obs) {…}
 
  void attach_init_observer(SmartPtr<process_observer_type> obs)
  { attach_to_group<TIO_GROUP_INIT_STEP>(obs); }
  void attach_init_observer(SmartPtr<process_observer_type> obs) {…}
 
  void attach_rewind_observer(SmartPtr<process_observer_type> obs)
  { attach_to_group<TIO_GROUP_REWIND_STEP>(obs); }
  void attach_rewind_observer(SmartPtr<process_observer_type> obs) {…}
 
  void attach_finalize_observer(SmartPtr<process_observer_type> obs)
  { attach_to_group<TIO_GROUP_FINALIZE_STEP>(obs); }
  void attach_finalize_observer(SmartPtr<process_observer_type> obs) {…}
 
  void attach_preprocess_observer(SmartPtr<process_observer_type> obs)
  { attach_to_group<TIO_GROUP_PREPROCESS_STEP>(obs); }
  void attach_preprocess_observer(SmartPtr<process_observer_type> obs) {…}
 
  void attach_postprocess_observer(SmartPtr<process_observer_type> obs)
  { attach_to_group<TIO_GROUP_POSTPROCESS_STEP>(obs); }
  void attach_postprocess_observer(SmartPtr<process_observer_type> obs) {…}
 
  void attach_start_observer(SmartPtr<process_observer_type> obs)
  { attach_to_group<TIO_GROUP_START>(obs); }
  void attach_start_observer(SmartPtr<process_observer_type> obs) {…}
 
  void attach_end_observer(SmartPtr<process_observer_type> obs)
  { attach_to_group<TIO_GROUP_END>(obs); }
  void attach_end_observer(SmartPtr<process_observer_type> obs) {…}
 
  void reset_observers()
  {
    m_vProcessObservers[TIO_GROUP_INIT_STEP].clear();
    m_vProcessObservers[TIO_GROUP_REWIND_STEP].clear();
    m_vProcessObservers[TIO_GROUP_FINALIZE_STEP].clear();
    m_vProcessObservers[TIO_GROUP_PREPROCESS_STEP].clear();
    m_vProcessObservers[TIO_GROUP_POSTPROCESS_STEP].clear();
    m_vProcessObservers[TIO_GROUP_START].clear();
    m_vProcessObservers[TIO_GROUP_END].clear();
 
    m_vInitObservers.clear();
    m_vRewindObservers.clear();
    m_vFinalizeObservers.clear();
    m_vPreprocessObservers.clear();
    m_vPostprocessObservers.clear();
    m_vStartObservers.clear();
    m_vEndObservers.clear();
  }
  void reset_observers() {…}
 
protected:
  template<int tGroup>
  bool notify_group(SmartPtr<grid_function_type> u, int step, number time, number dt)
  {
    process_observer_container_type &observers = m_vProcessObservers[tGroup];
    
    bool result = true;
    for (typename process_observer_container_type::iterator it = observers.begin(); it!= observers.end(); ++it)
    {
      result = (*it)->step_process(u, step, time, dt) && result;              
    }
 
    return result;
  }
  bool notify_group(SmartPtr<grid_function_type> u, int step, number time, number dt) {…}
 
 
public:
 
#define DECLARE_NOTIFY_STEP(functionName, stageName, stageID, container) \
  bool notify_##functionName(SmartPtr<grid_function_type> u, int step, number time, number dt)\
  {\
    bool res = notify_group<(stageID)>(u, step, time, dt);\
    const size_t numObs = (container).size();\
    for (size_t o = 0; o < numObs; ++o)\
      res &= (container)[o]->stageName##_action(u, step, time, dt);\
    return res;\
  }
#define DECLARE_NOTIFY_STEP(functionName, stageName, stageID, container) \ …
 
  DECLARE_NOTIFY_STEP(init_step, init, TIO_GROUP_INIT_STEP, m_vInitObservers)
 
  
  DECLARE_NOTIFY_STEP(rewind_step, rewind, TIO_GROUP_REWIND_STEP, m_vRewindObservers)
 
  
  DECLARE_NOTIFY_STEP(finalize_step, finalize, TIO_GROUP_FINALIZE_STEP, m_vFinalizeObservers)
 
  
  DECLARE_NOTIFY_STEP(preprocess_step, preprocess, TIO_GROUP_PREPROCESS_STEP, m_vPreprocessObservers)
 
  
  DECLARE_NOTIFY_STEP(postprocess_step, postprocess, TIO_GROUP_POSTPROCESS_STEP, m_vPostprocessObservers)
 
  
  DECLARE_NOTIFY_STEP(start, start, TIO_GROUP_START, m_vStartObservers)
 
  
  DECLARE_NOTIFY_STEP(end, end, TIO_GROUP_END, m_vEndObservers)
};
class TimeIntegratorSubject {…};
 
}
 
#endif