TRACE User Guide
TRACE Version 9.6.1
|
This page describes how to select and modify a turbulence model using a control file with the ChangeTurbulenceSettings
command.
Activate uncertainty quantification method for turbulence models. The underlying methodology is described in Reynolds stress eigenspace perturbation framework.
method | Specify method to use (choose from PerturbReynoldsStressUniformly and PerturbReynoldsStressMagnitudeLocally ) |
targetState | Turbulence limiting state for perturbation direction (choose from C1Min , C1Max , C2Min , C2Max C3Min , C3Max ) |
deltaB | Relative perturbation distance (has to be between 0 and 1) |
updateProductionK | Activate update of turbulent energy production term after perturbation. |
Change settings of turbulence models.
--model/-m | Mandatory paramater to change/select turbulence model: specified ModelID and set all sub-options to default values as described in Turbulence model IDs |
--transitionModel/-tm | Change transition model to specified ModelID and set all sub-options to default values as described in Transition model IDs |
--longOption/-shortOption | Change options of turbulence models as described in Turbulence model sub-options and transition models as described in Transition model sub-options |
--model
, all modifications are switched to default values and the plain turbulence model is used. A transition model can be activated by --transitionModel
.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. |
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\). |
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.
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 |
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. |