OPM - Reference Documentation for ewoms

This model implements a variant of the Richards equation for quasi-twophase flow. More...

#include <opm/material/localad/Math.hpp>
#include "richardsproperties.hh"
#include "richardsindices.hh"
#include "richardslocalresidual.hh"
#include "richardsextensivequantities.hh"
#include "richardsratevector.hh"
#include "richardsboundaryratevector.hh"
#include "richardsprimaryvariables.hh"
#include "richardsintensivequantities.hh"
#include "richardsnewtonmethod.hh"
#include <ewoms/models/common/multiphasebasemodel.hh>
#include <opm/material/components/NullComponent.hpp>
#include <opm/material/fluidsystems/LiquidPhase.hpp>
#include <opm/material/fluidsystems/GasPhase.hpp>
#include <opm/material/fluidsystems/TwoPhaseImmiscibleFluidSystem.hpp>
#include <dune/common/unused.hh>
#include <sstream>
#include <string>

Include dependency graph for richardsmodel.hh:

Go to the source code of this file.

Classes
class	Ewoms::RichardsModel< TypeTag >
	This model implements a variant of the Richards equation for quasi-twophase flow. More...

class	Ewoms::RichardsModel< TypeTag >
	This model implements a variant of the Richards equation for quasi-twophase flow. More...

Namespaces
	Ewoms

	Ewoms::Properties

Functions
	Ewoms::Properties::NEW_TYPE_TAG (Richards, INHERITS_FROM(MultiPhaseBaseModel))
	The type tag for problems discretized using the Richards model. More...

	Ewoms::Properties::SET_INT_PROP (Richards, LiquidPhaseIndex, 0)
	By default, assume that the first phase is the liquid one. More...

	Ewoms::Properties::SET_INT_PROP (Richards, GasPhaseIndex, 1-GET_PROP_VALUE(TypeTag, LiquidPhaseIndex))
	By default, assume that the non-liquid phase is gaseos. More...

	Ewoms::Properties::SET_INT_PROP (Richards, LiquidComponentIndex, GET_PROP_VALUE(TypeTag, LiquidPhaseIndex))
	By default, assume that component which the liquid is made of has the same index as the liquid phase. More...

	Ewoms::Properties::SET_INT_PROP (Richards, GasComponentIndex, 1-GET_PROP_VALUE(TypeTag, LiquidComponentIndex))
	By default, assume that the gas component is the other than the liquid one. More...

	Ewoms::Properties::SET_TYPE_PROP (Richards, LocalResidual, Ewoms::RichardsLocalResidual< TypeTag >)
	The local residual operator. More...

	Ewoms::Properties::SET_TYPE_PROP (Richards, Model, Ewoms::RichardsModel< TypeTag >)
	The global model used. More...

	Ewoms::Properties::SET_TYPE_PROP (Richards, RateVector, Ewoms::RichardsRateVector< TypeTag >)
	the RateVector property More...

	Ewoms::Properties::SET_TYPE_PROP (Richards, BoundaryRateVector, Ewoms::RichardsBoundaryRateVector< TypeTag >)
	the BoundaryRateVector property More...

	Ewoms::Properties::SET_TYPE_PROP (Richards, PrimaryVariables, Ewoms::RichardsPrimaryVariables< TypeTag >)
	the PrimaryVariables property More...

	Ewoms::Properties::SET_TYPE_PROP (Richards, IntensiveQuantities, Ewoms::RichardsIntensiveQuantities< TypeTag >)
	The class for the intensive quantities. More...

	Ewoms::Properties::SET_TYPE_PROP (Richards, ExtensiveQuantities, Ewoms::RichardsExtensiveQuantities< TypeTag >)
	The class for the quantities required for the flux calculation. More...

	Ewoms::Properties::SET_TYPE_PROP (Richards, NewtonMethod, Ewoms::RichardsNewtonMethod< TypeTag >)
	The class of the Newton method. More...

	Ewoms::Properties::SET_TYPE_PROP (Richards, Indices, Ewoms::RichardsIndices)
	The class with all index definitions for the model. More...

	Ewoms::Properties::SET_PROP (Richards, WettingFluid)
	The wetting phase used. More...

	Ewoms::Properties::SET_PROP (Richards, NonWettingFluid)
	The non-wetting phase used. More...

	Ewoms::Properties::SET_PROP (Richards, FluidSystem)
	The fluid system used by the model. More...

Detailed Description

This model implements a variant of the Richards equation for quasi-twophase flow.

In the unsaturated zone, Richards' equation is frequently used to approximate the water distribution above the groundwater level. It can be derived from the two-phase equations, i.e.

$\frac{\partial\;\phi S_\alpha \rho_\alpha}{\partial t} - \mathrm{div} \left\{ \rho_\alpha \frac{k_{r\alpha}}{\mu_\alpha}\; \mathbf{K}\; \mathbf{grad}\left[ p_\alpha - g\rho_\alpha \right] \right\} = q_\alpha,$

where $\alpha \in \{w, n\}$ is the index of the fluid phase, $\rho_\alpha$ is the fluid density, $S_\alpha$ is the fluid saturation, $\phi$ is the porosity of the soil, $k_{r\alpha}$ is the relative permeability for the fluid, $\mu_\alpha$ is the fluid's dynamic viscosity, $\mathbf{K}$ is the intrinsic permeability tensor, $p_\alpha$ is the fluid phase pressure and $g$ is the potential of the gravity field.

In contrast to the "full" two-phase model, the Richards model assumes that the non-wetting fluid is gas and that it thus exhibits a much lower viscosity than the (liquid) wetting phase. (This assumption is quite realistic in many applications: For example, at atmospheric pressure and at room temperature, the viscosity of air is only about $1\%$ of the viscosity of liquid water.) As a consequence, the $\frac{k_{r\alpha}}{\mu_\alpha}$ term typically is much larger for the gas phase than for the wetting phase. Using this reasoning, the Richards model assumes that $\frac{k_{rn}}{\mu_n}$ is infinitely large compared to the same term of the liquid phase. This implies that the pressure of the gas phase is equivalent to the static pressure distribution and that therefore, mass conservation only needs to be considered for the liquid phase.

The model thus choses the absolute pressure of the wetting phase $p_w$ as its only primary variable. The wetting phase saturation is calculated using the inverse of the capillary pressure, i.e.

$S_w = p_c^{-1}(p_n - p_w)$

holds, where $p_n$ is a reference pressure given by the problem's referencePressure() method. Nota bene, that the last step assumes that the capillary pressure-saturation curve can be uniquely inverted, i.e. it is not possible to set the capillary pressure to zero if the Richards model ought to be used!

Classes

Namespaces

Functions

Detailed Description