Homec4science
Diffusion LibMultiScale (features/components) Browse

libmultiscale/src/coupling/arlequin_template.hh
5a82d071ebbdfeatures/components

Last Change
Raw File

arlequin_template.hh
View Options

/**
* @file arlequin_template.hh
*
* @author Guillaume Anciaux <guillaume.anciaux@epfl.ch>
*
* @date Mon Nov 25 15:05:56 2013
*
* @brief Internal class to factor code for the Arlequin kind methods
*
* @section LICENSE
*
* Copyright INRIA and CEA
*
* The LibMultiScale is a C++ parallel framework for the multiscale
* coupling methods dedicated to material simulations. This framework
* provides an API which makes it possible to program coupled simulations
* and integration of already existing codes.
*
* This Project was initiated in a collaboration between INRIA Futurs Bordeaux
* within ScAlApplix team and CEA/DPTA Ile de France.
* The project is now continued at the Ecole Polytechnique Fédérale de Lausanne
* within the LSMS/ENAC laboratory.
*
* This software is governed by the CeCILL-C license under French law and
* abiding by the rules of distribution of free software. You can use,
* modify and/ or redistribute the software under the terms of the CeCILL-C
* license as circulated by CEA, CNRS and INRIA at the following URL
* "http://www.cecill.info".
*
* As a counterpart to the access to the source code and rights to copy,
* modify and redistribute granted by the license, users are provided only
* with a limited warranty and the software's author, the holder of the
* economic rights, and the successive licensors have only limited
* liability.
*
* In this respect, the user's attention is drawn to the risks associated
* with loading, using, modifying and/or developing or reproducing the
* software by the user in light of its specific status of free software,
* that may mean that it is complicated to manipulate, and that also
* therefore means that it is reserved for developers and experienced
* professionals having in-depth computer knowledge. Users are therefore
* encouraged to load and test the software's suitability as regards their
* requirements in conditions enabling the security of their systems and/or
* data to be ensured and, more generally, to use and operate it in the
* same conditions as regards security.
*
* The fact that you are presently reading this means that you have had
* knowledge of the CeCILL-C license and that you accept its terms.
*
*/
#ifndef __LIBMULTISCALE_ARLEQUIN_TEMPLATE_HH__
#define __LIBMULTISCALE_ARLEQUIN_TEMPLATE_HH__
/* -------------------------------------------------------------------------- */
#define CONTINUFLAG 1
#define ATOMEFLAG 2
/* -------------------------------------------------------------------------- */
#include "lib_continuum.hh"
#include "lib_md.hh"
//#include "operateur_moyenne.hh"
#include "bridging_atomic_continuum.hh"
#include "compute_compatibility.hh"
#include "coupling_atomic_continuum.hh"
/* -------------------------------------------------------------------------- */
__BEGIN_LIBMULTISCALE__
template <typename DomainA, typename DomainC, UInt Dim>
class ArlequinTemplate : public CouplingAtomicContinuum<DomainA, DomainC, Dim> {
/* ------------------------------------------------------------------------ */
/* Typedefs */
/* ------------------------------------------------------------------------ */
public:
typedef CouplingAtomicContinuum<DomainA, DomainC, Dim> Parent;
/* ------------------------------------------------------------------------ */
/* Constructors/Destructors */
/* ------------------------------------------------------------------------ */
ArlequinTemplate<DomainA, DomainC, Dim>(const std::string &name,
DomainInterface &domA,
DomainInterface &domC);
~ArlequinTemplate();
/* ------------------------------------------------------------------------ */
/* Methods */
/* ------------------------------------------------------------------------ */
void declareParams();
virtual void clearAll();
protected:
//! Allocating the structures (vector/matrices) for the constraUInt system
/** This step takes into account the migrations made by allocating
with a padding */
void allocate(UInt size);
//! Compute the weighting function of the coupled MD DOFs
void computeAtomWeights();
//! Compute the weighting function of the coupled FE DOFs
void computeContinuumWeights();
//! Correct the weighting function of the coupled MD DOFs
void correctAtomWeights();
//! Correct the weighting function of the coupled FE DOFs
void correctContinuumWeights();
//! Build the contribution from FE to the constraUInt matrix(using
//! shapematrix)
void buildContinuConstraintMatrix();
//! Build the contribution from MD to the constraUInt matrix
void buildAtomsConstraintMatrix();
//! Build the right hand side contribution from FE
void buildContinuRHS();
//! Build the right hand side contribution from MD
void buildAtomsRHS();
//! reset to zero the RHS vector
void cleanRHS();
//! solve the constraUInt system
void solveConstraint();
//! average multipliers : usefull for mesh when doing multitimestep to kill
//! problematic wave frequencies
void averageMultipliers();
//! apply correction to local FE Dofs
void applyContinuCorrection();
//! apply correction to local MD Dofs
void applyAtomsCorrection();
/* ------------------------------------------------------------------------ */
/* Class Members */
/* ------------------------------------------------------------------------ */
protected:
//! array to store matrix
std::vector<Real> A;
//! array to store rhs/multipliers data
std::vector<Real> rhs;
//! variable containing the size of the constraint system
UInt size_constraint;
//! multiple timestep indicator
UInt multi_time_step;
//! The bridging zone
BridgingAtomicContinuum<DomainA, DomainC, Dim> bridging_zone;
//! The bridge zone used for surface effects
BridgingAtomicContinuum<DomainA, DomainC, Dim> MDboundary_zone;
//! geometry id for the bridging zone
LMID bridging_geom;
//! geometry id for the boundary zone
LMID boundary_geom;
//! quality factor (see anciaux, coulaud, roman, zerah publication)
Real quality;
//! weighting vector for FE DOFs
ComputeCompatibility weightFE;
//! weighting vector for MD DOFs
ComputeCompatibility weightMD;
//! weighting vector for FE DOFs
ComputeCompatibility lambdasC;
//! weighting vector for MD DOFs
ComputeCompatibility lambdasA;
//! flag to know wether we have to chack for coherency
bool check_coherency;
};
/* -------------------------------------------------------------------------- */
__END_LIBMULTISCALE__
#endif /* __LIBMULTISCALE_ARLEQUIN_TEMPLATE_HH__ */
c4science · Help