-
Configuration File
Mesh File
Restart File
Solver Setup
Physical Definition
Markers and Boundary Conditions
Convective Schemes
Slope Limiters and Shock Resolution
History and Solution Output
Linear Solvers and Preconditioners
Basics of Multi-Zone Computations
Execution
Aeroacoustic analysis of unsteady pressure
Flamelet Solver — Python Wrapper Wall Boundary Conditions
Output Fields Reference
Error Messages
-
Setup Guide: Steady RANS for External Aerodynamics
Setup Guide: Incompressible Flows
Setup Guide: Unsteady Flows and DES
Setup Guide: Laminar-Turbulent Transition
Setup Guide: Turbomachinery
Setup Guide: Heat Transfer and Conjugate Heat Transfer
Setup Guide: Species Transport and Combustion
Setup Guide: Shape Optimization with the Discrete Adjoint
Setup Guide: Non-Ideal Compressible Flows
-
Option Reference
Problem Definition
FluidModel
Data-driven fluid model parameters
Freestream Conditions
Reference Conditions
Boundary Markers
Time-marching
Linear solver definition
Convergence
Multi-grid
Spatial Discretization
Adjoint and Gradient
Sobolev Gradient Solver Parameters
Input/output files and formats
Dynamic mesh definition
Aeroelastic Simulation (Typical Section Model)
Wind Gust
Equivalent Area
Grid deformation
Deformable mesh
FEM flow solver definition
FEA solver
Multizone definition
Radiation solver
Heat solver
Visualize Control Volumes
Inverse design problem
Unsupported options
FFD point inversion
Automatic Differentation options
Python Options
Hybrid_RANSLES Options
Output Options
libROM options
Renamed and Removed Options
-
GIT-ting Started
Developing SU2 on GitHub (Internal Developers)
Running Regression Tests
Code Review
Code Structure
Style Guide
Advanced AD Techniques
Containers for Development
Writing Unit Tests
Integrating Tracy Profiler with SU2
Automatic Differentiation (AD)
Code Reference (Doxygen)
Debugging SU2
Documentation Improvements and Status
Glossary
Docs Check
FEA solver
Generated from SU2 commit
6b54b78464on 2026-10-23. Do not edit this page. Edit the comment above the option inCommon/src/CConfig.cppinstead.
FEA_FILENAME
Filename to input for element-based properties
- Type: string
- Default:
string("default_element_properties") - In config_template.cfg:
FEA_FILENAME= default_element_properties.dat - Mentioned in: Non-linear Elasticity with Multiple Materials
- Used in 5 test case files, for example:
configFEA.cfg(element_properties.dat) - Code:
CConfig.cppline 2668
FEA_ADVANCED_MODE
Determine if advanced features are used from the element-based FEA analysis (NO, YES = experimental)
- Type: YES / NO
- Default:
NO - In config_template.cfg:
FEA_ADVANCED_MODE= NO - Used in 1 test case file, for example:
configFEA.cfg(YES) - Code:
CConfig.cppline 2670
ELASTICITY_MODULUS
Modulus of elasticity
- Type: list of real numbers
- In config_template.cfg:
ELASTICITY_MODULUS= 1000.0 - Mentioned in: Linear Elasticity, Non-linear Elasticity, Non-linear Elasticity with Multiple Materials
- Used in 25 test case files, for example:
configAD_fem.cfg(21000),configFEA.cfg(7E9),configFEA.cfg(34150) - Code:
CConfig.cppline 2673
POISSON_RATIO
Poisson ratio
- Type: list of real numbers
- In config_template.cfg:
POISSON_RATIO= 0.35 - Mentioned in: Linear Elasticity, Non-linear Elasticity, Non-linear Elasticity with Multiple Materials
- Used in 25 test case files, for example:
configAD_fem.cfg(0.4),configFEA.cfg(0.35),configFEA.cfg(0.0) - Code:
CConfig.cppline 2675
MATERIAL_DENSITY
Material density
More in config_template.cfg: Density used in solids
- Type: list of real numbers
- In config_template.cfg:
MATERIAL_DENSITY= 2710.0 - Mentioned in: Setup Guide: Heat Transfer and Conjugate Heat Transfer, Linear Dynamics, Static Conjugate Heat Transfer (CHT), Unsteady Conjugate Heat Transfer
- Used in 42 test case files, for example:
solid_cylinder1.cfg(0.000210322),solid.cfg(2719),solid_cylinder1.cfg(0.0210322) - Code:
CConfig.cppline 2677
MATERIAL_THERMAL_EXPANSION_COEFF
Material thermal expansion coefficient
- Type: list of real numbers
- In config_template.cfg:
MATERIAL_THERMAL_EXPANSION_COEFF= 0 - Mentioned in: Changes in Version 8
- Used in 7 test case files, for example:
configBeam_3d.cfg(2e-5),configFEA.cfg(1) - Code:
CConfig.cppline 2679
MATERIAL_REFERENCE_TEMPERATURE
Temperature at which there is no stress from thermal expansion
More in config_template.cfg: Freestream temperature at which there is no stress from thermal expansion
- Type: real number
- Default:
288.15 - In config_template.cfg:
MATERIAL_REFERENCE_TEMPERATURE= 288.15 - Mentioned in: Changes in Version 8
- Used in 7 test case files, for example:
configBeam_3d.cfg(288.15),linear_plane_strain_2d.cfg(300),configFEA.cfg(0.1) - Code:
CConfig.cppline 2681
KNOWLES_B
Knowles B constant
- Type: real number
- Default:
1.0 - In config_template.cfg:
KNOWLES_B= 1.0 - Used in 1 test case file, for example:
config.cfg(1.0) - Code:
CConfig.cppline 2683
KNOWLES_N
Knowles N constant
- Type: real number
- Default:
1.0 - In config_template.cfg:
KNOWLES_N= 1.0 - Used in 1 test case file, for example:
config.cfg(1.0) - Code:
CConfig.cppline 2685
DE_EFFECTS
Include DE effects Options: NO, YES
- Type: YES / NO
- Default:
NO - In config_template.cfg:
DE_EFFECTS= NO - Used in 1 test case file, for example:
configFEA.cfg(YES) - Code:
CConfig.cppline 2689
ELECTRIC_FIELD_CONST
Value of the Dielectric Elastomer constant
- Type: list of real numbers
- In config_template.cfg:
ELECTRIC_FIELD_CONST= 4.25e-11 - Used in 1 test case file, for example:
configFEA.cfg(4.25E-11) - Code:
CConfig.cppline 2691
ELECTRIC_FIELD_MOD
Modulus of the Electric Fields
- Type: list of real numbers
- In config_template.cfg:
ELECTRIC_FIELD_MOD= 20e5 - Used in 1 test case file, for example:
configFEA.cfg(20E5) - Code:
CConfig.cppline 2693
ELECTRIC_FIELD_DIR
Direction of the Electic Fields
- Type: list of real numbers
- In config_template.cfg:
ELECTRIC_FIELD_DIR= (0.0, 1.0) - Used in 1 test case file, for example:
configFEA.cfg((0.0,1.0)) - Code:
CConfig.cppline 2695
DESIGN_VARIABLE_FEA
- Design variable for FEA problems
More in config_template.cfg: Design variable for FEA problems options: NONE, YOUNG_MODULUS, POISSON_RATIO, DENSITY, DEAD_WEIGHT, ELECTRIC_FIELD
- Type: one of the values below
- Values:
NONE,YOUNG_MODULUS,POISSON_RATIO,DENSITY,DEAD_WEIGHT,ELECTRIC_FIELD - Default:
NONE - In config_template.cfg:
DESIGN_VARIABLE_FEA= NONE - Used in 4 test case files, for example:
configFEA.cfg(YOUNG_MODULUS) - Code:
CConfig.cppline 2699
REFERENCE_GEOMETRY
Consider a reference solution for the structure (optimization applications) Options: NO, YES
- Type: YES / NO
- Default:
NO - In config_template.cfg:
REFERENCE_GEOMETRY= NO - Used in 2 test case files, for example:
configAD_fem.cfg(YES) - Code:
CConfig.cppline 2702
REFERENCE_GEOMETRY_PENALTY
Penalty weight value for the objective function
- Type: real number
- Default:
1E6 - In config_template.cfg:
REFERENCE_GEOMETRY_PENALTY= 1.0E6 - Used in 1 test case file, for example:
configAD_fem.cfg(1E6) - Code:
CConfig.cppline 2704
REFERENCE_GEOMETRY_FILENAME
Reference geometry filename
- Type: string
- Default:
string("reference_geometry") - In config_template.cfg:
REFERENCE_GEOMETRY_FILENAME= reference_geometry - Used in 2 test case files, for example:
configAD_fem.cfg(reference_geometry) - Code:
CConfig.cppline 2706
REFERENCE_GEOMETRY_FORMAT
Format of the reference geometry file
- Type: one of the values below
- Values:
SU2,CUSTOM - Default:
SU2 - In config_template.cfg:
REFERENCE_GEOMETRY_FORMAT= SU2_REF - Used in 2 test case files, for example:
configAD_fem.cfg(SU2) - Code:
CConfig.cppline 2708
REFERENCE_GEOMETRY_SURFACE
If true consider only the surfaces where loads are applied.
- Type: YES / NO
- Default:
NO - In config_template.cfg:
REFERENCE_GEOMETRY_SURFACE= NO - Used in 2 test case files, for example:
configAD_fem.cfg(NO) - Code:
CConfig.cppline 2710
REFERENCE_NODE
Reference node for the structure (optimization applications)
- Type: integer
- Default:
0 - In config_template.cfg:
REFERENCE_NODE= 0 - Used in 7 test case files, for example:
configFEA.cfg(234),config.cfg(8452),configFEA.cfg(3) - Code:
CConfig.cppline 2713
REFERENCE_NODE_DISPLACEMENT
Target displacement of the reference node
- Type: list of real numbers
- In config_template.cfg:
REFERENCE_NODE_DISPLACEMENT= (0.0, 0.0) - Used in 7 test case files, for example:
configFEA.cfg((0.0, 0.0)),config.cfg((0.0, 0.0, 0.0)) - Code:
CConfig.cppline 2715
REFERENCE_NODE_PENALTY
Penalty weight value for the objective function
- Type: real number
- Default:
1E3 - In config_template.cfg:
REFERENCE_NODE_PENALTY= 1.0E3 - Used in 7 test case files, for example:
configFEA.cfg(1.0) - Code:
CConfig.cppline 2717
TOTAL_DV_PENALTY
Penalty weight value to maintain the total sum of DV constant
- Type: real number
- Default:
0 - In config_template.cfg:
TOTAL_DV_PENALTY= 0.0 - Code:
CConfig.cppline 2720
STRESS_PENALTY_PARAM
Maximum allowed stress and KS exponent for structural optimization
More in config_template.cfg: Parameters for the corresponding OF (allowed stress and KS multiplier).
- Type: fixed-size list of real numbers
- Default: Not extracted; see the code.
- In config_template.cfg:
STRESS_PENALTY_PARAM= (1.0, 10.0) - Used in 1 test case file, for example:
config.cfg((1.0, 10.0)) - Code:
CConfig.cppline 2723
GEOMETRIC_CONDITIONS
Geometric condition
More in config_template.cfg: Geometric conditions
- Type: one of the values below
- Values:
SMALL_DEFORMATIONS,LARGE_DEFORMATIONS - Default:
SMALL_DEFORMATIONS - In config_template.cfg:
GEOMETRIC_CONDITIONS= SMALL_DEFORMATIONS - Mentioned in: Linear Elasticity, Non-linear Elasticity
- Used in 25 test case files, for example:
configAD_fem.cfg(LARGE_DEFORMATIONS),configBeam_3d.cfg(SMALL_DEFORMATIONS) - Code:
CConfig.cppline 2726
MATERIAL_MODEL
Material model
- Type: one of the values below
- Values:
LINEAR_ELASTIC,NEO_HOOKEAN,KNOWLES,IDEAL_DE - Default:
LINEAR_ELASTIC - In config_template.cfg:
MATERIAL_MODEL= LINEAR_ELASTIC - Mentioned in: Linear Elasticity, Non-linear Elasticity
- Used in 25 test case files, for example:
configAD_fem.cfg(NEO_HOOKEAN),config.cfg(KNOWLES),configBeam_3d.cfg(LINEAR_ELASTIC) - Code:
CConfig.cppline 2728
MATERIAL_COMPRESSIBILITY
Compressibility of the material
- Type: one of the values below
- Values:
COMPRESSIBLE,NEARLY_INCOMPRESSIBLE - Default:
COMPRESSIBLE - In config_template.cfg:
MATERIAL_COMPRESSIBILITY= COMPRESSIBLE - Used in 5 test case files, for example:
configAD_fem.cfg(COMPRESSIBLE),config.cfg(NEARLY_INCOMPRESSIBLE) - Code:
CConfig.cppline 2730
PRESTRETCH
Consider a prestretch in the structural domain Options: NO, YES
- Type: YES / NO
- Default:
NO - In config_template.cfg:
PRESTRETCH= NO - Used in 1 test case file, for example:
configFEA.cfg(YES) - Code:
CConfig.cppline 2734
PRESTRETCH_FILENAME
Filename to input for prestretching membranes
- Type: string
- Default:
string("prestretch_file") - In config_template.cfg:
PRESTRETCH_FILENAME= prestretch_file - Used in 1 test case file, for example:
configFEA.cfg(prestretch) - Code:
CConfig.cppline 2736
NONLINEAR_FEM_SOLUTION_METHOD
Iterative method for non-linear structural analysis
- Type: one of the values below
- Values:
NEWTON_RAPHSON,MODIFIED_NEWTON_RAPHSON - Default:
NEWTON_RAPHSON - In config_template.cfg:
NONLINEAR_FEM_SOLUTION_METHOD= NEWTON_RAPHSON - Mentioned in: Non-linear Elasticity
- Used in 3 test case files, for example:
configAD_fem.cfg(NEWTON_RAPHSON) - Code:
CConfig.cppline 2739
FORMULATION_ELASTICITY_2D
Formulation for bidimensional elasticity solver
More in config_template.cfg: Formulation for 2-dimensional elasticity solver
- Type: one of the values below
- Values:
PLANE_STRESS,PLANE_STRAIN - Default:
PLANE_STRAIN - In config_template.cfg:
FORMULATION_ELASTICITY_2D= PLANE_STRAIN - Mentioned in: Linear Elasticity, Non-linear Elasticity
- Used in 19 test case files, for example:
configAD_fem.cfg(PLANE_STRAIN),configFEA.cfg(PLANE_STRESS) - Code:
CConfig.cppline 2741
CENTRIFUGAL_FORCE
Apply centrifugal forces Options: NO, YES
More in config_template.cfg: Centrifugal forces due to ROTATION_RATE around MOTION_ORIGIN. GRAVITY_FORCE and BODY_FORCE can also be used with the FEA solver.
- Type: YES / NO
- Default:
NO - In config_template.cfg:
CENTRIFUGAL_FORCE= NO - Mentioned in: Changes in Version 8
- Used in 1 test case file, for example:
config.cfg(YES) - Code:
CConfig.cppline 2744
PSEUDO_STATIC
Temporary: pseudo static analysis (no density in dynamic analysis) Options: NO, YES
- Type: YES / NO
- Default:
NO - In config_template.cfg:
PSEUDO_STATIC= NO - Code:
CConfig.cppline 2747
NEWMARK_BETA
Parameter alpha for Newmark scheme (s)
- Type: real number
- Default:
0.25 - In config_template.cfg:
NEWMARK_BETA= 0.25 - Mentioned in: Linear Dynamics
- Used in 6 test case files, for example:
configFEA.cfg(0.2601),configFEA.cfg(0.36),configFEA.cfg(0.25) - Code:
CConfig.cppline 2749
NEWMARK_GAMMA
Parameter gamma for Newmark scheme (s)
- Type: real number
- Default:
0.5 - In config_template.cfg:
NEWMARK_GAMMA= 0.50 - Mentioned in: Linear Dynamics
- Used in 6 test case files, for example:
configFEA.cfg(0.52),configFEA.cfg(0.7),configFEA.cfg(0.5) - Code:
CConfig.cppline 2751
RAMP_LOADING
Apply the load as a ramp
- Type: YES / NO
- Default:
NO - In config_template.cfg:
RAMP_LOADING= NO - Used in 2 test case files, for example:
config.cfg(YES),config_restart.cfg(NO) - Code:
CConfig.cppline 2753
RAMP_TIME
Time while the load is to be increased linearly
- Type: real number
- Default:
1.0 - In config_template.cfg:
RAMP_TIME= 1.0 - Code:
CConfig.cppline 2755
DYNAMIC_LOAD_TRANSFER
Transfer method used for multiphysics problems
- Type: one of the values below
- Values:
INSTANTANEOUS,RAMP,CUBIC,QUINTIC,SIGMOID_10,SIGMOID_20 - Default:
RAMP - In config_template.cfg:
DYNAMIC_LOAD_TRANSFER= RAMP - Code:
CConfig.cppline 2757
TIME_INT_STRUCT_COEFFS
Newmark - Generalized alpha - coefficients
- Type: list of real numbers
- In config_template.cfg:
TIME_INT_STRUCT_COEFFS= 0.0 - Code:
CConfig.cppline 2760
INCREMENTAL_LOAD
Apply dead loads. Options: NO, YES
- Type: YES / NO
- Default:
NO - In config_template.cfg:
INCREMENTAL_LOAD= NO - Mentioned in: Non-linear Elasticity
- Used in 2 test case files, for example:
configFEA.cfg(YES),configFEA.cfg(NO) - Code:
CConfig.cppline 2763
NUMBER_INCREMENTS
Maximum number of increments of the
- Type: integer
- Default:
10 - In config_template.cfg:
NUMBER_INCREMENTS= 10 - Mentioned in: Non-linear Elasticity
- Code:
CConfig.cppline 2765
INCREMENTAL_CRITERIA
Definition of the UTOL RTOL ETOL
- Type: fixed-size list of real numbers
- Default: Not extracted; see the code.
- In config_template.cfg:
INCREMENTAL_CRITERIA= (0.0, 0.0, 0.0) - Mentioned in: Non-linear Elasticity
- Code:
CConfig.cppline 2769
PREDICTOR
Use of predictor
- Type: YES / NO
- Default:
NO - In config_template.cfg:
PREDICTOR= NO - Used in 3 test case files, for example:
configFEA.cfg(YES) - Code:
CConfig.cppline 2772
PREDICTOR_ORDER
Order of the predictor
- Type: integer
- Default:
0 - In config_template.cfg:
PREDICTOR_ORDER= 0 - Used in 2 test case files, for example:
configFEA.cfg(0) - Code:
CConfig.cppline 2774
TOPOLOGY_OPTIMIZATION
Topology optimization options
More in config_template.cfg: “Classic” density approach to topology optimization. Each element is assigned a density variable that is used to penalize its stiffness.
- Type: YES / NO
- Default:
NO - In config_template.cfg:
TOPOLOGY_OPTIMIZATION= NO - Used in 4 test case files, for example:
config.cfg(YES) - Code:
CConfig.cppline 2777
TOPOL_OPTIM_OUTFILE
Output file for the derivatives of the OBJECTIVE_FUNCTION w.r.t. the design densities. (from config_template.cfg)
- Type: string
- Default:
string("element_derivatives.dat") - In config_template.cfg:
TOPOL_OPTIM_OUTFILE= element_derivatives.dat - Used in 4 test case files, for example:
config.cfg(grad_ref_node.dat),settings_compliance.cfg(grad_compliance.dat),settings_volfrac.cfg(grad_vol_frac.dat) - Code:
CConfig.cppline 2778
TOPOL_OPTIM_SIMP_EXPONENT
The penalization exponent for the Simplified Isotropic Material with Penalization. (from config_template.cfg)
- Type: real number
- Default:
1.0 - In config_template.cfg:
TOPOL_OPTIM_SIMP_EXPONENT= 1.0 - Used in 4 test case files, for example:
config.cfg(3.0) - Code:
CConfig.cppline 2779
TOPOL_OPTIM_SIMP_MINSTIFF
The stiffness of void elements (normalized by ELASTICITY_MODULUS) (from config_template.cfg)
- Type: real number
- Default:
0.001 - In config_template.cfg:
TOPOL_OPTIM_SIMP_MINSTIFF= 0.001 - Used in 1 test case file, for example:
config.cfg(0.001) - Code:
CConfig.cppline 2780
TOPOL_OPTIM_FILTER_KERNEL
Filtering is required to avoid numerical issues, see [Sigmund, 2007] (DOI 10.1007/s00158-006-0087-x). Currently available options: CONSTANT; CONICAL (default); GAUSSIAN; DILATE; ERODE. The filter can have multiple sequential stages (2 in this case). (from config_template.cfg)
- Type: list of the values below
- Values:
CONSTANT,CONICAL,GAUSSIAN,DILATE,ERODE - In config_template.cfg:
TOPOL_OPTIM_FILTER_KERNEL= (DILATE, ERODE) - Used in 4 test case files, for example:
config.cfg(( DILATE,ERODE )) - Code:
CConfig.cppline 2781
TOPOL_OPTIM_FILTER_RADIUS
Each kernel can have its own radius (R1, R2, …) or one value can be specified for all. (from config_template.cfg)
- Type: list of real numbers
- In config_template.cfg:
TOPOL_OPTIM_FILTER_RADIUS= 0.0 - Used in 4 test case files, for example:
config.cfg(0.01),settings.cfg(0.013) - Code:
CConfig.cppline 2782
TOPOL_OPTIM_KERNEL_PARAM
The Gaussian, Erode, and Dilate filters, have a constant parameter. Again this can be a list. (from config_template.cfg)
- Type: list of real numbers
- In config_template.cfg:
TOPOL_OPTIM_KERNEL_PARAM= 0.01 - Used in 4 test case files, for example:
config.cfg(200),settings.cfg(0.01) - Code:
CConfig.cppline 2783
TOPOL_OPTIM_SEARCH_LIMIT
The filtering may become very expensive if the mesh has very refined regions. If different from 0 this option mitigates that by limiting the “logical radius” (for immediate neighbors that radius is 1, etc.). (from config_template.cfg)
- Type: integer
- Default:
0 - In config_template.cfg:
TOPOL_OPTIM_SEARCH_LIMIT= 0 - Used in 1 test case file, for example:
config.cfg(0) - Code:
CConfig.cppline 2784
TOPOL_OPTIM_PROJECTION_TYPE
After the filtering, a projection step can be applied to increase the solid-void contrast, i.e. the discreteness of the solution. Options: NO_PROJECTION (default); HEAVISIDE_UP; HEAVISIDE_DOWN. (from config_template.cfg)
- Type: one of the values below
- Values:
NO_PROJECTION,HEAVISIDE_UP,HEAVISIDE_DOWN - Default:
NO_PROJECTION - In config_template.cfg:
TOPOL_OPTIM_PROJECTION_TYPE= NO_PROJECTION - Used in 4 test case files, for example:
config.cfg(NO_PROJECTION) - Code:
CConfig.cppline 2785
TOPOL_OPTIM_PROJECTION_PARAM
The continuous Heaviside function (step) approximations require a parameter, large value equals more discrete. (from config_template.cfg)
- Type: real number
- Default:
0.0 - In config_template.cfg:
TOPOL_OPTIM_PROJECTION_PARAM= 0.0 - Used in 4 test case files, for example:
config.cfg(0),settings.cfg(0.0) - Code:
CConfig.cppline 2786
FEA_ID_DIRECTDIFF
ID of the region we want to compute the sensitivities using direct differentiation
- Type: integer
- Default:
0 - In config_template.cfg:
FEA_ID_DIRECTDIFF= 0 - Code:
CConfig.cppline 2792
RESTART_STEADY_STATE
Restart from a steady state (sets grid velocities to 0 when loading the restart).
- Type: YES / NO
- Default:
NO - In config_template.cfg:
RESTART_STEADY_STATE= NO - Used in 1 test case file, for example:
config.cfg(NO) - Code:
CConfig.cppline 2795