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 enum { enableEnergy = getPropValue<TypeTag, Properties::EnableEnergy>() };
227
228public:
229 ImmiscibleModel(Simulator& simulator)
230 : ParentType(simulator)
231 {}
232
236 static void registerParameters()
237 {
239
240 if (enableEnergy)
242
243 Parameters::SetDefault<Parameters::VtkWriteSaturations>(false);
244 Parameters::SetDefault<Parameters::VtkWriteMobilities>(false);
245 Parameters::SetDefault<Parameters::VtkWriteRelativePermeabilities>(false);
246 }
247
251 static std::string name()
252 { return "immiscible"; }
253
257 std::string primaryVarName(unsigned pvIdx) const
258 {
259 std::string s;
260 if (!(s = EnergyModule::primaryVarName(pvIdx)).empty())
261 return s;
262
263 std::ostringstream oss;
264
265 if (pvIdx == Indices::pressure0Idx) {
266 oss << "pressure_" << FluidSystem::phaseName(/*phaseIdx=*/0);
267 }
268 else if (Indices::saturation0Idx <= pvIdx
269 && pvIdx < Indices::saturation0Idx + numPhases - 1) {
270 unsigned phaseIdx = pvIdx - Indices::saturation0Idx;
271 oss << "saturation_" << FluidSystem::phaseName(phaseIdx);
272 }
273 else
274 assert(false);
275
276 return oss.str();
277 }
278
282 std::string eqName(unsigned eqIdx) const
283 {
284 std::string s;
285 if (!(s = EnergyModule::eqName(eqIdx)).empty())
286 return s;
287
288 std::ostringstream oss;
289
290 if (Indices::conti0EqIdx <= eqIdx && eqIdx < Indices::conti0EqIdx + numComponents)
291 oss << "conti_" << FluidSystem::phaseName(eqIdx - Indices::conti0EqIdx);
292 else
293 assert(false);
294
295 return oss.str();
296 }
297
302 {
303 ParentType::updateBegin();
304
305 // find the a reference pressure. The first degree of freedom
306 // might correspond to non-interior entities which would lead
307 // to an undefined value, so we have to iterate...
308 size_t nDof = this->numTotalDof();
309 for (unsigned dofIdx = 0; dofIdx < nDof; ++ dofIdx) {
310 if (this->isLocalDof(dofIdx)) {
311 referencePressure_ =
312 this->solution(/*timeIdx=*/0)[dofIdx][/*pvIdx=*/Indices::pressure0Idx];
313 break;
314 }
315 }
316 }
317
321 Scalar primaryVarWeight(unsigned globalDofIdx, unsigned pvIdx) const
322 {
323 assert(referencePressure_ > 0);
324
325 Scalar tmp = EnergyModule::primaryVarWeight(asImp_(), globalDofIdx, pvIdx);
326 if (tmp > 0)
327 // energy related quantity
328 return tmp;
329 if (Indices::pressure0Idx == pvIdx) {
330 return 10 / referencePressure_;
331 }
332 return 1.0;
333 }
334
338 Scalar eqWeight(unsigned globalDofIdx, unsigned eqIdx) const
339 {
340 Scalar tmp = EnergyModule::eqWeight(asImp_(), globalDofIdx, eqIdx);
341 if (tmp > 0)
342 // energy related equation
343 return tmp;
344
345#ifndef NDEBUG
346 unsigned compIdx = eqIdx - Indices::conti0EqIdx;
347 assert(compIdx <= numPhases);
348#endif
349
350 // make all kg equal
351 return 1.0;
352 }
353
355 {
357
358 if (enableEnergy)
359 this->addOutputModule(new Opm::VtkEnergyModule<TypeTag>(this->simulator_));
360 }
361
362private:
363 const Implementation& asImp_() const
364 { return *static_cast<const Implementation *>(this); }
365
366 mutable Scalar referencePressure_;
367};
368} // namespace Opm
369
370#endif
Provides the auxiliary methods required for consideration of the energy equation.
Definition: energymodule.hh:50
Implements a boundary vector for the fully implicit multi-phase model which assumes immiscibility.
Definition: immiscibleboundaryratevector.hh:46
This class provides the data all quantities that are required to calculate the fluxes of the fluid ph...
Definition: immiscibleextensivequantities.hh:52
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:251
std::string primaryVarName(unsigned pvIdx) const
Given an primary variable index, return a human readable name.
Definition: immisciblemodel.hh:257
Scalar primaryVarWeight(unsigned globalDofIdx, unsigned pvIdx) const
Definition: immisciblemodel.hh:321
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:301
std::string eqName(unsigned eqIdx) const
Given an equation index, return a human readable name.
Definition: immisciblemodel.hh:282
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:338
void registerOutputModules_()
Definition: immisciblemodel.hh:354
Represents the primary variables used by the immiscible multi-phase, model.
Definition: immiscibleprimaryvariables.hh:55
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:153
static void registerParameters()
Register all run-time parameters for the immiscible model.
Definition: multiphasebasemodel.hh:179
void registerOutputModules_()
Definition: multiphasebasemodel.hh:254
VTK output module for quantities which make sense for models which assume thermal equilibrium.
Definition: vtkenergymodule.hh:66
static void registerParameters()
Register all run-time parameters for the Vtk output module.
Definition: vtkenergymodule.hh:93
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:72
Definition: blackoilboundaryratevector.hh:37
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:235
The indices for the isothermal multi-phase model.
Definition: immiscibleindices.hh:45
Type of object for specifying boundary conditions.
Definition: fvbaseproperties.hh:119
Specify whether energy should be considered as a conservation quantity or not.
Definition: multiphasebaseproperties.hh:76
Data required to calculate a flux over a face.
Definition: fvbaseproperties.hh:149
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:69
Enumerations used by the model.
Definition: multiphasebaseproperties.hh:48
The secondary variables within a sub-control volume.
Definition: fvbaseproperties.hh:133
The type of the local residual function.
Definition: fvbaseproperties.hh:94
The type of the model.
Definition: basicproperties.hh:88
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:130
Vector containing volumetric or areal rates of quantities.
Definition: fvbaseproperties.hh:116
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