RKDP45.H

Go to the documentation of this file.

/*---------------------------------------------------------------------------*\
  =========                 |
  \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
   \\    /   O peration     |
    \\  /    A nd           | www.openfoam.com
     \\/     M anipulation  |
-------------------------------------------------------------------------------
    Copyright (C) 2013-2016 OpenFOAM Foundation
    Copyright (C) 2019 OpenCFD Ltd.
-------------------------------------------------------------------------------
License
    This file is part of OpenFOAM.
 
    OpenFOAM 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.
 
    OpenFOAM 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 OpenFOAM.  If not, see <http://www.gnu.org/licenses/>.
 
Class
    Foam::RKDP45
 
Group
    grpODESolvers
 
Description
    4/5th Order Dormand-Prince Runge-Kutta ODE solver.
 
    References:
    \verbatim
        Dormand, J. R., & Prince, P. J. (1980).
        A family of embedded Runge-Kutta formulae.
        Journal of computational and applied mathematics, 6(1), 19-26.
 
        Hairer, E., Nørsett, S. P., & Wanner, G. (1993).
        Solving Ordinary Differential Equations I: Nonstiff Problems,
        second edition.
        Springer-Verlag, Berlin.
    \endverbatim
 
See also
    Foam::RKF45
    Foam::RKCK45
 
SourceFiles
    RKDP45.C
 
\*---------------------------------------------------------------------------*/
 
#ifndef RKDP45_H
#define RKDP45_H
 
#include "ODESolver.H"
#include "adaptiveSolver.H"
 
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
namespace Foam
{
 
/*---------------------------------------------------------------------------*\
                           Class RKDP45 Declaration
\*---------------------------------------------------------------------------*/
 
class RKDP45
:
    public ODESolver,
    public adaptiveSolver
{
    // Private data
 
        //- RKDP Constants
        static const scalar
            c2, c3, c4, c5,
            a21, a31, a32, a41, a42, a43, a51, a52, a53, a54,
            a61, a62, a63, a64, a65,
            b1, b3, b4, b5, b6,
            e1, e3, e4, e5, e6, e7;
 
        // Temporary fields
        mutable scalarField yTemp_;
        mutable scalarField k2_;
        mutable scalarField k3_;
        mutable scalarField k4_;
        mutable scalarField k5_;
        mutable scalarField k6_;
 
        //- Error-estimate field
        mutable scalarField err_;
 
 
public:
 
    //- Runtime type information
    TypeName("RKDP45");
 
 
    // Constructors
 
        //- Construct from ODESystem
        RKDP45(const ODESystem& ode, const dictionary& dict);
 
 
    //- Destructor
    virtual ~RKDP45() = default;
 
 
    // Member Functions
 
        //- Inherit solve from ODESolver
        using ODESolver::solve;
 
        //- Resize the ODE solver
        virtual bool resize();
 
        //- Solve a single step dx and return the error
        virtual scalar solve
        (
            const scalar x0,
            const scalarField& y0,
            const scalarField& dydx0,
            const scalar dx,
            scalarField& y
        ) const;
 
        //- Solve the ODE system and the update the state
        virtual void solve
        (
            scalar& x,
            scalarField& y,
            scalar& dxTry
        ) const;
};
 
 
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
} // End namespace Foam
 
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
#endif
 
// ************************************************************************* //