LiquidBridgeWilletSpecies Class Reference

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...
	~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 *S, LiquidBridgeWilletSpecies *T)
	creates default values for mixed species More...
void	setInteractionDistance ()
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 BaseForce
BaseSpecies *	getBaseSpecies () const
void	setBaseSpecies (BaseSpecies *baseSpecies)

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.

Member Typedef Documentation

InteractionType

typedef LiquidBridgeWilletInteraction LiquidBridgeWilletSpecies::InteractionType

The correct Interaction type for this AdhesiveForceSpecies.

Constructor & Destructor Documentation

LiquidBridgeWilletSpecies() [1/2]

LiquidBridgeWilletSpecies::LiquidBridgeWilletSpecies

(

)

The default constructor.

{
    liquidBridgeVolume_ = 0;
    cbrtLiquidBridgeVolume_ = 0;
    surfaceTension_ = 0;
    contactAngle_ = 0;
    setInteractionDistance();
#ifdef DEBUG_CONSTRUCTOR
    std::cout<<"LiquidBridgeWilletSpecies::LiquidBridgeWilletSpecies() finished"<<std::endl;
#endif
}

References cbrtLiquidBridgeVolume_, contactAngle_, liquidBridgeVolume_, setInteractionDistance(), and surfaceTension_.

LiquidBridgeWilletSpecies() [2/2]

LiquidBridgeWilletSpecies::LiquidBridgeWilletSpecies

(

const LiquidBridgeWilletSpecies &

s

)

The default copy constructor.

Parameters

[in]

the

species that is copied

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

References cbrtLiquidBridgeVolume_, contactAngle_, liquidBridgeVolume_, and surfaceTension_.

~LiquidBridgeWilletSpecies()

LiquidBridgeWilletSpecies::~LiquidBridgeWilletSpecies

(

)

The default destructor.

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

Member Function Documentation

getBaseName()

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")

{
    return "LiquidBridgeWillet";
}

getContactAngle()

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.

{
    return contactAngle_;
}

References contactAngle_.

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

getLiquidBridgeVolume()

Mdouble LiquidBridgeWilletSpecies::getLiquidBridgeVolume

(

)

const

used to access the Volume of the liquid bridge.

Returns

the volume of the liquid bridge.

{
    return liquidBridgeVolume_;
}

References liquidBridgeVolume_.

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

getSurfaceTension()

Mdouble LiquidBridgeWilletSpecies::getSurfaceTension

(

)

const

used to access the surface tension of the liquid.

Returns

the surface tension of the liquid.

{
    return surfaceTension_;
}

References surfaceTension_.

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

mix()

void LiquidBridgeWilletSpecies::mix	(	LiquidBridgeWilletSpecies *	S,
		LiquidBridgeWilletSpecies *	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

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

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

read()

void LiquidBridgeWilletSpecies::read

(

std::istream &

is

)

Reads the species properties from an input stream.

Parameters

[in]

input

stream (typically the restart file)

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

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

setContactAngle()

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.

{
    logger.assert_debug(contactAngle >= 0,"Error in setContactAngle");
    contactAngle_ = contactAngle;
    setInteractionDistance();
}

References contactAngle_, logger, and setInteractionDistance().

setInteractionDistance()

void LiquidBridgeWilletSpecies::setInteractionDistance

(

)

Returns

the maximum separation distance below which adhesive forces can occur (needed for contact detection)

{
    getBaseSpecies()->setInteractionDistance((1.0 + 0.5 * contactAngle_) * cbrtLiquidBridgeVolume_);
}

References cbrtLiquidBridgeVolume_, contactAngle_, BaseForce::getBaseSpecies(), and BaseSpecies::setInteractionDistance().

Referenced by LiquidBridgeWilletSpecies(), read(), setContactAngle(), and setLiquidBridgeVolume().

setLiquidBridgeVolume()

void LiquidBridgeWilletSpecies::setLiquidBridgeVolume

(

Mdouble

liquidBridgeVolume

)

used to set the Volume of the liquid bridge.

Parameters

[in]

liquidBridgeVolume

the volume of the liquid bridge.

{
    if (liquidBridgeVolume >= 0)
    {
        liquidBridgeVolume_ = liquidBridgeVolume;
        cbrtLiquidBridgeVolume_ = cbrt(liquidBridgeVolume);
        setInteractionDistance();
    }
    else
    {
        logger(ERROR, "Error in setLiquidBridgeVolume(%)", liquidBridgeVolume);
    }
}

References cbrtLiquidBridgeVolume_, ERROR, liquidBridgeVolume_, logger, and setInteractionDistance().

Referenced by mix().

setSurfaceTension()

void LiquidBridgeWilletSpecies::setSurfaceTension

(

Mdouble

surfaceTension

)

used to set the surface tension of the liquid.

Parameters

[in]

surfaceTension

the surface tension of the liquid.

{
    if (surfaceTension >= 0)
        surfaceTension_ = surfaceTension;
    else
    {
        logger(ERROR, "Error in setSurfaceTension");
    }
}

References ERROR, logger, and surfaceTension_.

write()

void LiquidBridgeWilletSpecies::write

(

std::ostream &

os

)

const

Writes the species properties to an output stream.

Parameters

[out]

output

stream (typically the restart file)

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

References contactAngle_, liquidBridgeVolume_, and surfaceTension_.

Member Data Documentation

cbrtLiquidBridgeVolume_

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.

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

contactAngle_

Mdouble LiquidBridgeWilletSpecies::contactAngle_

private

contact angle between particle and liquid bridge surface

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

liquidBridgeVolume_

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.

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

surfaceTension_

Mdouble LiquidBridgeWilletSpecies::surfaceTension_

private

surface tension of the liquid

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

---

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

• LiquidBridgeWilletSpecies.h
• LiquidBridgeWilletSpecies.cc