transportelement.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 transportelement_h
#define transportelement_h
 
#include "element.h"
#include "floatmatrix.h"
#include "primaryfield.h"
#include "matresponsemode.h"
 
#define _IFT_TransportElement_vof_function "voffunction"
 
namespace oofem {
class TransportCrossSection;
class ParamKey;

class TransportElement : public Element, public EIPrimaryFieldInterface
{
public:
    enum ElementMode { HeatTransferEM, HeatMass1TransferEM, Mass1TransferEM };
 
protected:
    ElementMode emode;
    static const double stefanBoltzmann;
    int vofFunction = 0;
 
    static ParamKey IPK_TransportElement_vof_function;
 
public:
    TransportElement(int n, Domain * d, ElementMode em = HeatTransferEM);
 
    void giveCharacteristicMatrix(FloatMatrix &answer, CharType type, TimeStep *tStep) override;
    void giveCharacteristicVector(FloatArray &answer, CharType type, ValueModeType mode, TimeStep *tStep) override;
 
    void giveDofManDofIDMask(int inode, IntArray &answer) const override;
 
    virtual void computeInternalForcesVector(FloatArray &answer, TimeStep *tStep);
    virtual void computeExternalForcesVector(FloatArray &answer, TimeStep *tStep, ValueModeType mode);
    virtual void computeInertiaForcesVector(FloatArray &answer, TimeStep *tStep);
    virtual void computeLumpedCapacityVector(FloatArray &answer, TimeStep *tStep);
 
    //Compute volumetric load from element
    void computeLoadVector(FloatArray &answer, BodyLoad *load, CharType type, ValueModeType mode, TimeStep *tStep) override;
    //Boundary load by prescribed flux, convection, or radiation over surface
    void computeBoundarySurfaceLoadVector(FloatArray &answer, BoundaryLoad *load, int boundary, CharType type, ValueModeType mode, TimeStep *tStep, bool global=true) override;
    //Contribution to conductivity matrix from convection
    void computeTangentFromSurfaceLoad(FloatMatrix &answer, BoundaryLoad *load, int boundary, MatResponseMode rmode, TimeStep *tStep) override;
    void computeTangentFromEdgeLoad(FloatMatrix &answer, BoundaryLoad *load, int boundary, MatResponseMode rmode, TimeStep *tStep) override;
    //Boundary load by prescribed flux, convection, or radiation over length
    void computeBoundaryEdgeLoadVector(FloatArray &answer, BoundaryLoad *load, int edge, CharType type, ValueModeType mode, TimeStep *tStep, bool global=true) override;
 
    void computeField(ValueModeType mode, TimeStep *tStep, const FloatArray &lcoords, FloatArray &answer) override;
 
    TransportCrossSection * giveTransportCrossSection();
    Material * giveMaterial() override;
    void initializeFrom(InputRecord &ir, int priority) override;
    void postInitialize() override;
    const char *giveClassName() const override { return "TransportElement"; }
    
    virtual double giveThicknessAt(const FloatArray &gcoords) { return 1.0; }

    virtual void computeCapacityMatrix(FloatMatrix &answer, TimeStep *tStep);
    virtual void computeConductivityMatrix(FloatMatrix &answer, MatResponseMode rMode, TimeStep *tStep);
    virtual void computeBCVectorAt(FloatArray &answer, TimeStep *tStep, ValueModeType mode);
    virtual void computeBCMtrxAt(FloatMatrix &answer, TimeStep *tStep, ValueModeType mode);
    virtual void computeInternalSourceRhsVectorAt(FloatArray &answer, TimeStep *tStep, ValueModeType mode);
    virtual void computeIntSourceLHSMatrix(FloatMatrix &answer, TimeStep *tStep);
    virtual void computeIntSourceLHSSubMatrix(FloatMatrix &answer, MatResponseMode rmode, int iri, TimeStep *tStep);
    virtual void computeFlow(FloatArray &answer, GaussPoint *gp, TimeStep *tStep);
    virtual double computeVof(TimeStep *tStep);
 
    // time step termination
    void updateInternalState(TimeStep *tStep) override;
    int checkConsistency() override;
 
    virtual int EIPrimaryFieldI_evaluateFieldVectorAt(FloatArray &answer, PrimaryField &pf,
                                                      const FloatArray &coords, IntArray &dofId, ValueModeType mode,
                                                      TimeStep *tStep) override;
 
#ifdef __OOFEG
    int giveInternalStateAtNode(FloatArray &answer, InternalStateType type, InternalStateMode mode,
                                int node, TimeStep *tStep) override;
    // Graphics output
    //void drawRawGeometry(oofegGraphicContext &gc, TimeStep *tStep) override {}
    //void drawDeformedGeometry(oofegGraphicContext &gc, TimeStep *tStep, UnknownType) override {}
#endif

    virtual void computeConstitutiveMatrixAt(FloatMatrix &answer,
                                             MatResponseMode rMode, GaussPoint *gp,
                                             TimeStep *tStep);
 
protected:
    virtual void computeCapacitySubMatrix(FloatMatrix &answer, MatResponseMode rmode, int iri, TimeStep *tStep);
    virtual void computeConductivitySubMatrix(FloatMatrix &answer, int iri, MatResponseMode rmode, TimeStep *tStep);
    void computeBCSubVectorAt(FloatArray &answer, TimeStep *tStep, ValueModeType mode, int indx);
    void computeBCSubMtrxAt(FloatMatrix &answer, TimeStep *tStep, ValueModeType mode, int indx);
    void computeBodyBCSubVectorAt(FloatArray &answer, Load *load, TimeStep *tStep, ValueModeType mode, int indx);
    void computeEdgeBCSubVectorAt(FloatArray &answer, Load *load, int iEdge,
                                  TimeStep *tStep, ValueModeType mode, int indx);

    void computeSurfaceBCSubVectorAt(FloatArray &answer, Load *load, int iSurf,
                                     TimeStep *tStep, ValueModeType mode, int indx);

    virtual void computeNAt(FloatArray &answer, const FloatArray &lcoord);
    virtual void computeNmatrixAt(FloatMatrix &answer, const FloatArray &lcoords);
    virtual void computeBmatrixAt(FloatMatrix &answer, const FloatArray &lcoords);
    virtual void computeGradientMatrixAt(FloatMatrix &answer, const FloatArray &lcoords);
    virtual void computeInternalSourceRhsSubVectorAt(FloatArray &answer, TimeStep *, ValueModeType mode, int indx);

    virtual void computeEgdeNAt(FloatArray &answer, int iEdge, const FloatArray &lcoord);
    virtual void giveEdgeDofMapping(IntArray &mask, int iEdge);
    virtual double computeEdgeVolumeAround(GaussPoint *gp, int iEdge) { return 0.; }
 
    virtual void computeSurfaceNAt(FloatArray &answer, int iSurf, const FloatArray &lcoord);
    virtual double computeSurfaceVolumeAround(GaussPoint *gp, int iSurf) { return 0.; }
    virtual void giveSurfaceDofMapping(IntArray &mask, int iSurf);
 
    virtual int giveApproxOrder(int unknownIndx);

    void assembleLocalContribution(FloatMatrix &answer, FloatMatrix &src, int ndofs, int rdof, int cdof);
    void assembleLocalContribution(FloatArray &answer, FloatArray &src, int ndofs, int rdof);
};
} // end namespace oofem
#endif // transportelement_h