Debian Codegraph @

demo/documented/hyperelasticity/hyperelasticity.rst

raw
1 .. _hyperelasticity:
2
3 Hyperelasticity background
4 ==========================
5
6 This example demonstrates the solution of a three-dimensional
7 elasticity problem. In addition to illustrating how to use
8 FunctionSpaces, Expressions and how to apply Dirichlet boundary
9 conditions, it focuses on how to:
10
11 * Minimise a non-quadratic functional
12 * Use automatic computation of the directional derivative
13 * Solve a nonlinear variational problem
14 * Define compiled sub-domains
15 * Use specific form compiler optimization options
16
17 Equation and problem definition
18 -------------------------------
19
20 By definition, boundary value problems for hyperelastic media can be
21 expressed as minimisation problems, and the minimization approach is
22 adopted in this example. For a domain :math:`\Omega \subset
23 \mathbb{R}^{d}`, where :math:`d` denotes the spatial dimension, the
24 task is to find the displacement field :math:`u: \Omega \rightarrow
25 \mathbb{R}^{d}` that minimises the total potential energy :math:`\Pi`:
26
27 .. math::
28 \min_{u \in V} \Pi,
29
30 where :math:`V` is a suitable function space that satisfies boundary
31 conditions on :math:`u`. The total potential energy is given by
32
33 .. math::
34 \Pi = \int_{\Omega} \psi(u) \, {\rm d} x
35 - \int_{\Omega} B \cdot u \, {\rm d} x
36 - \int_{\partial\Omega} T \cdot u \, {\rm d} s,
37
38 where :math:`\psi` is the elastic stored energy density, :math:`B` is a
39 body force (per unit reference volume) and :math:`T` is a traction force
40 (per unit reference area).
41
42 At minimum points of :math:`\Pi`, the directional derivative of :math:`\Pi`
43 with respect to change in :math:`u`
44
45 .. math::
46 :label: first_variation
47
48 L(u; v) = D_{v} \Pi = \left. \frac{d \Pi(u + \epsilon v)}{d\epsilon} \right|_{\epsilon = 0}
49
50 is equal to zero for all :math:`v \in V`:
51
52 .. math::
53 L(u; v) = 0 \quad \forall \ v \in V.
54
55 To minimise the potential energy, a solution to the variational
56 equation above is sought. Depending on the potential energy
57 :math:`\psi`, :math:`L(u; v)` can be nonlinear in :math:`u`. In such a
58 case, the Jacobian of :math:`L` is required in order to solve this
59 problem using Newton's method. The Jacobian of :math:`L` is defined as
60
61 .. math::
62 :label: second_variation
63
64 a(u; du, v) = D_{du} L = \left. \frac{d L(u + \epsilon du; v)}{d\epsilon} \right|_{\epsilon = 0} .
65
66
67
68 Elastic stored energy density
69 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
70
71 To define the elastic stored energy density, consider the deformation
72 gradient :math:`F`
73
74 .. math::
75
76 F = I + \nabla u,
77
78 the right Cauchy-Green tensor :math:`C`
79
80 .. math::
81
82 C = F^{T} F,
83
84 and the scalars :math:`J` and :math:`I_{c}`
85
86 .. math::
87 J &= \det(F), \\
88 I_{c} &= {\rm trace}(C).
89
90 This demo considers a common neo-Hookean stored energy model of the form
91
92 .. math::
93 \psi = \frac{\mu}{2} (I_{c} - 3) - \mu \ln(J) + \frac{\lambda}{2}\ln(J)^{2},
94
95 where :math:`\mu` and :math:`\lambda` are the Lame parameters. These
96 can be expressed in terms of the more common Young's modulus :math:`E`
97 and Poisson ratio :math:`\nu` by:
98
99 .. math::
100 \lambda = \frac{E \nu}{(1 + \nu)(1 - 2\nu)}, \quad \quad
101 \mu = \frac{E}{2(1 + \nu)} .
102
103
104 Demo parameters
105 ^^^^^^^^^^^^^^^
106
107 We consider a unit cube domain:
108
109 * :math:`\Omega = (0, 1) \times (0, 1) \times (0, 1)` (unit cube)
110
111 We use the following definitions of the boundary and boundary conditions:
112
113 * :math:`\Gamma_{D_{0}} = 0 \times (0, 1) \times (0, 1)` (Dirichlet boundary)
114
115 * :math:`\Gamma_{D_{1}} = 1 \times (0, 1) \times (0, 1)` (Dirichlet boundary)
116
117 * :math:`\Gamma_{N} = \partial \Omega \backslash \Gamma_{D}` (Neumann boundary)
118
119 * On :math:`\Gamma_{D_{0}}`: :math:`u = (0, 0, 0)`
120
121 * On :math:`\Gamma_{D_{1}}`
122 .. math::
123 u = (&0, \\
124 &(0.5 + (y - 0.5)\cos(\pi/3) - (z - 0.5)\sin(\pi/3) - y)/2, \\
125 &(0.5 + (y - 0.5)\sin(\pi/3) + (z - 0.5)\cos(\pi/3) - z))/2)
126
127 * On :math:`\Gamma_{N}`: :math:`T = (0.1, 0, 0)`
128
129 These are the body forces and material parameters used:
130
131 * :math:`B = (0, -0.5, 0)`
132
133 * :math:`E = 10.0`
134
135 * :math:`\nu = 0.3`
136
137 With the above input the solution for :math:`u` will look as follows:
138
139 .. image:: ../hyperelasticity_u0.png
140 :scale: 75
141 :align: center
142
143 .. image:: ../hyperelasticity_u1.png
144 :scale: 75
145 :align: center