ConstantRsDeadOilPvt.hpp

Go to the documentation of this file.

// -*- mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*-
// vi: set et ts=4 sw=4 sts=4:
/*
  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 2 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/>.

  Consult the COPYING file in the top-level source directory of this
  module for the precise wording of the license and the list of
  copyright holders.
*/
#ifndef OPM_CONSTANT_RS_DEAD_OIL_PVT_HPP
#define OPM_CONSTANT_RS_DEAD_OIL_PVT_HPP

#include <opm/material/common/Tabulated1DFunction.hpp>
#include <opm/material/common/MathToolbox.hpp>
#include <opm/common/Exceptions.hpp>

#include <cstddef>
#include <stdexcept>
#include <vector>

namespace Opm {

class EclipseState;
class Schedule;

template <class Scalar>
class ConstantRsDeadOilPvt
{
public:
    using TabulatedOneDFunction = Tabulated1DFunction<Scalar>;

    void initFromState(const EclipseState& eclState, const Schedule& schedule);

    void setNumRegions(std::size_t numRegions);

    void setVapPars(const Scalar, const Scalar)
    {
        // No vaporization parameters for constant Rs
    }

    void setReferenceDensities(unsigned regionIdx,
                               Scalar rhoRefOil,
                               Scalar rhoRefGas,
                               Scalar /*rhoRefWater*/)
    {
        oilReferenceDensity_[regionIdx] = rhoRefOil;
        gasReferenceDensity_[regionIdx] = rhoRefGas;
    }

    void setConstantRs(Scalar rsConst)
    { constantRs_ = rsConst; }

    void setBubblePointPressure(Scalar pbub)
    { bubblePointPressure_ = pbub; }

    void setInverseOilFormationVolumeFactor(unsigned regionIdx,
                                            const TabulatedOneDFunction& invBo)
    { inverseOilB_[regionIdx] = invBo; }

    void setOilViscosity(unsigned regionIdx, const TabulatedOneDFunction& muo)
    { oilMu_[regionIdx] = muo; }

    void initEnd();

    unsigned numRegions() const
    { return inverseOilBMu_.size(); }

    template <class Evaluation>
    Evaluation internalEnergy(unsigned,
                        const Evaluation&,
                        const Evaluation&,
                        const Evaluation&) const
    {
        throw std::runtime_error("Requested the enthalpy of oil but the thermal "
                                 "option is not enabled");
    }

    Scalar hVap(unsigned) const
    {
        throw std::runtime_error("Requested the hvap of oil but the thermal "
                                 "option is not enabled");
    }

    template <class Evaluation>
    Evaluation viscosity(unsigned regionIdx,
                         const Evaluation& temperature,
                         const Evaluation& pressure,
                         const Evaluation& /*Rs*/) const
    { return saturatedViscosity(regionIdx, temperature, pressure); }

    template <class Evaluation>
    Evaluation saturatedViscosity(unsigned regionIdx,
                                  const Evaluation& /*temperature*/,
                                  const Evaluation& pressure) const
    {
        const Evaluation& invBo = inverseOilB_[regionIdx].eval(pressure, /*extrapolate=*/true);
        const Evaluation& invMuoBo = inverseOilBMu_[regionIdx].eval(pressure, /*extrapolate=*/true);
        return invBo / invMuoBo;
    }

    template <class Evaluation>
    Evaluation inverseFormationVolumeFactor(unsigned regionIdx,
                                            const Evaluation& /*temperature*/,
                                            const Evaluation& pressure,
                                            const Evaluation& /*Rs*/) const
    { return inverseOilB_[regionIdx].eval(pressure, /*extrapolate=*/true); }

    template <class FluidState, class LhsEval = typename FluidState::ValueType>
    std::pair<LhsEval, LhsEval>
    inverseFormationVolumeFactorAndViscosity(const FluidState& fluidState, unsigned regionIdx)
    {
        const LhsEval& p = decay<LhsEval>(fluidState.pressure(FluidState::oilPhaseIdx));
        const auto segIdx = this->inverseOilB_[regionIdx].findSegmentIndex(p, /*extrapolate=*/ true);
        const auto& invBo = this->inverseOilB_[regionIdx].eval(p, SegmentIndex{segIdx});
        const auto& invMuoBo = this->inverseOilBMu_[regionIdx].eval(p, SegmentIndex{segIdx});
        return { invBo, invBo / invMuoBo };
    }

    template <class Evaluation>
    Evaluation saturatedInverseFormationVolumeFactor(unsigned regionIdx,
                                                     const Evaluation& /*temperature*/,
                                                     const Evaluation& pressure) const
    { return inverseOilB_[regionIdx].eval(pressure, /*extrapolate=*/true); }

    template <class Evaluation>
    Evaluation saturatedGasDissolutionFactor(unsigned /*regionIdx*/,
                                             const Evaluation& /*temperature*/,
                                             const Evaluation& pressure) const
    {
        // Enforce bubble point constraint from RSCONST manual:
        // "The run will terminate if the pressure in any grid block falls below this value."
        if (pressure < bubblePointPressure_) {
            throw NumericalProblem(
                "Pressure is below RSCONST bubble point pressure of " +
                std::to_string(bubblePointPressure_)
            );
        }
        return constantRs_;
    }

    template <class Evaluation>
    Evaluation saturatedGasDissolutionFactor(unsigned /*regionIdx*/,
                                             const Evaluation& /*temperature*/,
                                             const Evaluation& pressure,
                                             const Evaluation& /*oilSaturation*/,
                                             const Evaluation& /*maxOilSaturation*/) const
    {
        // Enforce bubble point constraint from RSCONST manual:
        // "The run will terminate if the pressure in any grid block falls below this value."
        if (pressure < bubblePointPressure_) {
            throw NumericalProblem(
                "Pressure is below RSCONST bubble point pressure of " +
                std::to_string(bubblePointPressure_)
            );
        }
        return constantRs_;
    }

    template <class Evaluation>
    Evaluation saturationPressure(unsigned /*regionIdx*/,
                                  const Evaluation& /*temperature*/,
                                  const Evaluation& /*Rs*/) const
    { return bubblePointPressure_; }

    template <class Evaluation>
    Evaluation diffusionCoefficient(const Evaluation& /*temperature*/,
                                    const Evaluation& /*pressure*/,
                                    unsigned /*compIdx*/) const
    {
        throw std::runtime_error("Not implemented: The PVT model does not provide "
                                 "a diffusionCoefficient()");
    }

    Scalar oilReferenceDensity(unsigned regionIdx) const
    { return oilReferenceDensity_[regionIdx]; }

    Scalar gasReferenceDensity(unsigned regionIdx) const
    { return gasReferenceDensity_[regionIdx]; }

    Scalar constantRs() const
    { return constantRs_; }

    Scalar bubblePointPressure() const
    { return bubblePointPressure_; }

    const std::vector<TabulatedOneDFunction>& inverseOilB() const
    { return inverseOilB_; }

    const std::vector<TabulatedOneDFunction>& oilMu() const
    { return oilMu_; }

    const std::vector<TabulatedOneDFunction>& inverseOilBMu() const
    { return inverseOilBMu_; }

private:

    std::vector<Scalar> oilReferenceDensity_{};
    std::vector<Scalar> gasReferenceDensity_{};
    std::vector<TabulatedOneDFunction> inverseOilB_{};
    std::vector<TabulatedOneDFunction> oilMu_{};
    std::vector<TabulatedOneDFunction> inverseOilBMu_{};
    
    // Global constants from RSCONST (same for all regions)
    Scalar constantRs_ = 0.0;           // Constant Rs value from RSCONST
    Scalar bubblePointPressure_ = 0.0;  // Bubble point pressure from RSCONST
};

} // namespace Opm

#endif