Debian Codegraph @

src/num/aslFDPoroElasticity.h

raw
1 /*
2 * Advanced Simulation Library <http://asl.org.il>
3 *
4 * Copyright 2015 Avtech Scientific <http://avtechscientific.com>
5 *
6 *
7 * This file is part of Advanced Simulation Library (ASL).
8 *
9 * ASL is free software: you can redistribute it and/or modify it
10 * under the terms of the GNU Affero General Public License as
11 * published by the Free Software Foundation, version 3 of the License.
12 *
13 * ASL is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU Affero General Public License for more details.
17 *
18 * You should have received a copy of the GNU Affero General Public License
19 * along with ASL. If not, see <http://www.gnu.org/licenses/>.
20 *
21 */
22
23
24 #ifndef ASLFDPOROELASTICITY_H
25 #define ASLFDPOROELASTICITY_H
26
27 #include "aslNumMethod.h"
28 #include "acl/aclMath/aclVectorOfElementsDef.h"
29 #include "aslFDElasticity.h"
30 #include "utilities/aslUValue.h"
31
32 namespace asl
33 {
34
35 /// Numerical method which computes homogenious isotropic poro-elasticity equation
36 /**
37 \ingroup Elasticity
38 \ingroup NumMethods
39
40 The classic poroelastic equations were originally developed by Biot (1941)
41 to represent biphasic soil consolidation. The equations can be written
42 in the following form:
43 \f[ (K+\mu/3)\nabla_j \nabla_k u_k+ \mu \Delta u_j - a \nabla_j p = - (\rho_s-\rho_f)g_j \f]
44 \f[ a\nabla_i\dot u_i+ \frac{1}{S} \dot p = \nabla_i k \nabla_i p, \f]
45 where
46 - \f$\vec u\f$ is the displacement vector,
47 - \f$ p \f$ the interstitial pressure,
48 - \f$ a \f$ the ratio of fluid volume extracted to volume change of the tissue under compression,
49 - \f$\rho_s\f$ the solid fraction density,
50 - \f$\rho_f\f$ the fluid density,
51 - \f$\vec g \f$ the gravitational vector,
52 - \f$ 1/S \f$ the amount of fluid which can be forced into the tissue under constant volume,
53 - \f$ k \f$ the hydraulic conductivity,
54 - \f$K\f$ is the bulk modulus,
55 - \f$\mu\f$ is the shear modulus,.
56
57 In order to solve the first equation we will introduce a fictisionus time \f$ \tau \f$:
58 \f[ \partial_\tau u = (K+\mu/3)\nabla_j \nabla_k u_k+ \mu \Delta u_j - a \nabla_j p + (\rho_s-\rho_f)g_j \f]
59 \f[ a\partial_t\nabla_i u_i+ \frac{1}{S} \partial_t p = \nabla_i k \nabla_i p, \f]
60
61
62 This implementation is aided to improove stability for incompressible materials.
63 Let us reformulate the first eqation by the following way:
64 \f[ \partial_\tau u = \mu \Delta u_j - \nabla_j \tilde p - a\nabla_j p + (\rho_s-\rho_f)g_j, \f]
65 \f[ \tilde p = -(K+\mu/3) \nabla_k u_k. \f]
66 then the second eqation will turn to:
67 \f[ \partial_t p = \frac{aS}{K+\mu/3}\partial_t\tilde p + S\nabla_i k \nabla_i p, \f]
68
69 The equation for \f$\tilde p\f$ leads to an instability for low values of the Poisson ration (for nearly incompressible materials).
70 Therefore the last equation we would like to replace by a relaxation one:
71 \f[ \partial_\tau \tilde p = - w\left( (K+\mu/3)\nabla_k u_k + \tilde p\right), \f]
72 where \f$ w \f$ is a relaxation parameter.
73
74 Let's return to single time variable. Two time steps are related as follows
75 \f$ \delta_t = N \delta_\tau \f$. Than \f$ \partial_\tau = N\partial_t \f$.
76 The resulting set of equations is:
77 \f[ \partial_\tau u = \mu \Delta u_j - \nabla_j \tilde p - a\nabla_j p + (\rho_s-\rho_f)g_j, \f]
78 \f[ \partial_\tau \tilde p = - w\left( (K+\mu/3)\nabla_k u_k + \tilde p\right), \f]
79 \f[ \partial_\tau p = \frac{aS}{K+\mu/3}\partial_\tau\tilde p + \frac{Sk}{N}\Delta p, \f]
80
81 */
82 class FDPoroElasticity: public ElasticityCommonA
83 {
84 private:
85 Data pressureData;
86 Data pressureInternalData;
87 Data pressureLiquidData;
88 Data pressureLiquidInternalData;
89
90 Param hydraulicCondactivity;
91 Param compresibility;
92 Param nSubsteps;
93
94 public:
95 FDPoroElasticity();
96 /**
97 \param d is a displacement field
98 \param pl is a pressure of liquid field
99 \param bM is the bulk modulus
100 \param sM is the shear modulus
101 \param k is hydraulic conductivity
102 \param vT is a vector template
103 */
104 FDPoroElasticity(Data d, Data pl, Param bM,
105 Param sM, Param k,
106 const VectorTemplate* vT);
107 ~FDPoroElasticity();
108
109 virtual void init();
110 virtual void execute();
111
112 inline Data getPressureData() const;
113 inline Data getLiquidPressureData() const;
114
115 /// defaul value 10
116 void setNSubsteps(unsigned int n);
117 };
118
119 typedef std::shared_ptr<FDPoroElasticity> SPFDPoroElasticity;
120
121 /**
122 \param d is a displacement field
123 \param pl is a pressure of liquid field
124 \param bM is the bulk modulus
125 \param sM is the shear modulus
126 \param k is hydraulic conductivity
127 \param vT is a vector template
128 */
129 SPFDPoroElasticity generateFDPoroElasticity(SPDataWithGhostNodesACLData d,
130 SPDataWithGhostNodesACLData pl,
131 double bM,
132 double sM,
133 double k,
134 const VectorTemplate* vT);
135
136 /**
137 \param d is a displacement field
138 \param pl is a pressure of liquid field
139 \param bM is the bulk modulus
140 \param sM is the shear modulus
141 \param k is hydraulic conductivity
142 \param vT is a vector template
143 */
144 template <typename T>
145 SPFDPoroElasticity generateFDPoroElasticity(SPDataWithGhostNodesACLData d,
146 SPDataWithGhostNodesACLData pl,
147 UValue<T> bM,
148 UValue<T> sM,
149 UValue<T> k,
150 const VectorTemplate* vT);
151
152 //-------------------------IMPLEMENTATION------------------------
153
154 inline ElasticityCommonA::Data FDPoroElasticity::getPressureData() const
155 {
156 return pressureData;
157 }
158
159 inline ElasticityCommonA::Data FDPoroElasticity::getLiquidPressureData() const
160 {
161 return pressureLiquidData;
162 }
163
164 } // asl
165 #endif // ASLFDELASTICITY_H