Seismo-VLAB  1.3
An Open-Source Finite Element Software for Meso-Scale Simulations
TIEQlin2DQuad4.hpp
Go to the documentation of this file.
1 //==============================================================================
2 //
3 // Seismo Virtual Laboratory
4 // Module for Serial and Parallel Analysis of seismic
5 // wave propagation and soil-structure interaction simulation
6 // Copyright (C) 2018-2021, The California Institute of Technology
7 // All Rights Reserved.
8 //
9 // Commercial use of this program without express permission of the California
10 // Institute of Technology, is strictly prohibited. See file "COPYRIGHT" in
11 // main directory for information on usage and redistribution, and for a
12 // DISCLAIMER OF ALL WARRANTIES.
13 //
14 //==============================================================================
15 //
16 // Written by:
17 // Danilo S. Kusanovic (dkusanov@caltech.edu)
18 // Elnaz E. Seylabi (elnaze@unr.edu)
19 //
20 // Supervised by:
21 // Domniki M. Asimaki (domniki@caltech.edu)
22 //
23 // References :
24 // [1] M. Darendeli (2001), Development of a new family of normalized modulus
25 // reduction and material damping curves
26 // [2] J. Shi & D. Asimaki (2017), From stiffness to strength: Formulation and
27 // validation of a hybrid hyperbolic nonlinear soil model for siteā€response
28 // analyses
29 //
30 // Description:
33 //------------------------------------------------------------------------------
34 
35 #ifndef _TIEQLIN2DQUAD4_HPP_
36 #define _TIEQLIN2DQUAD4_HPP_
37 
38 #include <map>
39 #include <memory>
40 #include <string>
41 #include <Eigen/Dense>
42 
43 #include "Node.hpp"
44 #include "Load.hpp"
45 #include "Material.hpp"
46 #include "Element.hpp"
47 #include "Damping.hpp"
48 #include "QuadratureRule.hpp"
49 
57 class TIEQlin2DQuad4 : public Element{
58 
59  public:
73  TIEQlin2DQuad4(const std::vector<unsigned int> nodes, std::unique_ptr<Material> &material, const double th, const std::string quadrature="GAUSS", const unsigned int nGauss=4, const std::string Type="DARENDELI", const double zref=0.0, const double cf1=0.0, const double cf2=0.0, const double eref=0.0);
74 
77 
80  void CommitState();
81 
84  void ReverseState();
85 
88  void InitialState();
89 
92  void UpdateState();
93 
98  void SetDomain(std::map<unsigned int, std::shared_ptr<Node> > &nodes);
99 
103  void SetDamping(const std::shared_ptr<Damping> &damping);
104 
107  std::vector<unsigned int> GetTotalDegreeOfFreedom() const;
108 
112  Eigen::MatrixXd GetStrain() const;
113 
117  Eigen::MatrixXd GetStress() const;
118 
122  Eigen::MatrixXd GetStrainRate() const;
123 
129  Eigen::MatrixXd GetStrainAt(double x3, double x2) const;
130 
136  Eigen::MatrixXd GetStressAt(double x3, double x2) const;
137 
142  Eigen::VectorXd GetVTKResponse(std::string response) const;
143 
146  double ComputeEnergy();
147 
152  Eigen::MatrixXd ComputeMassMatrix();
153 
158  Eigen::MatrixXd ComputeStiffnessMatrix();
159 
164  Eigen::MatrixXd ComputeDampingMatrix();
165 
170  Eigen::MatrixXd ComputePMLMatrix();
171 
176  Eigen::VectorXd ComputeInternalForces();
177 
182  Eigen::VectorXd ComputeInternalDynamicForces();
183 
190  Eigen::VectorXd ComputeSurfaceForces(const std::shared_ptr<Load> &surface, unsigned int face);
191 
198  Eigen::VectorXd ComputeBodyForces(const std::shared_ptr<Load> &body, unsigned int k=0);
199 
206  Eigen::VectorXd ComputeDomainReductionForces(const std::shared_ptr<Load> &drm, unsigned int k);
207 
208  private:
210  double t;
211 
213  double cf1;
214 
216  double cf2;
217 
219  double zref;
220 
222  double eref;
223 
225  std::string Type;
226 
228  std::shared_ptr<Damping> theDamping;
229 
231  std::vector<std::shared_ptr<Node> > theNodes;
232 
234  std::vector<std::unique_ptr<Material> > theMaterial;
235 
237  std::unique_ptr<QuadratureRule> QuadraturePoints;
238 
242  Eigen::VectorXd ComputeStrain(const Eigen::MatrixXd &Bij) const;
243 
247  Eigen::VectorXd ComputeStrainRate(const Eigen::MatrixXd &Bij) const;
248 
253  Eigen::MatrixXd ComputeJacobianMatrix(const double ri, const double si) const;
254 
259  Eigen::MatrixXd ComputeShapeFunctionMatrix(const double ri, const double si) const;
260 
266  Eigen::MatrixXd ComputeStrainDisplacementMatrix(const double ri, const double si, const Eigen::MatrixXd &Jij) const;
267 
273  Eigen::VectorXd ComputeGGmaxDamping(const double vs, const double z, const double rho) const;
274 };
275 
276 #endif
Eigen::VectorXd ComputeDomainReductionForces(const std::shared_ptr< Load > &drm, unsigned int k)
Compute the domain reduction forces acting on the element.
double ComputeEnergy()
Computes the element energy for a given deformation.
Eigen::MatrixXd ComputeStrainDisplacementMatrix(const double ri, const double si, const Eigen::MatrixXd &Jij) const
Evaluates the strain-displacement matrix at a given Gauss point.
std::vector< std::unique_ptr< Material > > theMaterial
The Element&#39;s material.
Definition: TIEQlin2DQuad4.hpp:234
Eigen::VectorXd ComputeInternalDynamicForces()
Compute the elastic, inertial, and viscous forces acting on the element.
~TIEQlin2DQuad4()
Destroys this TIEQlin2DQuad4 object.
std::unique_ptr< QuadratureRule > QuadraturePoints
Coordinate of Gauss points.
Definition: TIEQlin2DQuad4.hpp:237
This file contains the "Load" class declarations, which defines a load that can act in a node or an e...
double t
Element thickness.
Definition: TIEQlin2DQuad4.hpp:210
Eigen::MatrixXd ComputePMLMatrix()
Compute the PML history matrix using gauss-integration.
void SetDomain(std::map< unsigned int, std::shared_ptr< Node > > &nodes)
Sets the finite element dependance among objects.
std::vector< unsigned int > GetTotalDegreeOfFreedom() const
Gets the list of total-degree of freedom of this Element.
std::shared_ptr< Damping > theDamping
The Damping model.
Definition: TIEQlin2DQuad4.hpp:228
Eigen::MatrixXd ComputeShapeFunctionMatrix(const double ri, const double si) const
Evaluates the shape function matrix at a given Gauss point.
This file contains the abstract "Material object" declarations, which computes the strain...
double cf2
Upper corner frequencies for damping.
Definition: TIEQlin2DQuad4.hpp:216
std::vector< std::shared_ptr< Node > > theNodes
The Element&#39;s Nodes.
Definition: TIEQlin2DQuad4.hpp:231
Eigen::VectorXd ComputeSurfaceForces(const std::shared_ptr< Load > &surface, unsigned int face)
Compute the surface forces acting on the element.
Eigen::MatrixXd GetStrainAt(double x3, double x2) const
Gets the material strain in section at coordinate (x3,x2).
Class for creating a 2D time invariant equivalent linear four-node quadrilateral element in a mesh...
Definition: TIEQlin2DQuad4.hpp:57
double eref
Reference shear strain metric to read G/Gmax and damping curves.
Definition: TIEQlin2DQuad4.hpp:222
Eigen::VectorXd ComputeStrain(const Eigen::MatrixXd &Bij) const
Update strain in the element.
Eigen::MatrixXd ComputeDampingMatrix()
Compute the damping matrix of the element using gauss-integration.
void ReverseState()
Reverse the material/section states to previous converged state in this element.
Eigen::VectorXd ComputeGGmaxDamping(const double vs, const double z, const double rho) const
Compute GGmax and Damping for nType = 1 ==> equivalent linear model.
void CommitState()
Save the material states in the element.
Eigen::VectorXd ComputeStrainRate(const Eigen::MatrixXd &Bij) const
Update strain rate in the element.
void UpdateState()
Update the material states in the element.
Eigen::MatrixXd ComputeStiffnessMatrix()
Compute the stiffness matrix of the element using gauss-integration.
Eigen::VectorXd ComputeInternalForces()
Compute the internal (elastic) forces acting on the element.
Virtual class for creating an element in a mesh.
Definition: Element.hpp:51
Eigen::VectorXd GetVTKResponse(std::string response) const
Gets the element internal response in VTK format for Paraview display.
This file contains the "Node object" declarations, which is stores the coordinates, state variables, degrees-of-freedom, and total-degree of freedom lists of a node in a finite element mesh.
This file contains the "Damping object" declarations to update damping matrix to account for Caughey-...
void InitialState()
Brings the material/section state to its initial state in this element.
void SetDamping(const std::shared_ptr< Damping > &damping)
Sets the damping model.
std::string Type
Determine the type of modulus reduction and damping curve.
Definition: TIEQlin2DQuad4.hpp:225
Eigen::MatrixXd ComputeMassMatrix()
Compute the lumped/consistent mass matrix of the element.
Eigen::MatrixXd GetStressAt(double x3, double x2) const
Gets the material stress in section at coordinate (x3,x2).
double zref
Reference elevation to compute GGmax and damping.
Definition: TIEQlin2DQuad4.hpp:219
Eigen::MatrixXd GetStress() const
Gets the material/section (generalised) stress.
double cf1
Lower corner frequencies for damping.
Definition: TIEQlin2DQuad4.hpp:213
Eigen::MatrixXd GetStrainRate() const
Gets the material/section (generalised) strain-rate.
Eigen::MatrixXd ComputeJacobianMatrix(const double ri, const double si) const
Computes the jacobian of the transformation.
Eigen::MatrixXd GetStrain() const
Gets the material/section (generalised) strain.
TIEQlin2DQuad4(const std::vector< unsigned int > nodes, std::unique_ptr< Material > &material, const double th, const std::string quadrature="GAUSS", const unsigned int nGauss=4, const std::string Type="DARENDELI", const double zref=0.0, const double cf1=0.0, const double cf2=0.0, const double eref=0.0)
Creates a TIEQlin2DQuad4 in a finite element Mesh.
This file contains the abstract "Quadrature Rule" declarations to integrate quantities in the iso-par...
Eigen::VectorXd ComputeBodyForces(const std::shared_ptr< Load > &body, unsigned int k=0)
Compute the body forces acting on the element.
This file contains the "Element" object declarations, which defines an element in a finite element me...