fcm.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 fcm_h
#define fcm_h
 
#include "material.h"
#include "isolinearelasticmaterial.h"
#include "structuralmaterial.h"
#include "structuralms.h"
#include "intarray.h"


#define _IFT_FCM_nAllowedCracks "ncracks"
#define _IFT_FCM_crackSpacing "crackspacing"
#define _IFT_FCM_multipleCrackShear "multiplecrackshear"
#define _IFT_FCM_ecsm "ecsm"
#define _IFT_FCM_shearCoeffNumer "shearcoeffnumer"
#define _IFT_FCM_normalCoeffNumer "normalcoeffnumer"
 
namespace oofem {
// crack statuses
#define pscm_NONE 0
#define pscm_JUST_INIT 1
#define pscm_SOFTENING 2
#define pscm_UNLO_RELO 3
#define pscm_CLOSED 4
 
#define fcm_SMALL_STRAIN 1.e-12
#define fcm_BIGNUMBER 1.e6
#define fcm_TOLERANCE 1.e-6
#define fcm_THRESHOLD_CRACK_STRAIN 1.e-8
 

class FCMMaterialStatus : public StructuralMaterialStatus
{
protected:
    IntArray crackStatuses, tempCrackStatuses;
    FloatArray maxCrackStrains, tempMaxCrackStrains;
    FloatArray crackStrainVector, tempCrackStrainVector;
    FloatMatrix crackDirs;
    FloatArray charLengths;

    FloatMatrix transMatrix_G2Lstress;
    FloatMatrix transMatrix_G2Lstrain;
    FloatMatrix transMatrix_L2Gstress;
    FloatMatrix transMatrix_L2Gstrain;

    int nMaxCracks = 0;
 
public:
    FCMMaterialStatus(GaussPoint *g);
 
    void printOutputAt(FILE *file, TimeStep *tStep) const override;
    virtual int giveNumberOfCracks() const;
    virtual int giveNumberOfTempCracks() const;

    const FloatArray &giveMaxCrackStrainVector() { return maxCrackStrains; }
    double giveMaxCrackStrain(int icrack) { return maxCrackStrains.at(icrack); }
    void setMaxCrackStrain(int icrack, double val) { maxCrackStrains.at(icrack) = val; }

    double giveTempMaxCrackStrain(int icrack) { return tempMaxCrackStrains.at(icrack); }
    void setTempMaxCrackStrain(int icrack, double val) { tempMaxCrackStrains.at(icrack) = val; }

    const IntArray &giveTempCrackStatus() { return tempCrackStatuses; }
    int giveTempCrackStatus(int icrack) const { return tempCrackStatuses.at(icrack); }
    void setTempCrackStatus(int icrack, int val) { tempCrackStatuses.at(icrack) = val; }
    int giveCrackStatus(int icrack) const { return crackStatuses.at(icrack); }

    const FloatArray &giveCrackStrainVector() const { return crackStrainVector; }
    const FloatArray &giveTempCrackStrainVector() { return tempCrackStrainVector; }
    double giveCrackStrain(int icrack) const { return crackStrainVector.at(icrack); }
    double giveTempCrackStrain(int icrack) const { return tempCrackStrainVector.at(icrack); }
    void setTempCrackStrainVector(FloatArray a) { tempCrackStrainVector = std :: move(a); }
    void setTempNormalCrackStrainVector(FloatArray a);
    void setTempCrackStrain(int icrack, double val) { tempCrackStrainVector.at(icrack) = val; }
    void setCrackStrainVector(FloatArray a) { crackStrainVector = std :: move(a); }
    void setG2LStressVectorTransformationMtrx(FloatMatrix t) { transMatrix_G2Lstress = std :: move(t); }
    void setG2LStrainVectorTransformationMtrx(FloatMatrix s) { transMatrix_G2Lstrain = std :: move(s); }
    void setL2GStressVectorTransformationMtrx(FloatMatrix t) { transMatrix_L2Gstress = std :: move(t); }
    void setL2GStrainVectorTransformationMtrx(FloatMatrix s) { transMatrix_L2Gstrain = std :: move(s); }

    const FloatMatrix &giveG2LStressVectorTransformationMtrx() { return transMatrix_G2Lstress; }
    const FloatMatrix &giveG2LStrainVectorTransformationMtrx() { return transMatrix_G2Lstrain; }
    const FloatMatrix &giveL2GStressVectorTransformationMtrx() { return transMatrix_L2Gstress; }
    const FloatMatrix &giveL2GStrainVectorTransformationMtrx() { return transMatrix_L2Gstrain; }

    double giveCharLength(int icrack) const {
        if ( icrack ) {
            return charLengths.at(icrack);
        } else {
            return 0.0;
        }
    }

    void setCharLength(int icrack, double val) { charLengths.at(icrack) = val; }
    const FloatMatrix &giveCrackDirs() { return crackDirs; }
    const IntArray &giveCrackStatus() { return crackStatuses; }
    void setCrackDirs(FloatMatrix a) { crackDirs = std :: move(a); }
    virtual int giveMaxNumberOfCracks(GaussPoint *gp);
 
    const char *giveClassName() const override { return "FCMMaterialStatus"; }
 
    void initTempStatus() override;
    void updateYourself(TimeStep *tStep) override;
 
    void saveContext(DataStream &stream, ContextMode mode) override;
    void restoreContext(DataStream &stream, ContextMode mode) override;
};

class FCMMaterial : public StructuralMaterial
{
protected:
    IsotropicLinearElasticMaterial linearElasticMaterial;
 
public:
    FCMMaterial(int n, Domain *d);
 
    bool hasMaterialModeCapability(MaterialMode mode) const override;
 
    const char *giveClassName() const override { return "FCMMaterial"; }
 
    void initializeFrom(InputRecord &ir) override;
 
    double give(int aProperty, GaussPoint *gp) const override;
 
    FloatMatrixF<6,6> give3dMaterialStiffnessMatrix(MatResponseMode mode, GaussPoint *gp, TimeStep *tStep) const override;
 
    FloatMatrixF<3,3> givePlaneStressStiffMtrx(MatResponseMode mmode, GaussPoint *gp, TimeStep *tStep) const override;
 
    FloatMatrixF<4,4> givePlaneStrainStiffMtrx(MatResponseMode mmode, GaussPoint *gp, TimeStep *tStep) const override;
 
    void giveRealStressVector(FloatArray &answer, GaussPoint *gp,
                              const FloatArray &reducedStrain, TimeStep *tStep) const override;
 
    virtual void initializeCrack(GaussPoint *gp, TimeStep *tStep, FloatMatrix &base, int nCrack) const;
 
    FloatArrayF<6> giveRealStressVector_3d(const FloatArrayF<6> &strain, GaussPoint *gp, TimeStep *tStep) const override
    {
        FloatArray answer;
        const_cast<FCMMaterial*>(this)->giveRealStressVector(answer, gp, strain, tStep);
        return answer;
    }
    FloatArrayF<4> giveRealStressVector_PlaneStrain(const FloatArrayF<4> &strain, GaussPoint *gp, TimeStep *tStep) const override
    {
        FloatArray answer;
        const_cast<FCMMaterial*>(this)->giveRealStressVector(answer, gp, strain, tStep);
        return answer;
    }
    FloatArrayF<3> giveRealStressVector_PlaneStress(const FloatArrayF<3> &strain, GaussPoint *gp, TimeStep *tStep) const override
    {
        FloatArray answer;
        const_cast<FCMMaterial*>(this)->giveRealStressVector(answer, gp, strain, tStep);
        return answer;
    }
    FloatArrayF<1> giveRealStressVector_1d(const FloatArrayF<1> &strain, GaussPoint *gp, TimeStep *tStep) const override
    {
        FloatArray answer;
        const_cast<FCMMaterial*>(this)->giveRealStressVector(answer, gp, strain, tStep);
        return answer;
    }
    FloatArrayF<2> giveRealStressVector_2dBeamLayer(const FloatArrayF<2> &strain, GaussPoint *gp, TimeStep *tStep) const override
    {
        FloatArray answer;
        const_cast<FCMMaterial*>(this)->giveRealStressVector(answer, gp, strain, tStep);
        return answer;
    }
    FloatArrayF<5> giveRealStressVector_PlateLayer(const FloatArrayF<5> &strain, GaussPoint *gp, TimeStep *tStep) const override
    {
        FloatArray answer;
        const_cast<FCMMaterial*>(this)->giveRealStressVector(answer, gp, strain, tStep);
        return answer;
    }
 
    int giveIPValue(FloatArray &answer, GaussPoint *gp, InternalStateType type, TimeStep *tStep) override;

    virtual double computeNormalCrackOpening(GaussPoint *gp, int i) const;
    virtual double computeMaxNormalCrackOpening(GaussPoint *gp, TimeStep *tStep, int i) const;

    virtual double computeShearSlipOnCrack(GaussPoint *gp, TimeStep *tStep, int i) const;
 
    std::unique_ptr<MaterialStatus> CreateStatus(GaussPoint *gp) const override { return std::make_unique<FCMMaterialStatus>(gp); }
 
protected:

    int nAllowedCracks;

    ElementCharSizeMethod ecsMethod;

    bool multipleCrackShear;
 
    int iterLimitGlobal = 20;

    virtual double giveTensileStrength(GaussPoint *gp, TimeStep *tStep) const = 0;

    virtual void checkSnapBack(GaussPoint *gp, TimeStep *tStep, int crack) const = 0;

    virtual void updateCrackStatus(GaussPoint *gp) const;

    virtual double giveNormalCrackingStress(GaussPoint *gp, TimeStep *tStep, double eps_cr, int i) const = 0;

    virtual double giveCharacteristicElementLength(GaussPoint *gp, const FloatArray &crackPlaneNormal) const;

    virtual double giveCrackingModulus(MatResponseMode rMode, GaussPoint *gp, TimeStep *tStep, int i) const = 0;

    virtual double giveCrackingModulusInTension(MatResponseMode rMode, GaussPoint *gp, TimeStep *tStep, int i) const = 0;
    
    virtual double computeEffectiveShearModulus(GaussPoint *gp, TimeStep *tStep, int i) const = 0;

    virtual double computeTotalD2Modulus(GaussPoint *gp, TimeStep *tStep, int i) const;

    virtual double computeNumerD2Modulus(GaussPoint *gp, TimeStep *tStep, int i) const;

    virtual double computeD2ModulusForCrack(GaussPoint *gp, TimeStep *tStep, int icrack) const = 0;

    virtual double computeNumerD2ModulusForCrack(GaussPoint *gp, TimeStep *tStep, int icrack) const = 0;
    
    virtual double maxShearStress(GaussPoint *gp, TimeStep *tStep, int i) const = 0;

    virtual bool isIntactForShear(GaussPoint *gp, int i) const;

    virtual bool isIntact(GaussPoint *gp, int icrack) const;

    virtual bool isThisShearComponent(GaussPoint *gp, int component) const;

    virtual bool checkStrengthCriterion(FloatMatrix &newBase, const FloatArray &globalStress, GaussPoint *gp, TimeStep *tStep, int nCrack) const;

    virtual bool isStrengthExceeded(const FloatMatrix &base, GaussPoint *gp, TimeStep *tStep, int iCrack, double trialStress) const;

    virtual double computeShearStiffnessRedistributionFactor(GaussPoint *gp, TimeStep *tStep, int ithCrackPlane, int jthCrackDirection) const;

    double crackSpacing;

    double shearCoeffNumer;

    double normalCoeffNumer;
    

    virtual double giveCrackSpacing(void) const;

    virtual double giveNumberOfCracksInDirection(GaussPoint *gp, int iCrack) const;

    virtual double giveNumberOfCracksForShearDirection(GaussPoint *gp, int i) const;
 
 
    virtual void giveMaterialStiffnessMatrix(FloatMatrix & answer, MatResponseMode,
                                             GaussPoint * gp,
                                             TimeStep * tStep) const;

    virtual void giveTotalLocalCrackedStiffnessMatrix(FloatMatrix &answer,
                                                 MatResponseMode rMode,
                                                 GaussPoint *gp, TimeStep *tStep) const;

    virtual void giveNormalLocalCrackedStiffnessMatrix(FloatMatrix &answer,
                                                 MatResponseMode rMode,
                                                 GaussPoint *gp, TimeStep *tStep) const;

    virtual double computeOverallElasticStiffness(GaussPoint *gp, TimeStep *tStep) const { return linearElasticMaterial.giveYoungsModulus(); }

    virtual double computeOverallElasticShearModulus(GaussPoint *gp, TimeStep *tStep) const { return linearElasticMaterial.giveShearModulus(); }

    virtual double givePoissonsRatio() const { return linearElasticMaterial.givePoissonsRatio(); }
 
 
    
};
} // end namespace oofem
#endif // fcm_h