MetaSpringBC::OpSpringFsMaterial Struct Reference

RHS-operator for the spring boundary condition element for ALE formulation. More...

#include <users_modules/basic_finite_elements/src/SpringElement.hpp>

Inheritance diagram for MetaSpringBC::OpSpringFsMaterial:

Collaboration diagram for MetaSpringBC::OpSpringFsMaterial:

Public Member Functions
MoFEMErrorCode	doWork (int side, EntityType type, EntData &row_data)
	Operator for linear form, usually to calculate values on right hand side. More...
MoFEMErrorCode	iNtegrate (EntData &row_data)
	Integrates and assembles to global RHS vector virtual work of springs on material positions for configurational changes for ALE formulation. More...
MoFEMErrorCode	aSsemble (EntData &row_data)
	OpSpringFsMaterial (const string material_field, boost::shared_ptr< MetaSpringBC::DataAtIntegrationPtsSprings > data_at_pts, boost::shared_ptr< VolumeElementForcesAndSourcesCoreOnSide > side_fe, std::string &side_fe_name, MetaSpringBC::BlockOptionDataSprings &data)
Public Member Functions inherited from MoFEM::FaceElementForcesAndSourcesCore::UserDataOperator
double	getArea ()
	get area of face More...
VectorDouble &	getNormal ()
	get triangle normal More...
VectorDouble &	getTangent1 ()
	get triangle tangent 1 More...
VectorDouble &	getTangent2 ()
	get triangle tangent 2 More...
auto	getFTensor1Normal ()
	get normal as tensor More...
auto	getFTensor1Tangent1 ()
	get tangentOne as tensor More...
auto	getFTensor1Tangent2 ()
	get tangentTwo as tensor More...
int	getNumNodes ()
	get element number of nodes More...
const EntityHandle *	getConn ()
	get element connectivity More...
VectorDouble &	getCoords ()
	get triangle coordinates More...
auto	getFTensor1Coords ()
	get get coords at gauss points More...
MatrixDouble &	getNormalsAtGaussPts ()
	if higher order geometry return normals at Gauss pts. More...
ublas::matrix_row< MatrixDouble >	getNormalsAtGaussPts (const int gg)
	if higher order geometry return normals at Gauss pts. More...
MatrixDouble &	getTangent1AtGaussPts ()
	if higher order geometry return tangent vector to triangle at Gauss pts. More...
MatrixDouble &	getTangent2AtGaussPts ()
	if higher order geometry return tangent vector to triangle at Gauss pts. More...
auto	getFTensor1NormalsAtGaussPts ()
	get normal at integration points More...
auto	getFTensor1Tangent1AtGaussPts ()
	get tangent 1 at integration points More...
auto	getFTensor1Tangent2AtGaussPts ()
	get tangent 2 at integration points More...
FaceElementForcesAndSourcesCore *	getFaceFE ()
	return pointer to Generic Triangle Finite Element object More...
MoFEMErrorCode	loopSideVolumes (const string fe_name, VolumeElementForcesAndSourcesCoreOnSide &fe_method)
Public Member Functions inherited from MoFEM::ForcesAndSourcesCore::UserDataOperator
	UserDataOperator (const FieldSpace space, const char type=OPSPACE, const bool symm=true)
	UserDataOperator (const std::string field_name, const char type, const bool symm=true)
	UserDataOperator (const std::string row_field_name, const std::string col_field_name, const char type, const bool symm=true)
boost::shared_ptr< const NumeredEntFiniteElement >	getNumeredEntFiniteElementPtr () const
	Return raw pointer to NumeredEntFiniteElement. More...
EntityHandle	getFEEntityHandle () const
	Return finite element entity handle. More...
int	getFEDim () const
	Get dimension of finite element. More...
EntityType	getFEType () const
	Get dimension of finite element. More...
boost::weak_ptr< SideNumber >	getSideNumberPtr (const int side_number, const EntityType type)
	Get the side number pointer. More...
EntityHandle	getSideEntity (const int side_number, const EntityType type)
	Get the side entity. More...
int	getNumberOfNodesOnElement () const
	Get the number of nodes on finite element. More...
MoFEMErrorCode	getProblemRowIndices (const std::string filed_name, const EntityType type, const int side, VectorInt &indices) const
	Get row indices. More...
MoFEMErrorCode	getProblemColIndices (const std::string filed_name, const EntityType type, const int side, VectorInt &indices) const
	Get col indices. More...
const FEMethod *	getFEMethod () const
	Return raw pointer to Finite Element Method object. More...
int	getOpType () const
	Get operator types. More...
void	setOpType (const OpType type)
	Set operator type. More...
void	addOpType (const OpType type)
	Add operator type. More...
int	getNinTheLoop () const
	get number of finite element in the loop More...
int	getLoopSize () const
	get size of elements in the loop More...
std::string	getFEName () const
	Get name of the element. More...
ForcesAndSourcesCore *	getPtrFE () const
ForcesAndSourcesCore *	getSidePtrFE () const
ForcesAndSourcesCore *	getRefinePtrFE () const
const PetscData::Switches &	getDataCtx () const
const KspMethod::KSPContext	getKSPCtx () const
const SnesMethod::SNESContext	getSNESCtx () const
const TSMethod::TSContext	getTSCtx () const
Vec	getKSPf () const
Mat	getKSPA () const
Mat	getKSPB () const
Vec	getSNESf () const
Vec	getSNESx () const
Mat	getSNESA () const
Mat	getSNESB () const
Vec	getTSu () const
Vec	getTSu_t () const
Vec	getTSu_tt () const
Vec	getTSf () const
Mat	getTSA () const
Mat	getTSB () const
int	getTSstep () const
double	getTStime () const
double	getTStimeStep () const
double	getTSa () const
double	getTSaa () const
MatrixDouble &	getGaussPts ()
	matrix of integration (Gauss) points for Volume Element More...
auto	getFTensor0IntegrationWeight ()
	Get integration weights. More...
MatrixDouble &	getCoordsAtGaussPts ()
	Gauss points and weight, matrix (nb. of points x 3) More...
auto	getFTensor1CoordsAtGaussPts ()
	Get coordinates at integration points assuming linear geometry. More...
double	getMeasure () const
	get measure of element More...
double &	getMeasure ()
	get measure of element More...
MoFEMErrorCode	loopSide (const string &fe_name, ForcesAndSourcesCore *side_fe, const size_t dim, const EntityHandle ent_for_side=0, const int verb=QUIET, const LogManager::SeverityLevel sev=Sev::noisy, AdjCache *adj_cache=nullptr)
	User calls this function to loop over elements on the side of face. This function calls finite element with its operator to do calculations. More...
MoFEMErrorCode	loopThis (const string &fe_name, ForcesAndSourcesCore *this_fe, const int verb=QUIET, const LogManager::SeverityLevel sev=Sev::noisy)
	User calls this function to loop over the same element using a different set of integration points. This function calls finite element with its operator to do calculations. More...
MoFEMErrorCode	loopParent (const string &fe_name, ForcesAndSourcesCore *parent_fe, const int verb=QUIET, const LogManager::SeverityLevel sev=Sev::noisy)
	User calls this function to loop over parent elements. This function calls finite element with its operator to do calculations. More...
MoFEMErrorCode	loopChildren (const string &fe_name, ForcesAndSourcesCore *child_fe, const int verb=QUIET, const LogManager::SeverityLevel sev=Sev::noisy)
	User calls this function to loop over parent elements. This function calls finite element with its operator to do calculations. More...
Public Member Functions inherited from MoFEM::DataOperator
	DataOperator (const bool symm=true)
virtual	~DataOperator ()=default
virtual MoFEMErrorCode	doWork (int row_side, int col_side, EntityType row_type, EntityType col_type, EntitiesFieldData::EntData &row_data, EntitiesFieldData::EntData &col_data)
	Operator for bi-linear form, usually to calculate values on left hand side. More...
virtual MoFEMErrorCode	opLhs (EntitiesFieldData &row_data, EntitiesFieldData &col_data)
virtual MoFEMErrorCode	opRhs (EntitiesFieldData &data, const bool error_if_no_base=false)
bool	getSymm () const
	Get if operator uses symmetry of DOFs or not. More...
void	setSymm ()
	set if operator is executed taking in account symmetry More...
void	unSetSymm ()
	unset if operator is executed for non symmetric problem More...

Public Attributes
boost::shared_ptr< MetaSpringBC::DataAtIntegrationPtsSprings >	dataAtPts
boost::shared_ptr< VolumeElementForcesAndSourcesCoreOnSide >	sideFe
std::string	sideFeName
Vec	F
MetaSpringBC::BlockOptionDataSprings &	dAta
bool	hoGeometry
VectorDouble	nF
VectorInt	rowIndices
int	nbRows
	number of dofs on rows More...
int	nbIntegrationPts
	number of integration points More...
Public Attributes inherited from MoFEM::ForcesAndSourcesCore::UserDataOperator
char	opType
std::string	rowFieldName
std::string	colFieldName
FieldSpace	sPace
Public Attributes inherited from MoFEM::DataOperator
DoWorkLhsHookFunType	doWorkLhsHook
DoWorkRhsHookFunType	doWorkRhsHook
bool	sYmm
	If true assume that matrix is symmetric structure. More...
std::array< bool, MBMAXTYPE >	doEntities
	If true operator is executed for entity. More...
bool &	doVertices
	\deprectaed If false skip vertices More...
bool &	doEdges
	\deprectaed If false skip edges More...
bool &	doQuads
	\deprectaed More...
bool &	doTris
	\deprectaed More...
bool &	doTets
	\deprectaed More...
bool &	doPrisms
	\deprectaed More...

Additional Inherited Members
Public Types inherited from MoFEM::ForcesAndSourcesCore::UserDataOperator
enum	OpType {   OPROW = 1 << 0, OPCOL = 1 << 1, OPROWCOL = 1 << 2, OPSPACE = 1 << 3,   OPLAST = 1 << 3 }
	Controls loop over entities on element. More...
using	AdjCache = std::map< EntityHandle, std::vector< boost::weak_ptr< NumeredEntFiniteElement > >>
Public Types inherited from MoFEM::DataOperator
using	DoWorkLhsHookFunType = boost::function< MoFEMErrorCode(DataOperator *op_ptr, int row_side, int col_side, EntityType row_type, EntityType col_type, EntitiesFieldData::EntData &row_data, EntitiesFieldData::EntData &col_data)>
using	DoWorkRhsHookFunType = boost::function< MoFEMErrorCode(DataOperator *op_ptr, int side, EntityType type, EntitiesFieldData::EntData &data)>
Static Public Attributes inherited from MoFEM::ForcesAndSourcesCore::UserDataOperator
static const char *const	OpTypeNames []
Protected Attributes inherited from MoFEM::ForcesAndSourcesCore::UserDataOperator
ForcesAndSourcesCore *	ptrFE

Detailed Description

RHS-operator for the spring boundary condition element for ALE formulation.

Integrates virtual work of springs on material positions involved in configurational changes and assembles components to RHS global vector.

Definition at line 715 of file SpringElement.hpp.

Constructor & Destructor Documentation

OpSpringFsMaterial()

MetaSpringBC::OpSpringFsMaterial::OpSpringFsMaterial ( const string  material_field, boost::shared_ptr< MetaSpringBC::DataAtIntegrationPtsSprings >  data_at_pts, boost::shared_ptr< VolumeElementForcesAndSourcesCoreOnSide >  side_fe, std::string &  side_fe_name, MetaSpringBC::BlockOptionDataSprings &  data  )

inline

Parameters

material_field	String of field name for material positions for rows
data_at_pts	Pointer to the common data for spring element
side_fe	Pointer to the volume finite elements adjacent to the spring face element
side_fe_name	String of 3D element adjacent to the present springs elements
data	Variable containing data for normal and tangential stiffnesses of springs attached to the current element

Definition at line 788 of file SpringElement.hpp.

        : UserDataOperator(material_field, UserDataOperator::OPROW),
          dataAtPts(data_at_pts), sideFe(side_fe), sideFeName(side_fe_name),
          dAta(data){};

Member Function Documentation

aSsemble()

MoFEMErrorCode MetaSpringBC::OpSpringFsMaterial::aSsemble

(

EntData &

row_data

)

Definition at line 1009 of file SpringElement.cpp.

                                                                         {
  MoFEMFunctionBegin;
 
  // get pointer to first global index on row
  const int *row_indices = &*row_data.getIndices().data().begin();
 
  auto &data = *dataAtPts;
 
  rowIndices.resize(nbRows, false);
  noalias(rowIndices) = row_data.getIndices();
  row_indices = &rowIndices[0];
  VectorDofs &dofs = row_data.getFieldDofs();
  VectorDofs::iterator dit = dofs.begin();
  for (int ii = 0; dit != dofs.end(); ++dit, ++ii) {
    if (data.forcesOnlyOnEntitiesRow.find((*dit)->getEnt()) ==
        data.forcesOnlyOnEntitiesRow.end()) {
      rowIndices[ii] = -1;
    }
  }
 
  CHKERR VecSetOption(getSNESf(), VEC_IGNORE_NEGATIVE_INDICES, PETSC_TRUE);
  CHKERR VecSetValues(getSNESf(), nbRows, row_indices, &*nF.data().begin(),
                      ADD_VALUES);
 
  MoFEMFunctionReturn(0);
}

doWork()

MoFEMErrorCode MetaSpringBC::OpSpringFsMaterial::doWork ( int  side, EntityType  type, EntData &  data  )

virtual

Operator for linear form, usually to calculate values on right hand side.

Reimplemented from MoFEM::DataOperator.

Definition at line 887 of file SpringElement.cpp.

                                                                           {
 
  MoFEMFunctionBegin;
 
  if (dAta.tRis.find(getNumeredEntFiniteElementPtr()->getEnt()) ==
      dAta.tRis.end()) {
    MoFEMFunctionReturnHot(0);
  }
 
  // get number of dofs on row
  nbRows = row_data.getIndices().size();
  // if no dofs on row, exit that work, nothing to do here
  if (!nbRows)
    MoFEMFunctionReturnHot(0);
 
  nF.resize(nbRows, false);
  nF.clear();
 
  // get number of integration points
  nbIntegrationPts = getGaussPts().size2();
 
  // integrate local matrix for entity block
  CHKERR iNtegrate(row_data);
 
  // assemble local matrix
  CHKERR aSsemble(row_data);
 
  MoFEMFunctionReturn(0);
}

iNtegrate()

MoFEMErrorCode MetaSpringBC::OpSpringFsMaterial::iNtegrate

(

EntData &

row_data

)

Integrates and assembles to global RHS vector virtual work of springs on material positions for configurational changes for ALE formulation.

Computes virtual work of springs on material positions for configurational changes:

\[ f_s ({\mathbf x}, {\mathbf X}, \delta \mathbf{X}) = -\int\limits_{\partial \Omega }^{} {{\delta \mathbf{X}^T} \cdot {\mathbf{F}^{\intercal}} \left[ k_{\rm n} \left( {\mathbf N} \otimes {\mathbf N} \right) + k_{\rm t} \left( {\mathbf I} - {\mathbf N} \otimes {\mathbf N} \right) \right] \left( {\mathbf x} - {\mathbf X} \right) \partial \Omega } \]

where \( \delta \mathbf{X} \) is material position variation, \( k_{\rm n} \) is the stiffness of the springs normal to the surface, \( k_{\rm t} \) is the stiffness of the springs tangential to the surface, \( {\mathbf N} \) is the normal to the surface vector based on material positions, \( {\mathbf x} \) is the vector of spatial positions or displacements of the surface with springs, \( {\mathbf X} \) is the vector of material positions and finally \(\mathbf{F}\) is the deformation gradient

\[ \mathbf{F} = \mathbf{h}(\mathbf{x})\,\mathbf{H}(\mathbf{X})^{-1} = \frac{\partial\mathbf{x}}{\partial\boldsymbol{\chi}} \frac{\partial\boldsymbol{\chi}}{\partial\mathbf{X}} \]

where \(\mathbf{h}\) and \(\mathbf{H}\) are the gradients of the spatial and material maps, respectively, and \(\boldsymbol{\chi}\) are the reference coordinates.

Definition at line 919 of file SpringElement.cpp.

                                                                      {
  MoFEMFunctionBegin;
 
  CHKERR loopSideVolumes(sideFeName, *sideFe);
 
  // check that the faces have associated degrees of freedom
  const int nb_dofs = data.getIndices().size();
  if (nb_dofs == 0)
    MoFEMFunctionReturnHot(0);
 
  CHKERR dataAtPts->getBlockData(dAta);
 
  // get integration weights
  auto t_w = getFTensor0IntegrationWeight();
 
  // FTensor indices
  FTensor::Index<'i', 3> i;
  FTensor::Index<'j', 3> j;
  FTensor::Index<'k', 3> k;
 
  const double normal_stiffness = dataAtPts->springStiffnessNormal;
  const double tangent_stiffness = dataAtPts->springStiffnessTangent;
 
  // create a 3d vector to be used as the normal to the face with length equal
  // to the face area
  FTensor::Tensor1<double, 3> t_normal;
  FTensor::Tensor2<double, 3, 3> t_normal_projection;
  FTensor::Tensor2<double, 3, 3> t_tangent_projection;
 
  // Extract solution at Gauss points
  auto t_solution_at_gauss_point = getFTensor1FromMat<3>(*dataAtPts->xAtPts);
  auto t_init_solution_at_gauss_point =
      getFTensor1FromMat<3>(*dataAtPts->xInitAtPts);
  FTensor::Tensor1<double, 3> t_displacement_at_gauss_point;
 
  auto t_normal_1 = getFTensor1FromMat<3>(dataAtPts->normalVector);
 
  auto t_F = getFTensor2FromMat<3, 3>(*dataAtPts->FMat);
 
  // loop over all Gauss points of the face
  for (int gg = 0; gg != nbIntegrationPts; ++gg) {
    t_normal(i) = t_normal_1(i);
 
    const double normal_length = std::sqrt(t_normal(k) * t_normal(k));
    t_normal(i) = t_normal(i) / normal_length;
    t_normal_projection(i, j) = t_normal(i) * t_normal(j);
    t_tangent_projection(i, j) = t_normal_projection(i, j);
    t_tangent_projection(0, 0) -= 1;
    t_tangent_projection(1, 1) -= 1;
    t_tangent_projection(2, 2) -= 1;
    // Calculate the displacement at the Gauss point
    t_displacement_at_gauss_point(i) =
        t_solution_at_gauss_point(i) - t_init_solution_at_gauss_point(i);
 
    double w = t_w * 0.5 * normal_length; // area was constant
 
    auto t_base_func = data.getFTensor0N(gg, 0);
 
    // create a vector t_nf whose pointer points an array of 3 pointers
    // pointing to nF  memory location of components
    FTensor::Tensor1<FTensor::PackPtr<double *, 3>, 3> t_nf(&nF[0], &nF[1],
                                                            &nF[2]);
 
    for (int rr = 0; rr != nb_dofs / 3; ++rr) { // loop over the nodes
 
      t_nf(i) -= w * t_base_func * normal_stiffness * t_F(k, i) *
                 t_normal_projection(k, j) * t_displacement_at_gauss_point(j);
      t_nf(i) += w * t_base_func * tangent_stiffness * t_F(k, i) *
                 t_tangent_projection(k, j) * t_displacement_at_gauss_point(j);
 
      // move to next base function
      ++t_base_func;
      // move the pointer to next element of t_nf
      ++t_nf;
    }
    // move to next integration weight
    ++t_w;
    // move to the solutions at the next Gauss point
    ++t_solution_at_gauss_point;
    ++t_init_solution_at_gauss_point;
    ++t_normal_1;
    ++t_F;
  }
  // add computed values of spring in the global right hand side vector
  // Vec f = getFEMethod()->ksp_f != PETSC_NULL ? getFEMethod()->ksp_f
  //                                            : getFEMethod()->snes_f;
  // CHKERR VecSetValues(f, nb_dofs, &data.getIndices()[0], &nF[0], ADD_VALUES);
  MoFEMFunctionReturn(0);
}

Member Data Documentation

dAta

MetaSpringBC::BlockOptionDataSprings& MetaSpringBC::OpSpringFsMaterial::dAta

Definition at line 722 of file SpringElement.hpp.

dataAtPts

boost::shared_ptr<MetaSpringBC::DataAtIntegrationPtsSprings> MetaSpringBC::OpSpringFsMaterial::dataAtPts

Definition at line 718 of file SpringElement.hpp.

F

Vec MetaSpringBC::OpSpringFsMaterial::F

Definition at line 721 of file SpringElement.hpp.

hoGeometry

bool MetaSpringBC::OpSpringFsMaterial::hoGeometry

Definition at line 723 of file SpringElement.hpp.

nbIntegrationPts

int MetaSpringBC::OpSpringFsMaterial::nbIntegrationPts

number of integration points

Definition at line 730 of file SpringElement.hpp.

nbRows

int MetaSpringBC::OpSpringFsMaterial::nbRows

number of dofs on rows

Definition at line 729 of file SpringElement.hpp.

nF

VectorDouble MetaSpringBC::OpSpringFsMaterial::nF

Definition at line 725 of file SpringElement.hpp.

rowIndices

VectorInt MetaSpringBC::OpSpringFsMaterial::rowIndices

Definition at line 727 of file SpringElement.hpp.

sideFe

boost::shared_ptr<VolumeElementForcesAndSourcesCoreOnSide> MetaSpringBC::OpSpringFsMaterial::sideFe

Definition at line 719 of file SpringElement.hpp.

sideFeName

std::string MetaSpringBC::OpSpringFsMaterial::sideFeName

Definition at line 720 of file SpringElement.hpp.

---

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

• users_modules/basic_finite_elements/src/SpringElement.hpp
• users_modules/basic_finite_elements/src/impl/SpringElement.cpp