TRACE User Guide  TRACE Version 9.6.1
Turbulence Model Settings

This page describes how to select and modify a turbulence model using a control file with the ChangeTurbulenceSettings command.

ActivateUncertaintyQuantificationTM

Activate uncertainty quantification method for turbulence models. The underlying methodology is described in Reynolds stress eigenspace perturbation framework.

Usage
ActivateUncertaintyQuantificationTM --method <method> [--targetState <targetState>] [--deltaB <deltaB>] [--updateProductionK]
Parameters
methodSpecify method to use (choose from PerturbReynoldsStressUniformly and PerturbReynoldsStressMagnitudeLocally)
targetStateTurbulence limiting state for perturbation direction (choose from C1Min, C1Max, C2Min, C2Max C3Min, C3Max)
deltaBRelative perturbation distance (has to be between 0 and 1)
updateProductionKActivate update of turbulent energy production term after perturbation.
Domain
all, blockGroup
Example
all immediate ActivateUncertaintyQuantificationTM --method PerturbReynoldsStressUniformly --targetState C1Max --deltaB 0.5
Since
9.6

ChangeTurbulenceSettings

Change settings of turbulence models.

Usage
ChangeTurbulenceSettings --model/-m <ModelID> [--transitionModel/-tm <ModelID>] [--longOption/-shortOption <argument>]
Parameters
--model/-mMandatory paramater to change/select turbulence model: specified ModelID and set all sub-options to default values as described in Turbulence model IDs
--transitionModel/-tmChange transition model to specified ModelID and set all sub-options to default values as described in Transition model IDs
--longOption/-shortOptionChange options of turbulence models as described in Turbulence model sub-options and transition models as described in Transition model sub-options
Domain
all, blockGroup
Example
all immediate ChangeTurbulenceSettings --model MenterSST2003
Changes turbulence model to Menter SST \(k-\omega\) and resets all model sub-options. Transition model will be also deactivated.
all immediate ChangeTurbulenceSettings --model Wilcox1988 --transitionModel GammaReTheta
Changes turbulence model to \(k-\omega\) model of Wilcox, resets all model sub-options and activates plain \(\gamma-\text{Re}_\theta\) transition model.
all immediate ChangeTurbulenceSettings --model Wilcox1988 --transitionModel GammaReTheta --compressibilityEffects --QUwakeModel
Changes turbulence model to \(k-\omega\) model of Wilcox and activates \(\gamma-\text{Re}_\theta\) transition model. Only the compressibility extension for the turbulence model and the quasi-unsteady wake model for the transition model are activated, whereas all other sub-options of the transport models are switched to default values.
Note
When a model is selected with --model, all modifications are switched to default values and the plain turbulence model is used. A transition model can be activated by --transitionModel.
Warning
Overwrites all settings in GMC turbulence widget. Any changes to turbulence model setup in Control file are not written to output CGNS.
Since
7.3.199

Turbulence model IDs

Changes turbulence model and resets all sub-options. Valid model IDs are

Model Description Added Comments
NoModel Do not model turbulence 7.3.199 -
FrozenMu Use constant eddy viscosity 7.3.199 -
Wilcox1988 \(k-\omega\) model of Wilcox (1988) 7.3.199 -
MenterSST2003 Menter SST \(k-\omega\) model (2003) 7.3.199 Up to 7.7.81 identifier was MenterSST.
AnisotropicSST Siemens ASST Model based on SST 2003 9.3. EARSM intended for use with the film cooling model
HellstenEARSM Hellsten Explicit Algebraic Reynolds Stress Model 7.5.39 Solution method ILU is recommended.
SpalartAllmaras Spalart-Allmaras One-Equation Model (1994) 7.5.111 For validation see DA Magnus Hölle, transition only with Multi-Mode model.
SSGLRRw Eisfeld SSG/LRR- \(\omega\) RSTM 7.7.84 Validated for basic flows, may be modified without notice.
WilcoxStressW Wilcox Stress- \(\omega\) RSTM 8.0.199 Validated for ZPG flat plate, turbulent channel and So-Mellor curved bend.
JHwh Jakirlic/Hanjalic- \(\omega^h\) RSTM 8.2.288 Validated for ZPG flat plate, turbulent channel and So-Mellor curved bend, may be modified without notice.
LESSmagorinsky Smagorinsky model (LES) 8.0.59 Switches solver from RANS to LES, mesh is used as filter.
LESWale Wall adaptive local eddy viscosity (WALE) model (LES) 9.0.152 Switches solver from RANS to LES, mesh is used as filter.
LESImplicit Implicit LES (no subgrid model) 9.0.275 Switches solver from RANS to LES, mesh is used as filter.

Turbulence model sub-options

Valid sub-options are listed in the following table. Default values of arguments are written in bold, whereas flag-type options (e.g --compressibilityEffects) are not selected in default settings.

Long option Short option Arguments Description Added Restrictions
--ambientKW -akw \(k_\text{amb}\), \(\omega_\text{amb}\) Activate Controlled decay version of Menter SST model. Ambient turbulent kinetic energy and dissipation rate must be given. 9.1.404 Only available for Menter SST.
--circumferencialSmoothingBC -csbc - Activate circumferencial smoothing for turbulence boundary conditions. Default OFF recommended, but might help with convergence problems at interfaces or in/outlets. 9.2.071 Only active on turbulent kinetic energy and turbulent dissipation rate.
--compressibilityEffects -ce - Enables the compressibility extension. 7.3.199 Only available for the Wilcox \(k-\omega\) model.
--statisticModel -stm Hybrid, U_RANS Sets model to hybrid RANS/LES mode. If no statistic model is chosen, RANS will always be executed. 9.2.446 -
--hybridMethod -hym DES, DDES, IDDES, SAS Select hybrid model approach. Original DES is set by default. 9.2.446 Only available for statisticMethod = Hybrid. SAS available for Menter SST only. SAS mode since 8.1.232
--vorticityBasedSubgridLengthScale -vbsls Chauvet, Probst, Mockett, Shur Activates vorticity based subgrid length scale computation in DES context. 9.2.373 Only available for statisticMethod = Hybrid.
--diffusionLimitation -dflt - Switch on limitation of cross derivatives in diffusion terms of turbulence equations. 8.0.403 -
--DurbinLimiter -durbin - Activate Durbin's realizability limiter. 8.2.132 Only available for Wilcox 1988 and Menter SST \(k-\omega\) models. Has been available for SST since 7.7.131
--EARSMcurvatureCorrection -EARSMcc - Switch on curvature correction of EARSM. 9.0.182 Only available for the Hellsten EARSM.
--forceSGD -fsgd - Force simple gradient diffusion (SGD) in differential Reynolds stress models. 8.2.82 Only effective for differential Reynolds stress models.
--heatDiffusionModel -hm DalyHarlow, ECTM, Younis, ConstantPrandtl Select heat diffusion model: Daly-Harlow, Eddy Conductivity Transport Model (derived from Nagano 1988 \(k_\theta \omega_\theta\)), Younis or constant turbulent Prandtl number. 8.0.159 Validated for basic flows, may be modified without notice.
--kwLowReynolds -kwlr - Switch on low Reynolds version of Wilcox k-w model. 8.0.203 Only available for Wilcox \(k-\omega\) model.
--logOmega -logW - Switch on \( \log(\omega) \) version of turbulence model. 9.1.322 Only available for k-w and SST.
--mixingLayerModel -mlm - Switch on mixing layer extension for ASST. The film cooling hole sie can be set via SetASSTCoolingHoleSize . 9.3 Only available for ASST
--NoEARSMLimitation -noel - Switch off linear kernel limiter for the EARSM model. 9.0.047 Only available for Hellsten EARSM \(k-\omega\) model. Has been introduced to recuperate the status quo ante up to version 9.0.046.
--reattachmentModification -rm - Activates Menter's Reattachment modification (version 2011) for the SST model. 8.0.180 Only available for the Menter SST \(k-\omega\) model.
--vortexStreetWakeModel -vswm - Activates Vortex Street Wake Model. 9.2.272 Only available for the Wilcox \(k-\omega\) and Menter SST \(k-\omega\) models.
--slipVelocityTransitionModel -svtm - Activates Slip Velocity Model. 9.2.272 Only available for the Wilcox \(k-\omega\) and Menter SST \(k-\omega\) models.
--rotationalEffects -re Bardina, SLC, VRPM, VortexExtension OFF Activate Bardina source term, stream line curvature extension, Vortex Reactive Dissipation Model (VRPM) or Vortex Extension 7.3.199 Only available for the Wilcox \(k-\omega\) model. Bardina available for Menter SST model from 7.7.108.
--SACatrisAupoixDiffusionFormulation -saca - Use compressible formulation of diffusion term for SA model suggested by Catris & Aupoix. 7.5.111 Only available for the Spalart-Allmaras model.
--SSTversion -v 2003, STANDARD, V, BSL Select versions of Menter SST model. STANDARD refers to the original published version (1994), V selects the vorticity based version, BSL selects the Baseline Model. 7.7.84 Only available for the Menter SST \(k-\omega\) model. BSL not available in combination with Durbin Limiter.
--SSTModHellsten -smh - Activates Hellsten Blending for Menter SST model. Not compatible with BSL model. Validated with KatoLaunder. 9.6.0-dev60 Only available for the Menter SST \(k-\omega\) model. Not available in combination with Durbin Limiter.
--stagnationPointAnomalyFix -spaf Schwarz, KatoLaunder, OFF Controls the stagnation point treatment. 7.3.199 KatoLaunder is only available for the Wilcox \(k-\omega\) model, Schwarz limiter is available for all \(k-\omega\)-type models. KatoLaunder available for Menter SST model from 7.7.108.
--positiveTkeProduction -ptp - Switch on limit of TKE production to positive values - Only available for the Wilcox \(k-\omega\) and Menter SST \(k-\omega\) models.
--netProductionWakeOption -npwo - Switch on net production wake option - Only available for the Wilcox \(k-\omega\) and Menter SST \(k-\omega\) models.
--ViscousBlendingLimiter -vb - Switch on Viscous Blending limitation in eddy viscosity - Only available for the Wilcox \(k-\omega\).
--ViscousBlendingLimiterVersion2 -vb2 <VB constant 1> <VB constant 2> Switch on Viscous Blending limitation Version 2 in eddy viscosity. Model constants need to be specified. Use -vb2 1 0 for a default behaviour. - Only available for the Wilcox \(k-\omega\).

Uncertainty quantification for turbulence models

The perturbation approach Reynolds stress eigenspace perturbation framework requires certain input parameters, which are documented in ActivateUncertaintyQuantificationTM. The method is currenty only availabe for Menter SST.

Transition model IDs

Model Description Added Supported turbulence models
Off Do not model transition 7.3.199 -
MultiMode Multimode 7.3.199 Wilcox1988, MenterSST2003, SpalartAllmaras
GammaReTheta Gamma-ReTheta 7.3.199 Wilcox1988, MenterSST2003, SSGLRRw
Gamma \(\gamma\) model 9.0.117 MenterSST2003
LKE_Florence Laminar kinetic energy model 7.3.199 Wilcox1988 with option --kwLowReynolds

Transition model sub-options

Valid sub-options are listed in the following table. Default values of arguments are written in bold, whereas flag-type options (e.g --QUwakeModel) are not selected in default settings.

Long option Short option Arguments Description Added Restrictions
--transitionModelVersion -tmv NoVersion, Menter2004, Menter2004-01, Menter2009 Control modifications to \(\gamma-\text{Re}_\theta\) transition model versions. If sub-option is omitted, Menter2004 is selected for \(\gamma-\text{Re}_\theta\) 7.7.59 Only available for \(\gamma-\text{Re}_\theta\) transition model.
--QUwakeModel -quwm - Select quasi-unsteady wake model for \(\gamma-\text{Re}_\theta\) transition model. 9.3 Only available for \(\gamma-\text{Re}_\theta\) transition model.
--activateReThetaDevModification -rethdev - Activate full non-conservative recalculation of ReTheta boundary condition value at downstream interface panels (MP and ZONAL) 9.3 Only available for \(\gamma-\text{Re}_\theta\) transition model.
--gammaReThetaHighEddyViscosityMod -hev - Helps with transition prediction in high eddy viscosity flows (e.g. compressors) through scaling the effective intermittency gamma_eff with a factor computed from the local eddy viscosity and the limited eddy viscosity according to Menter. 9.4.8 Only available for \(\gamma-\text{Re}_\theta\) transition model.
--gammaReThetaTripwireMod -trip - Tripwire modification to enforce turbulent flow based on a 3D field 'GammaTripwire' generated by gmc 9.4.12+. 9.4.8 Only available for \(\gamma-\text{Re}_\theta\) transition model.
--wavinessModel -wm Start timestep Select waviness model \(\gamma-\text{Re}_\theta\) transition model starting at given time step. - Only available for \(\gamma-\text{Re}_\theta\) transition model.
--VGJModel -vgjm - Select VGJ model for \(\gamma-\text{Re}_\theta\) transition model. - Only available for \(\gamma-\text{Re}_\theta\) transition model.
--roughnessModel -rough - Select roughness model for \(\gamma-\text{Re}_\theta\) transition model. - Only available for \(\gamma-\text{Re}_\theta\) transition model.
--slipVelocityTransitionModel -svtm - Activates Slip Velocity Model. 9.4 Only available for \(\gamma-\text{Re}_\theta\) transition model.
--deactivateGammaSeparation -dgs - Deactivate the computation of gamma separation \(\gamma-\text{Re}_\theta\) transition model - Only available for \(\gamma-\text{Re}_\theta\) transition model.
--crossFlowModelBode -cfBode - Select crossflow Model implemented by Bode - Only available for \(\gamma-\text{Re}_\theta\) transition model.
--crossFlowModelMueller -cfMueller - Select crossflow Model implemented by Mueller - Only available for \(\gamma-\text{Re}_\theta\) transition model.