contact_mechanics_model.hh
No OneTemporary
Actions

Subscribers

None

File Metadata

Created: Sat, May 4, 09:53

contact_mechanics_model.hh
View Options

	/**
	* @file contact_mechanics_model.hh
	*
	* @author Mohit Pundir <mohit.pundir@epfl.ch>
	*
	* @date creation: Fri Jun 18 2010
	* @date last modification: Thu Jun 24 2021
	*
	* @brief Model of Contact Mechanics
	*
	*
	* @section LICENSE
	*
	* Copyright (©) 2010-2021 EPFL (Ecole Polytechnique Fédérale de Lausanne)
	* Laboratory (LSMS - Laboratoire de Simulation en Mécanique des Solides)
	*
	* Akantu is free software: you can redistribute it and/or modify it under the
	* terms of the GNU Lesser General Public License as published by the Free
	* Software Foundation, either version 3 of the License, or (at your option) any
	* later version.
	*
	* Akantu is distributed in the hope that it will be useful, but WITHOUT ANY
	* WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
	* A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
	* details.
	*
	* You should have received a copy of the GNU Lesser General Public License
	* along with Akantu. If not, see <http://www.gnu.org/licenses/>.
	*
	*/

	/* -------------------------------------------------------------------------- */
	#include "boundary_condition.hh"
	#include "contact_detector.hh"
	#include "data_accessor.hh"
	#include "fe_engine.hh"
	#include "model.hh"
	/* -------------------------------------------------------------------------- */

	#ifndef __AKANTU_CONTACT_MECHANICS_MODEL_HH__
	#define __AKANTU_CONTACT_MECHANICS_MODEL_HH__

	namespace akantu {
	class Resolution;
	template <ElementKind kind, class IntegrationOrderFunctor>
	class IntegratorGauss;
	template <ElementKind kind> class ShapeLagrange;
	} // namespace akantu

	/* -------------------------------------------------------------------------- */
	namespace akantu {

	/* -------------------------------------------------------------------------- */
	class ContactMechanicsModel : public Model,
	public DataAccessor<Element>,
	public DataAccessor<UInt>,
	public BoundaryCondition<ContactMechanicsModel> {

	/* ------------------------------------------------------------------------ */
	/* Constructors/Destructors */
	/* ------------------------------------------------------------------------ */

	using MyFEEngineType = FEEngineTemplate<IntegratorGauss, ShapeLagrange>;

	public:
	ContactMechanicsModel(
	Mesh & mesh, UInt dim = _all_dimensions,
	const ID & id = "contact_mechanics_model",
	std::shared_ptr<DOFManager> dof_manager = nullptr,
	ModelType model_type = ModelType::_contact_mechanics_model);

	~ContactMechanicsModel() override;

	/* ------------------------------------------------------------------------ */
	/* Methods */
	/* ------------------------------------------------------------------------ */
	protected:
	/// initialize completely the model
	void initFullImpl(const ModelOptions & options) override;

	/// allocate all vectors
	void initSolver(TimeStepSolverType /unused/,
	NonLinearSolverType /unused/) override;

	/// initialize all internal arrays for resolutions
	void initResolutions();

	/// initialize the modelType
	void initModel() override;

	/// call back for the solver, computes the force residual
	void assembleResidual() override;

	/// get the type of matrix needed
	MatrixType getMatrixType(const ID & matrix_id) const override;

	/// callback for the solver, this assembles different matrices
	void assembleMatrix(const ID & matrix_id) override;

	/// callback for the solver, this assembles the stiffness matrix
	void assembleLumpedMatrix(const ID & matrix_id) override;

	/// get some default values for derived classes
	std::tuple<ID, TimeStepSolverType>
	getDefaultSolverID(const AnalysisMethod & method) override;

	ModelSolverOptions
	getDefaultSolverOptions(const TimeStepSolverType & type) const override;

	/// callback for the solver, this is called at beginning of solve
	void beforeSolveStep() override;

	/// callback for the solver, this is called at end of solve
	void afterSolveStep(bool converged = true) override;

	/// function to print the containt of the class
	void printself(std::ostream & stream, int indent = 0) const override;

	/* ------------------------------------------------------------------------ */
	/* Contact Detection */
	/* ------------------------------------------------------------------------ */
	public:
	void search();

	void computeNodalAreas(GhostType ghost_type = _not_ghost);

	/* ------------------------------------------------------------------------ */
	/* Contact Resolution */
	/* ------------------------------------------------------------------------ */
	public:
	/// register an empty contact resolution of a given type
	Resolution & registerNewResolution(const ID & res_name, const ID & res_type,
	const ID & opt_param);

	protected:
	/// register a resolution in the dynamic database
	Resolution & registerNewResolution(const ParserSection & res_section);

	/// read the resolution files to instantiate all the resolutions
	void instantiateResolutions();

	/// save the parameters from previous state
	void savePreviousState();

	/* ------------------------------------------------------------------------ */
	/* Solver Interface */
	/* ------------------------------------------------------------------------ */
	public:
	/// assembles the contact stiffness matrix
	virtual void assembleStiffnessMatrix();

	/// assembles the contant internal forces
	virtual void assembleInternalForces();

	/* ------------------------------------------------------------------------ */
	/* Accessors */
	/* ------------------------------------------------------------------------ */
	public:
	FEEngine & getFEEngineBoundary(const ID & name = "") override;

	/* ------------------------------------------------------------------------ */
	/* Dumpable interface */
	/* ------------------------------------------------------------------------ */
	public:
	#if defined(AKANTU_USE_IOHELPER)
	std::shared_ptr<dumpers::Field>
	createNodalFieldReal(const std::string & field_name,
	const std::string & group_name,
	bool padding_flag) override;

	std::shared_ptr<dumpers::Field>
	createNodalFieldUInt(const std::string & field_name,
	const std::string & group_name,
	bool padding_flag) override;

	std::shared_ptr<dumpers::Field>
	createNodalFieldBool(const std::string & field_name,
	const std::string & group_name,
	bool padding_flag) override;
	#endif

	/* ------------------------------------------------------------------------ */
	/* Data Accessor inherited members */
	/* ------------------------------------------------------------------------ */
	public:
	UInt getNbData(const Array<Element> & elements,
	const SynchronizationTag & tag) const override;

	void packData(CommunicationBuffer & buffer, const Array<Element> & elements,
	const SynchronizationTag & tag) const override;

	void unpackData(CommunicationBuffer & buffer, const Array<Element> & elements,
	const SynchronizationTag & tag) override;

	UInt getNbData(const Array<UInt> & dofs,
	const SynchronizationTag & tag) const override;

	void packData(CommunicationBuffer & buffer, const Array<UInt> & dofs,
	const SynchronizationTag & tag) const override;

	void unpackData(CommunicationBuffer & buffer, const Array<UInt> & dofs,
	const SynchronizationTag & tag) override;

	protected:
	/// contact detection class
	friend class ContactDetector;

	/// contact resolution class
	friend class Resolution;

	/* ------------------------------------------------------------------------ */
	/* Accessors */
	/* ------------------------------------------------------------------------ */
	public:
	/// get the ContactMechanicsModel::displacement vector
	AKANTU_GET_MACRO(Displacement, *displacement, Array<Real> &);

	/// get the ContactMechanicsModel::increment vector \warn only consistent
	/// if ContactMechanicsModel::setIncrementFlagOn has been called before
	AKANTU_GET_MACRO(Increment, *displacement_increment, Array<Real> &);

	/// get the ContactMechanics::internal_force vector (internal forces)
	AKANTU_GET_MACRO(InternalForce, *internal_force, Array<Real> &);

	/// get the ContactMechanicsModel::external_force vector (external forces)
	AKANTU_GET_MACRO(ExternalForce, *external_force, Array<Real> &);

	/// get the ContactMechanics::normal_force vector (normal forces)
	AKANTU_GET_MACRO(NormalForce, *normal_force, Array<Real> &);

	/// get the ContactMechanics::tangential_force vector (friction forces)
	AKANTU_GET_MACRO(TangentialForce, *tangential_force, Array<Real> &);

	/// get the ContactMechanics::traction vector (friction traction)
	AKANTU_GET_MACRO(TangentialTractions, *tangential_tractions, Array<Real> &);

	/// get the ContactMechanics::previous_tangential_tractions vector
	AKANTU_GET_MACRO(PreviousTangentialTractions, *previous_tangential_tractions,
	Array<Real> &);

	/// get the ContactMechanicsModel::force vector (external forces)
	Array<Real> & getForce() {
	AKANTU_DEBUG_WARNING("getForce was maintained for backward compatibility, "
	"use getExternalForce instead");
	return *external_force;
	}

	/// get the ContactMechanics::blocked_dofs vector
	AKANTU_GET_MACRO(BlockedDOFs, *blocked_dofs, Array<Real> &);

	/// get the ContactMechanics::gaps (contact gaps)
	AKANTU_GET_MACRO(Gaps, *gaps, Array<Real> &);

	/// get the ContactMechanics::normals (normals on slave nodes)
	AKANTU_GET_MACRO(Normals, *normals, Array<Real> &);

	/// get the ContactMechanics::tangents (tangents on slave nodes)
	AKANTU_GET_MACRO(Tangents, *tangents, Array<Real> &);

	/// get the ContactMechanics::previous_tangents (tangents on slave nodes)
	AKANTU_GET_MACRO(PreviousTangents, *previous_tangents, Array<Real> &);

	/// get the ContactMechanics::areas (nodal areas)
	AKANTU_GET_MACRO(NodalArea, *nodal_area, Array<Real> &);

	/// get the ContactMechanics::previous_projections (previous_projections)
	AKANTU_GET_MACRO(PreviousProjections, *previous_projections, Array<Real> &);

	/// get the ContactMechanics::projections (projections)
	AKANTU_GET_MACRO(Projections, *projections, Array<Real> &);

	/// get the ContactMechanics::contact_state vector (no_contact/stick/slip
	/// state)
	AKANTU_GET_MACRO(ContactState, *contact_state, Array<ContactState> &);

	/// get the ContactMechanics::previous_master_elements
	AKANTU_GET_MACRO(PreviousMasterElements, *previous_master_elements,
	Array<Element> &);

	/// get contact detector
	AKANTU_GET_MACRO_NOT_CONST(ContactDetector, *detector, ContactDetector &);

	/// get the contact elements
	inline const Array<ContactElement> & getContactElements() const {
	return contact_elements;
	}

	/// get the current positions of the nodes
	inline Array<Real> & getPositions() { return detector->getPositions(); }

	/* ------------------------------------------------------------------------ */
	/* Class Members */
	/* ------------------------------------------------------------------------ */
	private:
	/// tells if the resolutions are instantiated
	bool are_resolutions_instantiated;

	/// displacements array
	std::unique_ptr<Array<Real>> displacement;

	/// increment of displacement
	std::unique_ptr<Array<Real>> displacement_increment;

	/// contact forces array
	std::unique_ptr<Array<Real>> internal_force;

	/// external forces array
	std::unique_ptr<Array<Real>> external_force;

	/// normal force array
	std::unique_ptr<Array<Real>> normal_force;

	/// friction force array
	std::unique_ptr<Array<Real>> tangential_force;

	/// friction traction array
	std::unique_ptr<Array<Real>> tangential_tractions;

	/// previous friction traction array
	std::unique_ptr<Array<Real>> previous_tangential_tractions;

	/// boundary vector
	std::unique_ptr<Array<Real>> blocked_dofs;

	/// array to store gap between slave and master
	std::unique_ptr<Array<Real>> gaps;

	/// array to store normals from master to slave
	std::unique_ptr<Array<Real>> normals;

	/// array to store tangents on the master element
	std::unique_ptr<Array<Real>> tangents;

	/// array to store previous tangents on the master element
	std::unique_ptr<Array<Real>> previous_tangents;

	/// array to store nodal areas
	std::unique_ptr<Array<Real>> nodal_area;

	/// array to store stick/slip state :
	std::unique_ptr<Array<ContactState>> contact_state;

	/// array to store previous projections in covariant basis
	std::unique_ptr<Array<Real>> previous_projections;

	// array to store projections in covariant basis
	std::unique_ptr<Array<Real>> projections;

	/// contact detection
	std::unique_ptr<ContactDetector> detector;

	/// list of contact resolutions
	std::vector<std::unique_ptr<Resolution>> resolutions;

	/// mapping between resolution name and resolution internal id
	std::map<std::string, UInt> resolutions_names_to_id;

	/// array to store contact elements
	Array<ContactElement> contact_elements;

	/// array to store previous master elements
	std::unique_ptr<Array<Element>> previous_master_elements;
	};

	} // namespace akantu

	/* ------------------------------------------------------------------------ */
	/* inline functions */
	/* ------------------------------------------------------------------------ */
	#include "parser.hh"
	#include "resolution.hh"
	/* ------------------------------------------------------------------------ */

	#endif /* __AKANTU_CONTACT_MECHANICS_MODEL_HH__ */

contact_mechanics_model.hhNo OneTemporaryActions

File Metadata

contact_mechanics_model.hhView Options

Event Timeline

contact_mechanics_model.hh
No OneTemporary
Actions

contact_mechanics_model.hh
View Options