MercuryDPM  Alpha
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
MindlinSpecies.h
Go to the documentation of this file.
1 //Copyright (c) 2013-2017, The MercuryDPM Developers Team. All rights reserved.
2 //For the list of developers, see <http://www.MercuryDPM.org/Team>.
3 //
4 //Redistribution and use in source and binary forms, with or without
5 //modification, are permitted provided that the following conditions are met:
6 // * Redistributions of source code must retain the above copyright
7 // notice, this list of conditions and the following disclaimer.
8 // * Redistributions in binary form must reproduce the above copyright
9 // notice, this list of conditions and the following disclaimer in the
10 // documentation and/or other materials provided with the distribution.
11 // * Neither the name MercuryDPM nor the
12 // names of its contributors may be used to endorse or promote products
13 // derived from this software without specific prior written permission.
14 //
15 //THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
16 //ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
17 //WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
18 //DISCLAIMED. IN NO EVENT SHALL THE MERCURYDPM DEVELOPERS TEAM BE LIABLE FOR ANY
19 //DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
20 //(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
21 //LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
22 //ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23 //(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
24 //SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25 
26 #ifndef MINDLINSPECIES_H
27 #define MINDLINSPECIES_H
28 #include "Species/BaseSpecies.h"
29 #include "Math/ExtendedMath.h"
31 
36 class MindlinSpecies : public virtual BaseSpecies
37 {
38 public:
41 
44 
47 
49  virtual ~MindlinSpecies();
50 
52  void read(std::istream& is) override;
53 
55  void write(std::ostream& os) const override;
56 
58  virtual std::string getBaseName() const;
59 
60 //setters and getters
61 
63  void setSlidingDissipation(Mdouble new_dispt);
64 
67 
69  //mu has to be set to allow tangential forces (sets dispt=disp as default)
71 
72  //k_edit
73  //allows the shear modulus to be set / changed
74  void setShearModulus(Mdouble new_G);
75  //k_edit
76  //allows the value of the shear modulus to be accessed
77  Mdouble getShearModulus() const;
78 
81 
84 
87 
91  bool getUseAngularDOFs() const override;
92 
94  void mix(MindlinSpecies* const S, MindlinSpecies* const T);
95 
96 private:
97 
108 
111 
114 
115  //k_edit
116  // the shear modulus of a given particle. By default, set to zero;
118 
119 };
120 #endif
Mdouble getSlidingDissipation() const
Allows the tangential viscosity to be accessed.
Mdouble slidingDissipation_
tangential dissipation coefficient.
Mdouble getSlidingFrictionCoefficient() const
Allows the (dynamic) Coulomb friction coefficient to be accessed.
BaseSpecies is the class from which all other species are derived.
Definition: BaseSpecies.h:44
void write(std::ostream &os) const override
Writes the species properties to an output stream.
void read(std::istream &is) override
Reads the species properties from an input stream.
Mdouble getSlidingFrictionCoefficientStatic() const
Allows the static Coulomb friction coefficient to be accessed.
void setShearModulus(Mdouble new_G)
double Mdouble
Computes the forces corresponding to sliding friction.
void mix(MindlinSpecies *const S, MindlinSpecies *const T)
creates default values for mixed species
MindlinSpecies contains the parameters used to describe sliding friction.
Mdouble slidingFrictionCoefficient_
(dynamic) Coulomb friction coefficient
void setSlidingFrictionCoefficient(Mdouble new_mu)
Allows the (dynamic) Coulomb friction coefficient to be changed; also sets mu_s by default...
virtual std::string getBaseName() const
Used in Species::getName to obtain a unique name for each Species.
Mdouble slidingFrictionCoefficientStatic_
static Coulomb friction coefficient (by default set equal to mu)
virtual ~MindlinSpecies()
The default destructor.
Mdouble getShearModulus() const
void setSlidingDissipation(Mdouble new_dispt)
Allows the tangential viscosity to be changed.
Mdouble shearModulus_
MindlinInteraction InteractionType
The correct Interaction type for this FrictionForceSpecies.
void setSlidingFrictionCoefficientStatic(Mdouble new_mu)
Allows the static Coulomb friction coefficient to be changed.
MindlinSpecies()
The default constructor.
bool getUseAngularDOFs() const override
Returns true if torques have to be calculated.