"""Doc."""
# Copyright (C) 2008-2016 Andrew T. T. McRae
#
# This file is part of UFL (https://www.fenicsproject.org)
#
# SPDX-License-Identifier: LGPL-3.0-or-later
#
# Modified by Massimiliano Leoni, 2016
from ufl.finiteelement.finiteelementbase import FiniteElementBase
from ufl.sobolevspace import HDiv, HCurl, L2
[docs]
class HDivElement(FiniteElementBase):
"""A div-conforming version of an outer product element, assuming this makes mathematical sense."""
__slots__ = ("_element", )
def __init__(self, element):
"""Doc."""
self._element = element
family = "TensorProductElement"
cell = element.cell()
degree = element.degree()
quad_scheme = element.quadrature_scheme()
value_shape = (element.cell().geometric_dimension(),)
reference_value_shape = (element.cell().topological_dimension(),)
# Skipping TensorProductElement constructor! Bad code smell, refactor to avoid this non-inheritance somehow.
FiniteElementBase.__init__(self, family, cell, degree,
quad_scheme, value_shape, reference_value_shape)
def __repr__(self):
"""Doc."""
return f"HDivElement({repr(self._element)})"
[docs]
def mapping(self):
"""Doc."""
return "contravariant Piola"
[docs]
def sobolev_space(self):
"""Return the underlying Sobolev space."""
return HDiv
[docs]
def reconstruct(self, **kwargs):
"""Doc."""
return HDivElement(self._element.reconstruct(**kwargs))
[docs]
def variant(self):
"""Doc."""
return self._element.variant()
def __str__(self):
"""Doc."""
return f"HDivElement({repr(self._element)})"
[docs]
def shortstr(self):
"""Format as string for pretty printing."""
return f"HDivElement({self._element.shortstr()})"
[docs]
class HCurlElement(FiniteElementBase):
"""A curl-conforming version of an outer product element, assuming this makes mathematical sense."""
__slots__ = ("_element",)
def __init__(self, element):
"""Doc."""
self._element = element
family = "TensorProductElement"
cell = element.cell()
degree = element.degree()
quad_scheme = element.quadrature_scheme()
cell = element.cell()
value_shape = (cell.geometric_dimension(),)
reference_value_shape = (cell.topological_dimension(),) # TODO: Is this right?
# Skipping TensorProductElement constructor! Bad code smell,
# refactor to avoid this non-inheritance somehow.
FiniteElementBase.__init__(self, family, cell, degree, quad_scheme,
value_shape, reference_value_shape)
def __repr__(self):
"""Doc."""
return f"HCurlElement({repr(self._element)})"
[docs]
def mapping(self):
"""Doc."""
return "covariant Piola"
[docs]
def sobolev_space(self):
"""Return the underlying Sobolev space."""
return HCurl
[docs]
def reconstruct(self, **kwargs):
"""Doc."""
return HCurlElement(self._element.reconstruct(**kwargs))
[docs]
def variant(self):
"""Doc."""
return self._element.variant()
def __str__(self):
"""Doc."""
return f"HCurlElement({repr(self._element)})"
[docs]
def shortstr(self):
"""Format as string for pretty printing."""
return f"HCurlElement({self._element.shortstr()})"
[docs]
class WithMapping(FiniteElementBase):
"""Specify an alternative mapping for the wrappee.
For example,
to use identity mapping instead of Piola map with an element E,
write
remapped = WithMapping(E, "identity")
"""
def __init__(self, wrapee, mapping):
"""Doc."""
if mapping == "symmetries":
raise ValueError("Can't change mapping to 'symmetries'")
self._mapping = mapping
self.wrapee = wrapee
def __getattr__(self, attr):
"""Doc."""
try:
return getattr(self.wrapee, attr)
except AttributeError:
raise AttributeError("'%s' object has no attribute '%s'" %
(type(self).__name__, attr))
def __repr__(self):
"""Doc."""
return f"WithMapping({repr(self.wrapee)}, '{self._mapping}')"
[docs]
def value_shape(self):
"""Doc."""
gdim = self.cell().geometric_dimension()
mapping = self.mapping()
if mapping in {"covariant Piola", "contravariant Piola"}:
return (gdim,)
elif mapping in {"double covariant Piola", "double contravariant Piola"}:
return (gdim, gdim)
else:
return self.wrapee.value_shape()
[docs]
def reference_value_shape(self):
"""Doc."""
tdim = self.cell().topological_dimension()
mapping = self.mapping()
if mapping in {"covariant Piola", "contravariant Piola"}:
return (tdim,)
elif mapping in {"double covariant Piola", "double contravariant Piola"}:
return (tdim, tdim)
else:
return self.wrapee.reference_value_shape()
[docs]
def mapping(self):
"""Doc."""
return self._mapping
[docs]
def sobolev_space(self):
"""Return the underlying Sobolev space."""
if self.wrapee.mapping() == self.mapping():
return self.wrapee.sobolev_space()
else:
return L2
[docs]
def reconstruct(self, **kwargs):
"""Doc."""
mapping = kwargs.pop("mapping", self._mapping)
wrapee = self.wrapee.reconstruct(**kwargs)
return type(self)(wrapee, mapping)
[docs]
def variant(self):
"""Doc."""
return self.wrapee.variant()
def __str__(self):
"""Doc."""
return f"WithMapping({repr(self.wrapee)}, {self._mapping})"
[docs]
def shortstr(self):
"""Doc."""
return f"WithMapping({self.wrapee.shortstr()}, {self._mapping})"