Constitutive model of Bingham fluid for concentrated suspensions and pastes. More...

#include <binghamfluid2.h>

Inheritance diagram for oofem::BinghamFluidMaterial2:

Collaboration diagram for oofem::BinghamFluidMaterial2:

Public Member Functions
	BinghamFluidMaterial2 (int n, Domain *d)
	Constructor. More...

virtual	~BinghamFluidMaterial2 ()
	Destructor. More...

virtual void	computeDeviatoricStressVector (FloatArray &answer, GaussPoint gp, const FloatArray &eps, TimeStep tStep)
	Computes the deviatoric stress vector from given strain. More...

virtual void	giveDeviatoricStiffnessMatrix (FloatMatrix &answer, MatResponseMode, GaussPoint gp, TimeStep tStep)
	Computes the deviatoric stiffness; $\frac{\partial\sigma_{\mathrm{dev}}}{\partial \epsilon_{\mathrm{dev}}}$ . More...

virtual double	giveEffectiveViscosity (GaussPoint gp, TimeStep tStep)
	Gives the effective viscosity for the given integration point. More...

virtual double	give (int aProperty, GaussPoint *gp)
	Returns the value of material property 'aProperty'. 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 const char *	giveClassName () const

virtual const char *	giveInputRecordName () const

virtual int	checkConsistency ()
	Allows programmer to test some internal data, before computation begins. 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::FluidDynamicMaterial
	FluidDynamicMaterial (int n, Domain *d)
	Constructor. More...

virtual	~FluidDynamicMaterial ()
	Destructor. More...

virtual void	computeDeviatoricStressVector (FloatArray &stress_dev, double &epsp_vol, GaussPoint gp, const FloatArray &eps, double pressure, TimeStep tStep)
	Computes the deviatoric stress vector and volumetric strain rate from given deviatoric strain and pressure. More...

virtual void	giveStiffnessMatrices (FloatMatrix &dsdd, FloatArray &dsdp, FloatArray &dedd, double &dedp, MatResponseMode mode, GaussPoint gp, TimeStep tStep)
	Computes the 4 tangents of the compressible material response in 3D. More...

virtual void	updateInternalState (const FloatArray &vec, GaussPoint gp, TimeStep tStep)
	Updates internal state of material according to new state vector. More...

virtual int	giveIPValue (FloatArray &answer, GaussPoint gp, InternalStateType type, TimeStep tStep)
	Returns the integration point corresponding value in Reduced form. 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 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 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	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...

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...

Protected Member Functions
double	computeActualViscosity (double Tau, double shearRate)

double	computeDevStrainMagnitude (MaterialMode mmode, const FloatArray &epsd)

double	computeDevStressMagnitude (MaterialMode mmode, const FloatArray &sigd)

void	computeDeviatoricStrain (FloatArray &answer, const FloatArray &eps, MaterialMode mmode)

void	computeDeviatoricStress (FloatArray &answer, const FloatArray &deps, double _nu, MaterialMode mmode)

void	__debug (GaussPoint gp, TimeStep tStep)

Protected Attributes
double	mu_0
	Viscosity. More...

double	tau_0
	Yield stress. More...

double	tau_c

double	mu_inf

double	stressGrowthRate

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

Constitutive model of Bingham fluid for concentrated suspensions and pastes.

This is the simplest two-constant model, with yield stress and viscosity as parameters.

Definition at line 105 of file binghamfluid2.h.

Constructor & Destructor Documentation

oofem::BinghamFluidMaterial2::BinghamFluidMaterial2	(	int	n,
		Domain *	d
	)

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 58 of file binghamfluid2.C.

virtual oofem::BinghamFluidMaterial2::~BinghamFluidMaterial2 ( )

inlinevirtual

Destructor.

Definition at line 125 of file binghamfluid2.h.

References oofem::FEMComponent::giveInputRecord(), oofem::IntegrationPointStatus::gp, and oofem::MaterialStatus::initializeFrom().

Member Function Documentation

void oofem::BinghamFluidMaterial2::__debug	(	GaussPoint *	gp,
		TimeStep *	tStep
	)

protected

Referenced by oofem::BinghamFluidMaterial2Status::restoreContext().

int oofem::BinghamFluidMaterial2::checkConsistency ( )

virtual

Allows programmer to test some internal data, before computation begins.

For example, one may use this function, to ensure that element has material with required capabilities is assigned to element. This must be done after all mesh components are instanciated.

Returns: Nonzero if receiver is consistent.

Reimplemented from oofem::Material.

Definition at line 391 of file binghamfluid2.C.

References oofem::Dictionary::at(), oofem::FEMComponent::domain, oofem::Domain::giveEngngModel(), oofem::EngngModel::giveEquationScalingFlag(), oofem::EngngModel::giveVariableScale(), mu_0, oofem::Material::propertyDictionary, tau_0, oofem::VST_Density, and oofem::VST_Viscosity.

double oofem::BinghamFluidMaterial2::computeActualViscosity	(	double	Tau,
		double	shearRate
	)

protected

Definition at line 407 of file binghamfluid2.C.

References BINGHAM_MIN_SHEAR_RATE, oofem::max(), mu_0, mu_inf, stressGrowthRate, tau_0, and tau_c.

Referenced by computeDeviatoricStressVector(), giveDeviatoricStiffnessMatrix(), and giveEffectiveViscosity().

void oofem::BinghamFluidMaterial2::computeDeviatoricStrain	(	FloatArray &	answer,
		const FloatArray &	eps,
		MaterialMode	mmode
	)

protected

Definition at line 471 of file binghamfluid2.C.

References oofem::FloatArray::at(), and OOFEM_ERROR.

Referenced by computeDeviatoricStressVector().

void oofem::BinghamFluidMaterial2::computeDeviatoricStress	(	FloatArray &	answer,
		const FloatArray &	deps,
		double	_nu,
		MaterialMode	mmode
	)

protected

Definition at line 511 of file binghamfluid2.C.

References oofem::FloatArray::at(), and OOFEM_ERROR.

Referenced by computeDeviatoricStressVector().

void oofem::BinghamFluidMaterial2::computeDeviatoricStressVector	(	FloatArray &	answer,
		GaussPoint *	gp,
		const FloatArray &	eps,
		TimeStep *	tStep
	)

virtual

Computes the deviatoric stress vector from given strain.

Parameters

answer	Deviatoric stress.
gp	Integration point.
eps	Strain-rate.
tStep	Time step.

Implements oofem::FluidDynamicMaterial.

Definition at line 162 of file binghamfluid2.C.

References computeActualViscosity(), computeDeviatoricStrain(), computeDeviatoricStress(), computeDevStrainMagnitude(), computeDevStressMagnitude(), oofem::GaussPoint::giveMaterialMode(), oofem::FloatArray::giveSize(), oofem::Material::giveStatus(), oofem::FluidDynamicMaterialStatus::letDeviatoricStressVectorBe(), oofem::BinghamFluidMaterial2Status::letTempDeviatoricStrainVectorBe(), oofem::BinghamFluidMaterial2Status::letTempDevStrainMagnitudeBe(), oofem::BinghamFluidMaterial2Status::letTempDevStressMagnitudeBe(), mu_inf, oofem::FloatArray::resize(), tau_0, and tau_c.

double oofem::BinghamFluidMaterial2::computeDevStrainMagnitude	(	MaterialMode	mmode,
		const FloatArray &	epsd
	)

protected

Definition at line 430 of file binghamfluid2.C.

References oofem::FloatArray::at(), and OOFEM_ERROR.

Referenced by computeDeviatoricStressVector().

double oofem::BinghamFluidMaterial2::computeDevStressMagnitude	(	MaterialMode	mmode,
		const FloatArray &	sigd
	)

protected

Definition at line 450 of file binghamfluid2.C.

References oofem::FloatArray::at(), and OOFEM_ERROR.

Referenced by computeDeviatoricStressVector().

MaterialStatus * oofem::BinghamFluidMaterial2::CreateStatus ( GaussPoint * gp ) const

virtual

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.

Definition at line 155 of file binghamfluid2.C.

References oofem::FEMComponent::giveDomain().

double oofem::BinghamFluidMaterial2::give	(	int	aProperty,
		GaussPoint *	gp
	)

virtual

Returns the value of material property 'aProperty'.

Property must be identified by unique int id. Integration point also passed to allow for materials with spatially varying properties

Parameters

aProperty	ID of property requested.
gp	Integration point,

Returns: Property value.

Reimplemented from oofem::Material.

Definition at line 142 of file binghamfluid2.C.

References oofem::Material::give(), mu_0, tau_0, Viscosity, and YieldStress.

virtual const char* oofem::BinghamFluidMaterial2::giveClassName ( ) const

inlinevirtual

Returns: Class name of the receiver.

Implements oofem::FEMComponent.

Definition at line 136 of file binghamfluid2.h.

void oofem::BinghamFluidMaterial2::giveDeviatoricStiffnessMatrix	(	FloatMatrix &	answer,
		MatResponseMode	mode,
		GaussPoint *	gp,
		TimeStep *	tStep
	)

virtual

Computes the deviatoric stiffness; $\frac{\partial\sigma_{\mathrm{dev}}}{\partial \epsilon_{\mathrm{dev}}}$ .

Parameters

answer	Stiffness matrix.
mode	Mode of result.
gp	Integration point.
tStep	Time step.

Note: This variable was actually never used:

Implements oofem::FluidDynamicMaterial.

Definition at line 202 of file binghamfluid2.C.

References oofem::FloatArray::at(), oofem::FloatMatrix::at(), BINGHAM_MIN_SHEAR_RATE, computeActualViscosity(), oofem::GaussPoint::giveMaterialMode(), oofem::Material::giveStatus(), oofem::BinghamFluidMaterial2Status::giveTempDeviatoricStrainVector(), oofem::BinghamFluidMaterial2Status::giveTempDevStrainMagnitude(), mu_0, OOFEM_ERROR, oofem::FloatMatrix::resize(), stressGrowthRate, tau_0, oofem::FloatArray::zero(), and oofem::FloatMatrix::zero().

double oofem::BinghamFluidMaterial2::giveEffectiveViscosity	(	GaussPoint *	gp,
		TimeStep *	tStep
	)

virtual

Gives the effective viscosity for the given integration point.

Parameters

gp	Gauss point of interest.
tStep	Time step.

Returns: The effective viscosity in the point.

Implements oofem::FluidDynamicMaterial.

Definition at line 97 of file binghamfluid2.C.

References oofem::FloatArray::at(), BINGHAM_MIN_SHEAR_RATE, computeActualViscosity(), oofem::Material::giveStatus(), oofem::BinghamFluidMaterial2Status::giveTempDeviatoricStrainVector(), oofem::BinghamFluidMaterial2Status::giveTempDevStrainMagnitude(), oofem::min(), mu_0, mu_inf, stressGrowthRate, tau_0, and tau_c.

void oofem::BinghamFluidMaterial2::giveInputRecord ( DynamicInputRecord & input )

virtual

Setups the input record string of receiver.

Parameters

input Dynamic input record to be filled by receiver.

Reimplemented from oofem::Material.

Definition at line 87 of file binghamfluid2.C.

References _IFT_BinghamFluidMaterial2_mu0, _IFT_BinghamFluidMaterial2_muinf, _IFT_BinghamFluidMaterial2_stressGrowthRate, _IFT_BinghamFluidMaterial2_tau0, oofem::Material::giveInputRecord(), mu_0, mu_inf, oofem::DynamicInputRecord::setField(), stressGrowthRate, and tau_0.

virtual const char* oofem::BinghamFluidMaterial2::giveInputRecordName ( ) const

inlinevirtual

Returns: Input record name of the receiver.

Implements oofem::FEMComponent.

Definition at line 137 of file binghamfluid2.h.

References _IFT_BinghamFluidMaterial2_Name, and oofem::FEMComponent::checkConsistency().

IRResultType oofem::BinghamFluidMaterial2::initializeFrom ( InputRecord * ir )

virtual

Initializes receiver according to object description stored in input record.

This function is called immediately after creating object using constructor. Input record can be imagined as data record in component database belonging to receiver. Receiver may use value-name extracting functions to extract particular field from record.