/* Copyright 2013 SINTEF ICT, Applied Mathematics. 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 . */ #ifndef OPM_BLACKOILPROPSAD_HEADER_INCLUDED #define OPM_BLACKOILPROPSAD_HEADER_INCLUDED #include #include #include #include #include #include namespace Opm { /// class BlackoilPropertiesInterface; /// This class is intended to present a fluid interface for /// three-phase black-oil that is easy to use with the AD-using /// simulators. /// /// Most methods are available in two overloaded versions, one /// taking a constant vector and returning the same, and one /// taking an AD type and returning the same. Derivatives are not /// returned separately by any method, only implicitly with the AD /// version of the methods. class BlackoilPropsAdFromDeck : public BlackoilPropsAdInterface { public: /// Constructor wrapping an opm-core black oil interface. BlackoilPropsAdFromDeck(const EclipseGridParser& deck, const UnstructuredGrid& grid, bool init_rock=true ); //////////////////////////// // Rock interface // //////////////////////////// /// \return D, the number of spatial dimensions. int numDimensions() const; /// \return N, the number of cells. int numCells() const; /// \return Array of N porosity values. const double* porosity() const; /// \return Array of ND^2 permeability values. /// The D^2 permeability values for a cell are organized as a matrix, /// which is symmetric (so ordering does not matter). const double* permeability() const; //////////////////////////// // Fluid interface // //////////////////////////// typedef AutoDiff::ForwardBlock ADB; typedef ADB::V V; typedef std::vector Cells; // ------ Canonical named indices for each phase ------ /// Canonical named indices for each phase. enum PhaseIndex { Water = 0, Oil = 1, Gas = 2 }; // ------ Density ------ /// Densities of stock components at surface conditions. /// \return Array of 3 density values. const double* surfaceDensity() const; // ------ Viscosity ------ /// Water viscosity. /// \param[in] pw Array of n water pressure values. /// \param[in] cells Array of n cell indices to be associated with the pressure values. /// \return Array of n viscosity values. V muWat(const V& pw, const Cells& cells) const; /// Oil viscosity. /// \param[in] po Array of n oil pressure values. /// \param[in] rs Array of n gas solution factor values. /// \param[in] cells Array of n cell indices to be associated with the pressure values. /// \return Array of n viscosity values. V muOil(const V& po, const V& rs, const Cells& cells) const; /// Gas viscosity. /// \param[in] pg Array of n gas pressure values. /// \param[in] cells Array of n cell indices to be associated with the pressure values. /// \return Array of n viscosity values. V muGas(const V& pg, const Cells& cells) const; /// Water viscosity. /// \param[in] pw Array of n water pressure values. /// \param[in] cells Array of n cell indices to be associated with the pressure values. /// \return Array of n viscosity values. ADB muWat(const ADB& pw, const Cells& cells) const; /// Oil viscosity. /// \param[in] po Array of n oil pressure values. /// \param[in] rs Array of n gas solution factor values. /// \param[in] cells Array of n cell indices to be associated with the pressure values. /// \return Array of n viscosity values. ADB muOil(const ADB& po, const ADB& rs, const Cells& cells) const; /// Gas viscosity. /// \param[in] pg Array of n gas pressure values. /// \param[in] cells Array of n cell indices to be associated with the pressure values. /// \return Array of n viscosity values. ADB muGas(const ADB& pg, const Cells& cells) const; // ------ Formation volume factor (b) ------ /// Water formation volume factor. /// \param[in] pw Array of n water pressure values. /// \param[in] cells Array of n cell indices to be associated with the pressure values. /// \return Array of n formation volume factor values. V bWat(const V& pw, const Cells& cells) const; /// Oil formation volume factor. /// \param[in] po Array of n oil pressure values. /// \param[in] rs Array of n gas solution factor values. /// \param[in] cells Array of n cell indices to be associated with the pressure values. /// \return Array of n formation volume factor values. V bOil(const V& po, const V& rs, const Cells& cells) const; /// Gas formation volume factor. /// \param[in] pg Array of n gas pressure values. /// \param[in] cells Array of n cell indices to be associated with the pressure values. /// \return Array of n formation volume factor values. V bGas(const V& pg, const Cells& cells) const; /// Water formation volume factor. /// \param[in] pw Array of n water pressure values. /// \param[in] cells Array of n cell indices to be associated with the pressure values. /// \return Array of n formation volume factor values. ADB bWat(const ADB& pw, const Cells& cells) const; /// Oil formation volume factor. /// \param[in] po Array of n oil pressure values. /// \param[in] rs Array of n gas solution factor values. /// \param[in] cells Array of n cell indices to be associated with the pressure values. /// \return Array of n formation volume factor values. ADB bOil(const ADB& po, const ADB& rs, const Cells& cells) const; /// Gas formation volume factor. /// \param[in] pg Array of n gas pressure values. /// \param[in] cells Array of n cell indices to be associated with the pressure values. /// \return Array of n formation volume factor values. ADB bGas(const ADB& pg, const Cells& cells) const; // ------ Rs bubble point curve ------ #if 0 /// Bubble point curve for Rs as function of oil pressure. /// \param[in] po Array of n oil pressure values. /// \param[in] cells Array of n cell indices to be associated with the pressure values. /// \return Array of n bubble point values for Rs. V rsMax(const V& po, const Cells& cells) const; /// Bubble point curve for Rs as function of oil pressure. /// \param[in] po Array of n oil pressure values. /// \param[in] cells Array of n cell indices to be associated with the pressure values. /// \return Array of n bubble point values for Rs. ADB rsMax(const ADB& po, const Cells& cells) const; #endif // ------ Relative permeability ------ /// Relative permeabilities for all phases. /// \param[in] sw Array of n water saturation values. /// \param[in] so Array of n oil saturation values. /// \param[in] sg Array of n gas saturation values. /// \param[in] cells Array of n cell indices to be associated with the saturation values. /// \return An std::vector with 3 elements, each an array of n relperm values, /// containing krw, kro, krg. Use PhaseIndex for indexing into the result. std::vector relperm(const V& sw, const V& so, const V& sg, const Cells& cells) const; /// Relative permeabilities for all phases. /// \param[in] sw Array of n water saturation values. /// \param[in] so Array of n oil saturation values. /// \param[in] sg Array of n gas saturation values. /// \param[in] cells Array of n cell indices to be associated with the saturation values. /// \return An std::vector with 3 elements, each an array of n relperm values, /// containing krw, kro, krg. Use PhaseIndex for indexing into the result. std::vector relperm(const ADB& sw, const ADB& so, const ADB& sg, const Cells& cells) const; private: RockFromDeck rock_; boost::scoped_ptr satprops_; PhaseUsage phase_usage_; std::vector > props_; double densities_[MaxNumPhases]; }; } // namespace Opm #endif // OPM_BLACKOILPROPSAD_HEADER_INCLUDED