LiquidBridgeWilletSpecies contains the parameters used to describe a short-range force caused by liquid bridges. More...

#include <LiquidBridgeWilletSpecies.h>

Inheritance diagram for LiquidBridgeWilletSpecies:

Public Types
typedef LiquidBridgeWilletInteraction	InteractionType
	The correct Interaction type for this AdhesiveForceSpecies. More...

Public Member Functions
	LiquidBridgeWilletSpecies ()
	The default constructor. More...

	LiquidBridgeWilletSpecies (const LiquidBridgeWilletSpecies &s)
	The default copy constructor. More...

virtual	~LiquidBridgeWilletSpecies ()
	The default destructor. More...

void	read (std::istream &is)
	Reads the species properties from an input stream. More...

void	write (std::ostream &os) const
	Writes the species properties to an output stream. More...

std::string	getBaseName () const
	Used in Species::getName to obtain a unique name for each Species. More...

void	mix (LiquidBridgeWilletSpecies const S, LiquidBridgeWilletSpecies const T)
	creates default values for mixed species More...

Mdouble	getInteractionDistance () const
	returns the largest separation distance at which adhesive short-range forces can occur. More...

void	setLiquidBridgeVolume (Mdouble liquidBridgeVolume)
	used to set the Volume of the liquid bridge. More...

Mdouble	getLiquidBridgeVolume () const
	used to access the Volume of the liquid bridge. More...

void	setSurfaceTension (Mdouble surfaceTension)
	used to set the surface tension of the liquid. More...

Mdouble	getSurfaceTension () const
	used to access the surface tension of the liquid. More...

void	setContactAngle (Mdouble contactAngle)
	used to set the contact angle between particle and liquid bridge surface. More...

Mdouble	getContactAngle () const
	used to access the contact angle between particle and liquid bridge surface. More...

Public Member Functions inherited from BaseSpecies
	BaseSpecies ()
	The default constructor. More...

	BaseSpecies (const BaseSpecies &p)
	The copy constructor. More...

virtual	~BaseSpecies ()
	The default destructor. More...

virtual BaseSpecies *	copy () const =0
	Creates a deep copy of the object from which it is called. More...

void	setHandler (SpeciesHandler *handler)
	Sets the pointer to the handler to which this species belongs. More...

SpeciesHandler *	getHandler () const
	Returns the pointer to the handler to which this species belongs. More...

Mdouble	average (Mdouble a, Mdouble b)
	defines the average of two variables by the harmonic mean. More...

virtual void	mixAll (BaseSpecies const S, BaseSpecies const T)=0
	creates default values for mixed species More...

virtual bool	getUseAngularDOFs () const =0
	Returns true if torques (i.e. angular degrees of freedom) have to be calculated. More...

virtual BaseInteraction *	getNewInteraction (BaseInteractable P, BaseInteractable I, Mdouble timeStamp)=0
	returns new Interaction object. More...

Public Member Functions inherited from BaseObject
	BaseObject ()
	Default constructor. More...

	BaseObject (const BaseObject &p)
	Copy constructor, copies all the objects BaseObject contains. More...

virtual	~BaseObject ()
	virtual destructor More...

virtual std::string	getName () const =0
	A purely virtual function. More...

virtual void	moveInHandler (const unsigned int index)
	Except that it is virtual, it does the same thing as setIndex() does. More...

void	setIndex (const unsigned int index)
	Allows one to assign an index to an object in the handler/container. More...

void	setId (const unsigned int id)
	Assigns a unique identifier to each object in the handler (container) which remains constant even after the object is deleted from the container/handler. More...

unsigned int	getIndex () const
	Returns the index of the object in the handler. More...

unsigned int	getId () const
	Returns the unique identifier of any particular object. More...

Private Attributes
Mdouble	liquidBridgeVolume_
	Volume of the liquid bridge. More...

Mdouble	cbrtLiquidBridgeVolume_
	Cube root of the liquid bridge. More...

Mdouble	contactAngle_
	contact angle between particle and liquid bridge surface More...

Mdouble	surfaceTension_
	surface tension of the liquid More...

Detailed Description

LiquidBridgeWilletSpecies contains the parameters used to describe a short-range force caused by liquid bridges.

See LiquidBridgeWilletInteraction::computeForce for a description of the force law.

Definition at line 36 of file LiquidBridgeWilletSpecies.h.

Member Typedef Documentation

typedef LiquidBridgeWilletInteraction LiquidBridgeWilletSpecies::InteractionType

The correct Interaction type for this AdhesiveForceSpecies.

Definition at line 40 of file LiquidBridgeWilletSpecies.h.

Constructor & Destructor Documentation

LiquidBridgeWilletSpecies::LiquidBridgeWilletSpecies ( )

The default constructor.

Definition at line 29 of file LiquidBridgeWilletSpecies.cc.

References cbrtLiquidBridgeVolume_, contactAngle_, liquidBridgeVolume_, and surfaceTension_.

 {
     liquidBridgeVolume_ = std::numeric_limits<double>::quiet_NaN();
     cbrtLiquidBridgeVolume_ = std::numeric_limits<double>::quiet_NaN();
     surfaceTension_ = std::numeric_limits<double>::quiet_NaN();
     contactAngle_ = std::numeric_limits<double>::quiet_NaN();
 #ifdef DEBUG_CONSTRUCTOR
     std::cout<<"LiquidBridgeWilletSpecies::LiquidBridgeWilletSpecies() finished"<<std::endl;
 #endif
 }

LiquidBridgeWilletSpecies::LiquidBridgeWilletSpecies ( const LiquidBridgeWilletSpecies & s )

The default copy constructor.

Parameters

[in] the species that is copied

Definition at line 43 of file LiquidBridgeWilletSpecies.cc.

References contactAngle_, liquidBridgeVolume_, setLiquidBridgeVolume(), and surfaceTension_.

 {
     setLiquidBridgeVolume(s.liquidBridgeVolume_);
     surfaceTension_ = s.surfaceTension_;
     contactAngle_ = s.contactAngle_;
 #ifdef DEBUG_CONSTRUCTOR
     std::cout<<"LiquidBridgeWilletSpecies::LiquidBridgeWilletSpecies(const LiquidBridgeWilletSpecies &p) finished"<<std::endl;
 #endif
 }

LiquidBridgeWilletSpecies::~LiquidBridgeWilletSpecies ( )

virtual

The default destructor.

Definition at line 53 of file LiquidBridgeWilletSpecies.cc.

 {
 #ifdef DEBUG_DESTRUCTOR
     std::cout<<"LiquidBridgeWilletSpecies::~LiquidBridgeWilletSpecies() finished"<<std::endl;
 #endif   
 }

Member Function Documentation

std::string LiquidBridgeWilletSpecies::getBaseName ( ) const

Used in Species::getName to obtain a unique name for each Species.

Returns: a string containing the name of the species (minus the word "Species")

Definition at line 84 of file LiquidBridgeWilletSpecies.cc.

 {
     return "LiquidBridgeWillet";
 }

Mdouble LiquidBridgeWilletSpecies::getContactAngle ( ) const

used to access the contact angle between particle and liquid bridge surface.

Returns: the contact angle between particle and liquid bridge surface.

Definition at line 173 of file LiquidBridgeWilletSpecies.cc.

References contactAngle_.

Referenced by LiquidBridgeWilletInteraction::computeAdhesionForce(), and mix().

 {
     return contactAngle_;
 }

Mdouble LiquidBridgeWilletSpecies::getInteractionDistance ( ) const

virtual

returns the largest separation distance at which adhesive short-range forces can occur.

Returns: the maximum separation distance between particles below which the adhesive force is active.

Implements BaseSpecies.

Definition at line 104 of file LiquidBridgeWilletSpecies.cc.

References cbrtLiquidBridgeVolume_, and contactAngle_.

 {
     return (1.0+0.5*contactAngle_)*cbrtLiquidBridgeVolume_; 
 }

Mdouble LiquidBridgeWilletSpecies::getLiquidBridgeVolume ( ) const

used to access the Volume of the liquid bridge.

Returns: the volume of the liquid bridge.

Definition at line 129 of file LiquidBridgeWilletSpecies.cc.

References liquidBridgeVolume_.

Referenced by LiquidBridgeWilletInteraction::computeAdhesionForce(), and mix().

 {
     return liquidBridgeVolume_;
 }

Mdouble LiquidBridgeWilletSpecies::getSurfaceTension ( ) const

used to access the surface tension of the liquid.

Returns: the surface tension of the liquid.

Definition at line 151 of file LiquidBridgeWilletSpecies.cc.

References surfaceTension_.

Referenced by LiquidBridgeWilletInteraction::computeAdhesionForce(), and mix().

 {
     return surfaceTension_;
 }

void LiquidBridgeWilletSpecies::mix	(	LiquidBridgeWilletSpecies *const	S,
		LiquidBridgeWilletSpecies *const	T
	)

creates default values for mixed species

For all parameters we assume that the harmonic mean of the parameters of the original two species is a sensible default.

Parameters

[in] S,T the two species whose properties are mixed to create the new species

Definition at line 94 of file LiquidBridgeWilletSpecies.cc.

References BaseSpecies::average(), contactAngle_, getContactAngle(), getLiquidBridgeVolume(), getSurfaceTension(), setLiquidBridgeVolume(), and surfaceTension_.

 {
     setLiquidBridgeVolume(average(S->getLiquidBridgeVolume(), T->getLiquidBridgeVolume()));
     surfaceTension_ = average(S->getSurfaceTension(), T->getSurfaceTension());
     contactAngle_ = average(S->getContactAngle(), T->getContactAngle());
 }

void LiquidBridgeWilletSpecies::read ( std::istream & is )

virtual

Reads the species properties from an input stream.

Parameters

[in] input stream (typically the restart file)

Implements BaseObject.

Definition at line 73 of file LiquidBridgeWilletSpecies.cc.

References contactAngle_, liquidBridgeVolume_, and surfaceTension_.

 {
     std::string dummy;
     is >> dummy >> liquidBridgeVolume_;
     is >> dummy >> surfaceTension_;
     is >> dummy >> contactAngle_;
 }

void LiquidBridgeWilletSpecies::setContactAngle ( Mdouble contactAngle )

used to set the contact angle between particle and liquid bridge surface.

Parameters

[in] contactAngle the contact angle between particle and liquid bridge surface.

Definition at line 159 of file LiquidBridgeWilletSpecies.cc.

References contactAngle_.

 {
     if (contactAngle >= 0)
         contactAngle_ = contactAngle;
     else
     {
         std::cerr << "Error in setContactAngle" << std::endl;
         exit(-1);
     }
 }

void LiquidBridgeWilletSpecies::setLiquidBridgeVolume ( Mdouble liquidBridgeVolume )

used to set the Volume of the liquid bridge.

Parameters

[in] liquidBridgeVolume the volume of the liquid bridge.

Definition at line 112 of file LiquidBridgeWilletSpecies.cc.

References cbrtLiquidBridgeVolume_, and liquidBridgeVolume_.

Referenced by LiquidBridgeWilletSpecies(), and mix().

 {
     if (liquidBridgeVolume >= 0) 
     {
         liquidBridgeVolume_ = liquidBridgeVolume;
         cbrtLiquidBridgeVolume_ = cbrt(liquidBridgeVolume);
     }
     else
     {
         std::cerr << "Error in setLiquidBridgeVolume" << std::endl;
         exit(-1);
     }
 }

void LiquidBridgeWilletSpecies::setSurfaceTension ( Mdouble surfaceTension )

used to set the surface tension of the liquid.

Parameters

[in] surfaceTension the surface tension of the liquid.

Definition at line 137 of file LiquidBridgeWilletSpecies.cc.

References surfaceTension_.

 {
     if (surfaceTension >= 0)
         surfaceTension_ = surfaceTension;
     else
     {
         std::cerr << "Error in setSurfaceTension" << std::endl;
         exit(-1);
     }
 }

void LiquidBridgeWilletSpecies::write ( std::ostream & os ) const

virtual

Writes the species properties to an output stream.

Parameters

[out] output stream (typically the restart file)

Implements BaseObject.

Definition at line 63 of file LiquidBridgeWilletSpecies.cc.

References contactAngle_, liquidBridgeVolume_, and surfaceTension_.

         {
     os << " liquidBridgeVolume " << liquidBridgeVolume_;
     os << " surfaceTension " << surfaceTension_;
     os << " contactAngle " << contactAngle_;
 }

Member Data Documentation

Mdouble LiquidBridgeWilletSpecies::cbrtLiquidBridgeVolume_

private

Cube root of the liquid bridge.

This is a slave variable of liquidBridgeVolume_ (i.e. it is always set together) but is useful, because the cube root has to be calculated to obtain the liquid bridge adhesive force.

Definition at line 114 of file LiquidBridgeWilletSpecies.h.

Referenced by getInteractionDistance(), LiquidBridgeWilletSpecies(), and setLiquidBridgeVolume().

Mdouble LiquidBridgeWilletSpecies::contactAngle_

private

contact angle between particle and liquid bridge surface

Definition at line 119 of file LiquidBridgeWilletSpecies.h.

Referenced by getContactAngle(), getInteractionDistance(), LiquidBridgeWilletSpecies(), mix(), read(), setContactAngle(), and write().

Mdouble LiquidBridgeWilletSpecies::liquidBridgeVolume_

private

Volume of the liquid bridge.

Currently, this is a Species property (i.e. all particles have the same liquid bridge volume), but this should probably become a Particle or Interaction property.

Definition at line 106 of file LiquidBridgeWilletSpecies.h.

Referenced by getLiquidBridgeVolume(), LiquidBridgeWilletSpecies(), read(), setLiquidBridgeVolume(), and write().

Mdouble LiquidBridgeWilletSpecies::surfaceTension_

private

surface tension of the liquid

Definition at line 124 of file LiquidBridgeWilletSpecies.h.

Referenced by getSurfaceTension(), LiquidBridgeWilletSpecies(), mix(), read(), setSurfaceTension(), and write().

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

Species/AdhesiveForceSpecies/LiquidBridgeWilletSpecies.h
Species/AdhesiveForceSpecies/LiquidBridgeWilletSpecies.cc

Public Types

Public Member Functions

Private Attributes

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation