nonequilibrium.hh

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:
//
// SPDX-FileCopyrightInfo: Copyright © DuMux Project contributors, see AUTHORS.md in root folder
// SPDX-License-Identifier: GPL-3.0-or-later
//
#ifndef DUMUX_NONEQUILIBRIUM_FLUID_STATE_HH
#define DUMUX_NONEQUILIBRIUM_FLUID_STATE_HH
 
#include <cmath>
#include <algorithm>
#include <dune/common/exceptions.hh>
 
namespace Dumux {
 
template <class ScalarType, class FluidSystem>
class NonEquilibriumFluidState
{
public:
    static constexpr int numPhases = FluidSystem::numPhases;
    static constexpr int numComponents = FluidSystem::numComponents;
 
    using Scalar = ScalarType;
 
    /*****************************************************
     * Generic access to fluid properties (No assumptions
     * on thermodynamic equilibrium required)
     *****************************************************/
    int wettingPhase() const { return wPhaseIdx_; }
    Scalar saturation(int phaseIdx) const
    { return saturation_[phaseIdx]; }
 
    Scalar moleFraction(int phaseIdx, int compIdx) const
    { return moleFraction_[phaseIdx][compIdx]; }
 
 
    Scalar massFraction(int phaseIdx, int compIdx) const
    {
        using std::abs;
        using std::max;
        return abs(sumMoleFractions_[phaseIdx])
               * moleFraction_[phaseIdx][compIdx]
               * FluidSystem::molarMass(compIdx)
               / max(1e-40, abs(averageMolarMass_[phaseIdx]));
    }
 
    Scalar averageMolarMass(int phaseIdx) const
    { return averageMolarMass_[phaseIdx]; }
 
    Scalar molarity(int phaseIdx, int compIdx) const
    { return molarDensity(phaseIdx)*moleFraction(phaseIdx, compIdx); }
 
    Scalar fugacityCoefficient(int phaseIdx, int compIdx) const
    { return fugacityCoefficient_[phaseIdx][compIdx]; }
 
    Scalar fugacity(int phaseIdx, int compIdx) const
    {
        return pressure_[phaseIdx]
               *fugacityCoefficient_[phaseIdx][compIdx]
               *moleFraction_[phaseIdx][compIdx];
    }
 
    Scalar fugacity(int compIdx) const
    { return fugacity(0, compIdx); }
 
    Scalar molarVolume(int phaseIdx) const
    { return 1.0/molarDensity(phaseIdx); }
 
    Scalar density(int phaseIdx) const
    { return density_[phaseIdx]; }
 
    Scalar molarDensity(int phaseIdx) const
    { return molarDensity_[phaseIdx]; }
 
    Scalar temperature(const int phaseIdx) const
    {  return temperature_[phaseIdx];  }
 
    Scalar temperature() const
    { return temperatureEquil_ ; }
 
    Scalar pressure(int phaseIdx) const
    { return pressure_[phaseIdx]; }
 
    Scalar partialPressure(int phaseIdx, int compIdx) const
    {
        assert(FluidSystem::isGas(phaseIdx));
        return moleFraction(phaseIdx, compIdx) * pressure(phaseIdx);
    }
 
    Scalar enthalpy(int phaseIdx) const
    { return enthalpy_[phaseIdx]; }
 
    Scalar internalEnergy(int phaseIdx) const
    { return enthalpy_[phaseIdx] - pressure(phaseIdx)/density(phaseIdx); }
 
    Scalar viscosity(int phaseIdx) const
    { return viscosity_[phaseIdx]; }
 
    /*****************************************************
     * Setter methods. Note that these are not part of the
     * generic FluidState interface but specific for each
     * implementation...
     *****************************************************/
    void setTemperature(int phaseIdx, Scalar value)
    { temperature_[phaseIdx] = value; }
 
    void setTemperature(Scalar value)
    { temperatureEquil_ = value; }
 
    void setPressure(int phaseIdx, Scalar value)
    { pressure_[phaseIdx] = value; }
 
    void setSaturation(int phaseIdx, Scalar value)
    { saturation_[phaseIdx] = value; }
 
    void setMoleFraction(int phaseIdx, int compIdx, Scalar value)
    {
        using std::isfinite;
        if (isfinite(averageMolarMass_[phaseIdx]))
        {
            Scalar delta = value - moleFraction_[phaseIdx][compIdx];
 
            moleFraction_[phaseIdx][compIdx] = value;
 
            sumMoleFractions_[phaseIdx] += delta;
            averageMolarMass_[phaseIdx] += delta*FluidSystem::molarMass(compIdx);
        }
        else
        {
            moleFraction_[phaseIdx][compIdx] = value;
 
            // re-calculate the mean molar mass
            sumMoleFractions_[phaseIdx] = 0.0;
            averageMolarMass_[phaseIdx] = 0.0;
            for (int compJIdx = 0; compJIdx < numComponents; ++compJIdx) {
                sumMoleFractions_[phaseIdx] += moleFraction_[phaseIdx][compJIdx];
                averageMolarMass_[phaseIdx] += moleFraction_[phaseIdx][compJIdx]*FluidSystem::molarMass(compJIdx);
            }
        }
    }
 
    void setMassFraction(int phaseIdx, int compIdx, Scalar value)
    {
        if (numComponents != 2)
            DUNE_THROW(Dune::NotImplemented, "This currently only works for 2 components.");
        else
        {
            // calculate average molar mass of the gas phase
            Scalar M1 = FluidSystem::molarMass(compIdx);
            Scalar M2 = FluidSystem::molarMass(1-compIdx);
            Scalar X2 = 1.0-value;
            Scalar avgMolarMass = M1*M2/(M2 + X2*(M1 - M2));
 
            moleFraction_[phaseIdx][compIdx] = value * avgMolarMass / M1;
            moleFraction_[phaseIdx][1-compIdx] = 1.0-moleFraction_[phaseIdx][compIdx];
 
            // re-calculate the mean molar mass
            sumMoleFractions_[phaseIdx] = 0.0;
            averageMolarMass_[phaseIdx] = 0.0;
            for (int compJIdx = 0; compJIdx < numComponents; ++compJIdx) {
                sumMoleFractions_[phaseIdx] += moleFraction_[phaseIdx][compJIdx];
                averageMolarMass_[phaseIdx] += moleFraction_[phaseIdx][compJIdx]*FluidSystem::molarMass(compJIdx);
            }
        }
    }
 
    void setFugacityCoefficient(int phaseIdx, int compIdx, Scalar value)
    { fugacityCoefficient_[phaseIdx][compIdx] = value; }
 
    void setDensity(int phaseIdx, Scalar value)
    { density_[phaseIdx] = value; }
 
    void setMolarDensity(int phaseIdx, Scalar value)
    { molarDensity_[phaseIdx] = value; }
 
    void setEnthalpy(int phaseIdx, Scalar value)
    { enthalpy_[phaseIdx] = value; }
 
    void setViscosity(int phaseIdx, Scalar value)
    { viscosity_[phaseIdx] = value; }
 
    void setWettingPhase(int phaseIdx)
    { wPhaseIdx_ = phaseIdx; }
 
    template <class FluidState>
    void assign(const FluidState& fs)
    {
        for (int phaseIdx = 0; phaseIdx < numPhases; ++phaseIdx)
        {
            averageMolarMass_[phaseIdx] = 0;
            sumMoleFractions_[phaseIdx] = 0;
            for (int compIdx = 0; compIdx < numComponents; ++compIdx)
            {
                moleFraction_[phaseIdx][compIdx] = fs.moleFraction(phaseIdx, compIdx);
                fugacityCoefficient_[phaseIdx][compIdx] = fs.fugacityCoefficient(phaseIdx, compIdx);
                averageMolarMass_[phaseIdx] += moleFraction_[phaseIdx][compIdx]*FluidSystem::molarMass(compIdx);
                sumMoleFractions_[phaseIdx] += moleFraction_[phaseIdx][compIdx];
            }
            pressure_[phaseIdx] = fs.pressure(phaseIdx);
            saturation_[phaseIdx] = fs.saturation(phaseIdx);
            density_[phaseIdx] = fs.density(phaseIdx);
            molarDensity_[phaseIdx] = fs.molarDensity(phaseIdx);
            enthalpy_[phaseIdx] = fs.enthalpy(phaseIdx);
            viscosity_[phaseIdx] = fs.viscosity(phaseIdx);
            temperature_[phaseIdx] = fs.temperature(phaseIdx);
        }
    }
 
protected:
    Scalar moleFraction_[numPhases][numComponents] = {};
    Scalar fugacityCoefficient_[numPhases][numComponents] = {};
    Scalar averageMolarMass_[numPhases] = {};
    Scalar sumMoleFractions_[numPhases] = {};
    Scalar pressure_[numPhases] = {};
    Scalar saturation_[numPhases] = {};
    Scalar density_[numPhases] = {};
    Scalar molarDensity_[numPhases] = {};
    Scalar enthalpy_[numPhases] = {};
    Scalar viscosity_[numPhases] = {};
    Scalar temperature_[numPhases] = {};
    Scalar temperatureEquil_ = 0.0;
 
    // For porous medium flow models, here we ... the index of the wetting
    // phase (needed for vapor pressure evaluation if kelvin equation is used)
    int wPhaseIdx_{0};
};
 
} // end namespace Dumux
 
#endif