Evolves an electrical potential equation. More...

#include <jouleHeatingSource.H>

Inheritance diagram for jouleHeatingSource:

Collaboration diagram for jouleHeatingSource:

Public Member Functions
	TypeName ("jouleHeatingSource")
	Runtime type information.
	jouleHeatingSource (const word &sourceName, const word &modelType, const dictionary &dict, const fvMesh &mesh, const word &defaultAreaName=word())
	Construct from explicit source name and mesh.
	jouleHeatingSource (const jouleHeatingSource &)=delete
	No copy construct.
void	operator= (const jouleHeatingSource &)=delete
	No copy assignment.
virtual	~jouleHeatingSource ()=default
	Destructor.
virtual void	addSup (const areaScalarField &h, const areaScalarField &rho, faMatrix< scalar > &eqn, const label fieldi)
	Add explicit contribution to energy equation.
virtual bool	read (const dictionary &dict)
	Read source dictionary.
Public Member Functions inherited from faceSetOption
	TypeName ("faceSetOption")
	Runtime type information.
	faceSetOption (const word &name, const word &modelType, const dictionary &dict, const fvMesh &mesh, const word &defaultAreaName=word())
	Construct from components.
virtual	~faceSetOption ()=default
	Destructor.
scalar	timeStart () const noexcept
	Return const access to the time start.
scalar	duration () const noexcept
	Return const access to the duration.
bool	inTimeLimits (const scalar timeValue) const
	Return true if within time limits.
bool	useSubMesh () const noexcept
	True if sub-selection should be used.
selectionModeType	selectionMode () const noexcept
	Return the face selection mode.
const wordRes &	selectionNames () const noexcept
	Return const access to the selection names (set, zone or patch selection).
const wordRe &	zoneName () const
	Return const access to the first set/zone/patch name.
scalar	A () const noexcept
	Return const access to the total face area.
const labelList &	faces () const noexcept
	Return const access to the local finite-area face selection.
scalar	timeStart (scalar val) noexcept
	Adjust the time start, return the old value.
scalar	duration (scalar val) noexcept
	Adjust the duration, return the old value.
virtual bool	isActive ()
	Is the source active?
Public Member Functions inherited from option
	TypeName ("option")
	Runtime type information.
	declareRunTimeSelectionTable (autoPtr, option, dictionary,(const word &name, const word &modelType, const dictionary &dict, const fvMesh &mesh, const word &areaName),(name, modelType, dict, mesh, areaName))
	option (const word &name, const word &modelType, const dictionary &dict, const fvMesh &mesh, const word &defaultAreaName=word())
	Construct from components.
autoPtr< option >	clone () const
	Return clone.
virtual	~option ()=default
	Destructor.
const word &	name () const noexcept
	The source name.
const fvMesh &	mesh () const noexcept
	Return const access to the volume mesh.
const dictionary &	coeffs () const noexcept
	Return dictionary.
bool	active () const noexcept
	True if source is active.
void	setApplied (const label fieldi)
	Set the applied flag to true for field index fieldi.
const word &	areaName () const noexcept
	The finite-area mesh name.
const word &	regionName () const noexcept
	The model region name.
const faMesh &	regionMesh () const
	Return the region mesh database (demand-driven).
const volSurfaceMapping &	vsm () const
	Return volSurfaceMapping (demand-driven).
bool	active (bool on) noexcept
	Change source active flag, return previous value.
const word &	suffixHint () const noexcept
	The suffix hint when generating variable names.
word	suffixed (const char *base) const
	Return the concatenation of `base` and the suffix hint.
word	suffixed (const std::string &base) const
	Return the concatenation of `base` and the suffix hint.
virtual label	applyToField (const word &fieldName) const
	Return index of field name if found in fieldNames list.
virtual void	checkApplied () const
	Check that the source has been applied.
virtual void	addSup (const areaScalarField &h, faMatrix< scalar > &eqn, const label fieldi)
virtual void	addSup (const areaScalarField &h, faMatrix< vector > &eqn, const label fieldi)
virtual void	addSup (const areaScalarField &h, faMatrix< symmTensor > &eqn, const label fieldi)
virtual void	addSup (const areaScalarField &h, faMatrix< sphericalTensor > &eqn, const label fieldi)
virtual void	addSup (const areaScalarField &h, faMatrix< tensor > &eqn, const label fieldi)
virtual void	addSup (const areaScalarField &h, const areaScalarField &rho, faMatrix< vector > &eqn, const label fieldi)
virtual void	addSup (const areaScalarField &h, const areaScalarField &rho, faMatrix< symmTensor > &eqn, const label fieldi)
virtual void	addSup (const areaScalarField &h, const areaScalarField &rho, faMatrix< sphericalTensor > &eqn, const label fieldi)
virtual void	addSup (const areaScalarField &h, const areaScalarField &rho, faMatrix< tensor > &eqn, const label fieldi)
virtual void	constrain (faMatrix< scalar > &eqn, const label fieldi)
virtual void	constrain (faMatrix< vector > &eqn, const label fieldi)
virtual void	constrain (faMatrix< sphericalTensor > &eqn, const label fieldi)
virtual void	constrain (faMatrix< symmTensor > &eqn, const label fieldi)
virtual void	constrain (faMatrix< tensor > &eqn, const label fieldi)
virtual void	correct (areaScalarField &field)
virtual void	correct (areaVectorField &field)
virtual void	correct (areaSphericalTensorField &field)
virtual void	correct (areaSymmTensorField &field)
virtual void	correct (areaTensorField &field)
virtual void	writeHeader (Ostream &) const
	Write the source header information.
virtual void	writeFooter (Ostream &) const
	Write the source footer information.
virtual void	writeData (Ostream &) const
	Write the source properties.

Additional Inherited Members
Public Types inherited from faceSetOption
enum	selectionModeType { smAll , smFaceSet , smFaceZone , smPatch }
	Enumeration for selection mode types. More...
Static Public Member Functions inherited from option
static autoPtr< option >	New (const word &name, const dictionary &dict, const fvMesh &mesh, const word &defaultAreaName=word())
	Return a reference to the selected faOption model.
static bool	sameRegionNames (const word &name1, const word &name2)
	Compare the region names.
Public Attributes inherited from option
bool	log
	Switch write log to Info.
Static Public Attributes inherited from faceSetOption
static const Enum< selectionModeType >	selectionModeTypeNames_
	List of selection mode type names.
Protected Member Functions inherited from faceSetOption
void	setSelection (const dictionary &dict)
	Set face selection name from dictionary input.
void	setFaceSelection ()
	Set face selection based on user input selection mode.
void	setArea ()
	Recalculate the area.
template<class Type>
void	subsetFilter (List< Type > &field) const
	Zero all non-selected locations within field.
Protected Member Functions inherited from option
void	resetApplied ()
	Resize/reset applied flag list for all fieldNames_ entries.
Protected Attributes inherited from faceSetOption
scalar	timeStart_
	Time start.
scalar	duration_
	Duration.
selectionModeType	selectionMode_
	Face selection mode.
wordRes	selectionNames_
	Face selection names (for set, zone or patch selections).
labelList	faces_
	Set of faces to apply source to.
scalar	A_
	Sum of face area.
Protected Attributes inherited from option
const word	name_
	Source name.
const word	modelType_
	Model type.
const fvMesh &	mesh_
	Reference to the mesh database.
dictionary	dict_
	Top level source dictionary.
dictionary	coeffs_
	Dictionary containing source coefficients.
wordList	fieldNames_
	Field names to apply source to - populated by derived models.
List< bool >	applied_
	Applied flag list - corresponds to each fieldNames_ entry.
word	areaName_
	The finite-area mesh name.
word	regionName_
	The model region name (finite-area).
word	suffixHint_
	Suffix hint for variable names (default: "").

Detailed Description

Evolves an electrical potential equation.

$\‍[ \grad \left( \sigma \grad V \right) \‍]$

where $ V $ is electrical potential and $\sigma$ is the electrical current.

To provide a Joule heating contribution according to:

Differential form of Joule heating - power per unit volume:

$\‍[ \frac{d(P)}{d(V)} = J \cdot E \‍]$

where $ J $ is the current density and $ E $ the electric field. If no magnetic field is present:

$\‍[ J = \sigma E \‍]$

The electric field given by

$\‍[ E = \grad V \‍]$

Therefore:

$\‍[ \frac{d(P)}{d(V)} = J \cdot E = (sigma E) \cdot E = (sigma \grad V) \cdot \grad V \‍]$

Usage

Minimal example by using constant/faOptions:

jouleHeatingSource1
{
    // Mandatory entries (unmodifiable)
    type                 jouleHeatingSource;

    // Mandatory entries (runtime modifiable)
    anisotropicElectricalConductivity true;

    // Optional entries (runtime modifiable)
    T                   <Tname>;
    nIter               -1;

    // Conditional mandatory entries (runtime modifiable)

        // when the entry "sigma" is present
        sigma           <Function1>;

        // when when the entry "sigma" is not present
        // read "sigma" from file

    // Mandatory/Optional (inherited) entries
    ...
}

where the entries mean:

Property	Description	Type	Reqd	Dflt
`type`	Type name: jouleHeatingSource	word	yes	-
`anisotropicElectricalConductivity`	Flag to indicate that if the electrical conductivity is anisotropic	bool	yes	-
`T`	Name of operand temperature field	word	no	T
`sigma`	Electrical conductivity as a function of temperature	table	no	-
`nIter`	Number of iterations for electrical potential equation solution	label	no	-1

The inherited entries are elaborated in:

Note: If the sigma entry is present, the electrical conductivity is specified as a function of temperature using a Function1 type, otherwise the sigma field will be read from file. When the anisotropicElectricalConductivity flag is set to true, sigma should be specified as a tensor quantity instead of as an isotropic scalar quantity.

BREAKING Naming changes from 2056 and earlier for the fields:

Field	Scoped names	Scoped names (old)
`V`	<scope>:V (suffix)	<scope>:V_ + regionName
`sigma`	<scope>:sigma (suffix)	<scope>:sigma_ + regionName

It is possible to replicate the older naming by specifying the suffixing to ('_' + regionName).

See also

Source files

Definition at line 214 of file jouleHeatingSource.H.

Constructor & Destructor Documentation

◆ jouleHeatingSource() [1/2]

jouleHeatingSource	(	const word &	sourceName,
		const word &	modelType,
		const dictionary &	dict,
		const fvMesh &	mesh,
		const word &	defaultAreaName = word() )

Construct from explicit source name and mesh.

Parameters

defaultAreaName The expected finite-area mesh name

References dict, and option::mesh().

Referenced by jouleHeatingSource(), and operator=().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ jouleHeatingSource() [2/2]

jouleHeatingSource ( const jouleHeatingSource & )

delete

No copy construct.

References jouleHeatingSource().

Here is the call graph for this function:

◆ ~jouleHeatingSource()

virtual ~jouleHeatingSource ( )

virtualdefault

Destructor.

Member Function Documentation

◆ TypeName()

TypeName ( "jouleHeatingSource" )

Runtime type information.

◆ operator=()

void operator= ( const jouleHeatingSource & )

delete

No copy assignment.

References jouleHeatingSource().

Here is the call graph for this function:

◆ addSup()

virtual void addSup	(	const areaScalarField &	h,
		const areaScalarField &	rho,
		faMatrix< scalar > &	eqn,
		const label	fieldi )

virtual

Add explicit contribution to energy equation.

Reimplemented from option.

References h, and rho.

◆ read()

virtual bool read ( const dictionary & dict )

virtual

Read source dictionary.

Reimplemented from faceSetOption.

References dict.

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

src/faOptions/sources/derived/jouleHeatingSource/jouleHeatingSource.H

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ jouleHeatingSource() [1/2]

◆ jouleHeatingSource() [2/2]

◆ ~jouleHeatingSource()

Member Function Documentation

◆ TypeName()

◆ operator=()

◆ addSup()

◆ read()