structuralelement.h

Go to the documentation of this file.

/*
 *
 *                 #####    #####   ######  ######  ###   ###
 *               ##   ##  ##   ##  ##      ##      ## ### ##
 *              ##   ##  ##   ##  ####    ####    ##  #  ##
 *             ##   ##  ##   ##  ##      ##      ##     ##
 *            ##   ##  ##   ##  ##      ##      ##     ##
 *            #####    #####   ##      ######  ##     ##
 *
 *
 *             OOFEM : Object Oriented Finite Element Code
 *
 *               Copyright (C) 1993 - 2025   Borek Patzak
 *
 *
 *
 *       Czech Technical University, Faculty of Civil Engineering,
 *   Department of Structural Mechanics, 166 29 Prague, Czech Republic
 *
 *  This library is free software; you can redistribute it and/or
 *  modify it under the terms of the GNU Lesser General Public
 *  License as published by the Free Software Foundation; either
 *  version 2.1 of the License, or (at your option) any later version.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 *  Lesser General Public License for more details.
 *
 *  You should have received a copy of the GNU Lesser General Public
 *  License along with this library; if not, write to the Free Software
 *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 */
 
#ifndef structuralelement_h
#define structuralelement_h
 
#include "element.h"
#include "matresponsemode.h"
#include "valuemodetype.h"
#include "integrationdomain.h"
#include "dofmantransftype.h"
#include "floatarray.h"
 
#include <memory>
 
namespace oofem {
#define ALL_STRAINS -1
 
class TimeStep;
class Node;
class Material;
class GaussPoint;
class FloatArray;
class IntArray;
class FloatMatrix;
class SparseMtrx; // required by addNonlocalStiffnessContributions declaration
class StructuralCrossSection;
class IDNLMaterial;

class OOFEM_EXPORT StructuralElement : public Element
{
protected:
    std::unique_ptr< FloatArray >initialDisplacements;
 
public:
    StructuralElement(int n, Domain *d);
    virtual ~StructuralElement();
 
    void giveCharacteristicMatrix(FloatMatrix &answer, CharType, TimeStep *tStep) override;
    void giveCharacteristicVector(FloatArray &answer, CharType type, ValueModeType mode, TimeStep *tStep) override;

    virtual void computeMassMatrix(FloatMatrix &answer, TimeStep *tStep);
    virtual void computeLumpedMassMatrix(FloatMatrix &answer, TimeStep *tStep);
    virtual void computeConsistentMassMatrix(FloatMatrix &answer, TimeStep *tStep, double &mass, const double *ipDensity = NULL);
    virtual void giveMassMtrxIntegrationgMask(IntArray &answer) { answer.clear(); }
    virtual void computeStiffnessMatrix(FloatMatrix &answer, MatResponseMode rMode, TimeStep *tStep);
    void computeStiffnessMatrix_withIRulesAsSubcells(FloatMatrix &answer, MatResponseMode rMode, TimeStep *tStep);

    virtual void computeInitialStressMatrix(FloatMatrix &answer, TimeStep *tStep)
    {
        OOFEM_ERROR("not implemented");
    }

    virtual void computeLumpedInitialStressMatrix(FloatMatrix &answer, TimeStep *tStep) {}
 
    void computeField(ValueModeType mode, TimeStep *tStep, const FloatArray &lcoords, FloatArray &answer) override;
 
    // stress equivalent vector in nodes (vector of internal forces)
    // - mainly for nonLinear Analysis.
    virtual void giveInternalForcesVector(FloatArray &answer, TimeStep *tStep, int useUpdatedGpRecord = 0);

    virtual void giveInternalForcesVector_withIRulesAsSubcells(FloatArray &answer,
                                                               TimeStep *tStep, int useUpdatedGpRecord = 0);

    virtual void computeStrainVector(FloatArray &answer, GaussPoint *gp, TimeStep *tStep);
 
    int giveIPValue(FloatArray &answer, GaussPoint *gp, InternalStateType type, TimeStep *tStep) override;
    virtual void computeResultingIPTemperatureAt(FloatArray &answer, TimeStep *tStep, GaussPoint *gp, ValueModeType mode);
    virtual void computeResultingIPEigenstrainAt(FloatArray &answer, TimeStep *tStep, GaussPoint *gp, ValueModeType mode);


    void updateBeforeNonlocalAverage(TimeStep *tStep) override;
    virtual void giveNonlocalLocationArray(IntArray &locationArray, const UnknownNumberingScheme &us);
    virtual void addNonlocalStiffnessContributions(SparseMtrx &dest, const UnknownNumberingScheme &s, TimeStep *tStep);
 
    // Overloaded methods.
    int adaptiveUpdate(TimeStep *tStep) override;
    void updateInternalState(TimeStep *tStep) override;
    void updateYourself(TimeStep *tStep) override;
    int checkConsistency() override;
    void giveInputRecord(DynamicInputRecord &input) override;
    const char *giveClassName() const override { return "StructuralElement"; }
 
#ifdef __OOFEG
    int giveInternalStateAtNode(FloatArray &answer, InternalStateType type, InternalStateMode mode,
                                int node, TimeStep *tStep) override;
    void showSparseMtrxStructure(CharType mtrx, oofegGraphicContext &gc, TimeStep *tStep) override;
    void showExtendedSparseMtrxStructure(CharType mtrx, oofegGraphicContext &gc, TimeStep *tStep) override;
 
#endif
 
    // Interface for body loads applied by Sets:
    void computeLoadVector(FloatArray &answer, BodyLoad *load, CharType type, ValueModeType mode, TimeStep *tStep) override;
    void computeBoundarySurfaceLoadVector(FloatArray &answer, BoundaryLoad *load, int boundary, CharType type, ValueModeType mode, TimeStep *tStep, bool global = true) override;
    void computeBoundaryEdgeLoadVector(FloatArray &answer, BoundaryLoad *load, int boundary, CharType type, ValueModeType mode, TimeStep *tStep, bool global = true) override;
    virtual void computeEdgeNMatrix(FloatMatrix &answer, int boundaryID, const FloatArray &lcoords);
    virtual void computeSurfaceNMatrix(FloatMatrix &answer, int boundaryID, const FloatArray &lcoords);
 

    virtual void computeConstitutiveMatrixAt(FloatMatrix &answer,
                                             MatResponseMode rMode, GaussPoint *gp,
                                             TimeStep *tStep) = 0;

    StructuralCrossSection *giveStructuralCrossSection();
 
    virtual void createMaterialStatus();
 
protected:
 

    virtual void computeBodyLoadVectorAt(FloatArray &answer, Load *load, TimeStep *tStep, ValueModeType mode);


    virtual void computePointLoadVectorAt(FloatArray &answer, Load *load, TimeStep *tStep, ValueModeType mode, bool global = true);

    virtual void giveEdgeDofMapping(IntArray &answer, int iEdge) const { answer.clear(); }
    virtual void giveSurfaceDofMapping(IntArray &answer, int iSurf) const { answer.clear(); }

    virtual double computeEdgeVolumeAround(GaussPoint *gp, int iEdge);
    virtual double computeSurfaceVolumeAround(GaussPoint *gp, int iSurf);
 
    // Global to local element c.s transformation for load vector dofs
    virtual int computeLoadGToLRotationMtrx(FloatMatrix &answer) {
        answer.clear();
        return 0;
    }
 
    // Local edge (LE-local Edge c.s) or surface (LS-local surface c.s) c.s
    // to element local c.s for load vector dofs
    virtual int computeLoadLEToLRotationMatrix(FloatMatrix &answer, int iEdge, GaussPoint *gp) {
        answer.clear();
        return 0;
    }

    virtual int computeLoadLSToLRotationMatrix(FloatMatrix &answer, int iSurf, GaussPoint *gp) {
        answer.clear();
        return 0;
    }

 
public:
    virtual void computeStressVector(FloatArray &answer, const FloatArray &strain, GaussPoint *gp, TimeStep *tStep) = 0;

    virtual void computeBmatrixAt(GaussPoint *gp, FloatMatrix &answer,
                                  int lowerIndx = 1, int upperIndx = ALL_STRAINS) = 0;

    virtual void computeNmatrixAt(const FloatArray &iLocCoord, FloatMatrix &answer);
 
protected:
    virtual int giveNumberOfIPForMassMtrxIntegration();

    void condense(FloatMatrix *stiff, FloatMatrix *mass, FloatArray *load, IntArray *what);
 

    virtual void setupIRForMassMtrxIntegration(IntegrationRule &iRule);
 
 
 
 
    friend class IDNLMaterial;
    friend class TrabBoneNL3D;
    friend class MisesMatNl;
    friend class RankineMatNl;
    friend class GradDpElement;
};
} // end namespace oofem
#endif // structuralelement_h