View Issue Details

IDProjectCategoryView StatusLast Update
0001930OpenFOAM[All Projects] Bugpublic2015-11-29 21:29
ReporterwyldckatAssigned Tohenry 
Status resolvedResolutionfixed 
Product Versiondev 
Fixed in Version 
Summary0001930: Default parameters in nutWallFunction are undocumented, update attached
DescriptionThis week at work, my colleague Pedro Freitas and I did some investigating into the values for "kappa" and "E" that is used by default in "nutWallFunctionFvPatchScalarField.C", because we were using another pair of values of "kappa=0.41" and "E=8.432" for smooth wall analytical expressions, which many people defend are better values based on experimental data.

After some archaeological investigation into the OpenFOAM-history repository, I found that the latest values were introduced in this commit: - which has the commit comment: «selecting common kappa=0.41 and E=9.8 (ref. Verst+Malal)»

Attached is the file "nutWallFunctionFvPatchScalarField.H" for OpenFOAM-dev (might be also usable in 3.0.x?) that has the updated description that includes this information:

    \heading Patch usage

        Property | Description | Required | Default value
        Cmu | Cmu coefficient | no | 0.09
        kappa | Von Karman constant | no | 0.41
        E | E coefficient | no | 9.8

    Examples of the boundary condition specification:
        type nutWallFunction;
        value uniform 0.0;

    Reference for the default model coefficients:
        H. Versteeg, W. Malalasekera
        An Introduction to Computational Fluid Dynamics: The Finite Volume
        Method, subsection "3.5.2 k-epsilon model"
Additional InformationFor complementing information on this topic, regarding what values should be used for kappa and E, lead us to the paper "Estimating the value of von Kármán’s constant in turbulent pipe flow", by S. C. C. Bailey, M. Vallikivi, M. Hultmark and A. J. Smits - doi:10.1017/jfm.2014.208 -

There we can find out right on the introduction the large variety of kappa and E pairs that can be used in several situations. In addition, in Figure 5 is shown how much these values can vary depending on a series of flow scenarios, therefore... the pseudo-magical numbers used by OpenFOAM in "nutWallFunction" are the ones from the aforementioned book and that settles the issue :)
TagsNo tags attached.



2015-11-29 20:19


nutWallFunctionFvPatchScalarField.H (5,437 bytes)


2015-11-29 20:22

updater   ~0005686

Ooops... I lost a "\endverbatim" when adding the book reference :(


2015-11-29 20:22


nutWallFunctionFvPatchScalarField_v2.H (5,454 bytes)


2015-11-29 20:23

updater   ~0005687

Attached the rectified file "nutWallFunctionFvPatchScalarField_v2.H", for replacing "src/TurbulenceModels/turbulenceModels/derivedFvPatchFields/wallFunctions/nutWallFunctions/nutWallFunction/nutWallFunctionFvPatchScalarField.H"


2015-11-29 21:29

manager   ~0005689

Resolved in OpenFOAM-dev by commit 69f0a5e316ee9f222be974f4c459d09e77487c5a
Resolved in OpenFOAM-3.0.x by commit 82270c6e4cbce65a3cb04d6043a367bd71811813

Issue History

Date Modified Username Field Change
2015-11-29 20:19 wyldckat New Issue
2015-11-29 20:19 wyldckat Status new => assigned
2015-11-29 20:19 wyldckat Assigned To => henry
2015-11-29 20:19 wyldckat File Added: nutWallFunctionFvPatchScalarField.H
2015-11-29 20:22 wyldckat Note Added: 0005686
2015-11-29 20:22 wyldckat File Added: nutWallFunctionFvPatchScalarField_v2.H
2015-11-29 20:23 wyldckat Note Added: 0005687
2015-11-29 21:29 henry Note Added: 0005689
2015-11-29 21:29 henry Status assigned => resolved
2015-11-29 21:29 henry Resolution open => fixed