Skip to content
Snippets Groups Projects
Commit ca4a92c3 authored by Christoph Lehmann's avatar Christoph Lehmann Committed by Dmitri Naumov
Browse files

Extended documentation

parent 8f74b26d
No related branches found
No related tags found
No related merge requests found
A numeric value of one of the implemented data types as given in MaterialPropertyLib::PropertyDataType.
The numerical value of one of the implemented data types, as given in MaterialPropertyLib::PropertyDataType.
Scalars, vectors (2 or 3 components), symmetric 3D tensors (6 components) and
full tensors (4 or 9 components) are supported. Based on the number of
components, OGS will deduce the type of the quantity (scalar/vector/tensor,
1D/2D/3D) automatically.
The elements of `<values>` are in row-major order. I.e., if you write the
following into your project file
```
<value>
1 2
3 4
</value>
```
OGS will read the proper 2x2 matrix.
For the order of symmetric tensor components please refer to [the user guide](https://www.opengeosys.org/docs/userguide/basics/conventions/#symmetric-tensors).
......@@ -88,13 +88,17 @@ This order is used, e.g., to display the per component convergence of the non-li
* [TwoPhaseFlow with PP](https://doxygen.opengeosys.org/d0/d3f/namespaceProcessLib_1_1TwoPhaseFlowWithPP.html#processvariablestpfwpp)
* [TwoPhaseFlow with Prho](https://doxygen.opengeosys.org/d4/de4/namespaceProcessLib_1_1TwoPhaseFlowWithPrho.html#processvariablestpfwprho)
## Kelvin mapping
## <a name="symmetric-tensors"></a> Symmetric tensors and Kelvin mapping
To map the elasticity/stiffness tensor OpenGeoSys internally uses a Kelvin mapping with an adapted component ordering for computational reasons \[[1](https://arxiv.org/abs/1605.09606)\].
For 2D, the Kelvin-Vector of the stress tensor looks like $\sigma=(\sigma_{xx},\sigma_{yy},\sigma_{zz},\sqrt{2}\sigma_{xy})$ whereas the 3D version reads as $\sigma=(\sigma_{xx},\sigma_{yy},\sigma_{zz},\sqrt{2}\sigma_{xy}, \sqrt{2}\sigma_{yz},\sqrt{2}\sigma_{xz})$. The actual output consists of the full (symmetric) tensor elements (without the factor $\sqrt{2}$) retaining the same order.
For 2D, the Kelvin-Vector of the stress tensor looks like $\sigma=(\sigma_{xx},\sigma_{yy},\sigma_{zz},\sqrt{2}\sigma_{xy})$ whereas the 3D version reads as $\sigma=(\sigma_{xx},\sigma_{yy},\sigma_{zz},\sqrt{2}\sigma_{xy}, \sqrt{2}\sigma_{yz},\sqrt{2}\sigma_{xz})$.
For Kelvin mapping also see the [conversion function documentation](https://doxygen.opengeosys.org/d6/dce/namespacemathlib_1_1kelvinvector#ad78b122c10e91732e95181b6c9a92486).
The input and output of symmetric tensors consists of the full (symmetric) tensor elements (without the factor $\sqrt{2}$), retaining the same order.
I.e., Input and output components are be $\sigma=(\sigma_{xx},\sigma_{yy},\sigma_{zz},\sigma_{xy})$
and $\sigma=(\sigma_{xx},\sigma_{yy},\sigma_{zz},\sigma_{xy},\sigma_{yz},\sigma_{xz})$, respectively.
## Staggered Scheme
A staggered scheme solves coupled problems by alternating on separate physical domains (e.g. thermal and mechanical) in contrast to monolithic schemes which solve all domains simultaneously (e.g. thermomechanical).
......@@ -138,4 +142,4 @@ For isotropic, linear elasticity we provide the interval [[2]](#2) and the recom
{{< bib "stonor2019" >}}
<a id="3">[3]</a>
{{< bib "mikwhe2013" >}}
\ No newline at end of file
{{< bib "mikwhe2013" >}}
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment