ESyS-Particle  4.0.1
Public Types | Public Member Functions | Static Public Member Functions | Protected Attributes | Friends
CHertzianViscoElasticFrictionInteraction Class Reference

Frictional+ViscoElastic interaction between particles. More...

#include <HertzianViscoElasticFrictionInteraction.h>

Inheritance diagram for CHertzianViscoElasticFrictionInteraction:
Inheritance graph
[legend]
Collaboration diagram for CHertzianViscoElasticFrictionInteraction:
Collaboration graph
[legend]

List of all members.

Public Types

typedef
CHertzianViscoElasticFrictionIGP 
ParameterType
typedef double(CHertzianViscoElasticFrictionInteraction::* ScalarFieldFunction )() const
typedef std::pair< bool,
double >
(CHertzianViscoElasticFrictionInteraction::* 
CheckedScalarFieldFunction )() const
typedef Vec3(CHertzianViscoElasticFrictionInteraction::* VectorFieldFunction )() const

Public Member Functions

 CHertzianViscoElasticFrictionInteraction (CParticle *, CParticle *)
 CHertzianViscoElasticFrictionInteraction (CParticle *, CParticle *, const CHertzianViscoElasticFrictionIGP &)
virtual void calcForces ()
virtual bool isPersistent ()
void setTimeStepSize (double dt)
std::pair< bool, double > getAbsFrictionalForce () const
std::pair< bool, double > getAbsFN () const
std::pair< bool, double > getAbsMuFN () const
std::pair< bool, double > getSlipVelocity () const
std::pair< bool, double > getNormalStress () const
std::pair< bool, double > getMaxFricStress () const
std::pair< bool, double > getAbsFrictionalStress () const
double getAbsForceDeficit () const
double getPotentialEnergy () const
double getSlipping () const
double getSticking () const
double getDissipatedEnergy () const
double Count () const
Vec3 getForce () const
Vec3 getNormalForce () const
virtual Vec3 getPos () const
std::pair< bool, double > getMuEff (const Vec3 &, const Vec3 &) const
std::pair< bool, double > getMuEffXY () const
std::pair< bool, double > getMuEffXZ () const
- Public Member Functions inherited from APairInteraction
 APairInteraction (CParticle *, CParticle *)
const CParticlefirst () const
const CParticlesecond () const
CParticlefirst ()
CParticlesecond ()
pair< int, int > getPairID () const
void setPP (CParticle *, CParticle *)
void checkIDs ()
virtual bool hasTag (int, int) const
virtual Vec3 getPosFirst () const
virtual Vec3 getPosSecond () const
esys::lsm::quintuple< Vec3,
double, Vec3, double, Vec3
getRaw2Data () const
template<class TmplParticle >
void setPP (const vector< TmplParticle * > &pp)
virtual void saveRestartData (std::ostream &oStream)
virtual void loadRestartData (std::istream &iStream)
- Public Member Functions inherited from AInteraction
bool initialized () const
virtual void calcHeatTrans ()
virtual void calcHeatFrict ()
vector< int > getAllID () const
int getID ()

Static Public Member Functions

static ScalarFieldFunction getScalarFieldFunction (const string &)
static CheckedScalarFieldFunction getCheckedScalarFieldFunction (const string &)
static VectorFieldFunction getVectorFieldFunction (const string &)
static string getType ()

Protected Attributes

double m_A
 Dissipative constant.
double m_E
 Young's modulus.
double m_nu
 Poisson ratio.
double m_r0
 equilibrium distance
double m_mu
 coefficient of friction
double m_ks
 shear stiffness (Cundall)
double m_dt
 time step
Vec3 m_Ffric
 current frictional force
Vec3 m_force_deficit
 difference between fric. force & force necessary for slip
Vec3 m_cpos
 contact position
Vec3 m_normal_force
 current normal force
double m_dn
 caching displacement for E_pot
bool m_is_slipping
 static/dynamic status of the interaction
bool m_is_touching
 contact status of the interaction
double m_E_diss
 dissipated energy
- Protected Attributes inherited from APairInteraction
CParticlem_p1
CParticlem_p2
- Protected Attributes inherited from AInteraction
vector< int > m_id
 id's of the particles involved
int m_iid
 interaction id
bool m_init

Friends

class TML_PackedMessageInterface
std::ostream & operator<< (std::ostream &, const CHertzianViscoElasticFrictionInteraction &)

Detailed Description

Frictional+ViscoElastic interaction between particles.

Author:
Laura Heredia & Pablo Richeri
Date:
2009-12-26 20:00:00 (sat, 26 dec 2009)

Constructor & Destructor Documentation

CHertzianViscoElasticFrictionInteraction::CHertzianViscoElasticFrictionInteraction ( CParticle p1,
CParticle p2 
)

constructor for CHertzianViscoElasticFrictionInteraction without friction and viscoelastic parameters, only calls the constructor of APairInteraction with the 2 particle pointers

References m_E_diss, m_is_slipping, and m_is_touching.


Member Function Documentation

void CHertzianViscoElasticFrictionInteraction::calcForces ( )
virtual

Calculate viscoelastic and frictional forces.

Implements APairInteraction.

References CParticle::applyForce(), m_A, m_cpos, m_dn, m_dt, m_E, m_E_diss, m_Ffric, m_force_deficit, m_is_slipping, m_is_touching, m_ks, m_mu, m_normal_force, and m_nu.

Here is the call graph for this function:

double CHertzianViscoElasticFrictionInteraction::Count ( ) const

return 1 if particles are in contact, 0 otherwise

Reimplemented from AInteraction.

References m_is_touching.

Referenced by getScalarFieldFunction().

Here is the caller graph for this function:

pair< bool, double > CHertzianViscoElasticFrictionInteraction::getAbsFN ( ) const

get current normal force

References m_is_touching, and m_normal_force.

Referenced by getCheckedScalarFieldFunction().

Here is the caller graph for this function:

double CHertzianViscoElasticFrictionInteraction::getAbsForceDeficit ( ) const

get the force needed to overcome friction and make the interaction slip

References m_force_deficit.

pair< bool, double > CHertzianViscoElasticFrictionInteraction::getAbsFrictionalForce ( ) const

get current frictional/stopping force

References m_Ffric.

Referenced by getCheckedScalarFieldFunction().

Here is the caller graph for this function:

pair< bool, double > CHertzianViscoElasticFrictionInteraction::getAbsFrictionalStress ( ) const

get current frictional/stopping stress (f_fric/r^2)

References m_Ffric.

Referenced by getCheckedScalarFieldFunction().

Here is the caller graph for this function:

pair< bool, double > CHertzianViscoElasticFrictionInteraction::getAbsMuFN ( ) const

get max. frictional force, i.e. coeff. of friction * normal force

References m_A, m_E, and m_nu.

Referenced by getCheckedScalarFieldFunction().

Here is the caller graph for this function:

CHertzianViscoElasticFrictionInteraction::CheckedScalarFieldFunction CHertzianViscoElasticFrictionInteraction::getCheckedScalarFieldFunction ( const string &  name)
static

Get the particle member function which returns a checked scalar field of a given name.

Parameters:
namethe name of the field

References getAbsFN(), getAbsFrictionalForce(), getAbsFrictionalStress(), getAbsMuFN(), getMaxFricStress(), getNormalStress(), and getSlipVelocity().

Here is the call graph for this function:

double CHertzianViscoElasticFrictionInteraction::getDissipatedEnergy ( ) const

return the amount of energy dissipated during the last time step

References m_E_diss.

Referenced by getScalarFieldFunction().

Here is the caller graph for this function:

Vec3 CHertzianViscoElasticFrictionInteraction::getForce ( ) const

get net force on particle1 imposed by this interaction. Returns Vec3::ZERO if particles are not in contact.

References m_Ffric, m_is_touching, and m_normal_force.

Referenced by getVectorFieldFunction().

Here is the caller graph for this function:

pair< bool, double > CHertzianViscoElasticFrictionInteraction::getMaxFricStress ( ) const

get max. frictional stress, i.e. coeff. of friction * normal stress

References m_A, m_E, and m_nu.

Referenced by getCheckedScalarFieldFunction().

Here is the caller graph for this function:

pair< bool, double > CHertzianViscoElasticFrictionInteraction::getMuEff ( const Vec3 dir,
const Vec3 norm 
) const

Calculate effective coefficient of friction for this interaction for a given direction of the applied shear force. If the effective coefficient of friction is infinite, -1 is returned.

Parameters:
dirthe direction of the applied shear force
Returns:
the effective coefficient of friction if it is finite, -1 otherwise and -2 for no contact

References m_mu.

Vec3 CHertzianViscoElasticFrictionInteraction::getNormalForce ( ) const

If the particles are in contact, get normal force, if not in contact return (0,0,0)

References m_is_touching, and m_normal_force.

Referenced by getVectorFieldFunction().

Here is the caller graph for this function:

pair< bool, double > CHertzianViscoElasticFrictionInteraction::getNormalStress ( ) const

get current normal stress

References m_is_touching, and m_normal_force.

Referenced by getCheckedScalarFieldFunction().

Here is the caller graph for this function:

double CHertzianViscoElasticFrictionInteraction::getPotentialEnergy ( ) const

get the potential energy stored in the interaction

References m_E, and m_normal_force.

Referenced by getScalarFieldFunction().

Here is the caller graph for this function:

CHertzianViscoElasticFrictionInteraction::ScalarFieldFunction CHertzianViscoElasticFrictionInteraction::getScalarFieldFunction ( const string &  name)
static

Get the particle member function which returns a scalar field of a given name.

Parameters:
namethe name of the field

References Count(), getDissipatedEnergy(), getPotentialEnergy(), getSlipping(), and getSticking().

Here is the call graph for this function:

double CHertzianViscoElasticFrictionInteraction::getSlipping ( ) const

Get the static/dynamic status of the interaction. Returns 1 for a contact in dynamic friction, 0 for static or no contact

References m_is_slipping.

Referenced by getScalarFieldFunction().

Here is the caller graph for this function:

pair< bool, double > CHertzianViscoElasticFrictionInteraction::getSlipVelocity ( ) const

get "force deficit", i.e. the force needed to make the contact dynamic

get the slipping velocity, i.e. the absolute value of the tangential part of the relatve particle velocity

Referenced by getCheckedScalarFieldFunction().

Here is the caller graph for this function:

double CHertzianViscoElasticFrictionInteraction::getSticking ( ) const

Get "sticking" contacts, i.e. return 1 if the contact is touching but not slipping, 0 otherwise

References m_is_slipping, and m_is_touching.

Referenced by getScalarFieldFunction().

Here is the caller graph for this function:

CHertzianViscoElasticFrictionInteraction::VectorFieldFunction CHertzianViscoElasticFrictionInteraction::getVectorFieldFunction ( const string &  name)
static

Get the particle member function which returns a vector field of a given name.

Parameters:
namethe name of the field

References getForce(), and getNormalForce().

Here is the call graph for this function:


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