Skip to content

Adding NEMO physical definition and solvers #109

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 7 commits into from
Jan 5, 2023
Merged

Adding NEMO physical definition and solvers #109

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
269b09d
initial commit
jtneedels Jan 4, 2023
69de67e
adding to phsyDef and solverSetup
jtneedels Jan 4, 2023
11a203b
add discussion of temp_ve initialization for nemo
jtneedels Jan 5, 2023
09a7256
add fluid model description
jtneedels Jan 5, 2023
a2f472c
bold description
jtneedels Jan 5, 2023
bb555b6
fix typo convective schemes
jtneedels Jan 5, 2023
7ebca99
Update _docs_v7/Solver-Setup.md
jtneedels Jan 5, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion _docs_v7/Convective-Schemes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -97,7 +97,7 @@ Some of the schemes above have tunning parameters or accept extra options, the f

### Upwind Schemes ###

`FDS` - Flux Difference Splitting with low speed preconditioning, this scheme does not have tunning parameters.
`FDS` - Flux Difference Splitting with low speed preconditioning, this scheme does not have tuning parameters.

## Turbulence Equations ##

Expand Down
23 changes: 23 additions & 0 deletions _docs_v7/Physical-Definition.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,9 @@ SU2 offers different ways of setting and computing this definition. This documen
- [Mach Number and Velocity](#mach-number-and-velocity)
- [Reynolds Number and Viscosity](#reynolds-number-and-viscosity)
- [Non-Dimensionalization](#non-dimensionalization)
- [Free-Stream Definition (Thermochemical Nonequilibrium)](#free-stream-definition-thermochemical-nonequilibrium)
- [Free-Stream Temperatures](#free-stream-temperatures)
- [Chemical Composition and Mass Fractions](#chemical-composition-and-mass-fractions)
- [Flow Condition (Incompressible)](#flow-condition-incompressible)
- [Thermodynamic and Gauge Pressure](#thermodynamic-and-gauge-pressure)
- [Initial State and Non-Dimensionalization](#initial-state-and-non-dimensionalization)
Expand Down Expand Up @@ -81,6 +84,26 @@ For all schemes, as reference values for the density and temperature the free-st
- `FREESTREAM_VEL_EQ_MACH`: Reference pressure is chosen such that the non-dimensional free-stream velocity equals the Mach number: $$p_{ref} = \gamma p_{\infty}$$.
- `FREESTREAM_VEL_EQ_ONE`: Reference pressure is chosen such that the non-dimensional free-stream velocity equals `1.0`: $$p_{ref} = Ma^2_{\infty} \gamma p_{\infty}$$.

## Free-Stream Definition (Thermochemical Nonequilibrium) ##

| Solver | Version |
| --- | --- |
| `NEMO_EULER`, `NEMO_NAVIER_STOKES` | 7.0.0 |

The physical definition for the thermochemical nonequilibrium (NEMO) solvers is similar to the compressible solvers, but with additional parameters to specify. The free-stream values are not only used as boundary conditions for the `MARKER_FAR` option, but also for initialization and non-dimensionalization. That means even if you don't have any farfield BCs in your problem, it might be important to prescribe physically meaningful values for the options.

### Free-Stream Temperatures ###

Thermodynamic state is specified using the same options as the compressible solver, with the addition of the free-stream electronic temperature. This can be specified using the `FREESTREAM_TEMPERATURE_VE` option in the config file. For a free-stream in equilibrium, this is typically the same value as specified in the `FREESTREAM_TEMPERATURE` option.

### Chemical Composition and Mass Fractions ###

The NEMO solvers require a specification of thermochemical nonequilibrium library using the `FLUID_MODEL` option, either `SU2_NONEQ` if using the SU2 built-in thermochemical library, or `MUTATIONPP` if using the Mutation++ thermochemical library.

A chemistry model, consisting of a set of flow species, thermochemical properties, and chemical reactions, is specified using `GAS_MODEL`. The names of these models are specific to the thermochemical library. If using the `SU2_NONEQ` option the choices are `ARGON`, `N2`, `AIR-5`, and `AIR-7`.

Free-stream mass fractions must also be specified in list using the option `GAS_COMPOSITION`. The mass fractions are specified as decimal values in the order of the species in the gas model. For example, an AIR-5 mixture of 77% oxygen and 23% nitrogen would be expressed as (0.77, 0.23, 0.00, 0.00, 0.00).

## Flow Condition (Incompressible) ##

| Solver | Version |
Expand Down
21 changes: 21 additions & 0 deletions _docs_v7/Solver-Setup.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ This is a basic introduction on how to set up a simulation using SU2. We disting
---

- [Defining the Problem](#defining-the-problem)
- [Specifying a Fluid Model](#specifying-a-fluid-model)
- [Restarting the simulation](#restarting-the-simulation)
- [Controlling the simulation](#controlling-the-simulation)
- [Time-dependent Simulation](#time-dependent-simulation)
Expand All @@ -31,6 +32,8 @@ SU2 is capable of dealing with different kinds of physical problems. The kind of
|`EULER` | **Euler's equation** |Finite-Volume method |
|`NAVIER_STOKES` | **Navier-Stokes' equation** | Finite-Volume method |
|`RANS` | **Reynolds-averaged Navier-Stokes' equation** | Finite-Volume method|
|`NEMO_EULER` | **Thermochemical Nonequilibrium Euler's equation** |Finite-Volume method |
|`NEMO_NAVIER_STOKES` | **Thermochemical Nonequilibrium Navier-Stokes' equation** | Finite-Volume method |
|`INC_EULER` | **Incompressible Euler's equation** | Finite-Volume method |
|`INC_NAVIER_STOKES` | **Incompressible Navier-Stokes' equation** | Finite-Volume method|
|`INC_RANS` | **Incompressible Reynolds-averaged Navier-Stokes' equation** | Finite-Volume method|
Expand All @@ -42,6 +45,24 @@ SU2 is capable of dealing with different kinds of physical problems. The kind of

Every solver has its specific options and we refer to the tutorial cases for more information. However, the basic controls detailed in the remainder of this page are the same for all problems.

## Specifying a Fluid Model ##

For fluid simulations, a model defining the equation of state and thermodynamic properties of the fluid or mixture is required. This is selected using the `FLUID_MODEL` option in the config. Available fluid models in SU2 include:

| Option Value | Description |
|---|---|
|`STANDARD_AIR` | **Air model with ideal gas EOS** |
|`IDEAL_GAS` | **Arbitrary fluid with ideal gas EOS** |
|`VW_GAS` | **Arbitrary fluid with Vander-Waals EOS** |
|`PR_GAS` | **Arbitrary fluid with Peng-Robinson EOS** |
|`CONSTANT_DENSITY` | **Constant density** |
|`INC_IDEAL_GAS` | **Incompressible ideal gas** |
|`INC_IDEAL_GAS_POLY` | **Incompressible ideal gas** |
|`SU2_NONEQ` | **SU2 nonequilibrium thermochemical library** |
|`MUTATIONPP` | **Mutation++ nonequilibrium thermochemical library** |

Some fluid models require the specification of additional parameters, with the full set of required options available in the configuration file template.

## Restarting the simulation ##

| Solver | Version |
Expand Down