explicitonestep.hh

Go to the documentation of this file.

// -*- tab-width: 2; indent-tabs-mode: nil -*-
// vi: set et ts=2 sw=2 sts=2:
 
#ifndef DUNE_PDELAB_INSTATIONARY_EXPLICITONESTEP_HH
#define DUNE_PDELAB_INSTATIONARY_EXPLICITONESTEP_HH
 
#include <iostream>
#include <iomanip>
 
#include <dune/common/ios_state.hh>
#include <dune/pdelab/common/logtag.hh>
#include <dune/pdelab/instationary/onestepparameter.hh>
 
namespace Dune {
  namespace PDELab {
 
    template<class R>
    class TimeControllerInterface
    {
    public:
      typedef R RealType;
 
      virtual RealType suggestTimestep (RealType time, RealType givendt) = 0;
 
      virtual ~TimeControllerInterface () {}
    };
 
 
    template<class R>
    class SimpleTimeController : public TimeControllerInterface<R>
    {
    public:
      typedef R RealType;
 
      virtual RealType suggestTimestep (RealType time, RealType givendt) override
      {
        return givendt;
      }
    };
 
 
 
    template<class R, class IGOS>
    class CFLTimeController : public TimeControllerInterface<R>
    {
    public:
      typedef R RealType;
 
      CFLTimeController (R cfl_, const IGOS& igos_) : cfl(cfl_), target(1e100), igos(igos_)
      {}
 
      CFLTimeController (R cfl_, R target_, const IGOS& igos_) : cfl(cfl_), target(target_), igos(igos_)
      {}
 
      void setTarget (R target_)
      {
        target = target_;
      }
 
      virtual RealType suggestTimestep (RealType time, RealType givendt) override
      {
        RealType suggested = cfl*igos.suggestTimestep(givendt);
        if (time+2.0*suggested<target)
          return suggested;
        if (time+suggested<target)
          return 0.5*(target-time);
        return target-time;
      }
 
    private:
      R cfl;
      R target;
      const IGOS& igos;
    };
 
 
 
    template<class T, class IGOS, class LS, class TrlV, class TstV = TrlV, class TC = SimpleTimeController<T> >
    class ExplicitOneStepMethod
    {
      typedef typename TrlV::ElementType Real;
      typedef typename IGOS::template MatrixContainer<Real>::Type M;
 
    public:
 
      [[deprecated(
        "Constructor with default assigned reduction is no longer supported. "
        "Use the new constructor by passing a suitable reduction to the linear "
        "system. In particular, use a dummy reduction (i.e. 0.99) on systems "
        "known to have diagonal mass matrices (e.g. FV or DG) and where the "
        "linear solver performs a block inversion on the first iteration "
        "(essentially any). Otherwise, specify a proper reduction suitable "
        "for your needs."
        )]]
      ExplicitOneStepMethod(const TimeSteppingParameterInterface<T>& method_, IGOS& igos_, LS& ls_)
        : method(&method_), igos(igos_), ls(ls_), verbosityLevel(1), step(1), D(igos),
          tc(new SimpleTimeController<T>()), allocated(true), ls_reduct{0.99}
      {
        if (method->implicit())
          DUNE_THROW(Exception,"explicit one step method called with implicit scheme");
        if (igos.trialGridFunctionSpace().gridView().comm().rank()>0)
          verbosityLevel = 0;
      }
 
      ExplicitOneStepMethod(const TimeSteppingParameterInterface<T>& method_,
                            IGOS& igos_,
                            LS& ls_,
                            double ls_reduct_)
        : method(&method_)
        , igos(igos_)
        , ls(ls_)
        , verbosityLevel(1)
        , step(1)
        , D(igos)
        , tc(new SimpleTimeController<T>())
        , allocated(true)
        , ls_reduct{ ls_reduct_ }
      {
        if (method->implicit())
          DUNE_THROW(Exception,
                     "explicit one step method called with implicit scheme");
        if (igos.trialGridFunctionSpace().gridView().comm().rank() > 0)
          verbosityLevel = 0;
      }
 
 
      [[deprecated(
        "Constructor with default assigned reduction is no longer supported. "
        "Use the new constructor by passing a suitable reduction to the linear "
        "system. In particular, use a dummy reduction (i.e. 0.99) on systems \n"
        "known to have diagonal mass matrices (e.g. FV or DG) and where the \n"
        "linear solver performs a block inversion on the first iteration \n"
        "(essentially any). Otherwise, specify a proper reduction suitable \n"
        "for your needs.\n"
        )]]
      ExplicitOneStepMethod(const TimeSteppingParameterInterface<T>& method_, IGOS& igos_, LS& ls_, TC& tc_)
        : method(&method_), igos(igos_), ls(ls_), verbosityLevel(1), step(1), D(igos),
          tc(&tc_), allocated(false), ls_reduct{0.99}
      {
        if (method->implicit())
          DUNE_THROW(Exception,"explicit one step method called with implicit scheme");
      }
 
      ExplicitOneStepMethod(const TimeSteppingParameterInterface<T>& method_,
                            IGOS& igos_,
                            LS& ls_,
                            TC& tc_,
                            double ls_reduct_)
        : method(&method_)
        , igos(igos_)
        , ls(ls_)
        , verbosityLevel(1)
        , step(1)
        , D(igos)
        , tc(&tc_)
        , allocated(false)
        , ls_reduct{ ls_reduct_ }
      {
        if (method->implicit())
          DUNE_THROW(Exception,
                     "explicit one step method called with implicit scheme");
      }
 
      ~ExplicitOneStepMethod ()
      {
        if (allocated) delete tc;
      }
 
      void setVerbosityLevel (int level)
      {
        if (igos.trialGridFunctionSpace().gridView().comm().rank()>0)
          verbosityLevel = 0;
        else
          verbosityLevel = level;
      }
 
      void setStepNumber(int newstep) { step = newstep; }
 
      void setReduction(const double& ls_reduction_) { ls_reduct = ls_reduction_; }
 
 
      void setMethod (const TimeSteppingParameterInterface<T>& method_)
      {
        method = &method_;
        if (method->implicit())
          DUNE_THROW(Exception,"explicit one step method called with implicit scheme");
      }
 
      T apply (T time, T dt, TrlV& xold, TrlV& xnew)
      {
        DefaultLimiter limiter;
        return apply(time,dt,xold,xnew,limiter);
      }
 
      template<typename Limiter>
      T apply (T time, T dt, TrlV& xold, TrlV& xnew, Limiter& limiter)
      {
        // save formatting attributes
        ios_base_all_saver format_attribute_saver(std::cout);
        LocalTag mytag;
        mytag << "ExplicitOneStepMethod::apply(): ";
 
        std::vector<TrlV*> x(1); // vector of pointers to all steps
        x[0] = &xold;         // initially we have only one
        if(verbosityLevel>=4)
          std::cout << mytag << "Creating residual vectors alpha and beta..."
                    << std::endl;
        TstV alpha(igos.testGridFunctionSpace()), beta(igos.testGridFunctionSpace()); // split residual vectors
        if(verbosityLevel>=4)
          std::cout << mytag
                    << "Creating residual vectors alpha and beta... done."
                    << std::endl;
 
        if (verbosityLevel>=1){
          std::ios_base::fmtflags oldflags = std::cout.flags();
          std::cout << "TIME STEP [" << method->name() << "] "
                    << std::setw(6) << step
                    << " time (from): "
                    << std::setw(12) << std::setprecision(4) << std::scientific
                    << time
                    << " dt: "
                    << std::setw(12) << std::setprecision(4) << std::scientific
                    << dt
                    << " time (to): "
                    << std::setw(12) << std::setprecision(4) << std::scientific
                    << time+dt
                    << std::endl;
          std::cout.flags(oldflags);
        }
 
        // prepare assembler
        if(verbosityLevel>=4)
          std::cout << mytag << "Preparing assembler..." << std::endl;
        igos.preStep(*method,time,dt);
        if(verbosityLevel>=4)
          std::cout << mytag << "Preparing assembler... done." << std::endl;
 
        // loop over all stages
        for(unsigned r=1; r<=method->s(); ++r)
          {
            LocalTag stagetag(mytag);
            stagetag << "stage " << r << ": ";
            if (verbosityLevel>=4)
              std::cout << stagetag << "Start." << std::endl;
 
            if (verbosityLevel>=2){
              std::ios_base::fmtflags oldflags = std::cout.flags();
              std::cout << "STAGE "
                        << r
                        << " time (to): "
                        << std::setw(12) << std::setprecision(4) << std::scientific
                        << time+method->d(r)*dt
                        << "." << std::endl;
              std::cout.flags(oldflags);
            }
 
            // get vector for current stage
            if (r==method->s())
              {
                // last stage
                x.push_back(&xnew);
                if (r>1) xnew = *(x[r-1]); // if r=1 then xnew has already initial guess
              }
            else
              {
                // intermediate step
                x.push_back(new TrlV(igos.trialGridFunctionSpace()));
                if (r>1)
                  *(x[r]) = *(x[r-1]); // use result of last stage as initial guess
                else
                  *(x[r]) = xnew;
              }
 
            // compute residuals and jacobian
            if (verbosityLevel>=4) std::cout << "assembling D, alpha, beta ..." << std::endl;
            D = Real(0.0);
            alpha = 0.0;
            beta = 0.0;
 
            //apply slope limiter to old solution (e.g for finite volume reconstruction scheme)
            limiter.prestage(*x[r-1]);
 
            if(verbosityLevel>=4)
              std::cout << stagetag << "Assembling residual..." << std::endl;
            igos.explicit_jacobian_residual(r,x,D,alpha,beta);
            if(verbosityLevel>=4)
              std::cout << stagetag << "Assembling residual... done."
                        << std::endl;
 
            // let time controller compute the optimal dt in first stage
            if (r==1)
              {
                T newdt = tc->suggestTimestep(time,dt);
                newdt = std::min(newdt, dt);
 
                if (verbosityLevel>=4){
                  std::ios_base::fmtflags oldflags = std::cout.flags();
                  std::cout << stagetag
                            << "current dt: "
                            << std::setw(12) << std::setprecision(4) << std::scientific
                            << dt
                            << " suggested dt: "
                            << std::setw(12) << std::setprecision(4) << std::scientific
                            << newdt
                            << std::endl;
                  std::cout.flags(oldflags);
                }
 
                if (verbosityLevel>=2 && newdt!=dt)
                  {
                    std::ios_base::fmtflags oldflags = std::cout.flags();
                    std::cout << "changed dt to "
                              << std::setw(12) << std::setprecision(4) << std::scientific
                              << newdt
                              << std::endl;
                    std::cout.flags(oldflags);
                  }
                dt = newdt;
              }
 
            // combine residual with selected dt
            if (verbosityLevel>=4)
              std::cout << stagetag
                        << "Combining residuals with selected dt..."
                        << std::endl;
            alpha.axpy(dt,beta);
            if (verbosityLevel>=4)
              std::cout << stagetag
                        << "Combining residuals with selected dt... done."
                        << std::endl;
 
            // solve linear system
            if (verbosityLevel>=4)
              std::cout << stagetag << "Solving linear system..."
                        << std::endl;
            ls.apply(D,*x[r],alpha,ls_reduct);
            if (verbosityLevel>=4)
              std::cout << stagetag << "Solving linear system... done."
                        << std::endl;
 
            // apply slope limiter to new solution (e.g DG scheme)
            limiter.poststage(*x[r]);
 
            // stage cleanup
            if (verbosityLevel>=4)
              std::cout << stagetag << "Cleanup..." << std::endl;
            igos.postStage();
            if (verbosityLevel>=4)
              std::cout << stagetag << "Cleanup... done" << std::endl;
 
            if (verbosityLevel>=4)
              std::cout << stagetag << "Finished." << std::endl;
          }
 
        // delete intermediate steps
        for(unsigned i=1; i<method->s(); ++i) delete x[i];
 
        // step cleanup
        if (verbosityLevel>=4)
          std::cout << mytag << "Cleanup..." << std::endl;
        igos.postStep();
        if (verbosityLevel>=4)
          std::cout << mytag << "Cleanup... done." << std::endl;
 
        step++;
        return dt;
      }
 
      template <typename F>
      T apply (T time, T dt, TrlV& xold, F& f, TrlV& xnew)
      {
        DefaultLimiter limiter;
        return apply(time,dt,xold,f,xnew,limiter);
      }
 
      template<typename F, typename Limiter>
      T apply (T time, T dt, TrlV& xold, F&f, TrlV& xnew, Limiter& limiter)
      {
        // save formatting attributes
        ios_base_all_saver format_attribute_saver(std::cout);
        LocalTag mytag;
        mytag << "ExplicitOneStepMethod::apply(): ";
 
        std::vector<TrlV*> x(1); // vector of pointers to all steps
        x[0] = &xold;         // initially we have only one
        if(verbosityLevel>=4)
          std::cout << mytag << "Creating residual vectors alpha and beta..."
                    << std::endl;
        TstV alpha(igos.testGridFunctionSpace()), beta(igos.testGridFunctionSpace()); // split residual vectors
        if(verbosityLevel>=4)
          std::cout << mytag
                    << "Creating residual vectors alpha and beta... done."
                    << std::endl;
 
        // In order to apply boundary constraints correctly we need to
        // solve the linear system from each stage in residual form
        // with appropriate constraints. 'residual' and 'update' are
        // two vectors needed for the residual formulation.
        if(verbosityLevel>=4)
          std::cout << mytag << "Creating residual vector and update for residual formulation of linear problem per stage"
                    << std::endl;
        TrlV residual(igos.testGridFunctionSpace());
        TrlV update(igos.testGridFunctionSpace());
        if(verbosityLevel>=4)
          std::cout << mytag << "Creating residual vector and update for residual... done."
                    << std::endl;
 
 
        if (verbosityLevel>=1){
          std::ios_base::fmtflags oldflags = std::cout.flags();
          std::cout << "TIME STEP [" << method->name() << "] "
                    << std::setw(6) << step
                    << " time (from): "
                    << std::setw(12) << std::setprecision(4) << std::scientific
                    << time
                    << " dt: "
                    << std::setw(12) << std::setprecision(4) << std::scientific
                    << dt
                    << " time (to): "
                    << std::setw(12) << std::setprecision(4) << std::scientific
                    << time+dt
                    << std::endl;
          std::cout.flags(oldflags);
        }
 
        // prepare assembler
        if(verbosityLevel>=4)
          std::cout << mytag << "Preparing assembler..." << std::endl;
        igos.preStep(*method,time,dt);
        if(verbosityLevel>=4)
          std::cout << mytag << "Preparing assembler... done." << std::endl;
 
        // loop over all stages
        for(unsigned r=1; r<=method->s(); ++r)
          {
            LocalTag stagetag(mytag);
            stagetag << "stage " << r << ": ";
            if (verbosityLevel>=4)
              std::cout << stagetag << "Start." << std::endl;
 
            if (verbosityLevel>=2){
              std::ios_base::fmtflags oldflags = std::cout.flags();
              std::cout << "STAGE "
                        << r
                        << " time (to): "
                        << std::setw(12) << std::setprecision(4) << std::scientific
                        << time+method->d(r)*dt
                        << "." << std::endl;
              std::cout.flags(oldflags);
            }
 
            // get vector for current stage
            if (r==method->s())
              {
                // last stage
                x.push_back(&xnew);
              }
            else
              {
                // intermediate step
                x.push_back(new TrlV(igos.trialGridFunctionSpace()));
              }
 
            // compute residuals and jacobian
            if (verbosityLevel>=4) std::cout << "assembling D, alpha, beta ..." << std::endl;
            D = Real(0.0);
            alpha = 0.0;
            beta = 0.0;
 
            // apply slope limiter to old solution (e.g for finite volume reconstruction scheme)
            limiter.prestage(*x[r-1]);
 
            // set initial value from xnew or last stage
            TrlV const * const init_guess = (r==1) ? &xnew : x[r-1];
            // set boundary conditions
            igos.interpolate(r,*init_guess,f,*x[r]);
 
            if(verbosityLevel>=4)
              std::cout << stagetag << "Assembling residual..." << std::endl;
            igos.explicit_jacobian_residual(r,x,D,alpha,beta);
            if(verbosityLevel>=4)
              std::cout << stagetag << "Assembling residual... done."
                        << std::endl;
 
            // let time controller compute the optimal dt in first stage
            if (r==1)
              {
                T newdt = tc->suggestTimestep(time,dt);
                newdt = std::min(newdt, dt);
 
                if (verbosityLevel>=4){
                  std::ios_base::fmtflags oldflags = std::cout.flags();
                  std::cout << stagetag
                            << "current dt: "
                            << std::setw(12) << std::setprecision(4) << std::scientific
                            << dt
                            << " suggested dt: "
                            << std::setw(12) << std::setprecision(4) << std::scientific
                            << newdt
                            << std::endl;
                  std::cout.flags(oldflags);
                }
 
                if (verbosityLevel>=2 && newdt!=dt)
                  {
                    std::ios_base::fmtflags oldflags = std::cout.flags();
                    std::cout << "changed dt to "
                              << std::setw(12) << std::setprecision(4) << std::scientific
                              << newdt
                              << std::endl;
                    std::cout.flags(oldflags);
                  }
                dt = newdt;
              }
 
            // combine residual with selected dt
            if (verbosityLevel>=4)
              std::cout << stagetag
                        << "Combining residuals with selected dt..."
                        << std::endl;
            alpha.axpy(dt,beta);
            if (verbosityLevel>=4)
              std::cout << stagetag
                        << "Combining residuals with selected dt... done."
                        << std::endl;
 
 
 
            // Set up residual formulation (for Dx[r]=alpha) and
            // compute update by solving linear system
            using Backend::native;
            native(D).mv(native(*x[r]), native(residual));
            residual -= alpha;
            auto cc = igos.trialConstraints();
            Dune::PDELab::set_constrained_dofs(cc, 0.0, residual);
            if (verbosityLevel>=4)
              std::cout << stagetag << "Solving linear system..."
                        << std::endl;
            ls.apply(D, update, residual, ls_reduct);
            if (verbosityLevel>=4)
              std::cout << stagetag << "Solving linear system... done."
                        << std::endl;
            *x[r] -= update;
 
            // apply slope limiter to new solution (e.g DG scheme)
            limiter.poststage(*x[r]);
 
            // stage cleanup
            if (verbosityLevel>=4)
              std::cout << stagetag << "Cleanup..." << std::endl;
            igos.postStage();
            if (verbosityLevel>=4)
              std::cout << stagetag << "Cleanup... done" << std::endl;
 
            if (verbosityLevel>=4)
              std::cout << stagetag << "Finished." << std::endl;
          }
 
        // delete intermediate steps
        for(unsigned i=1; i<method->s(); ++i) delete x[i];
 
        // step cleanup
        if (verbosityLevel>=4)
          std::cout << mytag << "Cleanup..." << std::endl;
        igos.postStep();
        if (verbosityLevel>=4)
          std::cout << mytag << "Cleanup... done." << std::endl;
 
        step++;
        return dt;
      }
 
    private:
 
      class DefaultLimiter
      {
      public:
        template<typename V>
        void prestage(V& v)
        {}
 
        template<typename V>
        void poststage(V& v)
        {}
      };
 
      const TimeSteppingParameterInterface<T> *method;
      IGOS& igos;
      LS& ls;
      int verbosityLevel;
      int step;
      M D;
      TimeControllerInterface<T> *tc;
      bool allocated;
      double ls_reduct;
    };
 
  } // end namespace PDELab
} // end namespace Dune
#endif // DUNE_PDELAB_INSTATIONARY_EXPLICITONESTEP_HH