Computes the load (and possibly tangent) for surface tension. More...

#include <surfacetensionbc.h>

Inheritance diagram for oofem::SurfaceTensionBoundaryCondition:

Collaboration diagram for oofem::SurfaceTensionBoundaryCondition:

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

virtual	~SurfaceTensionBoundaryCondition ()
	Destructor. More...

virtual IRResultType	initializeFrom (InputRecord *ir)
	Initializes receiver according to object description stored in input record. More...

virtual void	assemble (SparseMtrx &answer, TimeStep *tStep, CharType type, const UnknownNumberingScheme &r_s, const UnknownNumberingScheme &c_s, double scale=1.0)
	Assembles B.C. More...

virtual void	assembleVector (FloatArray &answer, TimeStep tStep, CharType type, ValueModeType mode, const UnknownNumberingScheme &s, FloatArray eNorms=NULL)
	Assembles B.C. More...

virtual void	giveLocationArrays (std::vector< IntArray > &rows, std::vector< IntArray > &cols, CharType type, const UnknownNumberingScheme &r_s, const UnknownNumberingScheme &c_s)
	Gives a list of location arrays that will be assembled. More...

virtual const char *	giveClassName () const

virtual const char *	giveInputRecordName () const

Public Member Functions inherited from oofem::ActiveBoundaryCondition
	ActiveBoundaryCondition (int n, Domain *d)
	Constructor. More...

virtual	~ActiveBoundaryCondition ()
	Destructor. More...

virtual void	addElementSide (int elem, int side)
	Adds element for active boundary condition. More...

virtual bool	requiresActiveDofs ()
	Checks to see if active boundary condition requires special DOFs. More...

virtual bool	isPrimaryDof (ActiveDof *dof)
	Checks to see if the dof is a primary DOF. More...

virtual double	giveBcValue (Dof dof, ValueModeType mode, TimeStep tStep)
	Returns the prescribed value of a dof (if any). More...

virtual bool	hasBc (Dof dof, TimeStep tStep)
	Returns the prescribed value of a dof (if any). More...

virtual int	giveNumberOfMasterDofs (ActiveDof *dof)
	Allows for active boundary conditions to handle their own special DOF. More...

virtual Dof *	giveMasterDof (ActiveDof *dof, int mdof)
	Give the pointer to master dof belonging to active DOF. More...

virtual void	computeDofTransformation (ActiveDof *dof, FloatArray &masterContribs)

virtual double	giveUnknown (PrimaryField &field, ValueModeType mode, TimeStep tStep, ActiveDof dof)
	Computes the value of the dof. More...

virtual double	giveUnknown (ValueModeType mode, TimeStep tStep, ActiveDof dof)
	Computes the value of the dof. More...

Public Member Functions inherited from oofem::GeneralBoundaryCondition
	GeneralBoundaryCondition (int n, Domain *d)
	Constructor. More...

virtual	~GeneralBoundaryCondition ()
	Destructor. More...

int	giveSetNumber ()
	Gives the set number which boundary condition is applied to. More...

virtual int	giveNumberOfInternalDofManagers ()
	Gives the number of internal dof managers. More...

virtual DofManager *	giveInternalDofManager (int i)
	Gives an internal dof manager from receiver. More...

Function *	giveTimeFunction ()

virtual bcValType	giveBCValType () const
	Returns receiver load type. More...

virtual bool	isImposed (TimeStep *tStep)
	Returns nonzero if receiver representing BC is imposed at given time, otherwise returns zero. More...

virtual const IntArray &	giveDofIDs () const
	Array with default dofs which b.c. More...

virtual bcType	giveType () const

virtual bcGeomType	giveBCGeoType () const
	Returns geometry character of boundary condition. More...

virtual void	scale (double s)
	Scales the receiver according to given value. More...

virtual void	postInitialize ()
	Performs post initialization steps. More...

virtual void	giveInputRecord (DynamicInputRecord &input)
	Setups the input record string of receiver. 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...

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 int	checkConsistency ()
	Allows programmer to test some internal data, before computation begins. More...

virtual void	printOutputAt (FILE file, TimeStep tStep)
	Prints output of receiver to stream, for given time step. More...

virtual void	printYourself ()
	Prints receiver state on stdout. Useful for debugging. 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
void	computeLoadVectorFromElement (FloatArray &answer, Element e, int side, TimeStep tStep)
	Helper function for computing the contributions to the load vector. More...

void	computeTangentFromElement (FloatMatrix &answer, Element e, int side, TimeStep tStep)
	Helper function for computing the tangent ( $K = \frac{\mathrm{d}F}{\mathrm{d}u}$ ) More...

Private Attributes
double	gamma
	Surface tension. More...

bool	useTangent
	Determines if tangent should be used. More...

Additional Inherited Members
Protected Attributes inherited from oofem::GeneralBoundaryCondition
int	timeFunction
	Associated load time function. More...

bcValType	valType
	Physical meaning of BC value. More...

IntArray	dofs
	Dofs that b.c. is applied to (relevant for Dirichlet type b.c.s). More...

int	isImposedTimeFunction
	Zero by default - the BC is than always imposed. More...

int	set
	Set number for boundary condition to be applied to. 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

Computes the load (and possibly tangent) for surface tension.

This boundary condition applicable to both solid and flow problems. Computing this load and tangent is involves some fairly complicated expression with lengthy derivations, especially for 3D surfaces.

Definition at line 57 of file surfacetensionbc.h.

Constructor & Destructor Documentation

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

inline

Constructor.

Creates boundary an active condition with given number, belonging to given domain.

Parameters

n	Boundary condition number.
d	Domain to which new object will belongs.

Definition at line 68 of file surfacetensionbc.h.

virtual oofem::SurfaceTensionBoundaryCondition::~SurfaceTensionBoundaryCondition ( )

inlinevirtual

Destructor.

Definition at line 70 of file surfacetensionbc.h.

Member Function Documentation

void oofem::SurfaceTensionBoundaryCondition::assemble	(	SparseMtrx &	answer,
		TimeStep *	tStep,
		CharType	type,
		const UnknownNumberingScheme &	r_s,
		const UnknownNumberingScheme &	c_s,
		double	scale = `1.0`
	)

virtual

Assembles B.C.

contributions to specified matrix.

Parameters

[in,out]	answer	Matrix to assemble to.
	tStep	Active time step.
	tStep	Active time step.
	type	Type of matrix to assemble.
	r_s	Row numbering scheme.
	c_s	Column numbering scheme.
	scale	Scaling factor.

Reimplemented from oofem::ActiveBoundaryCondition.

Definition at line 95 of file surfacetensionbc.C.

References oofem::SparseMtrx::assemble(), oofem::IntArray::at(), oofem::FEInterpolation::boundaryGiveNodes(), computeTangentFromElement(), oofem::GeneralBoundaryCondition::dofs, oofem::Element::giveBoundaryLocationArray(), oofem::FEMComponent::giveDomain(), oofem::Domain::giveElement(), oofem::Element::giveInterpolation(), oofem::Domain::giveSet(), oofem::IntArray::giveSize(), OOFEM_ERROR, oofem::FloatMatrix::times(), and useTangent.

void oofem::SurfaceTensionBoundaryCondition::assembleVector	(	FloatArray &	answer,
		TimeStep *	tStep,
		CharType	type,
		ValueModeType	mode,
		const UnknownNumberingScheme &	s,
		FloatArray *	eNorms = `NULL`
	)

virtual

Assembles B.C.

contributions to specified vector.

Parameters

[in,out]	answer	Vector to assemble to.
	tStep	Active time step.
	type	Type of matrix to assemble.
	mode	Mode of value.
	s	Numbering scheme.
	eNorms	Norms for each dofid.

Returns: Equivalent of the sum of the element norm (squared) of assembled vector.

Reimplemented from oofem::ActiveBoundaryCondition.

Definition at line 124 of file surfacetensionbc.C.

References oofem::FloatArray::assemble(), oofem::FloatArray::assembleSquared(), oofem::IntArray::at(), oofem::FEInterpolation::boundaryGiveNodes(), computeLoadVectorFromElement(), oofem::GeneralBoundaryCondition::dofs, oofem::Element::giveBoundaryLocationArray(), oofem::FEMComponent::giveDomain(), oofem::Domain::giveElement(), oofem::Element::giveInterpolation(), oofem::Domain::giveSet(), and oofem::IntArray::giveSize().

void oofem::SurfaceTensionBoundaryCondition::computeLoadVectorFromElement	(	FloatArray &	answer,
		Element *	e,
		int	side,
		TimeStep *	tStep
	)

protected

Helper function for computing the contributions to the load vector.

Todo:: More of this grunt work should be moved to the interpolation classes

Todo:: This should rely on the xindex and yindex in the interpolator..

Definition at line 264 of file surfacetensionbc.C.

Referenced by assembleVector().

void oofem::SurfaceTensionBoundaryCondition::computeTangentFromElement	(	FloatMatrix &	answer,
		Element *	e,
		int	side,
		TimeStep *	tStep
	)

protected

Helper function for computing the tangent ( $K = \frac{\mathrm{d}F}{\mathrm{d}u}$ )

Todo:: More of this grunt work should be moved to the interpolation classes

Todo:: The thickness is not often relevant or used in FM.

Todo:: Derive expressions for this.

Definition at line 153 of file surfacetensionbc.C.

Referenced by assemble().

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

inlinevirtual

Returns: Class name of the receiver.

Implements oofem::FEMComponent.

Definition at line 84 of file surfacetensionbc.h.

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

inlinevirtual

Returns: Input record name of the receiver.

Implements oofem::FEMComponent.

Definition at line 85 of file surfacetensionbc.h.

References _IFT_SurfaceTensionBoundaryCondition_Name.

void oofem::SurfaceTensionBoundaryCondition::giveLocationArrays	(	std::vector< IntArray > &	rows,
		std::vector< IntArray > &	cols,
		CharType	type,
		const UnknownNumberingScheme &	r_s,
		const UnknownNumberingScheme &	c_s
	)

virtual

Gives a list of location arrays that will be assembled.

This should only be used to construct zero structure in sparse matrices. The rows and columns location arrays returned in tuples (stored in vector), allowing to efficiently assemble and allocate off-diagonal blocks. The nonzero entries are assembled and allocated for entries at (rows[i], cols[i]) positions.

Parameters

rows	List of location arrays for r_s.
cols	List of location arrays for c_s.
type	Type of matrix to assemble.
r_s	Row numbering scheme.
c_s	Column numbering scheme.

Reimplemented from oofem::ActiveBoundaryCondition.

Definition at line 70 of file surfacetensionbc.C.

References oofem::IntArray::at(), oofem::FEInterpolation::boundaryGiveNodes(), oofem::GeneralBoundaryCondition::dofs, oofem::Element::giveBoundaryLocationArray(), oofem::FEMComponent::giveDomain(), oofem::Domain::giveElement(), oofem::Element::giveInterpolation(), oofem::Domain::giveSet(), oofem::IntArray::giveSize(), oofem::IntArray::resize(), and useTangent.

IRResultType oofem::SurfaceTensionBoundaryCondition::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.