immisciblemodel.hh
Go to the documentation of this file.
1// -*- mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*-
2// vi: set et ts=4 sw=4 sts=4:
3/*
4 This file is part of the Open Porous Media project (OPM).
5
6 OPM is free software: you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation, either version 2 of the License, or
9 (at your option) any later version.
10
11 OPM is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
15
16 You should have received a copy of the GNU General Public License
17 along with OPM. If not, see <http://www.gnu.org/licenses/>.
18
19 Consult the COPYING file in the top-level source directory of this
20 module for the precise wording of the license and the list of
21 copyright holders.
22*/
28#ifndef EWOMS_IMMISCIBLE_MODEL_HH
29#define EWOMS_IMMISCIBLE_MODEL_HH
30
31#include <opm/material/densead/Math.hpp>
33#include "immiscibleindices.hh"
40
44#include <opm/material/components/NullComponent.hpp>
45#include <opm/material/fluidsystems/GasPhase.hpp>
46#include <opm/material/fluidsystems/LiquidPhase.hpp>
47#include <opm/material/fluidsystems/SinglePhaseFluidSystem.hpp>
48#include <opm/material/fluidsystems/TwoPhaseImmiscibleFluidSystem.hpp>
49
50#include <sstream>
51#include <string>
52
53namespace Opm {
54template <class TypeTag>
55class ImmiscibleModel;
56}
57
58namespace Opm::Properties {
59
60// Create new type tags
61namespace TTag {
63struct ImmiscibleModel { using InheritsFrom = std::tuple<MultiPhaseBaseModel>; };
64
66struct ImmiscibleSinglePhaseModel { using InheritsFrom = std::tuple<ImmiscibleModel>; };
67
69struct ImmiscibleTwoPhaseModel { using InheritsFrom = std::tuple<ImmiscibleModel>; };
70} // end namespace TTag
71
73template<class TypeTag>
75
77template<class TypeTag>
78struct Model<TypeTag, TTag::ImmiscibleModel> { using type = Opm::ImmiscibleModel<TypeTag>; };
79
81template<class TypeTag>
83
85template<class TypeTag>
87
89template<class TypeTag>
91
93template<class TypeTag>
95
97template<class TypeTag>
99
101template<class TypeTag>
102struct Indices<TypeTag, TTag::ImmiscibleModel> { using type = Opm::ImmiscibleIndices<TypeTag, /*PVOffset=*/0>; };
103
105template<class TypeTag>
106struct EnableEnergy<TypeTag, TTag::ImmiscibleModel> { static constexpr bool value = false; };
107
109// set slightly different properties for the single-phase case
111
113template<class TypeTag>
114struct FluidSystem<TypeTag, TTag::ImmiscibleSinglePhaseModel>
115{ private:
118public:
119 using type = Opm::SinglePhaseFluidSystem<Scalar , Fluid>;
120};
121
122template<class TypeTag>
123struct Fluid<TypeTag, TTag::ImmiscibleSinglePhaseModel>
124{
125private:
127
128public:
129 using type = Opm::LiquidPhase<Scalar, Opm::NullComponent<Scalar> >;
130};
131
133// set slightly different properties for the two-phase case
135template<class TypeTag>
136struct WettingPhase<TypeTag, TTag::ImmiscibleTwoPhaseModel>
137{
138private:
140
141public:
142 using type = Opm::LiquidPhase<Scalar, Opm::NullComponent<Scalar> >;
143};
144
145template<class TypeTag>
146struct NonwettingPhase<TypeTag, TTag::ImmiscibleTwoPhaseModel>
147{
148private:
150
151public:
152 using type = Opm::LiquidPhase<Scalar, Opm::NullComponent<Scalar> >;
153};
154
155template<class TypeTag>
156struct FluidSystem<TypeTag, TTag::ImmiscibleTwoPhaseModel>
157{
158private:
162
163public:
164 using type = Opm::TwoPhaseImmiscibleFluidSystem<Scalar, WettingPhase, NonwettingPhase>;
165};
166
167} // namespace Opm::Properties
168
169namespace Opm {
170
208template <class TypeTag>
210 : public Opm::MultiPhaseBaseModel<TypeTag>
211{
212 using ParentType = Opm::MultiPhaseBaseModel<TypeTag>;
213 using Implementation = GetPropType<TypeTag, Properties::Model>;
215
219
220 enum { numComponents = FluidSystem::numComponents };
221
222
223
224 enum { numPhases = getPropValue<TypeTag, Properties::NumPhases>() };
225 static constexpr bool enableEnergy = getPropValue<TypeTag, Properties::EnableEnergy>();
227
228public:
229 explicit ImmiscibleModel(Simulator& simulator)
230 : ParentType(simulator)
231 {}
232
236 static void registerParameters()
237 {
239
240 if constexpr (enableEnergy) {
242 }
243
244 Parameters::SetDefault<Parameters::VtkWriteSaturations>(false);
245 Parameters::SetDefault<Parameters::VtkWriteMobilities>(false);
246 Parameters::SetDefault<Parameters::VtkWriteRelativePermeabilities>(false);
247 }
248
252 static std::string name()
253 { return "immiscible"; }
254
258 std::string primaryVarName(unsigned pvIdx) const
259 {
260 std::string s;
261 if (!(s = EnergyModule::primaryVarName(pvIdx)).empty())
262 return s;
263
264 std::ostringstream oss;
265
266 if (pvIdx == Indices::pressure0Idx) {
267 oss << "pressure_" << FluidSystem::phaseName(/*phaseIdx=*/0);
268 }
269 else if (Indices::saturation0Idx <= pvIdx
270 && pvIdx < Indices::saturation0Idx + numPhases - 1) {
271 unsigned phaseIdx = pvIdx - Indices::saturation0Idx;
272 oss << "saturation_" << FluidSystem::phaseName(phaseIdx);
273 }
274 else
275 assert(false);
276
277 return oss.str();
278 }
279
283 std::string eqName(unsigned eqIdx) const
284 {
285 std::string s;
286 if (!(s = EnergyModule::eqName(eqIdx)).empty())
287 return s;
288
289 std::ostringstream oss;
290
291 if (Indices::conti0EqIdx <= eqIdx && eqIdx < Indices::conti0EqIdx + numComponents)
292 oss << "conti_" << FluidSystem::phaseName(eqIdx - Indices::conti0EqIdx);
293 else
294 assert(false);
295
296 return oss.str();
297 }
298
303 {
304 ParentType::updateBegin();
305
306 // find the a reference pressure. The first degree of freedom
307 // might correspond to non-interior entities which would lead
308 // to an undefined value, so we have to iterate...
309 size_t nDof = this->numTotalDof();
310 for (unsigned dofIdx = 0; dofIdx < nDof; ++ dofIdx) {
311 if (this->isLocalDof(dofIdx)) {
312 referencePressure_ =
313 this->solution(/*timeIdx=*/0)[dofIdx][/*pvIdx=*/Indices::pressure0Idx];
314 break;
315 }
316 }
317 }
318
322 Scalar primaryVarWeight(unsigned globalDofIdx, unsigned pvIdx) const
323 {
324 assert(referencePressure_ > 0);
325
326 Scalar tmp = EnergyModule::primaryVarWeight(asImp_(), globalDofIdx, pvIdx);
327 if (tmp > 0)
328 // energy related quantity
329 return tmp;
330 if (Indices::pressure0Idx == pvIdx) {
331 return 10 / referencePressure_;
332 }
333 return 1.0;
334 }
335
342 Scalar eqWeight(unsigned globalDofIdx, unsigned eqIdx) const
343 {
344 Scalar tmp = EnergyModule::eqWeight(asImp_(), globalDofIdx, eqIdx);
345 if (tmp > 0)
346 // energy related equation
347 return tmp;
348
349#ifndef NDEBUG
350 unsigned compIdx = eqIdx - Indices::conti0EqIdx;
351 assert(compIdx <= numPhases);
352#endif
353
354 // make all kg equal
355 return 1.0;
356 }
357
359 {
361
362 if constexpr (enableEnergy) {
363 this->addOutputModule(std::make_unique<VtkEnergyModule<TypeTag>>(this->simulator_));
364 }
365 }
366
367private:
368 const Implementation& asImp_() const
369 { return *static_cast<const Implementation *>(this); }
370
371 mutable Scalar referencePressure_;
372};
373} // namespace Opm
374
375#endif
Provides the auxiliary methods required for consideration of the energy equation.
Definition: energymodule.hh:54
Implements a boundary vector for the fully implicit multi-phase model which assumes immiscibility.
Definition: immiscibleboundaryratevector.hh:50
This class provides the data all quantities that are required to calculate the fluxes of the fluid ph...
Definition: immiscibleextensivequantities.hh:53
Contains the quantities which are are constant within a finite volume for the immiscible multi-phase ...
Definition: immiscibleintensivequantities.hh:54
Calculates the local residual of the immiscible multi-phase model.
Definition: immisciblelocalresidual.hh:46
A fully-implicit multi-phase flow model which assumes immiscibility of the phases.
Definition: immisciblemodel.hh:211
static std::string name()
Definition: immisciblemodel.hh:252
std::string primaryVarName(unsigned pvIdx) const
Given an primary variable index, return a human readable name.
Definition: immisciblemodel.hh:258
Scalar primaryVarWeight(unsigned globalDofIdx, unsigned pvIdx) const
Definition: immisciblemodel.hh:322
ImmiscibleModel(Simulator &simulator)
Definition: immisciblemodel.hh:229
void updateBegin()
Called by the update() method before it tries to apply the newton method. This is primary a hook whic...
Definition: immisciblemodel.hh:302
std::string eqName(unsigned eqIdx) const
Given an equation index, return a human readable name.
Definition: immisciblemodel.hh:283
static void registerParameters()
Register all run-time parameters for the immiscible model.
Definition: immisciblemodel.hh:236
Scalar eqWeight(unsigned globalDofIdx, unsigned eqIdx) const
Definition: immisciblemodel.hh:342
void registerOutputModules_()
Definition: immisciblemodel.hh:358
Represents the primary variables used by the immiscible multi-phase, model.
Definition: immiscibleprimaryvariables.hh:54
Implements a vector representing rates of conserved quantities.
Definition: immiscibleratevector.hh:51
A base class for fully-implicit multi-phase porous-media flow models which assume multiple fluid phas...
Definition: multiphasebasemodel.hh:175
static void registerParameters()
Register all run-time parameters for the immiscible model.
Definition: multiphasebasemodel.hh:197
void registerOutputModules_()
Definition: multiphasebasemodel.hh:273
VTK output module for quantities which make sense for models which assume thermal equilibrium.
Definition: vtkenergymodule.hpp:58
static void registerParameters()
Register all run-time parameters for the Vtk output module.
Definition: vtkenergymodule.hpp:87
Contains the classes required to consider energy as a conservation quantity in a multi-phase module.
Defines the properties required for the immiscible multi-phase model.
Definition: blackoilmodel.hh:74
Definition: blackoilbioeffectsmodules.hh:45
typename Properties::Detail::GetPropImpl< TypeTag, Property >::type::type GetPropType
get the type alias defined in the property (equivalent to old macro GET_PROP_TYPE(....
Definition: propertysystem.hh:233
The indices for the isothermal multi-phase model.
Definition: immiscibleindices.hh:45
Type of object for specifying boundary conditions.
Definition: fvbaseproperties.hh:125
Specify whether energy should be considered as a conservation quantity or not.
Definition: multiphasebaseproperties.hh:87
Data required to calculate a flux over a face.
Definition: fvbaseproperties.hh:164
Opm::LiquidPhase< Scalar, Opm::NullComponent< Scalar > > type
Definition: immisciblemodel.hh:129
The fluid used by the model.
Definition: immiscibleproperties.hh:49
Opm::SinglePhaseFluidSystem< Scalar, Fluid > type
Definition: immisciblemodel.hh:119
Opm::TwoPhaseImmiscibleFluidSystem< Scalar, WettingPhase, NonwettingPhase > type
Definition: immisciblemodel.hh:164
The fluid systems including the information about the phases.
Definition: multiphasebaseproperties.hh:79
Enumerations used by the model.
Definition: multiphasebaseproperties.hh:51
The secondary variables within a sub-control volume.
Definition: fvbaseproperties.hh:139
The type of the local residual function.
Definition: fvbaseproperties.hh:100
The type of the model.
Definition: basicproperties.hh:92
Opm::LiquidPhase< Scalar, Opm::NullComponent< Scalar > > type
Definition: immisciblemodel.hh:152
The non-wetting phase for two-phase models.
Definition: immiscibleproperties.hh:44
A vector of primary variables within a sub-control volume.
Definition: fvbaseproperties.hh:136
Vector containing volumetric or areal rates of quantities.
Definition: fvbaseproperties.hh:122
The generic type tag for problems using the immiscible multi-phase model.
Definition: immisciblemodel.hh:63
std::tuple< MultiPhaseBaseModel > InheritsFrom
Definition: immisciblemodel.hh:63
The type tag for single-phase immiscible problems.
Definition: immisciblemodel.hh:66
std::tuple< ImmiscibleModel > InheritsFrom
Definition: immisciblemodel.hh:66
The type tag for two-phase immiscible problems.
Definition: immisciblemodel.hh:69
std::tuple< ImmiscibleModel > InheritsFrom
Definition: immisciblemodel.hh:69
Opm::LiquidPhase< Scalar, Opm::NullComponent< Scalar > > type
Definition: immisciblemodel.hh:142
The wetting phase for two-phase models.
Definition: immiscibleproperties.hh:41