hyperbolic.C
Go to the documentation of this file.
1 /*---------------------------------------------------------------------------*\
2  ========= |
3  \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
4  \\ / O peration | Website: https://openfoam.org
5  \\ / A nd | Copyright (C) 2014-2023 OpenFOAM Foundation
6  \\/ M anipulation |
7 -------------------------------------------------------------------------------
8 License
9  This file is part of OpenFOAM.
10 
11  OpenFOAM is free software: you can redistribute it and/or modify it
12  under the terms of the GNU General Public License as published by
13  the Free Software Foundation, either version 3 of the License, or
14  (at your option) any later version.
15 
16  OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
17  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
18  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
19  for more details.
20 
21  You should have received a copy of the GNU General Public License
22  along with OpenFOAM. If not, see <http://www.gnu.org/licenses/>.
23 
24 \*---------------------------------------------------------------------------*/
25 
26 #include "hyperbolic.H"
28 
29 // * * * * * * * * * * * * * * Static Data Members * * * * * * * * * * * * * //
30 
31 namespace Foam
32 {
33 namespace blendingMethods
34 {
37 }
38 }
39 
40 
41 // * * * * * * * * * * * * Protected Member Functions * * * * * * * * * * * //
42 
44 (
45  const UPtrList<const volScalarField>& alphas,
46  const label phaseSet,
47  const label systemSet
48 ) const
49 {
50  tmp<volScalarField> x = this->x(alphas, phaseSet, systemSet);
51  tmp<volScalarField> a = parameter(alphas, phaseSet, minContinuousAlpha_);
52  return (1 + tanh((4/transitionAlphaScale_.value)*(x - a)))/2;
53 }
54 
55 
56 // * * * * * * * * * * * * * * * * Constructors * * * * * * * * * * * * * * //
57 
59 (
60  const dictionary& dict,
61  const phaseInterface& interface
62 )
63 :
64  blendingMethod(dict, interface),
65  minContinuousAlpha_
66  (
67  readParameters("minContinuousAlpha", dict, interface, {0, 1}, true)
68  ),
69  transitionAlphaScale_
70  (
71  readParameter("transitionAlphaScale", dict, {0, vGreat}, false)
72  )
73 {
74  if
75  (
76  canBeContinuous(0)
77  && canBeContinuous(1)
78  && minContinuousAlpha_[0].value + minContinuousAlpha_[1].value
79  < 1 - rootSmall
80  )
81  {
83  << typeName.capitalise() << " blending function for interface "
84  << interface.name() << " is invalid in that it creates negative "
85  << "coefficients for sub-modelled values. A valid function will "
86  << "have minimum continuous alphas that sum one or greater."
87  << exit(FatalError);
88  }
89 }
90 
91 
92 // * * * * * * * * * * * * * * * * Destructor * * * * * * * * * * * * * * * //
93 
95 {}
96 
97 
98 // * * * * * * * * * * * * * * Member Functions * * * * * * * * * * * * * * //
99 
101 {
102  return minContinuousAlpha_[index].valid;
103 }
104 
105 
107 {
108  return
109  canBeContinuous(0)
110  && canBeContinuous(1)
111  && minContinuousAlpha_[0].value + minContinuousAlpha_[1].value
112  > 1 + rootSmall;
113 }
114 
115 
116 // ************************************************************************* //
Macros for easy insertion into run-time selection tables.
A templated 1D list of pointers to objects of type <T>, where the size of the array is known and used...
Definition: UPtrList.H:66
Abstract base class for functions that are used to combine interfacial sub-models according to the vo...
tmp< volScalarField > x(const UPtrList< const volScalarField > &alphas, const label phaseSet, const label systemSet) const
Return the coordinate of the blending function.
tmp< volScalarField > parameter(const UPtrList< const volScalarField > &alphas, const label set, const Pair< blendingParameter > &parameters) const
Get a blending parameter averaged for the given set.
Blending method based on smooth hyperbolic functions. Supports the full range of phase fraction space...
Definition: hyperbolic.H:63
virtual tmp< volScalarField > fContinuous(const UPtrList< const volScalarField > &alphas, const label phaseSet, const label systemSet) const
Evaluate the blending function.
Definition: hyperbolic.C:44
virtual bool canSegregate() const
Return whether or not this interface can segregate.
Definition: hyperbolic.C:106
hyperbolic(const dictionary &dict, const phaseInterface &interface)
Construct from a dictionary and an interface.
Definition: hyperbolic.C:59
virtual bool canBeContinuous(const label index) const
Return whether or not a phase can be considered continuous.
Definition: hyperbolic.C:100
A list of keyword definitions, which are a keyword followed by any number of values (e....
Definition: dictionary.H:160
Class to represent an interface between phases. Derivations can further specify the configuration of ...
A class for managing temporary objects.
Definition: tmp.H:55
#define FatalErrorInFunction
Report an error message using Foam::FatalError.
Definition: error.H:306
defineTypeNameAndDebug(continuous, 0)
addToRunTimeSelectionTable(blendingMethod, continuous, dictionary)
Namespace for OpenFOAM.
errorManipArg< error, int > exit(error &err, const int errNo=1)
Definition: errorManip.H:124
intWM_LABEL_SIZE_t label
A label is an int32_t or int64_t as specified by the pre-processor macro WM_LABEL_SIZE.
Definition: label.H:59
dimensionedScalar tanh(const dimensionedScalar &ds)
error FatalError
dictionary dict
scalar value
The parameter value. Could be templated if needed.