SinterNormalSpecies.h
Go to the documentation of this file.
1 // This file is part of the MercuryDPM project (https://www.mercurydpm.org).
2 // Copyright (c), The MercuryDPM Developers Team. All rights reserved.
3 // License: BSD 3-Clause License; see the LICENSE file in the root directory.
4 
5 #ifndef SinterNormalSpecies_H
6 #define SinterNormalSpecies_H
7 
9 #include "Math/ExtendedMath.h"
11 #include "Math/Helpers.h"
12 
13 enum class SINTERTYPE : unsigned char
14 {
16  CONSTANT_RATE = 1,
19 };
20 
26 {
27 public:
30 
33 
36 
39 
41  void read(std::istream& is);
42 
44  void write(std::ostream& os) const;
45 
47  std::string getBaseName() const;
48 
49 // Species-specific functions
50 
53 
58 
61 
66 
67 //setters and getters
68 
72  void setPlasticParameters(Mdouble loadingStiffness, Mdouble unloadingStiffnessMax, Mdouble cohesionStiffness,
73  Mdouble penetrationDepthMax);
74 
79 
84 
89 
94 
98  void setLoadingStiffness(Mdouble loadingStiffness);
99 
103  void setUnloadingStiffnessMax(Mdouble unloadingStiffnessMax);
104 
108  void setCohesionStiffness(Mdouble cohesionStiffness);
109 
113  void setPenetrationDepthMax(Mdouble penetrationDepthMax);
114 
118  void setDissipation(Mdouble dissipation);
119 
123  Mdouble getDissipation() const;
124 
128  void setSinterAdhesion(Mdouble sinterAdhesion);
129 
133  Mdouble getSinterAdhesion() const;
134 
138  void setInverseSinterViscosity(Mdouble inverseSinterViscosity);
139 
144 
149 
154 
155  void setSinterForceAndTime(Mdouble adhesionForce, Mdouble sinterTime, Mdouble radius);
156 
161  (Mdouble alpha, Mdouble beta, Mdouble atomicVolume /*Omega*/, Mdouble surfaceEnergy /*gamma_s*/,
162  Mdouble thicknessDiffusion /*deltaB*D0B*/, Mdouble activationEnergy /*QB*/, Mdouble temperature /*T*/);
163 
167  void setSinterRate(Mdouble sinterRate);
168 
172  void setSinterType(SINTERTYPE sinterType);
173 
177  Mdouble getSinterRate() const;
178 
179  SINTERTYPE getSinterType() const;
180 
181  std::function<double(double temperature)> getTemperatureDependentSinterRate() const;
182 
183  double getTemperatureDependentSinterRate(double temperature) const;
184 
185  void setTemperatureDependentSinterRate(std::function<double(double temperature)> temperatureDependentSinterRate);
186 
187  void setComplianceZero(Mdouble complianceZero);
188 
189  Mdouble getComplianceZero() const;
190 
191  void setSurfTension(Mdouble complianceZero);
192 
193  Mdouble getSurfTension() const;
194 
196 
197  Mdouble getConstantC1() const;
198 
199  void setSeparationDis(Mdouble separationDis);
200 
201  Mdouble getSeparationDis() const;
202 
203 
204 private:
207 
210 
213 
216 
219 
224 
229 
234 
239 
245 
251 
256 
263 
267  std::function<double(double temperature)> temperatureDependentSinterRate_ = [this](
268  double temperature) { return sinterRate_; };
269 };
270 
271 #endif
#define MERCURYDPM_DEPRECATED
Definition: GeneralDefine.h:16
SINTERTYPE
Definition: SinterNormalSpecies.h:14
@ TEMPERATURE_DEPENDENT_FRENKEL
float * p
Definition: Tutorial_Map_using.cpp:9
Definition: BaseNormalForce.h:11
Computes normal forces in case of a linear plastic visco-elastic interaction.
Definition: SinterInteraction.h:19
SinterNormalSpecies contains the parameters used to describe a plastic-cohesive normal force (Stefan ...
Definition: SinterNormalSpecies.h:26
Mdouble getUnloadingStiffnessMax() const
Returns the maximum unloading stiffness of the linear plastic-viscoelastic normal force.
Definition: SinterNormalSpecies.cc:169
void setStiffnessAndRestitutionCoefficient(Mdouble k_, Mdouble eps, Mdouble mass)
Sets k, disp such that it matches a given tc and eps for a collision of two copies of P.
Definition: SinterNormalSpecies.cc:493
void setTemperatureDependentSinterRate(std::function< double(double temperature)> temperatureDependentSinterRate)
Definition: SinterNormalSpecies.cc:457
void setCohesionStiffness(Mdouble cohesionStiffness)
Sets the cohesive stiffness of the linear plastic-viscoelastic normal force.
Definition: SinterNormalSpecies.cc:209
Mdouble sinterAdhesion_
Definition: SinterNormalSpecies.h:223
SinterInteraction InteractionType
The correct Interaction type for this FrictionForceSpecies.
Definition: SinterNormalSpecies.h:29
void write(std::ostream &os) const
Writes the species properties to an output stream.
Definition: SinterNormalSpecies.cc:69
Mdouble getComplianceZero() const
Definition: SinterNormalSpecies.cc:422
std::function< double(double temperature)> getTemperatureDependentSinterRate() const
Definition: SinterNormalSpecies.cc:452
Mdouble computeTimeStep(Mdouble mass)
Returns the optimal time step to resolve a collision of two particles of a given mass.
Definition: SinterNormalSpecies.cc:226
Mdouble cohesionStiffness_
the adhesive spring constant (k^c) for plastic deformations
Definition: SinterNormalSpecies.h:212
Mdouble getCollisionTime(Mdouble mass)
Calculates collision time for two copies of a particle of given disp, k, mass.
Definition: SinterNormalSpecies.cc:509
Mdouble getPenetrationDepthMax() const
Returns the maximum penetration depth of the linear plastic-viscoelastic normal force.
Definition: SinterNormalSpecies.cc:185
~SinterNormalSpecies()
The default destructor.
Definition: SinterNormalSpecies.cc:59
Mdouble getSeparationDis() const
Definition: SinterNormalSpecies.cc:437
void setInverseSinterViscosity(Mdouble inverseSinterViscosity)
Sets inverseSinterViscosity_.
Definition: SinterNormalSpecies.cc:337
void mix(SinterNormalSpecies *S, SinterNormalSpecies *T)
creates default values for mixed species
Definition: SinterNormalSpecies.cc:122
Mdouble getConstantC1() const
Definition: SinterNormalSpecies.cc:432
Mdouble unloadingStiffnessMax_
the maximum elastic constant (k_2^max) for plastic deformations
Definition: SinterNormalSpecies.h:209
std::function< double(double temperature)> temperatureDependentSinterRate_
Definition: SinterNormalSpecies.h:267
Mdouble penetrationDepthMax_
the depth (relative to the normalized radius) at which k_2^max is used (phi_f)
Definition: SinterNormalSpecies.h:215
void read(std::istream &is)
Reads the species properties from an input stream.
Definition: SinterNormalSpecies.cc:89
void setSurfTension(Mdouble complianceZero)
Definition: SinterNormalSpecies.cc:284
Mdouble getDissipation() const
Allows the normal dissipation to be accessed.
Definition: SinterNormalSpecies.cc:393
void setSinterAdhesion(Mdouble sinterAdhesion)
Sets sinterAdhesion_.
Definition: SinterNormalSpecies.cc:253
SinterNormalSpecies()
The default constructor.
Definition: SinterNormalSpecies.cc:14
Mdouble getInverseSinterViscosity() const
Accesses inverseSinterViscosity_.
Definition: SinterNormalSpecies.cc:409
void setPlasticParameters(Mdouble loadingStiffness, Mdouble unloadingStiffnessMax, Mdouble cohesionStiffness, Mdouble penetrationDepthMax)
Sets all parameters of the linear plastic-viscoelastic normal force at once.
Definition: SinterNormalSpecies.cc:144
void setSinterForceAndTime(Mdouble adhesionForce, Mdouble sinterTime, Mdouble radius)
Definition: SinterNormalSpecies.cc:348
Mdouble getSinterAdhesion() const
Accesses sinterAdhesion_.
Definition: SinterNormalSpecies.cc:401
void setSeparationDis(Mdouble separationDis)
Definition: SinterNormalSpecies.cc:302
Mdouble complianceZero_
Definition: SinterNormalSpecies.h:238
void setLoadingStiffness(Mdouble loadingStiffness)
Sets the loading stiffness of the linear plastic-viscoelastic normal force.
Definition: SinterNormalSpecies.cc:193
void setSinterRate(Mdouble sinterRate)
Sets sinterRate_.
Definition: SinterNormalSpecies.cc:266
void setPenetrationDepthMax(Mdouble penetrationDepthMax)
Sets the maximum penetration depth of the linear plastic-viscoelastic normal force.
Definition: SinterNormalSpecies.cc:217
void setConstantC1(Mdouble constantC1_)
Definition: SinterNormalSpecies.cc:293
Mdouble surfTension_
Definition: SinterNormalSpecies.h:244
SINTERTYPE getSinterType() const
Definition: SinterNormalSpecies.cc:442
Mdouble getSinterRate() const
Accesses sinterRate_.
Definition: SinterNormalSpecies.cc:417
Mdouble separationDis_
Definition: SinterNormalSpecies.h:255
void setSinterType(SINTERTYPE sinterType)
Sets sinterRate_.
Definition: SinterNormalSpecies.cc:318
Mdouble getSurfTension() const
Definition: SinterNormalSpecies.cc:427
Mdouble inverseSinterViscosity_
Definition: SinterNormalSpecies.h:228
void setComplianceZero(Mdouble complianceZero)
Definition: SinterNormalSpecies.cc:275
MERCURYDPM_DEPRECATED void setLoadingStiffnessAndDissipation(helpers::KAndDisp new_)
Allows the spring and dissipation constants to be changed simultaneously.
Definition: SinterNormalSpecies.cc:384
SINTERTYPE sinterType_
sinterType options determin how the rate of sintering, d(equilibriumOverlap)/dt is computed PARHAMI_M...
Definition: SinterNormalSpecies.h:262
void setParhamiMcKeeping(Mdouble alpha, Mdouble beta, Mdouble atomicVolume, Mdouble surfaceEnergy, Mdouble thicknessDiffusion, Mdouble activationEnergy, Mdouble temperature)
Sets the sinterAdhesion_ and inverseSinterViscosity_ based on the Parhami-McKeeping parameters.
Definition: SinterNormalSpecies.cc:363
void setCollisionTimeAndRestitutionCoefficient(Mdouble tc, Mdouble eps, Mdouble mass)
Definition: SinterNormalSpecies.cc:471
void setDissipation(Mdouble dissipation)
Sets the linear dissipation coefficient of the linear plastic-viscoelastic normal force.
Definition: SinterNormalSpecies.cc:240
Mdouble sinterRate_
Definition: SinterNormalSpecies.h:233
Mdouble getLoadingStiffness() const
Returns the loading stiffness of the linear plastic-viscoelastic normal force.
Definition: SinterNormalSpecies.cc:161
Mdouble loadingStiffness_
(normal) spring constant (k_1)
Definition: SinterNormalSpecies.h:206
Mdouble getCohesionStiffness() const
Returns the cohesive stiffness of the linear plastic-viscoelastic normal force.
Definition: SinterNormalSpecies.cc:177
Mdouble constantC1_
Definition: SinterNormalSpecies.h:250
std::string getBaseName() const
Used in Species::getName to obtain a unique name for each Species.
Definition: SinterNormalSpecies.cc:112
void setUnloadingStiffnessMax(Mdouble unloadingStiffnessMax)
Sets the maximum unloading stiffness of the linear plastic-viscoelastic normal force.
Definition: SinterNormalSpecies.cc:201
Mdouble dissipation_
linear dissipation coefficient
Definition: SinterNormalSpecies.h:218
RealScalar alpha
Definition: level1_cplx_impl.h:151
Scalar beta
Definition: level2_cplx_impl.h:36
double eps
Definition: crbond_bessel.cc:24
radius
Definition: UniformPSDSelfTest.py:15
std::string string(const unsigned &i)
Definition: oomph_definitions.cc:286
@ S
Definition: quadtree.h:62
return type specifically for fuctions returning k and disp at once
Definition: FormulaHelpers.h:17