Output Options

Generated from SU2 commit 6b54b78464 on 2026-10-23. Do not edit this page. Edit the comment above the option in Common/src/CConfig.cpp instead.

SCREEN_OUTPUT

Type of screen output

More in config_template.cfg: Screen output fields (use ‘SU2_CFD -d ' to view list of available fields)

• Type: list of strings
• In config_template.cfg: SCREEN_OUTPUT= (INNER_ITER, ITER_TIME, RMS_DENSITY, RMS_MOMENTUM-X, RMS_MOMENTUM-Y, RMS_ENERGY)
• Mentioned in: History and Solution Output, Setup Guide: Incompressible Flows, Setup Guide: Laminar-Turbulent Transition, Setup Guide: Non-Ideal Compressible Flows, Setup Guide: Species Transport and Combustion, Setup Guide: Steady RANS for External Aerodynamics and 10 more
• Used in 254 test case files, for example: aeroelastic_NACA64A010.cfg ((TIME_ITER, INNER_ITER, RMS_DENSITY, RMS_ENERGY, LIFT, DRAG_ON_SURFACE, PLUNGE, PITCH, LINSOL_RESIDUAL)), air_nozzle_restart.cfg ((INNER_ITER, RMS_DENSITY, RMS_ENERGY, RMS_TKE, RMS_DISSIPATION, TOTAL_HEATFLUX, \), air_nozzle_species.cfg ((INNER_ITER, RMS_DENSITY, RMS_ENERGY, RMS_TKE, RMS_DISSIPATION, RMS_SPECIES_0, TOTAL_HEATFLUX, \)
• Code: CConfig.cpp line 3192

HISTORY_OUTPUT

Type of output printed to the history file

More in config_template.cfg: History output groups (use ‘SU2_CFD -d ' to view list of available fields)

• Type: list of strings
• In config_template.cfg: HISTORY_OUTPUT= (ITER, RMS_RES)
• Mentioned in: Aeroacoustic analysis of unsteady pressure, History and Solution Output, Setup Guide: Heat Transfer and Conjugate Heat Transfer, Setup Guide: Incompressible Flows, Setup Guide: Laminar-Turbulent Transition, Setup Guide: Shape Optimization with the Discrete Adjoint and 11 more
• Used in 105 test case files, for example: backwardStep.cfg ((ITER, RMS_PRESSURE, RMS_VELOCITY-X, RMS_VELOCITY-Y, RMS_VELOCITY-Z, RMS_NU_TILDE, RMS_STOCH_VAR-X, RMS_STOCH_VAR-Y, RMS_STOCH_VAR-Z)), config.cfg ((ITER)), inv_NACA0012.cfg ((ITER, RMS_RES, AERO_COEFF, SENSITIVITY))
• Code: CConfig.cpp line 3194

VOLUME_OUTPUT

Type of output printed to the volume solution file

More in config_template.cfg: Volume output fields/groups (use ‘SU2_CFD -d ' to view list of available fields)

• Type: list of strings
• In config_template.cfg: VOLUME_OUTPUT= (COORDINATES, SOLUTION, PRIMITIVE)
• Mentioned in: Changes in Version 8, Guide to Version v7, History and Solution Output, Hybrid RANS/LES (DES), Setup Guide: Laminar-Turbulent Transition, Setup Guide: Species Transport and Combustion and 6 more
• Used in 48 test case files, for example: backwardStep.cfg (( COORDINATES, SOLUTION, PRIMITIVE, LES_SENSOR, VORTEX_IDENTIFICATION, TIME_AVERAGE, BACKSCATTER, DES_LENGTHSCALE)), config.cfg ((COORDINATES)), inv_NACA0012.cfg ((COORDINATES, SOLUTION, PRESSURE, TEMPERATURE, SENSITIVITY))
• Code: CConfig.cpp line 3196

HISTORY_WRT_FREQ_INNER

History writing frequency (INNER_ITER)

More in config_template.cfg: Writing frequency for history output

• Type: integer
• Default: 1
• In config_template.cfg: HISTORY_WRT_FREQ_INNER= 1
• Mentioned in: History and Solution Output, Setup Guide: Unsteady Flows and DES
• Used in 9 test case files, for example: backwardStep.cfg (10), naca0012.cfg (0), NACA64206.cfg (30)
• Code: CConfig.cpp line 3199

HISTORY_WRT_FREQ_OUTER

History writing frequency (OUTER_ITER)

• Type: integer
• Default: 1
• In config_template.cfg: HISTORY_WRT_FREQ_OUTER= 1
• Mentioned in: History and Solution Output
• Used in 4 test case files, for example: turb_SST_flatplate_compressibility_Sarkar.cfg (1)
• Code: CConfig.cpp line 3201

HISTORY_WRT_FREQ_TIME

History writing frequency (TIME_ITER)

• Type: integer
• Default: 1
• In config_template.cfg: HISTORY_WRT_FREQ_TIME= 1
• Mentioned in: History and Solution Output
• Used in 2 test case files, for example: turb_SST_flatplate_compressibility_Sarkar.cfg (1)
• Code: CConfig.cpp line 3203

SCREEN_WRT_FREQ_INNER

Screen writing frequency (INNER_ITER)

More in config_template.cfg: Writing frequency for screen output

• Type: integer
• Default: 1
• In config_template.cfg: SCREEN_WRT_FREQ_INNER= 1
• Mentioned in: Guide to Version v7, History and Solution Output, Setup Guide: Laminar-Turbulent Transition, Setup Guide: Unsteady Flows and DES, Static Fluid-Structure Interaction (FSI)
• Used in 81 test case files, for example: backwardStep.cfg (10), lam_NACA0012.cfg (5), def_intersect.cfg (1)
• Code: CConfig.cpp line 3206

SCREEN_WRT_FREQ_OUTER

Screen writing frequency (OUTER_ITER)

• Type: integer
• Default: 1
• In config_template.cfg: SCREEN_WRT_FREQ_OUTER= 1
• Mentioned in: Guide to Version v7, History and Solution Output
• Used in 16 test case files, for example: chtMaster.cfg (50), def_intersect.cfg (1), DA_configMaster.cfg (100)
• Code: CConfig.cpp line 3208

SCREEN_WRT_FREQ_TIME

Screen writing frequency (TIME_ITER)

• Type: integer
• Default: 1
• In config_template.cfg: SCREEN_WRT_FREQ_TIME= 1
• Mentioned in: Guide to Version v7, History and Solution Output
• Used in 2 test case files, for example: turb_SST_flatplate_compressibility_Sarkar.cfg (1)
• Code: CConfig.cpp line 3210

OUTPUT_WRT_FREQ

list of writing frequencies for each file type (length same as nVolumeOutputFiles)

More in config_template.cfg: list of writing frequencies corresponding to the list in OUTPUT_FILES

• Type: list of integers
• In config_template.cfg: OUTPUT_WRT_FREQ= 10, 250, 42
• Mentioned in: Guide to Version v7, History and Solution Output, Restart File, Setup Guide: Laminar-Turbulent Transition, Setup Guide: Non-Ideal Compressible Flows, Setup Guide: Turbomachinery and 3 more
• Used in 339 test case files, for example: aeroelastic_NACA64A010.cfg (1000), config.cfg (100), inv_NACA0012.cfg (250)
• Code: CConfig.cpp line 3212

OUTPUT_FILES

Volume solution files

More in config_template.cfg: Files to output Possible formats : (TECPLOT_ASCII, TECPLOT, SURFACE_TECPLOT_ASCII, SURFACE_TECPLOT, CSV, SURFACE_CSV, PARAVIEW_ASCII, PARAVIEW_LEGACY, SURFACE_PARAVIEW_ASCII, SURFACE_PARAVIEW_LEGACY, PARAVIEW, SURFACE_PARAVIEW, RESTART_ASCII, RESTART, CGNS, SURFACE_CGNS, STL_ASCII, STL_BINARY) default : (RESTART, PARAVIEW, SURFACE_PARAVIEW)

• Type: list of the values below
• Values: TECPLOT_ASCII, TECPLOT, SURFACE_TECPLOT_ASCII, SURFACE_TECPLOT, CSV, SURFACE_CSV, PARAVIEW_ASCII, PARAVIEW_LEGACY, SURFACE_PARAVIEW_ASCII, SURFACE_PARAVIEW_LEGACY, PARAVIEW, SURFACE_PARAVIEW, PARAVIEW_MULTIBLOCK, MESH, MESH_BINARY, RESTART_ASCII, RESTART, CGNS, SURFACE_CGNS, STL_ASCII, STL_BINARY
• In config_template.cfg: OUTPUT_FILES= (RESTART, PARAVIEW, SURFACE_PARAVIEW)
• Mentioned in: Guide to Version v7, History and Solution Output, Quick Start, Restart File, Setup Guide: Heat Transfer and Conjugate Heat Transfer, Setup Guide: Laminar-Turbulent Transition and 9 more
• Used in 145 test case files, for example: aeroelastic_NACA64A010.cfg ((RESTART_ASCII)), backwardStep.cfg ((RESTART, PARAVIEW, SURFACE_PARAVIEW)), config.cfg ((SURFACE_CGNS))
• Code: CConfig.cpp line 3215

UQ_DELTA_B

Parameter to perturb eigenvalues

More in config_template.cfg: Perturbation magnitude (float [0,1], default= 1.0)

• Type: real number
• Default: 1.0
• In config_template.cfg: UQ_DELTA_B= 1.0
• Mentioned in: Turbulence Models, Epistemic Uncertainty Quantification of RANS predictions of NACA 0012 airfoil
• Used in 5 test case files, for example: turb_NACA0012_uq_1c.cfg (1.0)
• Code: CConfig.cpp line 3218

UQ_COMPONENT

Parameter to determine kind of perturbation

More in config_template.cfg: Eigenvalue perturbation definition (1, 2, or 3)

• Type: integer
• Default: 1
• In config_template.cfg: UQ_COMPONENT= 1
• Mentioned in: Turbulence Models, Epistemic Uncertainty Quantification of RANS predictions of NACA 0012 airfoil
• Used in 5 test case files, for example: turb_NACA0012_uq_1c.cfg (1), turb_NACA0012_uq_2c.cfg (2), turb_NACA0012_uq_3c.cfg (3)
• Code: CConfig.cpp line 3221

UQ_URLX

Parameter to perturb eigenvalues

More in config_template.cfg: Under-relaxation factor (float [0,1], default = 0.1)

• Type: real number
• Default: 0.1
• In config_template.cfg: UQ_URLX= 0.1
• Mentioned in: Turbulence Models, Epistemic Uncertainty Quantification of RANS predictions of NACA 0012 airfoil
• Used in 5 test case files, for example: turb_NACA0012_uq_1c.cfg (0.1)
• Code: CConfig.cpp line 3224

UQ_PERMUTE

Permuting eigenvectors for UQ analysis

More in config_template.cfg: Permuting eigenvectors (YES, NO)

• Type: YES / NO
• Default: NO
• In config_template.cfg: UQ_PERMUTE= NO
• Mentioned in: Turbulence Models, Epistemic Uncertainty Quantification of RANS predictions of NACA 0012 airfoil
• Used in 5 test case files, for example: turb_NACA0012_uq_1c.cfg (NO), turb_NACA0012_uq_p1c1.cfg (YES)
• Code: CConfig.cpp line 3227

PASTIX_FACTORIZATION_FREQUENCY

Number of calls to ‘Build’ that trigger re-factorization (0 means only once).

• Type: integer
• Default: 1
• In config_template.cfg: PASTIX_FACTORIZATION_FREQUENCY= 1
• Used in 1 test case file, for example: config.cfg (1)
• Code: CConfig.cpp line 3230

PASTIX_VERBOSITY_LEVEL

0 - Quiet, 1 - During factorization and cleanup, 2 - Even more detail.

• Type: integer
• Default: 0
• In config_template.cfg: PASTIX_VERBOSITY_LEVEL= 0
• Used in 1 test case file, for example: config.cfg (0)
• Code: CConfig.cpp line 3233

PASTIX_FILL_LEVEL

Level of fill for PaStiX incomplete LU factorization.

• Type: integer
• Default: 1
• In config_template.cfg: PASTIX_FILL_LEVEL= 1
• Used in 1 test case file, for example: config.cfg (1)
• Code: CConfig.cpp line 3236

EDGE_COLORING_GROUP_SIZE

Size of the edge groups colored for thread parallel edge loops (0 forces the reducer strategy).

More in config_template.cfg: An advanced performance parameter for FVM solvers, a large-ish value should be best when relatively few threads per MPI rank are in use (~4). However, maximum parallelism is obtained with EDGE_COLORING_GROUP_SIZE=1, consider using this value only if SU2 warns about low coloring efficiency during preprocessing (performance is usually worse). Setting the option to 0 disables coloring and a different strategy is used instead, that strategy is automatically used when the coloring efficiency is less than 0.875. The optimum value/strategy is case-dependent.

• Type: integer
• Default: 512
• In config_template.cfg: EDGE_COLORING_GROUP_SIZE= 512
• Code: CConfig.cpp line 3239

EDGE_COLORING_RELAX_DISC_ADJ

Allow fallback to smaller edge color group sizes for the discrete adjoint and allow more colors.

More in config_template.cfg: Coloring tends to perform better for the discrete adjoint than reductions because it uses less memory and enables the shared reading optimization for color loops. This option allows an automatic fallback to smaller edge color group sizes on ranks where the requested edge color group size is not efficient. Specifically, the largest edge color group size up to EDGE_COLORING_GROUP_SIZE is chosen that is at least 0.875 efficient. Also, this option allows using more colors, up to 255 instead of up to 64.

• Type: YES / NO
• Default: YES
• In config_template.cfg: EDGE_COLORING_RELAX_DISC_ADJ= YES
• Code: CConfig.cpp line 3242

RCM_NUM_SEEDS

Number of concurrent BFS fronts used to build the RCM reordering (1 is standard single-seed RCM).

More in config_template.cfg: Number of concurrent BFS fronts used to build the RCM point reordering (default 1, standard single-seed RCM). The GPU ILU triangular solves are scheduled by level, and the number of levels scales with the RCM ordering’s BFS depth; increasing this spreads the ordering over several seeds picked by farthest-point sampling, which reduces that depth (and hence the number of level-scheduled kernel launches) at the cost of a somewhat wider matrix bandwidth.

• Type: integer
• Default: 1
• In config_template.cfg: RCM_NUM_SEEDS= 1
• Code: CConfig.cpp line 3245