Public Member Functions | List of all members
electrostaticDepositionFvPatchScalarField Class Reference
Boundary conditions » Generic

The electrostaticDeposition is a boundary condition to calculate electric potential (V) on a given boundary based on film thickness (h) and film resistance (R) fields which are updated based on a given patch-normal current density field (jn), Coulombic efficiency and film resistivity. More...

Inheritance diagram for electrostaticDepositionFvPatchScalarField:
Inheritance graph
[legend]
Collaboration diagram for electrostaticDepositionFvPatchScalarField:
Collaboration graph
[legend]

Public Member Functions

 TypeName ("electrostaticDeposition")
 
 electrostaticDepositionFvPatchScalarField (const fvPatch &, const DimensionedField< scalar, volMesh > &)
 
 electrostaticDepositionFvPatchScalarField (const fvPatch &, const DimensionedField< scalar, volMesh > &, const dictionary &)
 
 electrostaticDepositionFvPatchScalarField (const electrostaticDepositionFvPatchScalarField &, const fvPatch &, const DimensionedField< scalar, volMesh > &, const fvPatchFieldMapper &)
 
 electrostaticDepositionFvPatchScalarField (const electrostaticDepositionFvPatchScalarField &)
 
virtual tmp< fvPatchScalarField > clone () const
 
 electrostaticDepositionFvPatchScalarField (const electrostaticDepositionFvPatchScalarField &, const DimensionedField< scalar, volMesh > &)
 
virtual tmp< fvPatchScalarField > clone (const DimensionedField< scalar, volMesh > &iF) const
 
const scalarField & h () const noexcept
 
virtual void autoMap (const fvPatchFieldMapper &)
 
virtual void rmap (const fvPatchScalarField &, const labelList &)
 
tmp< scalarField > sigma () const
 
virtual void updateCoeffs ()
 
virtual void write (Ostream &) const
 

Detailed Description

The electrostaticDeposition is a boundary condition to calculate electric potential (V) on a given boundary based on film thickness (h) and film resistance (R) fields which are updated based on a given patch-normal current density field (jn), Coulombic efficiency and film resistivity.

\[ j_n = - \sigma \nabla^\perp_p V = - \sigma (\vec{n}\cdot(\nabla V)_p) \]

\[ \frac{dh}{dt} = C_{eff} (j_n - j_{min}) \]

\[ \frac{dR}{dt} = \rho \frac{dh}{dt} = \rho C_{eff} (j_n - j_{min}) \]

\[ V_{film}^n = V_{film}^o + j_n R_\Delta \]

\[ V_{body} = j_n R_{body} \]

\[ V_p^n = V_i + V_{body} + V_{film}^n \]

where

$ j_n $ = Patch-normal current density [A/m^2]
$ V_p^n $ = Electric potential on film-fluid interface [volt = kg m^2/(A s^3)]
$ V_p^o $ = Previous time-step electric potential on the interface [volt]
$ V_{film} $ = Electric potential due to film resistance [volt]
$ V_{body} $ = Electric potential due to body resistance [volt]
$ V_i $ = Initial electric potential [volt]
$ R_\Delta$ = Film resistance (finite increment) [ohm m^2 = kg m^4/(A^2 s^3)]
$ R_{body} $ = Body resistance [ohm m^2 = kg m^4/(A^2 s^3)]
$ \rho $ = Isotropic film resistivity [ohm m = kg m^3/(A^2 s^3)]
$ h $ = Film thickness [m]
$ C_{eff} $ = Volumetric Coulombic efficiency [m^3/(A s)]
$ j_{min} $ = Minimum current density for deposition onset [A/m^2]
$ \sigma $ = Isotropic conductivity of mixture [S/m = A^2 s^3/(kg m^3)]
$ \vec{n} $ = Patch-normal unit vector [-]
Usage
Example of the boundary condition specification: 
<patchName>
{
    // Mandatory entries
    type                    electrostaticDeposition;
    h                       <scalarField>;
    CoulombicEfficiency     <PatchFunction1>;
    resistivity             <PatchFunction1>;

    // Conditional mandatory entries

        // Option-1: single-phase
        sigma       <scalar>;

        // Option-2: multiphase
        phases
        {
            alpha.air
            {
                sigma       <scalar>;
            }
            alpha.water
            {
                sigma       <scalar>;
            }
            alpha.mercury
            {
                sigma       <scalar>;
            }
            ...
        }

    // Optional entries
    jMin                    <scalar>;
    qMin                    <scalar>;
    Rbody                   <scalar>;
    Vi                      <scalar>;
    Vanode                  <scalar>;
    qCumulative             <scalarField>;

    // Inherited entries
    ...
}

where the entries mean:

Property Description Type Reqd Deflt
type Type name: electrostaticDeposition word yes -
h Film thickness scalarField yes -
CoulombicEfficiency Coulombic efficiency PatchFunction1<scalar> yes -
resistivity Isotropic film resistivity PatchFunction1<scalar> yes -
sigma Isotropic electrical conductivity of phase scalar yes -
jMin Minimum current density for deposition onset scalar no 0
qMin Minimum accumulative specific charge for deposition onset scalar no 0
Rbody Resistance due to main body and/or pretreatment layers scalar no 0
Vi Initial electric potential scalar no 0
Vanode Anode electric potential scalar no GREAT
qCumulative Accumulative specific charge [A s/m^2] scalarField no 0

The inherited entries are elaborated in:

Note
  • Depletion or abrasion of material due to negative current is not allowed.
  • When accumulative specific charge (qCumulative) is less than minimum accumulative specific charge (qMin), no deposition occurs.
  • Boundary-condition updates are not allowed during outer corrections to prevent spurious accumulation of film thickness.
  • resistivity, jMin, qMin and Rbody are always non-negative.
Source files

Definition at line 315 of file electrostaticDepositionFvPatchScalarField.H.

Constructor & Destructor Documentation

◆ electrostaticDepositionFvPatchScalarField() [1/5]

electrostaticDepositionFvPatchScalarField ( const fvPatch &  p,
const DimensionedField< scalar, volMesh > &  iF 
)

Definition at line 134 of file electrostaticDepositionFvPatchScalarField.C.

Referenced by electrostaticDepositionFvPatchScalarField::clone().

Here is the caller graph for this function:

◆ electrostaticDepositionFvPatchScalarField() [2/5]

electrostaticDepositionFvPatchScalarField ( const fvPatch &  p,
const DimensionedField< scalar, volMesh > &  iF,
const dictionary &  dict 
)

Definition at line 162 of file electrostaticDepositionFvPatchScalarField.C.

References dict, Foam::dimCurrent, Foam::dimLength, Foam::dimMass, Foam::dimTime, Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, forAll, dictionary::found(), MinMax::ge(), dictionary::getCheck(), Foam::glTF::key(), Foam::nl, fvPatchField::operator, fvPatchField::operator=(), p, phasei, Foam::pow3(), and Foam::sqr().

Here is the call graph for this function:

◆ electrostaticDepositionFvPatchScalarField() [3/5]

electrostaticDepositionFvPatchScalarField ( const electrostaticDepositionFvPatchScalarField &  ptf,
const fvPatch &  p,
const DimensionedField< scalar, volMesh > &  iF,
const fvPatchFieldMapper &  mapper 
)

Definition at line 278 of file electrostaticDepositionFvPatchScalarField.C.

◆ electrostaticDepositionFvPatchScalarField() [4/5]

electrostaticDepositionFvPatchScalarField ( const electrostaticDepositionFvPatchScalarField &  ptf)

Definition at line 308 of file electrostaticDepositionFvPatchScalarField.C.

◆ electrostaticDepositionFvPatchScalarField() [5/5]

electrostaticDepositionFvPatchScalarField ( const electrostaticDepositionFvPatchScalarField &  ptf,
const DimensionedField< scalar, volMesh > &  iF 
)

Definition at line 335 of file electrostaticDepositionFvPatchScalarField.C.

Member Function Documentation

◆ TypeName()

TypeName ( "electrostaticDeposition"  )

◆ clone() [1/2]

virtual tmp<fvPatchScalarField> clone ( ) const
inlinevirtual

Definition at line 439 of file electrostaticDepositionFvPatchScalarField.H.

References electrostaticDepositionFvPatchScalarField::electrostaticDepositionFvPatchScalarField().

Here is the call graph for this function:

◆ clone() [2/2]

virtual tmp<fvPatchScalarField> clone ( const DimensionedField< scalar, volMesh > &  iF) const
inlinevirtual

Definition at line 456 of file electrostaticDepositionFvPatchScalarField.H.

References electrostaticDepositionFvPatchScalarField::electrostaticDepositionFvPatchScalarField().

Here is the call graph for this function:

◆ h()

const scalarField& h ( ) const
inlinenoexcept

Definition at line 472 of file electrostaticDepositionFvPatchScalarField.H.

◆ autoMap()

void autoMap ( const fvPatchFieldMapper &  m)
virtual

Definition at line 364 of file electrostaticDepositionFvPatchScalarField.C.

◆ rmap()

void rmap ( const fvPatchScalarField &  ptf,
const labelList &  addr 
)
virtual

Definition at line 387 of file electrostaticDepositionFvPatchScalarField.C.

◆ sigma()

Foam::tmp< Foam::scalarField > sigma ( ) const

Definition at line 414 of file electrostaticDepositionFvPatchScalarField.C.

References tmp::New(), Foam::foamVersion::patch, and tmp::ref().

Here is the call graph for this function:

◆ updateCoeffs()

void updateCoeffs ( )
virtual

Definition at line 436 of file electrostaticDepositionFvPatchScalarField.C.

References Foam::endl(), forAll, Foam::gAverage(), Foam::gMax(), Foam::gMin(), Foam::Info, UPstream::master(), Foam::max(), Foam::min(), Foam::nl, Foam::operator==(), Foam::foamVersion::patch, tmp::ref(), sigma(), and timeIndex.

Here is the call graph for this function:

◆ write()

void write ( Ostream &  os) const
virtual

Definition at line 537 of file electrostaticDepositionFvPatchScalarField.C.

References os(), fvPatchField::write(), Ostream::writeEntry(), and Ostream::writeEntryIfDifferent().

Here is the call graph for this function:
The documentation for this class was generated from the following files:

Copyright © 2011-2018  OpenFOAM | OPENFOAM® is a registered trademark of OpenCFD Ltd.

Generated by   doxygen 1.8.17