UnxBoucWen3DLink.hpp

Go to the documentation of this file.

//==============================================================================
//
//                       Seismo Virtual Laboratory
//             Module for Serial and Parallel Analysis of seismic 
//         wave propagation and soil-structure interaction simulation
//         Copyright (C) 2018-2021, The California Institute of Technology
//                         All Rights Reserved.
//
// Commercial use of this program without express permission of the California
// Institute of Technology, is strictly  prohibited. See  file "COPYRIGHT"  in
// main  directory  for  information on  usage  and  redistribution, and for a
// DISCLAIMER OF ALL WARRANTIES.
//
//==============================================================================
//
// Written by:
//   Danilo S. Kusanovic (dkusanov@caltech.edu)
//   Elnaz E. Seylabi    (elnaze@unr.edu)
//
// Supervised by:
//   Domniki M. Asimaki  (domniki@caltech.edu)
//
// References   : 
//  [1] Bouc, R. (1971). "Mathematical model for hysteresis." Report to the Centre 
//      de Recherches Physiques, pp16-25, Marseille, France.
//  [2] Wen, Y.-K. (1976). \Method for random vibration of hysteretic systems." 
//      Journal of Engineering Mechanics Division, 102(EM2), 249-263. 
//
// Description:
//------------------------------------------------------------------------------

#ifndef _UNXBOUCWEN3DLINK_HPP_
#define _UNXBOUCWEN3DLINK_HPP_

#include <map>
#include <memory>
#include <string>
#include <Eigen/Dense>

#include "Node.hpp"
#include "Load.hpp"
#include "Material.hpp"
#include "Element.hpp"
#include "Damping.hpp"

class UnxBoucWen3DLink : public Element{

    public:
        UnxBoucWen3DLink(const std::vector<unsigned int> nodes, std::vector<double> parameters, std::vector<double> variables, const unsigned int dim, const unsigned int dir, double tol=1E-06, unsigned int nmax=50);

        ~UnxBoucWen3DLink();

        void CommitState();

        void ReverseState();

        void InitialState();

        void UpdateState();

        void SetDomain(std::map<unsigned int, std::shared_ptr<Node> > &nodes);

        void SetDamping(const std::shared_ptr<Damping> &damping);

        std::vector<unsigned int> GetTotalDegreeOfFreedom() const;

        Eigen::MatrixXd GetStrain() const;

        Eigen::MatrixXd GetStress() const;

        Eigen::MatrixXd GetStrainRate() const;

        Eigen::MatrixXd GetStrainAt(double x3, double x2) const;

        Eigen::MatrixXd GetStressAt(double x3, double x2) const;

        Eigen::VectorXd GetVTKResponse(std::string response) const;

        double ComputeEnergy();

        Eigen::MatrixXd ComputeMassMatrix();

        Eigen::MatrixXd ComputeStiffnessMatrix();

        Eigen::MatrixXd ComputeDampingMatrix();

        Eigen::MatrixXd ComputePMLMatrix();

        Eigen::VectorXd ComputeInternalForces();

        Eigen::VectorXd ComputeInternalDynamicForces();

        Eigen::VectorXd ComputeSurfaceForces(const std::shared_ptr<Load> &surface, unsigned int face);

        Eigen::VectorXd ComputeBodyForces(const std::shared_ptr<Load> &body, unsigned int k=0);

        Eigen::VectorXd ComputeDomainReductionForces(const std::shared_ptr<Load> &drm, unsigned int k);

    private:
        double Ko;

        double Fy;

        double alpha;

        double eta;

        double beta;

        double gamma;

        double Tol;

        double z;

        double zn;

        double U;

        double Un;

        double qbw;

        double qbc;

        double kbw;

        double kbc;

        unsigned int nMax;

        unsigned int Dimension;

        unsigned int Direction;
    
        std::vector<std::shared_ptr<Node> > theNodes;

        double sign(double x) const;

        Eigen::VectorXd ComputeRelativeDeformation() const;
    
        Eigen::MatrixXd ComputeLocalAxes() const;

        Eigen::MatrixXd ComputeRotationMatrix() const;
};

#endif