ENH: turbulentDFSEMInlet: various improvements

Summary

• ENH: Input entries of R, L and U are now PatchFunction1 type.
• ENH: Adds two scalar normalisation factors for input R, L and U: Uref and Lref (default=1).
• ENH: Adds a scalar factor to enable users to tune the C1 normalisation coefficient: scale (default=1).
• BUG: MappedFile: separates scopes of entries.
• TUT: Replaces chan395DFSEM and PCF tutorials with planeChannel and oneCellThickPlaneChannel tutorials.
  • Corrects the integral-length scale input files.
  • Updates the Extended Code Guide's channel flow case, and allows users to reproduce the results.

Resolved bugs (If applicable)

#2098 (closed) #2097 (closed) #2090 #1004 #1744 #2089 (closed)

Details of new models (If applicable)

A set of results obtained from the planeChannel tutorial (and its plot script available to users) with a different set of settings can be seen below:

Ruv vs y

u vs y

Ruu vs y

x vs Cf

Rvv vs y

Rww vs y

Risks

User input

Users (my apologies) will have to change the input syntax for R, L and U entries. For example, for reading the input files in constant/boundaryData/inlet/0/, users were using the following minimal syntax:

inlet
{
    type            turbulentDFSEMInlet;
    delta           1;
    mapMethod       nearestCell;
    value           $internalField;
}

For the same effect, one of the syntax examples could be as follows:

inlet
{
    type            turbulentDFSEMInlet;
    delta           1;

    U               mappedFile;
    R               mappedFile;
    L               mappedFile;
    mapMethod       nearest;

    value           $internalField;
}

or as follows:

inlet
{
    type            turbulentDFSEMInlet;
    delta           1;
        
    U
    {
        type        mappedFile;
        mapMethod   nearest;
    }
    R
    {
        type        mappedFile;
        mapMethod   nearest;
    }
    L
    {
        type        mappedFile;
        mapMethod   nearest;
    }

    value           $internalField;
}

Users can, however, use any of the PatchFunction1 input syntax exemplified in this link and this link.

Regressions

• The default value of nCellPerEddy entry was changed from 5 to 1, which is the default value corresponding to the original journal paper.
• The default value of nCellPerEddy entry was kept the same as 5.

Remaining issues

• Arguably, the DFSEM method has various theoretical issues that need to be addressed (see #2090). We have been trying to reach the originators of the method during the last couple of years; and we will continue our efforts, if possible, to cooperate with them to resolve some of these issues.