OOFEM  2.4
OOFEM.org - Object Oriented Finite Element Solver
oofem::TransportMaterial Class Referenceabstract

Abstract base class for all constitutive models for transport problems. More...

#include <transportmaterial.h>

+ Inheritance diagram for oofem::TransportMaterial:
+ Collaboration diagram for oofem::TransportMaterial:

Public Member Functions

 TransportMaterial (int n, Domain *d)
 Constructor. More...
 
virtual ~TransportMaterial ()
 Destructor. More...
 
virtual void giveFluxVector (FloatArray &answer, GaussPoint *gp, const FloatArray &grad, const FloatArray &field, TimeStep *tStep)=0
 Returns the flux for the field and its gradient. More...
 
virtual void giveCharacteristicMatrix (FloatMatrix &answer, MatResponseMode mode, GaussPoint *gp, TimeStep *tStep)=0
 Computes characteristic matrix of receiver in given integration point. More...
 
virtual double giveCharacteristicValue (MatResponseMode mode, GaussPoint *gp, TimeStep *tStep)=0
 Computes the characteristic value of receiver in given integration point, respecting its history. More...
 
virtual void updateInternalState (const FloatArray &state, GaussPoint *gp, TimeStep *tStep)
 Updates internal state of material according to new state vector. More...
 
virtual int hasInternalSource ()
 Returns nonzero if receiver generates internal source of state variable(s), zero otherwise. More...
 
virtual void computeInternalSourceVector (FloatArray &val, GaussPoint *gp, TimeStep *tStep, ValueModeType mode)
 Computes the internal source vector of receiver. More...
 
virtual double giveHumidity (GaussPoint *gp, ValueModeType mode)
 Returns positive value of humidity if implemented and enabled in derived material, -1 otherwise. More...
 
virtual int giveIPValue (FloatArray &answer, GaussPoint *gp, InternalStateType type, TimeStep *tStep)
 Returns the integration point corresponding value in Reduced form. More...
 
virtual MaterialStatusCreateStatus (GaussPoint *gp) const
 Creates new copy of associated status and inserts it into given integration point. More...
 
- Public Member Functions inherited from oofem::Material
 Material (int n, Domain *d)
 Constructor. More...
 
virtual ~Material ()
 Destructor. More...
 
virtual bool isCharacteristicMtrxSymmetric (MatResponseMode rMode)
 Returns true if stiffness matrix of receiver is symmetric Default implementation returns true. More...
 
virtual double give (int aProperty, GaussPoint *gp)
 Returns the value of material property 'aProperty'. More...
 
virtual bool hasProperty (int aProperty, GaussPoint *gp)
 Returns true if 'aProperty' exists on material. More...
 
virtual void modifyProperty (int aProperty, double value, GaussPoint *gp)
 Modify 'aProperty', which already exists on material. More...
 
double giveCastingTime ()
 
virtual bool isActivated (TimeStep *tStep)
 
virtual int hasNonLinearBehaviour ()
 Returns nonzero if receiver is non linear. More...
 
virtual int hasMaterialModeCapability (MaterialMode mode)
 Tests if material supports material mode. More...
 
virtual int hasCastingTimeSupport ()
 Tests if material supports casting time. More...
 
virtual IRResultType initializeFrom (InputRecord *ir)
 Initializes receiver according to object description stored in input record. More...
 
virtual void giveInputRecord (DynamicInputRecord &input)
 Setups the input record string of receiver. More...
 
virtual void printYourself ()
 Prints receiver state on stdout. Useful for debugging. More...
 
virtual contextIOResultType saveIPContext (DataStream &stream, ContextMode mode, GaussPoint *gp)
 Stores integration point state to output stream. More...
 
virtual contextIOResultType restoreIPContext (DataStream &stream, ContextMode mode, GaussPoint *gp)
 Reads integration point state to output stream. More...
 
virtual int checkConsistency ()
 Allows programmer to test some internal data, before computation begins. More...
 
virtual int initMaterial (Element *element)
 Optional function to call specific procedures when initializing a material. More...
 
virtual MaterialStatusgiveStatus (GaussPoint *gp) const
 Returns material status of receiver in given integration point. More...
 
virtual int packUnknowns (DataStream &buff, TimeStep *tStep, GaussPoint *ip)
 Pack all necessary data of integration point (according to element parallel_mode) into given communication buffer. More...
 
virtual int unpackAndUpdateUnknowns (DataStream &buff, TimeStep *tStep, GaussPoint *ip)
 Unpack and updates all necessary data of given integration point (according to element parallel_mode) into given communication buffer. More...
 
virtual int estimatePackSize (DataStream &buff, GaussPoint *ip)
 Estimates the necessary pack size to hold all packed data of receiver. More...
 
virtual double predictRelativeComputationalCost (GaussPoint *gp)
 Returns the weight representing relative computational cost of receiver The reference material model is linear isotropic material - its weight is set to 1.0 The other material models should compare to this reference model. More...
 
virtual double predictRelativeRedistributionCost (GaussPoint *gp)
 Returns the relative redistribution cost of the receiver. More...
 
virtual void initTempStatus (GaussPoint *gp)
 Initializes temporary variables stored in integration point status at the beginning of new time step. More...
 
virtual int setIPValue (const FloatArray &value, GaussPoint *gp, InternalStateType type)
 Sets the value of a certain variable at a given integration point to the given value. More...
 
- Public Member Functions inherited from oofem::FEMComponent
 FEMComponent (int n, Domain *d)
 Regular constructor, creates component with given number and belonging to given domain. More...
 
virtual ~FEMComponent ()
 Virtual destructor. More...
 
virtual const char * giveClassName () const =0
 
virtual const char * giveInputRecordName () const =0
 
DomaingiveDomain () const
 
virtual void setDomain (Domain *d)
 Sets associated Domain. More...
 
int giveNumber () const
 
void setNumber (int num)
 Sets number of receiver. More...
 
virtual void updateLocalNumbering (EntityRenumberingFunctor &f)
 Local renumbering support. More...
 
virtual contextIOResultType saveContext (DataStream &stream, ContextMode mode, void *obj=NULL)
 Stores receiver state to output stream. More...
 
virtual contextIOResultType restoreContext (DataStream &stream, ContextMode mode, void *obj=NULL)
 Restores the receiver state previously written in stream. More...
 
virtual void printOutputAt (FILE *file, TimeStep *tStep)
 Prints output of receiver to stream, for given time step. More...
 
virtual InterfacegiveInterface (InterfaceType t)
 Interface requesting service. More...
 
std::string errorInfo (const char *func) const
 Returns string for prepending output (used by error reporting macros). More...
 

Additional Inherited Members

- Protected Attributes inherited from oofem::Material
Dictionary propertyDictionary
 Property dictionary. More...
 
double castingTime
 Casting time. More...
 
- Protected Attributes inherited from oofem::FEMComponent
int number
 Component number. More...
 
Domaindomain
 Link to domain object, useful for communicating with other FEM components. More...
 

Detailed Description

Abstract base class for all constitutive models for transport problems.

It declares common services provided by all structural material models. The implementation of these services is partly left on derived classes, which will implement constitutive model dependent part. Some general purpose services are implemented on this level. For details, how to store material model related history variables in integration points, see base class Material documentation.

Definition at line 119 of file transportmaterial.h.

Constructor & Destructor Documentation

oofem::TransportMaterial::TransportMaterial ( int  n,
Domain d 
)
inline

Constructor.

Creates material with given number, belonging to given domain.

Parameters
nMaterial number.
dDomain to which new material will belong.

Definition at line 127 of file transportmaterial.h.

virtual oofem::TransportMaterial::~TransportMaterial ( )
inlinevirtual

Destructor.

Definition at line 129 of file transportmaterial.h.

References oofem::TransportMaterialStatus::field, and oofem::IntegrationPointStatus::gp.

Member Function Documentation

virtual void oofem::TransportMaterial::computeInternalSourceVector ( FloatArray val,
GaussPoint gp,
TimeStep tStep,
ValueModeType  mode 
)
inlinevirtual

Computes the internal source vector of receiver.

Parameters
valContains response.
gpIntegration point.
tStepSolution step.
modeDetermines response mode.

Reimplemented in oofem::CemhydMat, oofem::HydratingIsoHeatMaterial, oofem::HydratingConcreteMat, and oofem::HydratingHeMoMaterial.

Definition at line 188 of file transportmaterial.h.

References oofem::FloatArray::clear().

Referenced by oofem::TransportElement::computeInternalForcesVector(), and oofem::TransportElement::computeInternalSourceRhsSubVectorAt().

virtual MaterialStatus* oofem::TransportMaterial::CreateStatus ( GaussPoint gp) const
inlinevirtual

Creates new copy of associated status and inserts it into given integration point.

Parameters
gpIntegration point where newly created status will be stored.
Returns
Reference to new status.

Reimplemented from oofem::Material.

Reimplemented in oofem::LatticeTransportMaterial, oofem::CemhydMat, oofem::HydratingConcreteMat, oofem::RVEStokesFlow, oofem::HydratingIsoHeatMaterial, oofem::IsotropicHeatTransferMaterial, and oofem::HydratingHeMoMaterial.

Definition at line 198 of file transportmaterial.h.

References oofem::FEMComponent::domain, and oofem::TransportMaterialStatus::TransportMaterialStatus().

virtual void oofem::TransportMaterial::giveCharacteristicMatrix ( FloatMatrix answer,
MatResponseMode  mode,
GaussPoint gp,
TimeStep tStep 
)
pure virtual

Computes characteristic matrix of receiver in given integration point.

The algorithm should use temporary or equilibrium history variables stored in integration point status to compute and return required result.

Parameters
answerContains result.
modeMaterial response mode.
gpIntegration point.
tStepTime step (most models are able to respond only when tStep is current time step).

Implemented in oofem::LatticeTransportMaterial, oofem::RVEStokesFlow, oofem::HeMoKunzelMaterial, oofem::HeMoTKMaterial, oofem::HeMoBazNajMaterial, oofem::AnisotropicMassTransferMaterial, oofem::IsotropicHeatTransferMaterial, oofem::NonlinearMassTransferMaterial, and oofem::IsotropicMoistureTransferMaterial.

Referenced by oofem::Tr1Darcy::computeStiffnessMatrix().

virtual double oofem::TransportMaterial::giveCharacteristicValue ( MatResponseMode  mode,
GaussPoint gp,
TimeStep tStep 
)
pure virtual

Computes the characteristic value of receiver in given integration point, respecting its history.

The algorithm should use temporary or equilibrium history variables stored in integration point status to compute and return required result.

Parameters
modeMaterial response mode.
gpIntegration point.
tStepTime step (most models are able to respond only when tStep is current time step).

Implemented in oofem::LatticeTransportMaterial, oofem::HeMoKunzelMaterial, oofem::RVEStokesFlow, oofem::CemhydMat, oofem::HeMoTKMaterial, oofem::HeMoBazNajMaterial, oofem::HydratingIsoHeatMaterial, oofem::HydratingConcreteMat, oofem::IsotropicHeatTransferMaterial, oofem::NonlinearMassTransferMaterial, oofem::AnisotropicMassTransferMaterial, oofem::HydratingHeMoMaterial, and oofem::IsotropicMoistureTransferMaterial.

Referenced by oofem::TransportElement::computeCapacitySubMatrix(), and oofem::TransportElement::computeIntSourceLHSSubMatrix().

virtual void oofem::TransportMaterial::giveFluxVector ( FloatArray answer,
GaussPoint gp,
const FloatArray grad,
const FloatArray field,
TimeStep tStep 
)
pure virtual

Returns the flux for the field and its gradient.

Todo:
{ Should the field variable just be a scalar? This might change when we rethink the coupled-fields approach. Now its either just [temperature], or [temperature, concentration] so to cover both cases there is a floatarray. }
Parameters
answerThe flux.
gpGauss point.
gradGradient of the primary field, usually the main input.
fieldThe value of the field itself.
tStepActive time step.

Implemented in oofem::LatticeTransportMaterial, oofem::RVEStokesFlow, oofem::HeMoKunzelMaterial, oofem::HeMoTKMaterial, oofem::HeMoBazNajMaterial, oofem::NonlinearMassTransferMaterial, oofem::AnisotropicMassTransferMaterial, oofem::IsotropicHeatTransferMaterial, and oofem::IsotropicMoistureTransferMaterial.

Referenced by oofem::TransportElement::computeInternalForcesVector(), oofem::Tr1Darcy::computeInternalForcesVector(), and oofem::TransportElement::updateInternalState().

virtual double oofem::TransportMaterial::giveHumidity ( GaussPoint gp,
ValueModeType  mode 
)
inlinevirtual

Returns positive value of humidity if implemented and enabled in derived material, -1 otherwise.

Reimplemented in oofem::HeMoKunzelMaterial, oofem::NlIsoMoistureMaterial, oofem::HeMoTKMaterial, and oofem::BazantNajjarMoistureTransferMaterial.

Definition at line 193 of file transportmaterial.h.

Referenced by oofem::HeMoBazNajMaterial::giveIPValue().

int oofem::TransportMaterial::giveIPValue ( FloatArray answer,
GaussPoint gp,
InternalStateType  type,
TimeStep tStep 
)
virtual

Returns the integration point corresponding value in Reduced form.

Parameters
answerContain corresponding ip value, zero sized if not available.
gpIntegration point to which the value refers.
typeDetermines the type of internal variable.
tStepDetermines the time step.
Returns
Nonzero if the assignment can be done, zero if this type of variable is not supported.
Todo:
Shouldn't be named velocity.. instead, "MassFlow" or something suitable like that.

Reimplemented from oofem::Material.

Reimplemented in oofem::HeMoKunzelMaterial, oofem::HeMoTKMaterial, oofem::HeMoBazNajMaterial, oofem::RVEStokesFlow, oofem::CemhydMat, oofem::HydratingIsoHeatMaterial, oofem::HydratingConcreteMat, oofem::IsotropicHeatTransferMaterial, oofem::HydratingHeMoMaterial, oofem::NonlinearMassTransferMaterial, and oofem::IsotropicMoistureTransferMaterial.

Definition at line 177 of file transportmaterial.C.

References oofem::FloatArray::at(), oofem::TransportElement::computeFlow(), oofem::GaussPoint::giveElement(), oofem::TransportMaterialStatus::giveField(), oofem::TransportMaterialStatus::giveFlux(), oofem::TransportMaterialStatus::giveGradient(), oofem::Material::giveIPValue(), oofem::TransportMaterialStatus::giveMaturity(), and oofem::FloatArray::resizeWithValues().

Referenced by oofem::IsotropicMoistureTransferMaterial::giveIPValue(), oofem::NonlinearMassTransferMaterial::giveIPValue(), oofem::IsotropicHeatTransferMaterial::giveIPValue(), oofem::HydratingConcreteMat::giveIPValue(), oofem::HydratingIsoHeatMaterial::giveIPValue(), oofem::CemhydMat::giveIPValue(), oofem::HeMoBazNajMaterial::giveIPValue(), oofem::RVEStokesFlow::giveIPValue(), oofem::HeMoTKMaterial::giveIPValue(), and oofem::HeMoKunzelMaterial::giveIPValue().

virtual int oofem::TransportMaterial::hasInternalSource ( )
inlinevirtual
void oofem::TransportMaterial::updateInternalState ( const FloatArray state,
GaussPoint gp,
TimeStep tStep 
)
virtual

Updates internal state of material according to new state vector.

Parameters
stateNew state vector.
gpIntegration point.
tStepSolution step.

Reimplemented in oofem::HydratingIsoHeatMaterial, and oofem::HydratingHeMoMaterial.

Definition at line 59 of file transportmaterial.C.

References oofem::TransportMaterialStatus::letTempStateVectorBe().

Referenced by oofem::Lattice2d_mt::updateInternalState(), and oofem::TransportElement::updateInternalState().


The documentation for this class was generated from the following files:

This page is part of the OOFEM documentation. Copyright (c) 2011 Borek Patzak
Project e-mail: info@oofem.org
Generated at Tue Jan 2 2018 20:07:43 for OOFEM by doxygen 1.8.11 written by Dimitri van Heesch, © 1997-2011