OOFEM 3.0
Loading...
Searching...
No Matches
rankinemat.h
Go to the documentation of this file.
1/*
2 *
3 * ##### ##### ###### ###### ### ###
4 * ## ## ## ## ## ## ## ### ##
5 * ## ## ## ## #### #### ## # ##
6 * ## ## ## ## ## ## ## ##
7 * ## ## ## ## ## ## ## ##
8 * ##### ##### ## ###### ## ##
9 *
10 *
11 * OOFEM : Object Oriented Finite Element Code
12 *
13 * Copyright (C) 1993 - 2025 Borek Patzak
14 *
15 *
16 *
17 * Czech Technical University, Faculty of Civil Engineering,
18 * Department of Structural Mechanics, 166 29 Prague, Czech Republic
19 *
20 * This library is free software; you can redistribute it and/or
21 * modify it under the terms of the GNU Lesser General Public
22 * License as published by the Free Software Foundation; either
23 * version 2.1 of the License, or (at your option) any later version.
24 *
25 * This program is distributed in the hope that it will be useful,
26 * but WITHOUT ANY WARRANTY; without even the implied warranty of
27 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
28 * Lesser General Public License for more details.
29 *
30 * You should have received a copy of the GNU Lesser General Public
31 * License along with this library; if not, write to the Free Software
32 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
33 */
34
35#ifndef rankinemat_h
36#define rankinemat_h
37
41#include "dictionary.h"
42#include "floatarray.h"
43#include "floatmatrix.h"
44
45// this turns on or off a bunch of internal variables
46// that allow tracking the distribution of dissipated energy
47// (can be turned off if such information is not needed)
48#define keep_track_of_dissipated_energy
49//#undefine keep_track_of_dissipated_energy
50
52
53#define _IFT_RankineMat_Name "rankmat"
54#define _IFT_RankineMat_sig0 "sig0"
55#define _IFT_RankineMat_h "h"
56#define _IFT_RankineMat_a "a"
57#define _IFT_RankineMat_plasthardtype "plasthardtype"
58#define _IFT_RankineMat_delsigy "delsigy"
59#define _IFT_RankineMat_yieldtol "yieldtol"
60#define _IFT_RankineMat_gf "gf"
61#define _IFT_RankineMat_ep "ep"
62#define _IFT_RankineMat_damlaw "damlaw"
63#define _IFT_RankineMat_param1 "param1"
64#define _IFT_RankineMat_param2 "param2"
65#define _IFT_RankineMat_param3 "param3"
66#define _IFT_RankineMat_param4 "param4"
67#define _IFT_RankineMat_param5 "param5"
69
70namespace oofem {
71class RankineMatStatus;
72
86{
87protected:
90
92 double E = 0.;
93
95 double nu = 0.;
96
98 double H0 = 0.;
99
102
104 double delSigY = 0.;
105
107 double sig0 = 0.;
108
110 double yieldtol = 0.;
111
113 double a = 0.;
114
116 double ep = 0.;
117
119 double md = 0.;
120
122 int damlaw = 1;
123
125 double param1 = 0.;
126
128 double param2 = 0.;
129
131 double param3 = 0.;
132
134 double param4 = 0.;
135
137 double param5 = 0.;
138
139
140public:
141 RankineMat(int n, Domain * d);
142
143 double evalYieldFunction(const FloatArray &sigPrinc, const double kappa) const;
144 double evalYieldStress(const double kappa) const;
145 double evalPlasticModulus(const double kappa) const;
146 void performPlasticityReturn(GaussPoint *gp, const FloatArray &totalStrain) const;
147 double computeDamage(GaussPoint *gp, TimeStep *tStep) const;
148 double computeDamageParam(double tempKappa) const;
149 double computeDamageParamPrime(double tempKappa) const;
150 virtual double computeCumPlastStrain(GaussPoint *gp, TimeStep *tStep) const;
151
152 bool hasMaterialModeCapability(MaterialMode mode) const override;
153
154 void initializeFrom(InputRecord &ir) override;
155
156 // identification and auxiliary functions
157 const char *giveInputRecordName() const override { return _IFT_RankineMat_Name; }
158 const char *giveClassName() const override { return "RankineMat"; }
159
162
163 bool isCharacteristicMtrxSymmetric(MatResponseMode rMode) const override { return ( a == 0. ); }
164
165 std::unique_ptr<MaterialStatus> CreateStatus(GaussPoint *gp) const override;
166
167 FloatArrayF<3> giveRealStressVector_PlaneStress(const FloatArrayF<3> &reducesStrain, GaussPoint *gp, TimeStep *tStep) const override;
168 FloatArrayF<1> giveRealStressVector_1d(const FloatArrayF<1> &totalStrain, GaussPoint *gp, TimeStep *tStep) const override;
169
170 FloatMatrixF<1,1> give1dStressStiffMtrx(MatResponseMode mode, GaussPoint *gp, TimeStep *tStep) const override;
171 FloatMatrixF<3,3> givePlaneStressStiffMtrx(MatResponseMode mode, GaussPoint *gp, TimeStep *tStep) const override;
172
173protected:
179 TimeStep *tStep, double gprime) const;
180
182 void computeEta(FloatArray &answer, RankineMatStatus *status);
183
184 int giveIPValue(FloatArray &answer, GaussPoint *gp, InternalStateType type, TimeStep *tStep) override;
185};
186
187//=============================================================================
188
189
191{
192protected:
195
198
201
204
206 double kappa = 0.;
207
209 double tempKappa = 0.;
210
216 double dKappa1 = 0., dKappa2 = 0.;
217
219 double damage = 0.;
220
222 double tempDamage = 0.;
223
225 double tanG = 0.;
226
227#ifdef keep_track_of_dissipated_energy
229 double stressWork = 0.;
231 double tempStressWork = 0.;
233 double dissWork = 0.;
235 double tempDissWork = 0.;
236#endif
237
238public:
240
241 const FloatArray & givePlasticStrain() const { return plasticStrain; }
242
243 double giveDamage() const { return damage; }
244 double giveTempDamage() const { return tempDamage; }
245
246 double giveCumulativePlasticStrain() const { return kappa; }
248
249 double giveDKappa(int i) const
250 {
251 if ( i == 1 ) {
252 return dKappa1;
253 } else {
254 return dKappa2;
255 }
256 }
257
259 { return tanG; }
260
261 const FloatArray &giveEffectiveStress() const { return effStress; }
263
264 void letTempPlasticStrainBe(FloatArray values) { tempPlasticStrain = std :: move(values); }
265
266 void letEffectiveStressBe(FloatArray values) { effStress = std :: move(values); }
267
268 void letTempEffectiveStressBe(FloatArray values) { tempEffStress = std :: move(values); }
269
270 void setTempCumulativePlasticStrain(double value) { tempKappa = value; }
271
272 void setDKappa(double val1, double val2) {
273 dKappa1 = val1;
274 dKappa2 = val2;
275 }
276
277 void setTempDamage(double value) { tempDamage = value; }
278
279 void setTangentShearStiffness(double value) { tanG = value; }
280
282
283 void printOutputAt(FILE *file, TimeStep *tStep) const override;
284
285 void initTempStatus() override;
286 void updateYourself(TimeStep *tStep) override;
287
288 void saveContext(DataStream &stream, ContextMode mode) override;
289 void restoreContext(DataStream &stream, ContextMode mode) override;
290
291#ifdef keep_track_of_dissipated_energy
293 double giveStressWork() { return stressWork; }
297 void setTempStressWork(double w) { tempStressWork = w; }
299 double giveDissWork() { return dissWork; }
301 double giveTempDissWork() { return tempDissWork; }
303 void setTempDissWork(double w) { tempDissWork = w; }
311 void computeWork_PlaneStress(GaussPoint *gp, double gf);
312 void computeWork_1d(GaussPoint *gp, double gf);
313#endif
314
315 const char *giveClassName() const override { return "RankineMatStatus"; }
316};
317} // end namespace oofem
318#endif // rankinemat_h
GaussPoint * gp
Associated integration point.
void computeWork_PlaneStress(GaussPoint *gp, double gf)
Definition rankinemat.C:820
FloatArray tempEffStress
Effective stress (final).
Definition rankinemat.h:203
void initTempStatus() override
Definition rankinemat.C:723
double giveTempDamage() const
Definition rankinemat.h:244
double tempStressWork
Non-equilibrated density of total work done by stresses on strain increments.
Definition rankinemat.h:231
FloatArray tempPlasticStrain
Plastic strain (final).
Definition rankinemat.h:197
double giveStressWork()
Returns the density of total work of stress on strain increments.
Definition rankinemat.h:293
void setTangentShearStiffness(double value)
Definition rankinemat.h:279
void saveContext(DataStream &stream, ContextMode mode) override
Definition rankinemat.C:759
void setTempDissWork(double w)
Sets the density of dissipated work to given value.
Definition rankinemat.h:303
FloatArray plasticStrain
Plastic strain (initial).
Definition rankinemat.h:194
double giveDamage() const
Definition rankinemat.h:243
void setTempDamage(double value)
Definition rankinemat.h:277
void letEffectiveStressBe(FloatArray values)
Definition rankinemat.h:266
double tempKappa
Cumulative plastic strain (final).
Definition rankinemat.h:209
double giveTempCumulativePlasticStrain() const
Definition rankinemat.h:247
const char * giveClassName() const override
Definition rankinemat.h:315
void updateYourself(TimeStep *tStep) override
Definition rankinemat.C:744
void setTempStressWork(double w)
Sets the density of total work of stress on strain increments to given value.
Definition rankinemat.h:297
double giveTempDissWork()
Returns the density of temp dissipated work.
Definition rankinemat.h:301
const FloatArray & giveTempEffectiveStress() const
Definition rankinemat.h:262
double giveTangentShearStiffness()
Definition rankinemat.h:258
const FloatArray & givePlasticStrain() const
Definition rankinemat.h:241
double tempDamage
Damage (final).
Definition rankinemat.h:222
const FloatArray & givePlasDef()
Definition rankinemat.h:281
double giveDKappa(int i) const
Definition rankinemat.h:249
double tempDissWork
Non-equilibrated density of dissipated work.
Definition rankinemat.h:235
const FloatArray & giveEffectiveStress() const
Definition rankinemat.h:261
void letTempEffectiveStressBe(FloatArray values)
Definition rankinemat.h:268
double giveTempStressWork()
Returns the temp density of total work of stress on strain increments.
Definition rankinemat.h:295
void setTempCumulativePlasticStrain(double value)
Definition rankinemat.h:270
double stressWork
Density of total work done by stresses on strain increments.
Definition rankinemat.h:229
void letTempPlasticStrainBe(FloatArray values)
Definition rankinemat.h:264
double kappa
Cumulative plastic strain (initial).
Definition rankinemat.h:206
double giveCumulativePlasticStrain() const
Definition rankinemat.h:246
double damage
Damage (initial).
Definition rankinemat.h:219
RankineMatStatus(GaussPoint *g)
Definition rankinemat.C:676
double giveDissWork()
Returns the density of dissipated work.
Definition rankinemat.h:299
void computeWork_1d(GaussPoint *gp, double gf)
Definition rankinemat.C:848
void setDKappa(double val1, double val2)
Definition rankinemat.h:272
void printOutputAt(FILE *file, TimeStep *tStep) const override
Print receiver's output to given stream.
Definition rankinemat.C:693
void restoreContext(DataStream &stream, ContextMode mode) override
Definition rankinemat.C:789
FloatArray effStress
Effective stress (initial).
Definition rankinemat.h:200
double tanG
Tangent shear stiffness (needed for tangent matrix).
Definition rankinemat.h:225
double dissWork
Density of dissipated work.
Definition rankinemat.h:233
void initializeFrom(InputRecord &ir) override
Definition rankinemat.C:68
virtual double computeCumPlastStrain(GaussPoint *gp, TimeStep *tStep) const
Definition rankinemat.C:467
LinearElasticMaterial * giveLinearElasticMaterial()
Returns a reference to the basic elastic material.
Definition rankinemat.h:161
double param3
coefficient required when damlaw=2
Definition rankinemat.h:131
double a
Parameter that controls damage evolution (a=0 turns damage off).
Definition rankinemat.h:113
double H0
Initial hardening modulus.
Definition rankinemat.h:98
double evalYieldStress(const double kappa) const
Definition rankinemat.C:218
double computeDamage(GaussPoint *gp, TimeStep *tStep) const
Definition rankinemat.C:454
double md
Exponent in hardening law–Used only if plasthardtype=2.
Definition rankinemat.h:119
LinearElasticMaterial * linearElasticMaterial
Reference to the basic elastic material.
Definition rankinemat.h:89
double computeDamageParamPrime(double tempKappa) const
Definition rankinemat.C:435
double param1
coefficient required when damlaw=1 or 2
Definition rankinemat.h:125
int giveIPValue(FloatArray &answer, GaussPoint *gp, InternalStateType type, TimeStep *tStep) override
Definition rankinemat.C:624
double ep
Total strain at peak stress sig0–Used only if plasthardtype=2.
Definition rankinemat.h:116
FloatMatrixF< 3, 3 > givePlaneStressStiffMtrx(MatResponseMode mode, GaussPoint *gp, TimeStep *tStep) const override
Definition rankinemat.C:475
double yieldtol
Relative tolerance in yield condition.
Definition rankinemat.h:110
std::unique_ptr< MaterialStatus > CreateStatus(GaussPoint *gp) const override
Definition rankinemat.C:146
double delSigY
Final increment of yield stress (at infinite cumulative plastic strain).
Definition rankinemat.h:104
double evalPlasticModulus(const double kappa) const
Definition rankinemat.C:241
FloatArrayF< 3 > giveRealStressVector_PlaneStress(const FloatArrayF< 3 > &reducesStrain, GaussPoint *gp, TimeStep *tStep) const override
Default implementation relies on giveRealStressVector_StressControl.
Definition rankinemat.C:182
int damlaw
type of damage law (0=exponential, 1=exponential and damage starts after peak stress sig0)
Definition rankinemat.h:122
double param5
coefficient required when damlaw=2
Definition rankinemat.h:137
int plasthardtype
Type of plastic hardening (0=linear, 1=exponential).
Definition rankinemat.h:101
const char * giveClassName() const override
Definition rankinemat.h:158
RankineMat(int n, Domain *d)
Definition rankinemat.C:52
bool hasMaterialModeCapability(MaterialMode mode) const override
Definition rankinemat.C:60
double evalYieldFunction(const FloatArray &sigPrinc, const double kappa) const
Definition rankinemat.C:211
FloatArrayF< 1 > giveRealStressVector_1d(const FloatArrayF< 1 > &totalStrain, GaussPoint *gp, TimeStep *tStep) const override
Default implementation relies on giveRealStressVector_StressControl.
Definition rankinemat.C:154
FloatMatrixF< 3, 3 > evaluatePlaneStressStiffMtrx(MatResponseMode mode, GaussPoint *gp, TimeStep *tStep, double gprime) const
Definition rankinemat.C:502
double sig0
Initial (uniaxial) yield stress.
Definition rankinemat.h:107
const char * giveInputRecordName() const override
Definition rankinemat.h:157
double param4
coefficient required when damlaw=2
Definition rankinemat.h:134
void computeEta(FloatArray &answer, RankineMatStatus *status)
Computes derivatives of final kappa with respect to final strain.
Definition rankinemat.C:587
FloatMatrixF< 1, 1 > give1dStressStiffMtrx(MatResponseMode mode, GaussPoint *gp, TimeStep *tStep) const override
Definition rankinemat.C:486
double param2
coefficient required when damlaw=1 or 2
Definition rankinemat.h:128
double nu
Poisson's ratio.
Definition rankinemat.h:95
double E
Young's modulus.
Definition rankinemat.h:92
bool isCharacteristicMtrxSymmetric(MatResponseMode rMode) const override
Definition rankinemat.h:163
double computeDamageParam(double tempKappa) const
Definition rankinemat.C:416
void performPlasticityReturn(GaussPoint *gp, const FloatArray &totalStrain) const
Definition rankinemat.C:263
StructuralMaterialStatus(GaussPoint *g)
Constructor. Creates new StructuralMaterialStatus with IntegrationPoint g.
StructuralMaterial(int n, Domain *d)
long ContextMode
Definition contextmode.h:43
#define _IFT_RankineMat_Name
Definition rankinemat.h:53

This page is part of the OOFEM-3.0 documentation. Copyright Copyright (C) 1994-2025 Borek Patzak Bořek Patzák
Project e-mail: oofem@fsv.cvut.cz
Generated at for OOFEM by doxygen 1.15.0 written by Dimitri van Heesch, © 1997-2011