solidificationMelting.C

Go to the documentation of this file.

/*---------------------------------------------------------------------------*\
  =========                 |
  \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
   \\    /   O peration     | Website:  https://openfoam.org
    \\  /    A nd           | Copyright (C) 2014-2026 OpenFOAM Foundation
     \\/     M anipulation  |
-------------------------------------------------------------------------------
License
    This file is part of OpenFOAM.
 
    OpenFOAM 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.
 
    OpenFOAM 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 OpenFOAM.  If not, see <http://www.gnu.org/licenses/>.
 
\*---------------------------------------------------------------------------*/
 
#include "solidificationMelting.H"
#include "fvcDdt.H"
#include "fvMatrices.H"
#include "basicThermo.H"
#include "uniformDimensionedFields.H"
#include "zeroGradientFvPatchFields.H"
#include "extrapolatedCalculatedFvPatchFields.H"
#include "addToRunTimeSelectionTable.H"
#include "geometricOneField.H"
 
// * * * * * * * * * * * * * Static Member Functions * * * * * * * * * * * * //
 
namespace Foam
{
namespace fv
{
    defineTypeNameAndDebug(solidificationMelting, 0);
 
    addToRunTimeSelectionTable(fvModel, solidificationMelting, dictionary);
    addBackwardCompatibleToRunTimeSelectionTable
    (
        fvModel,
        solidificationMelting,
        dictionary,
        solidificationMeltingSource,
        "solidificationMeltingSource"
    );
}
}
 
 
const Foam::NamedEnum<Foam::fv::solidificationMelting::thermoMode, 2>
Foam::fv::solidificationMelting::thermoModeTypeNames_
{
    "thermo",
    "lookup"
};
 
 
// * * * * * * * * * * * * * Private Member Functions  * * * * * * * * * * * //
 
void Foam::fv::solidificationMelting::readCoeffs(const dictionary& dict)
{
    Tsol_ = dict.lookup<scalar>("Tsol");
    Tliq_ = dict.lookupOrDefault<scalar>("Tliq", Tsol_);
    alpha1e_ = dict.lookupOrDefault<scalar>("alpha1e", 0.0);
    L_ = dict.lookup<scalar>("L");
 
    relax_ = dict.lookupOrDefault("relax", 0.9);
 
    mode_ = thermoModeTypeNames_.read(dict.lookup("thermoMode"));
 
    rhoRef_ = dict.lookup<scalar>("rhoRef");
    TName_ = dict.lookupOrDefault<word>("T", "T");
    CpName_ = dict.lookupOrDefault<word>("Cp", "Cp");
    UName_ = dict.lookupOrDefault<word>("U", "U");
    phiName_ = dict.lookupOrDefault<word>("phi", "phi");
 
    Cu_ = dict.lookupOrDefault<scalar>("Cu", 100000);
    q_ = dict.lookupOrDefault("q", 0.001);
 
    beta_ = dict.lookup<scalar>("beta");
 
    if (mode_ == thermoMode::lookup)
    {
        CpRef_ = dict.lookup<scalar>("CpRef");
    }
 
    if (!mesh().foundObject<uniformDimensionedVectorField>("g"))
    {
        g_ = dict.lookup("g");
    }
}
 
 
Foam::tmp<Foam::volScalarField>
Foam::fv::solidificationMelting::Cp() const
{
    switch (mode_)
    {
        case thermoMode::thermo:
        {
            const basicThermo& thermo =
                mesh().lookupObject<basicThermo>(physicalProperties::typeName);
 
            return thermo.Cp();
            break;
        }
        case thermoMode::lookup:
        {
            if (CpName_ == "CpRef")
            {
                return volScalarField::New
                (
                    name() + ":Cp",
                    mesh(),
                    dimensionedScalar
                    (
                        dimEnergy/dimMass/dimTemperature,
                        CpRef_
                    ),
                    extrapolatedCalculatedFvPatchScalarField::typeName
                );
            }
            else
            {
                return mesh().lookupObject<volScalarField>(CpName_);
            }
 
            break;
        }
        default:
        {
            FatalErrorInFunction
                << "Unhandled thermo mode: " << thermoModeTypeNames_[mode_]
                << abort(FatalError);
        }
    }
 
    return tmp<volScalarField>(nullptr);
}
 
 
Foam::vector Foam::fv::solidificationMelting::g() const
{
    if (mesh().foundObject<uniformDimensionedVectorField>("g"))
    {
        const uniformDimensionedVectorField& value =
            mesh().lookupObject<uniformDimensionedVectorField>("g");
        return value.value();
    }
    else
    {
        return g_;
    }
}
 
 
void Foam::fv::solidificationMelting::update
(
    const volScalarField& Cp
) const
{
    if (curTimeIndex_ == mesh().time().timeIndex())
    {
        return;
    }
 
    if (debug)
    {
        Info<< indent
            << type() << ": " << name()
            << " - updating phase indicator" << endl;
    }
 
    // update old time alpha1 field
    alpha1_.oldTime();
 
    const volScalarField& T = mesh().lookupObject<volScalarField>(TName_);
 
    zone_.regenerate();
    const labelList& cells = zone_.zone();
 
    forAll(cells, i)
    {
        const label celli = cells[i];
 
        const scalar Tc = T[celli];
        const scalar Cpc = Cp[celli];
        const scalar alpha1New =
            alpha1_[celli]
          + relax_*Cpc
           *(
                Tc
              - max
                (
                    Tsol_,
                    Tsol_
                  + (Tliq_ - Tsol_)*(alpha1_[celli] - alpha1e_)/(1 - alpha1e_)
                )
            )/L_;
 
        alpha1_[celli] = max(0, min(alpha1New, 1));
        deltaT_[i] =
            Tc
          - max
            (
                Tsol_,
                Tsol_
              + (Tliq_ - Tsol_)*(alpha1_[celli] - alpha1e_)/(1 - alpha1e_)
            );
    }
 
    alpha1_.correctBoundaryConditions();
 
    curTimeIndex_ = mesh().time().timeIndex();
}
 
 
template<class RhoFieldType>
void Foam::fv::solidificationMelting::apply
(
    const RhoFieldType& rho,
    fvMatrix<scalar>& eqn
) const
{
    if (debug)
    {
        Info<< indent
            << type() << ": applying source to " << eqn.psi().name() << endl;
    }
 
    const volScalarField Cp(this->Cp());
 
    update(Cp);
 
    dimensionedScalar L("L", dimEnergy/dimMass, L_);
 
    // Contributions added to rhs of solver equation
    if (eqn.psi().dimensions() == dimTemperature)
    {
        eqn -= L/Cp*(fvc::ddt(rho, alpha1_));
    }
    else
    {
        eqn -= L*(fvc::ddt(rho, alpha1_));
    }
}
 
 
// * * * * * * * * * * * * * * * * Constructors  * * * * * * * * * * * * * * //
 
Foam::fv::solidificationMelting::solidificationMelting
(
    const word& name,
    const word& modelType,
    const fvMesh& mesh,
    const dictionary& dict
)
:
    fvModel(name, modelType, mesh, dict),
    zone_(mesh, coeffs(dict)),
    Tsol_(NaN),
    Tliq_(NaN),
    alpha1e_(NaN),
    L_(NaN),
    relax_(NaN),
    mode_(thermoMode::thermo),
    rhoRef_(NaN),
    TName_(word::null),
    CpName_(word::null),
    UName_(word::null),
    phiName_(word::null),
    Cu_(NaN),
    q_(NaN),
    beta_(NaN),
    alpha1_
    (
        IOobject
        (
            this->name() + ":alpha1",
            mesh.time().name(),
            mesh,
            IOobject::READ_IF_PRESENT,
            IOobject::AUTO_WRITE
        ),
        mesh,
        dimensionedScalar(dimless, 0),
        zeroGradientFvPatchScalarField::typeName
    ),
    curTimeIndex_(-1),
    deltaT_(zone_.nCells(), 0)
{
    readCoeffs(coeffs(dict));
}
 
 
// * * * * * * * * * * * * * * * Member Functions  * * * * * * * * * * * * * //
 
Foam::wordList Foam::fv::solidificationMelting::addSupFields() const
{
    switch (mode_)
    {
        case thermoMode::thermo:
        {
            const basicThermo& thermo =
                mesh().lookupObject<basicThermo>(physicalProperties::typeName);
 
            return wordList({UName_, thermo.he().name()});
        }
        case thermoMode::lookup:
        {
            return wordList({UName_, TName_});
        }
    }
 
    return wordList::null();
}
 
 
void Foam::fv::solidificationMelting::addSup
(
    const volScalarField& he,
    fvMatrix<scalar>& eqn
) const
{
    apply(geometricOneField(), eqn);
}
 
 
void Foam::fv::solidificationMelting::addSup
(
    const volScalarField& rho,
    const volScalarField& he,
    fvMatrix<scalar>& eqn
) const
{
    apply(rho, eqn);
}
 
 
void Foam::fv::solidificationMelting::addSup
(
    const volVectorField& U,
    fvMatrix<vector>& eqn
) const
{
    if (debug)
    {
        Info<< indent
            << type() << ": applying source to " << eqn.psi().name() << endl;
    }
 
    const volScalarField Cp(this->Cp());
 
    update(Cp);
 
    const vector g = this->g();
 
    scalarField& Sp = eqn.diag();
    vectorField& Su = eqn.source();
    const scalarField& V = mesh().V();
 
    const labelList& cells = zone_.zone();
 
    forAll(cells, i)
    {
        const label celli = cells[i];
 
        const scalar Vc = V[celli];
        const scalar alpha1c = alpha1_[celli];
 
        const scalar S = -Cu_*sqr(1.0 - alpha1c)/(pow3(alpha1c) + q_);
        const vector Sb = rhoRef_*g*beta_*deltaT_[i];
 
        Sp[celli] += Vc*S;
        Su[celli] += Vc*Sb;
    }
}
 
 
void Foam::fv::solidificationMelting::addSup
(
    const volScalarField& rho,
    const volVectorField& U,
    fvMatrix<vector>& eqn
) const
{
    addSup(U, eqn);
}
 
 
bool Foam::fv::solidificationMelting::movePoints()
{
    zone_.movePoints();
    return true;
}
 
 
void Foam::fv::solidificationMelting::topoChange
(
    const polyTopoChangeMap& map
)
{
    zone_.topoChange(map);
}
 
 
void Foam::fv::solidificationMelting::mapMesh(const polyMeshMap& map)
{
    zone_.mapMesh(map);
}
 
 
void Foam::fv::solidificationMelting::distribute
(
    const polyDistributionMap& map
)
{
    zone_.distribute(map);
}
 
 
bool Foam::fv::solidificationMelting::read(const dictionary& dict)
{
    if (fvModel::read(dict))
    {
        zone_.read(coeffs(dict));
        readCoeffs(coeffs(dict));
        return true;
    }
    else
    {
        return false;
    }
 
    return false;
}
 
 
// ************************************************************************* //