Debian Codegraph @

include/deal.II/fe/fe_values_views_internal.h

raw
1 // ------------------------------------------------------------------------
2 //
3 // SPDX-License-Identifier: LGPL-2.1-or-later
4 // Copyright (C) 2023 by the deal.II authors
5 //
6 // This file is part of the deal.II library.
7 //
8 // Part of the source code is dual licensed under Apache-2.0 WITH
9 // LLVM-exception OR LGPL-2.1-or-later. Detailed license information
10 // governing the source code and code contributions can be found in
11 // LICENSE.md and CONTRIBUTING.md at the top level directory of deal.II.
12 //
13 // ------------------------------------------------------------------------
14
15 #ifndef dealii_fe_values_views_internal_h
16 #define dealii_fe_values_views_internal_h
17
18 #include <deal.II/base/config.h>
19
20 #include <deal.II/base/array_view.h>
21 #include <deal.II/base/symmetric_tensor.h>
22 #include <deal.II/base/table.h>
23 #include <deal.II/base/tensor.h>
24
25 #include <deal.II/fe/fe_values_views.h>
26
27 #include <vector>
28
29 DEAL_II_NAMESPACE_OPEN
30
31 namespace FEValuesViews
32 {
33 /**
34 * Internal namespace for the utility functions used to actually compute
35 * values by FEValuesViews
36 */
37 namespace internal
38 {
39 // Given values of degrees of freedom, evaluate the
40 // values/gradients/... at quadrature points
41
42 // ------------------------- scalar functions --------------------------
43
44 /**
45 * Compute function values for Scalars.
46 */
47 template <int dim, int spacedim, typename Number>
48 void
49 do_function_values(
50 const ArrayView<const Number> &dof_values,
51 const Table<2, double> &shape_values,
52 const std::vector<typename Scalar<dim, spacedim>::ShapeFunctionData>
53 &shape_function_data,
54 std::vector<typename ProductType<Number, double>::type> &values);
55
56 /**
57 * same code for gradient and Hessian, template argument 'order' to give
58 * the order of the derivative (= rank of gradient/Hessian tensor)
59 */
60 template <int order, int dim, int spacedim, typename Number>
61 void
62 do_function_derivatives(
63 const ArrayView<const Number> &dof_values,
64 const Table<2, dealii::Tensor<order, spacedim>> &shape_derivatives,
65 const std::vector<typename Scalar<dim, spacedim>::ShapeFunctionData>
66 &shape_function_data,
67 std::vector<
68 typename ProductType<Number, dealii::Tensor<order, spacedim>>::type>
69 &derivatives);
70
71 /**
72 * Compute Laplacian values for Scalars.
73 */
74 template <int dim, int spacedim, typename Number>
75 void
76 do_function_laplacians(
77 const ArrayView<const Number> &dof_values,
78 const Table<2, dealii::Tensor<2, spacedim>> &shape_hessians,
79 const std::vector<typename Scalar<dim, spacedim>::ShapeFunctionData>
80 &shape_function_data,
81 std::vector<typename Scalar<dim, spacedim>::
82 template solution_laplacian_type<Number>> &laplacians);
83
84 // ----------------------------- vector part ---------------------------
85
86 /**
87 * Compute function values for Vectors.
88 */
89 template <int dim, int spacedim, typename Number>
90 void
91 do_function_values(
92 const ArrayView<const Number> &dof_values,
93 const Table<2, double> &shape_values,
94 const std::vector<typename Vector<dim, spacedim>::ShapeFunctionData>
95 &shape_function_data,
96 std::vector<
97 typename ProductType<Number, dealii::Tensor<1, spacedim>>::type>
98 &values);
99
100 /**
101 * same code for gradient and Hessian, template argument 'order' to give
102 * the order of the derivative (= rank of gradient/Hessian tensor)
103 */
104 template <int order, int dim, int spacedim, typename Number>
105 void
106 do_function_derivatives(
107 const ArrayView<const Number> &dof_values,
108 const Table<2, dealii::Tensor<order, spacedim>> &shape_derivatives,
109 const std::vector<typename Vector<dim, spacedim>::ShapeFunctionData>
110 &shape_function_data,
111 std::vector<
112 typename ProductType<Number, dealii::Tensor<order + 1, spacedim>>::type>
113 &derivatives);
114
115 /**
116 * Compute gradient values for Vectors.
117 */
118 template <int dim, int spacedim, typename Number>
119 void
120 do_function_symmetric_gradients(
121 const ArrayView<const Number> &dof_values,
122 const Table<2, dealii::Tensor<1, spacedim>> &shape_gradients,
123 const std::vector<typename Vector<dim, spacedim>::ShapeFunctionData>
124 &shape_function_data,
125 std::vector<
126 typename ProductType<Number,
127 dealii::SymmetricTensor<2, spacedim>>::type>
128 &symmetric_gradients);
129
130 /**
131 * Compute divergence values for Vectors.
132 */
133 template <int dim, int spacedim, typename Number>
134 void
135 do_function_divergences(
136 const ArrayView<const Number> &dof_values,
137 const Table<2, dealii::Tensor<1, spacedim>> &shape_gradients,
138 const std::vector<typename Vector<dim, spacedim>::ShapeFunctionData>
139 &shape_function_data,
140 std::vector<typename Vector<dim, spacedim>::
141 template solution_divergence_type<Number>> &divergences);
142
143 /**
144 * Compute curl values for Vectors.
145 */
146 template <int dim, int spacedim, typename Number>
147 void
148 do_function_curls(
149 const ArrayView<const Number> &dof_values,
150 const Table<2, dealii::Tensor<1, spacedim>> &shape_gradients,
151 const std::vector<typename Vector<dim, spacedim>::ShapeFunctionData>
152 &shape_function_data,
153 std::vector<typename ProductType<
154 Number,
155 typename dealii::internal::CurlType<spacedim>::type>::type> &curls);
156
157 /**
158 * Compute Laplacian values for Vectors.
159 */
160 template <int dim, int spacedim, typename Number>
161 void
162 do_function_laplacians(
163 const ArrayView<const Number> &dof_values,
164 const Table<2, dealii::Tensor<2, spacedim>> &shape_hessians,
165 const std::vector<typename Vector<dim, spacedim>::ShapeFunctionData>
166 &shape_function_data,
167 std::vector<typename Vector<dim, spacedim>::
168 template solution_laplacian_type<Number>> &laplacians);
169
170 // ---------------------- symmetric tensor part ------------------------
171
172 /**
173 * Compute values for symmetric tensors.
174 */
175 template <int dim, int spacedim, typename Number>
176 void
177 do_function_values(
178 const ArrayView<const Number> &dof_values,
179 const dealii::Table<2, double> &shape_values,
180 const std::vector<
181 typename SymmetricTensor<2, dim, spacedim>::ShapeFunctionData>
182 &shape_function_data,
183 std::vector<
184 typename ProductType<Number,
185 dealii::SymmetricTensor<2, spacedim>>::type>
186 &values);
187
188 /**
189 * Compute divergence values for symmetric tensors.
190 */
191 template <int dim, int spacedim, typename Number>
192 void
193 do_function_divergences(
194 const ArrayView<const Number> &dof_values,
195 const Table<2, dealii::Tensor<1, spacedim>> &shape_gradients,
196 const std::vector<
197 typename SymmetricTensor<2, dim, spacedim>::ShapeFunctionData>
198 &shape_function_data,
199 std::vector<typename SymmetricTensor<2, dim, spacedim>::
200 template solution_divergence_type<Number>> &divergences);
201
202 // ---------------------- non-symmetric tensor part ------------------------
203
204 /**
205 * Compute values for nonsymmetric tensors.
206 */
207 template <int dim, int spacedim, typename Number>
208 void
209 do_function_values(
210 const ArrayView<const Number> &dof_values,
211 const dealii::Table<2, double> &shape_values,
212 const std::vector<typename Tensor<2, dim, spacedim>::ShapeFunctionData>
213 &shape_function_data,
214 std::vector<
215 typename ProductType<Number, dealii::Tensor<2, spacedim>>::type>
216 &values);
217
218 /**
219 * Compute divergence values for nonsymmetric tensors.
220 */
221 template <int dim, int spacedim, typename Number>
222 void
223 do_function_divergences(
224 const ArrayView<const Number> &dof_values,
225 const Table<2, dealii::Tensor<1, spacedim>> &shape_gradients,
226 const std::vector<typename Tensor<2, dim, spacedim>::ShapeFunctionData>
227 &shape_function_data,
228 std::vector<typename Tensor<2, dim, spacedim>::
229 template solution_divergence_type<Number>> &divergences);
230
231 /**
232 * Compute gradient values for nonsymmetric tensors.
233 */
234 template <int dim, int spacedim, typename Number>
235 void
236 do_function_gradients(
237 const ArrayView<const Number> &dof_values,
238 const Table<2, dealii::Tensor<1, spacedim>> &shape_gradients,
239 const std::vector<typename Tensor<2, dim, spacedim>::ShapeFunctionData>
240 &shape_function_data,
241 std::vector<typename Tensor<2, dim, spacedim>::
242 template solution_gradient_type<Number>> &gradients);
243 } // end of namespace internal
244 } // namespace FEValuesViews
245
246
247 DEAL_II_NAMESPACE_CLOSE
248
249 #endif