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 MaterialStatus *	CreateStatus (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 MaterialStatus *	giveStatus (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

Domain *	giveDomain () 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 Interface *	giveInterface (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...

Domain *	domain
	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

n	Material number.
d	Domain 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

val	Contains response.
gp	Integration point.
tStep	Solution step.
mode	Determines 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

gp	Integration 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

answer	Contains result.
mode	Material response mode.
gp	Integration point.
tStep	Time 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

mode	Material response mode.
gp	Integration point.
tStep	Time 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

answer	The flux.
gp	Gauss point.
grad	Gradient of the primary field, usually the main input.
field	The value of the field itself.
tStep	Active 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

answer	Contain corresponding ip value, zero sized if not available.
gp	Integration point to which the value refers.
type	Determines the type of internal variable.
tStep	Determines 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

Returns nonzero if receiver generates internal source of state variable(s), zero otherwise.

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

Definition at line 180 of file transportmaterial.h.

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

void oofem::TransportMaterial::updateInternalState	(	const FloatArray &	state,
		GaussPoint *	gp,
		TimeStep *	tStep
	)

virtual

Updates internal state of material according to new state vector.

Parameters

state	New state vector.
gp	Integration point.
tStep	Solution 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:

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation