TimeStepControl.hpp

Go to the documentation of this file.

/*
  Copyright 2014 IRIS AS
  Copyright 2015 Dr. Blatt - HPC-Simulation-Software & Services
  Copyright 2015 Statoil AS
 
  This file is part of the Open Porous Media project (OPM).
 
  OPM 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.
 
  OPM 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 OPM.  If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef OPM_TIMESTEPCONTROL_HEADER_INCLUDED
#define OPM_TIMESTEPCONTROL_HEADER_INCLUDED
 
#include <opm/simulators/timestepping/TimeStepControlInterface.hpp>
 
#include <string>
#include <vector>
 
namespace Opm
{
    enum class TimeStepControlType {
      SimpleIterationCount,
      PID,
      PIDAndIterationCount,
      HardCodedTimeStep
    };
 
    //
    class SimpleIterationCountTimeStepControl : public TimeStepControlInterface
    {
    public:
        static constexpr TimeStepControlType Type = TimeStepControlType::SimpleIterationCount;
        SimpleIterationCountTimeStepControl() = default;
 
        //  \param decayrate          decayrate of time step when target iterations are not met (should be <= 1)
        //  \param growthrate         growthrate of time step when target iterations are not met (should be >= 1)
        SimpleIterationCountTimeStepControl( const int target_iterations,
                                             const double decayrate,
                                             const double growthrate,
                                             const bool verbose = false);
 
        static SimpleIterationCountTimeStepControl serializationTestObject();
 
        double computeTimeStepSize( const double dt, const int iterations, const RelativeChangeInterface& /* relativeChange */, const double /*simulationTimeElapsed */ ) const;
 
        template<class Serializer>
        void serializeOp(Serializer& serializer)
        {
            serializer(target_iterations_);
            serializer(decayrate_);
            serializer(growthrate_);
            serializer(verbose_);
        }
 
        bool operator==(const SimpleIterationCountTimeStepControl&) const;
 
    protected:
        const int     target_iterations_ = 0;
        const double  decayrate_ = 0.0;
        const double  growthrate_ = 0.0;
        const bool    verbose_ = false;
    };
 
    class PIDTimeStepControl : public TimeStepControlInterface
    {
    public:
        static constexpr TimeStepControlType Type = TimeStepControlType::PID;
        PIDTimeStepControl( const double tol = 1e-3,
                            const bool verbose = false );
 
        static PIDTimeStepControl serializationTestObject();
 
        double computeTimeStepSize( const double dt, const int /* iterations */, const RelativeChangeInterface& relativeChange, const double /*simulationTimeElapsed */ ) const;
 
        template<class Serializer>
        void serializeOp(Serializer& serializer)
        {
            serializer(tol_);
            serializer(errors_);
            serializer(verbose_);
        }
 
        bool operator==(const PIDTimeStepControl&) const;
 
    protected:
        const double tol_ = 1e-3;
        mutable std::vector< double > errors_{};
 
        const bool verbose_ = false;
    };
 
    //
    class PIDAndIterationCountTimeStepControl : public PIDTimeStepControl
    {
        typedef PIDTimeStepControl BaseType;
    public:
        static constexpr TimeStepControlType Type = TimeStepControlType::PIDAndIterationCount;
 
        PIDAndIterationCountTimeStepControl( const int target_iterations = 20,
                                             const double decayDampingFactor = 1.0,
                                             const double growthDampingFactor = 1.0/1.2,
                                             const double tol = 1e-3,
                                             const double minTimeStepBasedOnIterations = 0.,
                                             const bool verbose = false);
 
        static PIDAndIterationCountTimeStepControl serializationTestObject();
 
        double computeTimeStepSize( const double dt, const int iterations, const RelativeChangeInterface& relativeChange, const double /*simulationTimeElapsed */ ) const;
 
        template<class Serializer>
        void serializeOp(Serializer& serializer)
        {
            serializer(static_cast<PIDTimeStepControl&>(*this));
            serializer(target_iterations_);
            serializer(decayDampingFactor_);
            serializer(growthDampingFactor_);
            serializer(minTimeStepBasedOnIterations_);
        }
 
        bool operator==(const PIDAndIterationCountTimeStepControl&) const;
 
    protected:
        const int     target_iterations_;
        const double  decayDampingFactor_;
        const double  growthDampingFactor_;
        const double  minTimeStepBasedOnIterations_;
    };
 
    class HardcodedTimeStepControl : public TimeStepControlInterface
    {
    public:
        static constexpr TimeStepControlType Type = TimeStepControlType::HardCodedTimeStep;
        HardcodedTimeStepControl() = default;
 
        explicit HardcodedTimeStepControl( const std::string& filename);
 
        static HardcodedTimeStepControl serializationTestObject();
 
        double computeTimeStepSize( const double dt, const int /* iterations */, const RelativeChangeInterface& /*relativeChange */, const double simulationTimeElapsed) const;
 
        template<class Serializer>
        void serializeOp(Serializer& serializer)
        {
            serializer(subStepTime_);
        }
 
        bool operator==(const HardcodedTimeStepControl&) const;
 
    protected:
        // store the time (in days) of the substeps the simulator should use
        std::vector<double> subStepTime_;
    };
 
 
} // end namespace Opm
#endif