exponential.C
Go to the documentation of this file.
1 /*---------------------------------------------------------------------------*\
2  ========= |
3  \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
4  \\ / O peration |
5  \\ / A nd | www.openfoam.com
6  \\/ M anipulation |
7 -------------------------------------------------------------------------------
8  Copyright (C) 2011-2016 OpenFOAM Foundation
9  Copyright (C) 2021 OpenCFD Ltd.
10 -------------------------------------------------------------------------------
11 License
12  This file is part of OpenFOAM.
13 
14  OpenFOAM is free software: you can redistribute it and/or modify it
15  under the terms of the GNU General Public License as published by
16  the Free Software Foundation, either version 3 of the License, or
17  (at your option) any later version.
18 
19  OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
20  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
21  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
22  for more details.
23 
24  You should have received a copy of the GNU General Public License
25  along with OpenFOAM. If not, see <http://www.gnu.org/licenses/>.
26 
27 \*---------------------------------------------------------------------------*/
28 
29 #include "exponential.H"
31 
32 // * * * * * * * * * * * * * * Static Data Members * * * * * * * * * * * * * //
33 
34 namespace Foam
35 {
36 namespace distributionModels
37 {
38  defineTypeNameAndDebug(exponential, 0);
39  addToRunTimeSelectionTable(distributionModel, exponential, dictionary);
40 }
41 }
42 
43 // * * * * * * * * * * * * * * * * Constructors * * * * * * * * * * * * * * //
44 
46 (
47  const dictionary& dict,
48  Random& rndGen
49 )
50 :
51  distributionModel(typeName, dict, rndGen),
52  lambda_(distributionModelDict_.get<scalar>("lambda"))
53 {
54  if (lambda_ < VSMALL)
55  {
57  << "Rate parameter cannot be equal to or less than zero:" << nl
58  << " lambda = " << lambda_
59  << exit(FatalError);
60  }
61 
62  check();
63 }
64 
65 
67 :
69  lambda_(p.lambda_)
70 {}
71 
72 
73 // * * * * * * * * * * * * * * * Member Functions * * * * * * * * * * * * * //
74 
76 {
77  const scalar u = rndGen_.sample01<scalar>();
78  const scalar qMin = exp(-lambda_*minValue_);
79  const scalar qMax = exp(-lambda_*maxValue_);
80  return -(scalar(1)/lambda_)*log(qMin + u*(qMax - qMin));
81 }
82 
83 
85 {
86  return scalar(1)/lambda_;
87 }
88 
89 
90 // ************************************************************************* //
Foam::Random
Random number generator.
Definition: Random.H:59
exponential.H
p
volScalarField & p
Definition: createFieldRefs.H:8
Foam::distributionModels::exponential::sample
virtual scalar sample() const
Sample the distribution.
Definition: exponential.C:75
Foam::distributionModels::exponential::exponential
exponential(const dictionary &dict, Random &rndGen)
Construct from components.
Definition: exponential.C:46
Foam::distributionModels::addToRunTimeSelectionTable
addToRunTimeSelectionTable(distributionModel, binned, dictionary)
Foam::exp
dimensionedScalar exp(const dimensionedScalar &ds)
Definition: dimensionedScalar.C:261
Foam::distributionModel
A library of runtime-selectable doubly-truncated probability distribution models. Returns random samp...
Definition: distributionModel.H:72
Foam::check
static void check(const int retVal, const char *what)
Definition: ptscotchDecomp.C:80
dict
dictionary dict
Definition: searchingEngine.H:14
Foam::FatalError
error FatalError
Foam::dictionary
A list of keyword definitions, which are a keyword followed by a number of values (eg,...
Definition: dictionary.H:123
Foam::log
dimensionedScalar log(const dimensionedScalar &ds)
Definition: dimensionedScalar.C:262
addToRunTimeSelectionTable.H
Macros for easy insertion into run-time selection tables.
Foam
Namespace for OpenFOAM.
Definition: atmBoundaryLayer.C:33
Foam::exit
errorManipArg< error, int > exit(error &err, const int errNo=1)
Definition: errorManip.H:130
Foam::distributionModels::exponential::meanValue
virtual scalar meanValue() const
Return the theoretical mean of the distribution.
Definition: exponential.C:84
FatalErrorInFunction
#define FatalErrorInFunction
Report an error message using Foam::FatalError.
Definition: error.H:453
Foam::nl
constexpr char nl
Definition: Ostream.H:404
Foam::distributionModels::defineTypeNameAndDebug
defineTypeNameAndDebug(binned, 0)
rndGen
Random rndGen
Definition: createFields.H:23
Foam::distributionModels::exponential
Particle-size distribution model wherein random samples are drawn from the doubly-truncated exponenti...
Definition: exponential.H:189