LiquidBridgeClassicalWilletSpecies Class Reference

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

#include <LiquidBridgeClassicalWilletSpecies.h>

Inheritance diagram for LiquidBridgeClassicalWilletSpecies:

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

Public Member Functions
	LiquidBridgeClassicalWilletSpecies ()
	The default constructor. More...
	LiquidBridgeClassicalWilletSpecies (const LiquidBridgeClassicalWilletSpecies &s)
	The default copy constructor. More...
	~LiquidBridgeClassicalWilletSpecies ()
	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 (LiquidBridgeClassicalWilletSpecies *S, LiquidBridgeClassicalWilletSpecies *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

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

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

Member Typedef Documentation

InteractionType

typedef LiquidBridgeClassicalWilletInteraction LiquidBridgeClassicalWilletSpecies::InteractionType

The correct Interaction type for this AdhesiveForceSpecies.

Constructor & Destructor Documentation

LiquidBridgeClassicalWilletSpecies() [1/2]

LiquidBridgeClassicalWilletSpecies::LiquidBridgeClassicalWilletSpecies

(

)

The default constructor.

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

References cbrtLiquidBridgeVolume_, contactAngle_, liquidBridgeVolume_, and surfaceTension_.

LiquidBridgeClassicalWilletSpecies() [2/2]

LiquidBridgeClassicalWilletSpecies::LiquidBridgeClassicalWilletSpecies

(

const LiquidBridgeClassicalWilletSpecies &

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<<"LiquidBridgeClassicalWilletSpecies::LiquidBridgeClassicalWilletSpecies(const LiquidBridgeClassicalWilletSpecies &p) finished"<<std::endl;
#endif
}

References cbrtLiquidBridgeVolume_, contactAngle_, liquidBridgeVolume_, s, and surfaceTension_.

~LiquidBridgeClassicalWilletSpecies()

LiquidBridgeClassicalWilletSpecies::~LiquidBridgeClassicalWilletSpecies

(

)

The default destructor.

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

Member Function Documentation

getBaseName()

std::string LiquidBridgeClassicalWilletSpecies::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 "LiquidBridgeClassicalWillet";
}

getContactAngle()

Mdouble LiquidBridgeClassicalWilletSpecies::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 LiquidBridgeClassicalWilletInteraction::computeAdhesionForce().

getLiquidBridgeVolume()

Mdouble LiquidBridgeClassicalWilletSpecies::getLiquidBridgeVolume

(

)

const

used to access the Volume of the liquid bridge.

Returns

the volume of the liquid bridge.

{
    return liquidBridgeVolume_;
}

References liquidBridgeVolume_.

Referenced by LiquidBridgeClassicalWilletInteraction::computeAdhesionForce().

getSurfaceTension()

Mdouble LiquidBridgeClassicalWilletSpecies::getSurfaceTension

(

)

const

used to access the surface tension of the liquid.

Returns

the surface tension of the liquid.

{
    return surfaceTension_;
}

References surfaceTension_.

Referenced by LiquidBridgeClassicalWilletInteraction::computeAdhesionForce().

mix()

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

{
    liquidBridgeVolume_ = BaseSpecies::average(S->getLiquidBridgeVolume(), T->getLiquidBridgeVolume());
    cbrtLiquidBridgeVolume_ = cbrt(liquidBridgeVolume_);
    surfaceTension_ = BaseSpecies::average(S->getSurfaceTension(), T->getSurfaceTension());
    contactAngle_ = BaseSpecies::average(S->getContactAngle(), T->getContactAngle());
    setInteractionDistance();
}

References BaseSpecies::average(), Eigen::numext::cbrt(), cbrtLiquidBridgeVolume_, contactAngle_, liquidBridgeVolume_, oomph::QuadTreeNames::S, setInteractionDistance(), and surfaceTension_.

read()

void LiquidBridgeClassicalWilletSpecies::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_;
    cbrtLiquidBridgeVolume_ = cbrt(liquidBridgeVolume_);
    is >> dummy >> surfaceTension_;
    is >> dummy >> contactAngle_;
    setInteractionDistance();
}

References Eigen::numext::cbrt(), cbrtLiquidBridgeVolume_, contactAngle_, liquidBridgeVolume_, setInteractionDistance(), oomph::Global_string_for_annotation::string(), and surfaceTension_.

setContactAngle()

void LiquidBridgeClassicalWilletSpecies::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_always(contactAngle >= 0, "Error in setContactAngle(%), contactAngle should be >= 0", contactAngle);
    contactAngle_ = contactAngle;
    setInteractionDistance();
}

References contactAngle_, logger, and setInteractionDistance().

setInteractionDistance()

void LiquidBridgeClassicalWilletSpecies::setInteractionDistance ( )

virtual

Returns

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

Reimplemented from BaseAdhesiveForce.

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

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

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

setLiquidBridgeVolume()

void LiquidBridgeClassicalWilletSpecies::setLiquidBridgeVolume

(

Mdouble

liquidBridgeVolume

)

used to set the Volume of the liquid bridge.

Parameters

[in]

liquidBridgeVolume

the volume of the liquid bridge.

{
    logger.assert_always(liquidBridgeVolume >= 0, "Error in setLiquidBridgeVolume(%), liquidBridgeVolume should be >= 0", liquidBridgeVolume);
    liquidBridgeVolume_ = liquidBridgeVolume;
    cbrtLiquidBridgeVolume_ = cbrt(liquidBridgeVolume);
    setInteractionDistance();
}

References Eigen::numext::cbrt(), cbrtLiquidBridgeVolume_, liquidBridgeVolume_, logger, and setInteractionDistance().

setSurfaceTension()

void LiquidBridgeClassicalWilletSpecies::setSurfaceTension

(

Mdouble

surfaceTension

)

used to set the surface tension of the liquid.

Parameters

[in]

surfaceTension

the surface tension of the liquid.

{
    logger.assert_always(surfaceTension >= 0, "Error in setSurfaceTension(%), surfaceTension should be >= 0", surfaceTension);
    surfaceTension_ = surfaceTension;
}

References logger, and surfaceTension_.

write()

void LiquidBridgeClassicalWilletSpecies::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 LiquidBridgeClassicalWilletSpecies::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 LiquidBridgeClassicalWilletSpecies(), mix(), read(), setInteractionDistance(), and setLiquidBridgeVolume().

contactAngle_

Mdouble LiquidBridgeClassicalWilletSpecies::contactAngle_

private

contact angle between particle and liquid bridge surface

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

liquidBridgeVolume_

Mdouble LiquidBridgeClassicalWilletSpecies::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(), LiquidBridgeClassicalWilletSpecies(), mix(), read(), setLiquidBridgeVolume(), and write().

surfaceTension_

Mdouble LiquidBridgeClassicalWilletSpecies::surfaceTension_

private

surface tension of the liquid

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

---

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

• LiquidBridgeClassicalWilletSpecies.h
• LiquidBridgeClassicalWilletSpecies.cc