Seismo-VLAB  1.3
An Open-Source Finite Element Software for Meso-Scale Simulations
lin3DTetra10.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] Finite Element Procedures, Bathe, K.J., Chapter 5: pages 371-376.
25 // Prentice-Hall, 1996.
26 //
27 // Description:
30 //------------------------------------------------------------------------------
31 
32 #ifndef _LIN3DTETRA10_HPP_
33 #define _LIN3DTETRA10_HPP_
34 
35 #include <map>
36 #include <memory>
37 #include <string>
38 #include <Eigen/Dense>
39 
40 #include "Node.hpp"
41 #include "Load.hpp"
42 #include "Material.hpp"
43 #include "Element.hpp"
44 #include "Damping.hpp"
45 #include "QuadratureRule.hpp"
46 
54 class lin3DTetra10 : public Element{
55 
56  public:
64  lin3DTetra10(const std::vector<unsigned int> nodes, std::unique_ptr<Material> &material, const std::string quadrature="GAUSS", const unsigned int nGauss=8);
65 
67  ~lin3DTetra10();
68 
71  void CommitState();
72 
75  void ReverseState();
76 
79  void InitialState();
80 
83  void UpdateState();
84 
89  void SetDomain(std::map<unsigned int, std::shared_ptr<Node> > &nodes);
90 
94  void SetDamping(const std::shared_ptr<Damping> &damping);
95 
98  std::vector<unsigned int> GetTotalDegreeOfFreedom() const;
99 
103  Eigen::MatrixXd GetStrain() const;
104 
108  Eigen::MatrixXd GetStress() const;
109 
113  Eigen::MatrixXd GetStrainRate() const;
114 
120  Eigen::MatrixXd GetStrainAt(double x3, double x2) const;
121 
127  Eigen::MatrixXd GetStressAt(double x3, double x2) const;
128 
133  Eigen::VectorXd GetVTKResponse(std::string response) const;
134 
137  double ComputeEnergy();
138 
143  Eigen::MatrixXd ComputeMassMatrix();
144 
149  Eigen::MatrixXd ComputeStiffnessMatrix();
150 
155  Eigen::MatrixXd ComputeDampingMatrix();
156 
161  Eigen::MatrixXd ComputePMLMatrix();
162 
167  Eigen::VectorXd ComputeInternalForces();
168 
173  Eigen::VectorXd ComputeInternalDynamicForces();
174 
181  Eigen::VectorXd ComputeSurfaceForces(const std::shared_ptr<Load> &surface, unsigned int face);
182 
189  Eigen::VectorXd ComputeBodyForces(const std::shared_ptr<Load> &body, unsigned int k=0);
190 
197  Eigen::VectorXd ComputeDomainReductionForces(const std::shared_ptr<Load> &drm, unsigned int k);
198 
199  private:
201  std::shared_ptr<Damping> theDamping;
202 
204  std::vector<std::shared_ptr<Node> > theNodes;
205 
207  std::vector<std::unique_ptr<Material> > theMaterial;
208 
210  std::unique_ptr<QuadratureRule> QuadraturePoints;
211 
215  Eigen::VectorXd ComputeStrain(const Eigen::MatrixXd &Bij) const;
216 
220  Eigen::VectorXd ComputeStrainRate(const Eigen::MatrixXd &Bij) const;
221 
227  Eigen::MatrixXd ComputeJacobianMatrix(const double ri, const double si, const double ti) const;
228 
234  Eigen::MatrixXd ComputeShapeFunctionMatrix(const double ri, const double si, const double ti) const;
235 
242  Eigen::MatrixXd ComputeStrainDisplacementMatrix(const double ri, const double si, const double ti, const Eigen::MatrixXd &Jij) const;
243 
247  Eigen::MatrixXd ComputeInitialStiffnessMatrix() const;
248 };
249 
250 #endif
Eigen::VectorXd ComputeDomainReductionForces(const std::shared_ptr< Load > &drm, unsigned int k)
Compute the domain reduction forces acting on the element.
This file contains the "Load" class declarations, which defines a load that can act in a node or an e...
std::unique_ptr< QuadratureRule > QuadraturePoints
Coordinate of Gauss points.
Definition: lin3DTetra10.hpp:210
Eigen::MatrixXd ComputeJacobianMatrix(const double ri, const double si, const double ti) const
Computes the jacobian of the transformation.
void UpdateState()
Update the material states in the element.
double ComputeEnergy()
Computes the element energy for a given deformation.
std::vector< unsigned int > GetTotalDegreeOfFreedom() const
Gets the list of total-degree of freedom of this Element.
void InitialState()
Brings the material/section state to its initial state in this element.
lin3DTetra10(const std::vector< unsigned int > nodes, std::unique_ptr< Material > &material, const std::string quadrature="GAUSS", const unsigned int nGauss=8)
Creates a lin3DTetra10 in a finite element Mesh.
This file contains the abstract "Material object" declarations, which computes the strain...
Eigen::VectorXd ComputeInternalDynamicForces()
Compute the elastic, inertial, and viscous forces acting on 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.
std::vector< std::unique_ptr< Material > > theMaterial
The Element&#39;s material.
Definition: lin3DTetra10.hpp:207
Eigen::MatrixXd GetStressAt(double x3, double x2) const
Gets the material stress in section at coordinate (x3,x2).
void SetDamping(const std::shared_ptr< Damping > &damping)
Sets the damping model.
Eigen::MatrixXd ComputeDampingMatrix()
Compute the damping matrix of the element using gauss-integration.
Eigen::MatrixXd GetStrainAt(double x3, double x2) const
Gets the material strain in section at coordinate (x3,x2).
Class for creating a 3D linearized eight-node hexahedron element in a mesh.
Definition: lin3DTetra10.hpp:54
Eigen::MatrixXd GetStress() const
Gets the material/section (generalised) stress.
~lin3DTetra10()
Destroys this lin3DTetra10 object.
Virtual class for creating an element in a mesh.
Definition: Element.hpp:51
Eigen::MatrixXd ComputeStrainDisplacementMatrix(const double ri, const double si, const double ti, const Eigen::MatrixXd &Jij) const
Evaluates the strain-displacement matrix at a given Gauss point.
void ReverseState()
Reverse the material/section states to previous converged state in this element.
Eigen::VectorXd ComputeBodyForces(const std::shared_ptr< Load > &body, unsigned int k=0)
Compute the body forces acting on the element.
Eigen::VectorXd ComputeStrain(const Eigen::MatrixXd &Bij) const
Update strain in the element.
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-...
std::shared_ptr< Damping > theDamping
The Damping model.
Definition: lin3DTetra10.hpp:201
Eigen::MatrixXd GetStrainRate() const
Gets the material/section (generalised) strain-rate.
Eigen::MatrixXd ComputeShapeFunctionMatrix(const double ri, const double si, const double ti) const
Evaluates the shape function matrix at a given Gauss point.
void CommitState()
Save the material states in the element.
Eigen::MatrixXd ComputePMLMatrix()
Compute the PML history matrix using gauss-integration.
Eigen::VectorXd GetVTKResponse(std::string response) const
Gets the element internal response in VTK format for Paraview display.
Eigen::MatrixXd ComputeMassMatrix()
Compute the lumped/consistent mass matrix of the element.
Eigen::MatrixXd GetStrain() const
Gets the material/section (generalised) strain.
void SetDomain(std::map< unsigned int, std::shared_ptr< Node > > &nodes)
Sets the finite element dependance among objects.
This file contains the abstract "Quadrature Rule" declarations to integrate quantities in the iso-par...
Eigen::MatrixXd ComputeInitialStiffnessMatrix() const
Compute the stiffness matrix of the element using gauss-integration.
std::vector< std::shared_ptr< Node > > theNodes
The Element&#39;s Nodes.
Definition: lin3DTetra10.hpp:204
Eigen::VectorXd ComputeStrainRate(const Eigen::MatrixXd &Bij) const
Update strain rate in the element.
This file contains the "Element" object declarations, which defines an element in a finite element me...
Eigen::VectorXd ComputeSurfaceForces(const std::shared_ptr< Load > &surface, unsigned int face)
Compute the surface forces acting on the element.