structuralelement.h

Go to the documentation of this file.

/*
 *
 *                 #####    #####   ######  ######  ###   ###
 *               ##   ##  ##   ##  ##      ##      ## ### ##
 *              ##   ##  ##   ##  ####    ####    ##  #  ##
 *             ##   ##  ##   ##  ##      ##      ##     ##
 *            ##   ##  ##   ##  ##      ##      ##     ##
 *            #####    #####   ##      ######  ##     ##
 *
 *
 *             OOFEM : Object Oriented Finite Element Code
 *
 *               Copyright (C) 1993 - 2013   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 StructuralElement : public Element
{
protected:
    std :: unique_ptr< FloatArray >initialDisplacements;

public:
    StructuralElement(int n, Domain *d);
    virtual ~StructuralElement();

    virtual void giveCharacteristicMatrix(FloatMatrix & answer, CharType, TimeStep * tStep);
    virtual void giveCharacteristicVector(FloatArray &answer, CharType type, ValueModeType mode, TimeStep *tStep);

    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 computeField(ValueModeType mode, TimeStep *tStep, const FloatArray &lcoords, FloatArray &answer);

    // 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);

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

    virtual void updateBeforeNonlocalAverage(TimeStep *tStep);
    virtual void giveNonlocalLocationArray(IntArray &locationArray, const UnknownNumberingScheme &us);
    virtual void addNonlocalStiffnessContributions(SparseMtrx &dest, const UnknownNumberingScheme &s, TimeStep *tStep);

    // Overloaded methods.
    virtual int adaptiveUpdate(TimeStep *tStep);
    virtual void updateInternalState(TimeStep *tStep);
    virtual void updateYourself(TimeStep *tStep);
    virtual int checkConsistency();
    virtual IRResultType initializeFrom(InputRecord *ir);
    virtual void giveInputRecord(DynamicInputRecord &input);
    virtual const char *giveClassName() const { return "StructuralElement"; }

#ifdef __OOFEG

    virtual int giveInternalStateAtNode(FloatArray &answer, InternalStateType type, InternalStateMode mode,
                                        int node, TimeStep *tStep);
    virtual void showSparseMtrxStructure(CharType mtrx, oofegGraphicContext &gc, TimeStep *tStep);
    virtual void showExtendedSparseMtrxStructure(CharType mtrx, oofegGraphicContext &gc, TimeStep *tStep);

#endif

    // Interface for body loads applied by Sets:
    virtual void computeLoadVector(FloatArray &answer, BodyLoad *load, CharType type, ValueModeType mode, TimeStep *tStep);
    virtual void computeBoundarySurfaceLoadVector(FloatArray &answer, BoundaryLoad *load, int boundary, CharType type, ValueModeType mode, TimeStep *tStep, bool global = true);
    virtual void computeBoundaryEdgeLoadVector(FloatArray &answer, BoundaryLoad *load, int boundary, CharType type, ValueModeType mode, TimeStep *tStep, bool global = true);
    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 IntegrationRule *GetSurfaceIntegrationRule(int order) { return NULL; }
    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