RosinRammler.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) 2011-2024 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 "RosinRammler.H"
28 
29 // * * * * * * * * * * * * * * Static Data Members * * * * * * * * * * * * * //
30 
31 namespace Foam
32 {
33 namespace distributions
34 {
37 }
38 }
39 
40 
41 // * * * * * * * * * * * * Protected Member Functions * * * * * * * * * * * //
42 
44 (
45  const label q,
46  const scalarField& x
47 ) const
48 {
49  const scalarField xByDPowNm1(pow(x/d_, n_ - 1));
50 
51  return integerPow(x, q)*(n_/d_)*xByDPowNm1*exp(- xByDPowNm1*x/d_);
52 }
53 
54 
56 (
57  const label q,
58  const scalarField& x
59 ) const
60 {
61  if (q == 0)
62  {
63  return - exp(- pow(x/d_, n_));
64  }
65  else
66  {
68  }
69 }
70 
71 
72 // * * * * * * * * * * * * * * * * Constructors * * * * * * * * * * * * * * //
73 
75 (
76  const unitConversion& units,
77  const dictionary& dict,
78  const label sampleQ,
80 )
81 :
83  (
84  typeName,
85  units,
86  dict,
87  sampleQ,
88  std::move(rndGen)
89  ),
90  min_(dict.lookupBackwardsCompatible<scalar>({"min", "minValue"}, units)),
91  max_(dict.lookupBackwardsCompatible<scalar>({"max", "maxValue"}, units)),
92  d_(dict.lookup<scalar>("d", units)),
93  n_(dict.lookup<scalar>("n", unitless))
94 {
95  validateBounds(dict);
96  validatePositive(dict);
97  mean();
98 }
99 
100 
102 (
103  const RosinRammler& d,
104  const label sampleQ
105 )
106 :
108  min_(d.min_),
109  max_(d.max_),
110  d_(d.d_),
111  n_(d.n_)
112 {}
113 
114 
115 // * * * * * * * * * * * * * * * * Destructor * * * * * * * * * * * * * * * //
116 
118 {}
119 
120 
121 // * * * * * * * * * * * * * * * Member Functions * * * * * * * * * * * * * //
122 
124 {
125  if (q() == 0)
126  {
127  const scalar s = rndGen_.sample01<scalar>();
128  const Pair<scalar>& Phi01 = this->Phi01();
129  const scalar PhiS = (1 - s)*Phi01[0] + s*Phi01[1];
130  return d_*pow(- log(- PhiS), 1/n_);
131  }
132  else
133  {
135  }
136 }
137 
138 
140 {
141  return min_;
142 }
143 
144 
146 {
147  return max_;
148 }
149 
150 
152 (
153  Ostream& os,
154  const unitConversion& units
155 ) const
156 {
158 
159  writeEntry(os, "min", units, min_);
160  writeEntry(os, "max", units, max_);
161  writeEntry(os, "d", units, d_);
162  writeEntry(os, "n", unitless, n_);
163 }
164 
165 
168 {
170  tx.ref()[0] = Foam::max(tx.ref()[0], q() < 0 ? min_/2 : rootVSmall);
171  return tx;
172 }
173 
174 
175 // ************************************************************************* //
label n
Macros for easy insertion into run-time selection tables.
An Ostream is an abstract base class for all output systems (streams, files, token lists,...
Definition: Ostream.H:57
A list of keyword definitions, which are a keyword followed by any number of values (e....
Definition: dictionary.H:162
Base class for statistical distributions.
Definition: distribution.H:76
virtual tmp< scalarField > x(const label n) const
Return coordinates to plot across the range of the distribution.
Definition: distribution.C:147
Rosin-Rammler distribution, scaled so that it spans between a specified minimum and maximum value,...
Definition: RosinRammler.H:77
virtual tmp< scalarField > Phi(const label q, const scalarField &x) const
Return values of the un-normalised CDF for the given size exponent.
Definition: RosinRammler.C:56
virtual scalar min() const
Return the minimum value.
Definition: RosinRammler.C:139
virtual scalar sample() const
Sample the distribution.
Definition: RosinRammler.C:123
virtual tmp< scalarField > x(const label n) const
Return coordinates to plot across the range of the distribution.
Definition: RosinRammler.C:167
RosinRammler(const unitConversion &units, const dictionary &dict, const label sampleQ, randomGenerator &&rndGen)
Construct from a dictionary.
Definition: RosinRammler.C:75
virtual ~RosinRammler()
Destructor.
Definition: RosinRammler.C:117
virtual void write(Ostream &os, const unitConversion &units) const
Write to a stream.
Definition: RosinRammler.C:152
virtual scalar max() const
Return the maximum value.
Definition: RosinRammler.C:145
virtual tmp< scalarField > phi(const label q, const scalarField &x) const
Return values of the un-normalised PDF for the given size exponent.
Definition: RosinRammler.C:44
virtual tmp< scalarField > Phi(const label q, const scalarField &x) const
Return values of the un-normalised CDF for the given size exponent.
Definition: unintegrable.C:254
scalar sample() const
Sample the distribution.
Definition: unintegrable.C:351
Random number generator.
A class for managing temporary objects.
Definition: tmp.H:55
T & ref() const
Return non-const reference or generate a fatal error.
Definition: tmpI.H:181
Unit conversion structure. Contains the associated dimensions and the multiplier with which to conver...
gmvFile<< "tracers "<< particles.size()<< nl;forAllConstIter(Cloud< passiveParticle >, particles, iter){ gmvFile<< iter().position().x()<< " ";}gmvFile<< nl;forAllConstIter(Cloud< passiveParticle >, particles, iter){ gmvFile<< iter().position().y()<< " ";}gmvFile<< nl;forAllConstIter(Cloud< passiveParticle >, particles, iter){ gmvFile<< iter().position().z()<< " ";}gmvFile<< nl;forAll(lagrangianScalarNames, i){ word name=lagrangianScalarNames[i];IOField< scalar > s(IOobject(name, runTime.name(), cloud::prefix, mesh, IOobject::MUST_READ, IOobject::NO_WRITE))
defineTypeNameAndDebug(exponential, 0)
addToRunTimeSelectionTable(distribution, exponential, dictionary)
void write(std::ostream &os, const bool binary, List< floatScalar > &fField)
Write floats ascii or binary.
Namespace for OpenFOAM.
dimensionedScalar exp(const dimensionedScalar &ds)
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
scalar integerPow(const scalar x, const label e)
Compute the power of the number x to the integer e.
Definition: scalarI.H:30
dimensionedScalar log(const dimensionedScalar &ds)
const HashTable< unitConversion > & units()
Get the table of unit conversions.
dimensionedScalar pow(const dimensionedScalar &ds, const dimensionedScalar &expt)
void writeEntry(Ostream &os, const HashTable< T, Key, Hash > &ht)
Definition: HashTableIO.C:96
layerAndWeight max(const layerAndWeight &a, const layerAndWeight &b)
const unitConversion unitless
dictionary dict
randomGenerator rndGen(653213)