libMesh::PeriodicBoundary Class Reference

Used for implementing periodic BCs via constraints. More...

#include <periodic_boundary.h>

Inheritance diagram for libMesh::PeriodicBoundary:

Public Types

enum  TransformationType { FORWARD =0, INVERSE =1 }
 

Public Member Functions

 PeriodicBoundary ()
 
virtual ~PeriodicBoundary ()
 
 PeriodicBoundary (const PeriodicBoundary &o, TransformationType t=FORWARD)
 
 PeriodicBoundary (const RealVectorValue &vector)
 
virtual Point get_corresponding_pos (const Point &pt) const override
 
virtual std::unique_ptr< PeriodicBoundaryBaseclone (TransformationType t=FORWARD) const override
 
void set_variable (unsigned int var)
 
void merge (const PeriodicBoundaryBase &pb)
 
bool is_my_variable (unsigned int var_num) const
 
bool has_transformation_matrix () const
 
const DenseMatrix< Real > & get_transformation_matrix () const
 
void set_transformation_matrix (const DenseMatrix< Real > &matrix)
 
const std::set< unsigned int > & get_variables () const
 

Public Attributes

boundary_id_type myboundary
 
boundary_id_type pairedboundary
 

Protected Attributes

RealVectorValue translation_vector
 
std::set< unsigned int > variables
 
std::unique_ptr< DenseMatrix< Real > > _transformation_matrix
 

Detailed Description

Used for implementing periodic BCs via constraints.

The definition of a periodic boundary.

Author
Roy Stogner
Date
2010

Definition at line 44 of file periodic_boundary.h.

Member Enumeration Documentation

◆ TransformationType

Constructor & Destructor Documentation

◆ PeriodicBoundary() [1/3]

libMesh::PeriodicBoundary::PeriodicBoundary ( )

Constructor

Definition at line 30 of file periodic_boundary.C.

◆ ~PeriodicBoundary()

virtual libMesh::PeriodicBoundary::~PeriodicBoundary ( )
inlinevirtual

Destructor

Definition at line 55 of file periodic_boundary.h.

55 {}

◆ PeriodicBoundary() [2/3]

libMesh::PeriodicBoundary::PeriodicBoundary ( const PeriodicBoundary o,
TransformationType  t = FORWARD 
)

Copy constructor, with option for the copy to represent an inverse transformation.

Definition at line 38 of file periodic_boundary.C.

References libMesh::PeriodicBoundaryBase::INVERSE, libMesh::PeriodicBoundaryBase::myboundary, libMesh::PeriodicBoundaryBase::pairedboundary, swap(), and translation_vector.

38  :
40  translation_vector(o.translation_vector)
41 {
42  if (t == INVERSE)
43  {
45  translation_vector *= -1.0;
46  }
47 }
RealVectorValue translation_vector
void swap(Iterator &lhs, Iterator &rhs)

◆ PeriodicBoundary() [3/3]

libMesh::PeriodicBoundary::PeriodicBoundary ( const RealVectorValue vector)

Constructor taking a reference to the translation vector.

Definition at line 51 of file periodic_boundary.C.

51  :
53  translation_vector(vector)
54 {
55 }
RealVectorValue translation_vector

Member Function Documentation

◆ clone()

std::unique_ptr< PeriodicBoundaryBase > libMesh::PeriodicBoundary::clone ( TransformationType  t = FORWARD) const
overridevirtual

If we want the DofMap to be able to make copies of references and store them in the underlying map, this class must be clone'able, i.e. have a kind of virtual construction mechanism.

Implements libMesh::PeriodicBoundaryBase.

Definition at line 66 of file periodic_boundary.C.

67 {
68  return libmesh_make_unique<PeriodicBoundary>(*this, t);
69 }

◆ get_corresponding_pos()

Point libMesh::PeriodicBoundary::get_corresponding_pos ( const Point pt) const
overridevirtual

This function should be overridden by derived classes to define how one finds corresponding nodes on the periodic boundary pair.

Implements libMesh::PeriodicBoundaryBase.

Definition at line 59 of file periodic_boundary.C.

References translation_vector.

60 {
61  return pt + translation_vector;
62 }
RealVectorValue translation_vector

◆ get_transformation_matrix()

const DenseMatrix< Real > & libMesh::PeriodicBoundaryBase::get_transformation_matrix ( ) const
inherited

Get the transformation matrix, if it is defined. Throw an error if it is not defined.

Definition at line 81 of file periodic_boundary_base.C.

References libMesh::PeriodicBoundaryBase::_transformation_matrix, and libMesh::PeriodicBoundaryBase::has_transformation_matrix().

Referenced by libMesh::FEGenericBase< FEOutputType< T >::type >::compute_periodic_constraints().

82 {
84  {
85  libmesh_error_msg("Transformation matrix is not defined");
86  }
87 
88  return *_transformation_matrix;
89 }
std::unique_ptr< DenseMatrix< Real > > _transformation_matrix

◆ get_variables()

const std::set< unsigned int > & libMesh::PeriodicBoundaryBase::get_variables ( ) const
inherited

Get the set of variables for this periodic boundary condition.

Definition at line 106 of file periodic_boundary_base.C.

References libMesh::PeriodicBoundaryBase::variables.

Referenced by libMesh::FEGenericBase< FEOutputType< T >::type >::compute_periodic_constraints().

107 {
108  return variables;
109 }
std::set< unsigned int > variables

◆ has_transformation_matrix()

bool libMesh::PeriodicBoundaryBase::has_transformation_matrix ( ) const
inherited
Returns
true if _transformation_matrix is not null.

Definition at line 74 of file periodic_boundary_base.C.

References libMesh::PeriodicBoundaryBase::_transformation_matrix.

Referenced by libMesh::FEGenericBase< FEOutputType< T >::type >::compute_periodic_constraints(), and libMesh::PeriodicBoundaryBase::get_transformation_matrix().

75 {
76  return bool(_transformation_matrix);
77 }
std::unique_ptr< DenseMatrix< Real > > _transformation_matrix

◆ is_my_variable()

bool libMesh::PeriodicBoundaryBase::is_my_variable ( unsigned int  var_num) const
inherited

Definition at line 66 of file periodic_boundary_base.C.

References libMesh::PeriodicBoundaryBase::variables.

Referenced by libMesh::FEGenericBase< FEOutputType< T >::type >::compute_periodic_constraints().

67 {
68  bool a = variables.empty() || (!variables.empty() && variables.find(var_num) != variables.end());
69  return a;
70 }
std::set< unsigned int > variables

◆ merge()

void libMesh::PeriodicBoundaryBase::merge ( const PeriodicBoundaryBase pb)
inherited

Definition at line 59 of file periodic_boundary_base.C.

References libMesh::PeriodicBoundaryBase::variables.

Referenced by libMesh::DofMap::add_periodic_boundary().

60 {
61  variables.insert(pb.variables.begin(), pb.variables.end());
62 }
std::set< unsigned int > variables

◆ set_transformation_matrix()

void libMesh::PeriodicBoundaryBase::set_transformation_matrix ( const DenseMatrix< Real > &  matrix)
inherited

Set the transformation matrix. When calling this method we require the following conditions: 1) matrix is square with size that matches this->variables.size() 2) the list of variables in this->variables set must all have the same FE type Both of these conditions are asserted in DBG mode.

Definition at line 93 of file periodic_boundary_base.C.

References libMesh::PeriodicBoundaryBase::_transformation_matrix, and libMesh::PeriodicBoundaryBase::variables.

94 {
95  // Make a deep copy of matrix
96  this->_transformation_matrix = libmesh_make_unique<DenseMatrix<Real>>();
97  *(this->_transformation_matrix) = matrix;
98 
99  // if _transformation_matrix is defined then it must be the same sie as variables.
100  libmesh_assert_equal_to(_transformation_matrix->m(), variables.size());
101  libmesh_assert_equal_to(_transformation_matrix->n(), variables.size());
102 }
std::set< unsigned int > variables
std::unique_ptr< DenseMatrix< Real > > _transformation_matrix

◆ set_variable()

void libMesh::PeriodicBoundaryBase::set_variable ( unsigned int  var)
inherited

Definition at line 52 of file periodic_boundary_base.C.

References libMesh::PeriodicBoundaryBase::variables.

53 {
54  variables.insert(var);
55 }
std::set< unsigned int > variables

Member Data Documentation

◆ _transformation_matrix

std::unique_ptr<DenseMatrix<Real> > libMesh::PeriodicBoundaryBase::_transformation_matrix
protectedinherited

A DenseMatrix that defines the mapping of variables on this boundary and the counterpart boundary. This is necessary for periodic-boundaries with vector-valued quantities (e.g. velocity or displacement) on a sector of a circular domain, for exaple, since in that case we must map each variable to a corresponding linear combination of all the variables. We store the DenseMatrix via a unique_ptr, and an uninitialized pointer is treated as equivalent to the identity matrix.

Definition at line 147 of file periodic_boundary_base.h.

Referenced by libMesh::PeriodicBoundaryBase::get_transformation_matrix(), libMesh::PeriodicBoundaryBase::has_transformation_matrix(), libMesh::PeriodicBoundaryBase::PeriodicBoundaryBase(), and libMesh::PeriodicBoundaryBase::set_transformation_matrix().

◆ myboundary

boundary_id_type libMesh::PeriodicBoundaryBase::myboundary
inherited

The boundary ID of this boundary and its counterpart

Definition at line 59 of file periodic_boundary_base.h.

Referenced by libMesh::DofMap::add_periodic_boundary(), and PeriodicBoundary().

◆ pairedboundary

◆ translation_vector

RealVectorValue libMesh::PeriodicBoundary::translation_vector
protected

Definition at line 85 of file periodic_boundary.h.

Referenced by get_corresponding_pos(), and PeriodicBoundary().

◆ variables

std::set<unsigned int> libMesh::PeriodicBoundaryBase::variables
protectedinherited

The documentation for this class was generated from the following files: