16 #ifndef dealii_dof_accessor_h
17 #define dealii_dof_accessor_h
29 #include <boost/container/small_vector.hpp>
38 template <
typename number>
40 template <
typename number>
42 template <
typename number>
45 template <
typename Accessor>
53 namespace DoFCellAccessorImplementation
55 struct Implementation;
58 namespace DoFHandlerImplementation
60 struct Implementation;
63 struct Implementation;
69 namespace DoFHandlerImplementation
71 struct Implementation;
85 namespace DoFAccessorImplementation
103 template <
int structdim,
int dim,
int spacedim>
119 template <
int dim,
int spacedim>
129 struct Implementation;
210 template <
int structdim,
int dim,
int spacedim,
bool level_dof_access>
211 class DoFAccessor :
public ::internal::DoFAccessorImplementation::
231 using BaseClass = typename ::internal::DoFAccessorImplementation::
232 Inheritance<structdim, dimension, space_dimension>::BaseClass;
301 template <
int structdim2,
int dim2,
int spacedim2>
308 template <
int structdim2,
int dim2,
int spacedim2,
bool level_dof_access2>
315 template <
bool level_dof_access2>
352 template <
bool level_dof_access2>
388 typename ::internal::DoFHandlerImplementation::
389 Iterators<dim, spacedim, level_dof_access>::line_iterator
390 line(
const unsigned int i)
const;
397 typename ::internal::DoFHandlerImplementation::
398 Iterators<dim, spacedim, level_dof_access>::quad_iterator
399 quad(
const unsigned int i)
const;
448 std::vector<types::global_dof_index> &dof_indices,
460 std::vector<types::global_dof_index> &dof_indices,
469 const std::vector<types::global_dof_index> &dof_indices,
495 const unsigned int vertex,
496 const unsigned int i,
507 const unsigned int vertex,
508 const unsigned int i,
588 std::set<types::fe_index>
621 "This accessor object has not been "
622 "associated with any DoFHandler object.");
676 template <
int structdim2,
int dim2,
int spacedim2,
bool level_dof_access2>
684 template <
int structdim2,
int dim2,
int spacedim2,
bool level_dof_access2>
716 const unsigned int i,
722 const unsigned int i,
728 const unsigned int vertex,
729 const unsigned int i,
737 template <
int,
int,
int,
bool>
745 friend struct ::internal::DoFHandlerImplementation::Policy::
747 friend struct ::internal::DoFHandlerImplementation::Implementation;
748 friend struct ::internal::hp::DoFHandlerImplementation::Implementation;
749 friend struct ::internal::DoFCellAccessorImplementation::Implementation;
750 friend struct ::internal::DoFAccessorImplementation::Implementation;
762 template <
int spacedim,
bool level_dof_access>
821 const unsigned int vertex_index,
847 template <
int structdim2,
int dim2,
int spacedim2>
854 template <
int structdim2,
int dim2,
int spacedim2,
bool level_dof_access2>
906 template <
bool level_dof_access2>
938 typename ::
internal::DoFHandlerImplementation::
939 Iterators<1, spacedim, level_dof_access>::line_iterator
940 line(const
unsigned int i) const;
948 typename ::
internal::DoFHandlerImplementation::
949 Iterators<1, spacedim, level_dof_access>::quad_iterator
950 quad(const
unsigned int i) const;
1032 const
unsigned int vertex,
1033 const
unsigned int i,
1117 "This accessor
object has not been "
1161 template <
int structdim2,
int dim2,
int spacedim2,
bool level_dof_access2>
1164 const
DoFAccessor<structdim2, dim2, spacedim2, level_dof_access2> &) const;
1169 template <
int structdim2,
int dim2,
int spacedim2,
bool level_dof_access2>
1172 const
DoFAccessor<structdim2, dim2, spacedim2, level_dof_access2> &) const;
1200 const
unsigned int i,
1214 friend struct ::
internal::DoFHandlerImplementation::Policy::
1216 friend struct ::
internal::DoFHandlerImplementation::Implementation;
1217 friend struct ::
internal::
hp::DoFHandlerImplementation::Implementation;
1218 friend struct ::
internal::DoFCellAccessorImplementation::Implementation;
1246 template <
int structdim,
int dim,
int spacedim = dim>
1264 const int level = -1,
1265 const int index = -1,
1281 template <
typename OtherAccessor>
1301 const unsigned int i,
1322 template <
int dimension_,
int space_dimension_,
bool level_dof_access>
1332 static const unsigned int dim = dimension_;
1337 static const unsigned int spacedim = space_dimension_;
1393 template <
int structdim2,
int dim2,
int spacedim2>
1400 template <
int structdim2,
int dim2,
int spacedim2,
bool level_dof_access2>
1482 periodic_neighbor(
const unsigned int i)
const;
1490 neighbor_or_periodic_neighbor(
const unsigned int i)
const;
1503 boost::container::small_vector<
1532 neighbor_child_on_subface(
const unsigned int face_no,
1533 const unsigned int subface_no)
const;
1542 periodic_neighbor_child_on_subface(
const unsigned int face_no,
1543 const unsigned int subface_no)
const;
1573 template <
class InputVector,
typename number>
1594 template <
typename Number,
typename ForwardIterator>
1597 ForwardIterator local_values_begin,
1598 ForwardIterator local_values_end)
const;
1620 template <
class InputVector,
typename ForwardIterator>
1624 const InputVector &
values,
1625 ForwardIterator local_values_begin,
1626 ForwardIterator local_values_end)
const;
1652 template <
class OutputVector,
typename number>
1655 OutputVector &
values)
const;
1688 template <
typename Number>
1690 get_interpolated_dof_values(
1756 template <
class OutputVector,
typename number>
1758 set_dof_values_by_interpolation(
1762 const bool perform_check =
false)
const;
1773 template <
class OutputVector,
typename number>
1775 distribute_local_to_global_by_interpolation(
1794 template <
typename number,
typename OutputVector>
1797 OutputVector &global_destination)
const;
1813 template <
typename ForwardIterator,
typename OutputVector>
1816 ForwardIterator local_source_end,
1817 OutputVector &global_destination)
const;
1832 template <
typename ForwardIterator,
typename OutputVector>
1836 ForwardIterator local_source_begin,
1837 ForwardIterator local_source_end,
1838 OutputVector &global_destination)
const;
1846 template <
typename number,
typename OutputMatrix>
1849 OutputMatrix &global_destination)
const;
1855 template <
typename number,
typename OutputMatrix,
typename OutputVector>
1859 OutputMatrix &global_matrix,
1860 OutputVector &global_vector)
const;
1888 std::vector<types::global_dof_index> &dof_indices)
const;
1922 get_dof_indices(std::vector<types::global_dof_index> &dof_indices)
const;
2023 set_dof_indices(
const std::vector<types::global_dof_index> &dof_indices);
2115 friend struct ::internal::DoFCellAccessorImplementation::Implementation;
2119 template <
int structdim,
int dim,
int spacedim,
bool level_dof_access>
2123 return level_dof_access;
2128 template <
int structdim,
int dim,
int spacedim>
2129 template <
typename OtherAccessor>
2131 const OtherAccessor &)
2134 ExcMessage(
"You are attempting an illegal conversion between "
2135 "iterator/accessor types. The constructor you call "
2136 "only exists to make certain template constructs "
2137 "easier to write as dimension independent code but "
2138 "the conversion is not valid in the current context."));
2146 #include <deal.II/dofs/dof_accessor.templates.h>
DoFAccessor(const InvalidAccessor< structdim2, dim2, spacedim2 > &)
DoFAccessor(const Triangulation< 1, spacedim > *, const int=0, const int=0, const DoFHandler< 1, spacedim > *dof_handler=0)
DoFAccessor(DoFAccessor< 0, 1, spacedim, level_dof_access > &&)=default
DoFAccessor(const Triangulation< 1, spacedim > *tria, const typename TriaAccessor< 0, 1, spacedim >::VertexKind vertex_kind, const unsigned int vertex_index, const DoFHandler< 1, spacedim > *dof_handler)
DoFAccessor< 0, 1, spacedim, level_dof_access > & operator=(DoFAccessor< 0, 1, spacedim, level_dof_access > &&) noexcept=default
DoFAccessor(const DoFAccessor< 0, 1, spacedim, level_dof_access > &)=default
DoFAccessor(const DoFAccessor< structdim2, dim2, spacedim2, level_dof_access2 > &)
DoFAccessor< 0, 1, spacedim, level_dof_access > & operator=(const DoFAccessor< 0, 1, spacedim, level_dof_access > &da)=delete
static constexpr unsigned int space_dimension
void set_mg_dof_index(const int level, const unsigned int i, const types::global_dof_index index) const
const FiniteElement< dim, spacedim > & get_fe(const types::fe_index fe_index) const
DoFAccessor< structdim, dim, spacedim, level_dof_access > & operator=(DoFAccessor< structdim, dim, spacedim, level_dof_access > &&)
types::fe_index nth_active_fe_index(const unsigned int n) const
DoFAccessor(DoFAccessor< structdim, dim, spacedim, level_dof_access > &&)
DoFAccessor(const DoFAccessor< structdim, dim, spacedim, level_dof_access2 > &)
const DoFHandler< dim, spacedim > & get_dof_handler() const
void set_mg_vertex_dof_index(const int level, const unsigned int vertex, const unsigned int i, const types::global_dof_index index, const types::fe_index fe_index=numbers::invalid_fe_index) const
static constexpr unsigned int dimension
void set_dof_handler(DoFHandler< dim, spacedim > *dh)
DoFAccessor(const DoFAccessor< structdim2, dim2, spacedim2, level_dof_access2 > &)
typename ::internal::DoFHandlerImplementation::Iterators< dim, spacedim, level_dof_access >::quad_iterator quad(const unsigned int i) const
std::set< types::fe_index > get_active_fe_indices() const
DoFAccessor(const DoFAccessor< structdim, dim, spacedim, level_dof_access > &)=default
void set_mg_dof_indices(const int level, const std::vector< types::global_dof_index > &dof_indices, const types::fe_index fe_index=numbers::invalid_fe_index)
void get_mg_dof_indices(const int level, std::vector< types::global_dof_index > &dof_indices, const types::fe_index fe_index=numbers::invalid_fe_index) const
types::global_dof_index mg_vertex_dof_index(const int level, const unsigned int vertex, const unsigned int i, const types::fe_index fe_index=numbers::invalid_fe_index) const
TriaIterator< DoFAccessor< structdim, dim, spacedim, level_dof_access > > child(const unsigned int c) const
DoFAccessor(const Triangulation< dim, spacedim > *tria, const int level, const int index, const DoFHandler< dim, spacedim > *dof_handler)
bool operator!=(const DoFAccessor< structdim2, dim2, spacedim2, level_dof_access2 > &) const
void copy_from(const TriaAccessorBase< structdim, dim, spacedim > &da)
types::global_dof_index dof_index(const unsigned int i, const types::fe_index fe_index=numbers::invalid_fe_index) const
void copy_from(const DoFAccessor< structdim, dim, spacedim, level_dof_access2 > &a)
typename ::internal::DoFHandlerImplementation::Iterators< dim, spacedim, level_dof_access >::line_iterator line(const unsigned int i) const
void get_dof_indices(std::vector< types::global_dof_index > &dof_indices, const types::fe_index fe_index=numbers::invalid_fe_index) const
bool operator==(const DoFAccessor< structdim2, dim2, spacedim2, level_dof_access2 > &) const
types::global_dof_index mg_dof_index(const int level, const unsigned int i) const
void set_dof_index(const unsigned int i, const types::global_dof_index index, const types::fe_index fe_index=numbers::invalid_fe_index) const
unsigned int n_active_fe_indices() const
DoFAccessor< structdim, dim, spacedim, level_dof_access > & operator=(const DoFAccessor< structdim, dim, spacedim, level_dof_access > &da)=delete
static bool is_level_cell()
typename ::internal::DoFAccessorImplementation::Inheritance< structdim, dimension, space_dimension >::BaseClass BaseClass
types::global_dof_index vertex_dof_index(const unsigned int vertex, const unsigned int i, const types::fe_index fe_index=numbers::invalid_fe_index) const
DoFHandler< dim, spacedim > * dof_handler
DoFAccessor(const InvalidAccessor< structdim2, dim2, spacedim2 > &)
bool fe_index_is_active(const types::fe_index fe_index) const
boost::container::small_vector< TriaIterator< DoFCellAccessor< dimension_, space_dimension_, level_dof_access > >, GeometryInfo< dimension_ >::max_children_per_cell > child_iterators() const
DoFCellAccessor< dimension_, space_dimension_, level_dof_access > & operator=(DoFCellAccessor< dimension_, space_dimension_, level_dof_access > &&)=default
DoFCellAccessor(DoFCellAccessor< dimension_, space_dimension_, level_dof_access > &&)=default
void get_active_or_mg_dof_indices(std::vector< types::global_dof_index > &dof_indices) const
void get_dof_values(const InputVector &values, Vector< number > &local_values) const
face_iterator face(const unsigned int i) const
types::fe_index future_fe_index() const
DoFCellAccessor(const Triangulation< dimension_, space_dimension_ > *tria, const int level, const int index, const AccessorData *local_data)
void set_future_fe_index(const types::fe_index i) const
void distribute_local_to_global(const Vector< number > &local_source, OutputVector &global_destination) const
void get_dof_values(const AffineConstraints< typename InputVector::value_type > &constraints, const InputVector &values, ForwardIterator local_values_begin, ForwardIterator local_values_end) const
void distribute_local_to_global(const FullMatrix< number > &local_source, OutputMatrix &global_destination) const
TriaIterator< DoFCellAccessor< dimension_, space_dimension_, level_dof_access > > child(const unsigned int i) const
boost::container::small_vector< face_iterator, GeometryInfo< dimension_ >::faces_per_cell > face_iterators() const
void set_active_fe_index(const types::fe_index i) const
const FiniteElement< dimension_, space_dimension_ > & get_future_fe() const
DoFCellAccessor< dimension_, space_dimension_, level_dof_access > & operator=(const DoFCellAccessor< dimension_, space_dimension_, level_dof_access > &da)=delete
DoFCellAccessor(const DoFAccessor< structdim2, dim2, spacedim2, level_dof_access2 > &)
TriaIterator< DoFCellAccessor< dimension_, space_dimension_, level_dof_access > > neighbor(const unsigned int i) const
DoFCellAccessor(const InvalidAccessor< structdim2, dim2, spacedim2 > &)
void clear_future_fe_index() const
void distribute_local_to_global(const FullMatrix< number > &local_matrix, const Vector< number > &local_vector, OutputMatrix &global_matrix, OutputVector &global_vector) const
void distribute_local_to_global(const AffineConstraints< typename OutputVector::value_type > &constraints, ForwardIterator local_source_begin, ForwardIterator local_source_end, OutputVector &global_destination) const
void set_dof_values(const Vector< number > &local_values, OutputVector &values) const
DoFCellAccessor(const DoFCellAccessor< dimension_, space_dimension_, level_dof_access > &)=default
const FiniteElement< dimension_, space_dimension_ > & get_fe() const
void distribute_local_to_global(ForwardIterator local_source_begin, ForwardIterator local_source_end, OutputVector &global_destination) const
void get_dof_values(const ReadVector< Number > &values, ForwardIterator local_values_begin, ForwardIterator local_values_end) const
~DoFCellAccessor()=default
TriaIterator< DoFCellAccessor< dimension_, space_dimension_, level_dof_access > > parent() const
bool future_fe_index_set() const
types::fe_index active_fe_index() const
DoFInvalidAccessor(const void *parent=nullptr, const int level=-1, const int index=-1, const AccessorData *local_data=nullptr)
typename InvalidAccessor< structdim, dim, spacedim >::AccessorData AccessorData
#define DEAL_II_NAMESPACE_OPEN
#define DEAL_II_NAMESPACE_CLOSE
#define DeclException0(Exception0)
static ::ExceptionBase & ExcVectorDoesNotMatch()
#define Assert(cond, exc)
static ::ExceptionBase & ExcNotActive()
#define DeclExceptionMsg(Exception, defaulttext)
static ::ExceptionBase & ExcInvalidObject()
static ::ExceptionBase & ExcMatrixDoesNotMatch()
static ::ExceptionBase & ExcCantCompareIterators()
static ::ExceptionBase & ExcVectorNotEmpty()
static ::ExceptionBase & ExcMessage(std::string arg1)
const types::fe_index invalid_fe_index
unsigned int global_dof_index
unsigned short int fe_index
const ::Triangulation< dim, spacedim > & tria