7.16.2.1. Volume Heating

Scope: Aria Region, Equation System, Explicit Equation System, Root Finder Equation System
Summary: Defines a volumetric heat source. Exactly one heating type specification is allowed.
Description: The volumetric heating must be applied to at least one volume. If a user subroutine is specified, then real and integer data may be declared that will be local in scope to this instance of the volume heating.

begin Volume Heating Name

   Add Volume VolumeList...

   Chemeq {=} Model

   Element Subroutine {=} Name

   Element Variable {=} Name

   Field Scaling {=} Scale_factor

   Integer Data Values...

   Integrated Power Output VariableName

   Joule Heating

   Nodal Variable {=} Name

   Real Data Values...

   Scaling Time Function {=} Function

   Scaling With Global Variable {=} name

   Source Fortran Subroutine {=} Name

   Temperature Function {=} Function

   Time Function {=} Function

   Use Data Block Name

   Use Toggle Block ToggleName [ {on} ElementBlockList...  ]

   Use Verdi

   Value {=} vhs

   Verdi Qdot Scaling {=} Scale_factor For Keyval...

end Volume Heating Name

7.16.2.1.1. Line Commands

Add Volume

Syntax: Add Volume VolumeList…
Summary: Specifies the mesh volume to which this code feature is to be applied. More than one volume name may be specified, as a space-delimited list.

Parameter	Value	Default
VolumeList	string…	–

Chemeq

Syntax: Chemeq {=} Model
Summary: Specifies that volume heating is due to chemical reaction. Here MODEL pertains to the paired CHEMEQ MODEL and CHEMEQ SOLVER command blocks that define the chemical system and how it can evolve. Chemical heating source contributions are further controlled through parameters in the CHEMEQ SOLVER command block.

Parameter	Value	Default
{=}	{= \| are \| is}	–
Model	string	–

Element Subroutine

Syntax: Element Subroutine {=} Name
Summary: Specifies that the named user-defined subroutine be used. At most one subroutine name may be specified for a given quantity. This subroutine must conform to the “element signature” argument list type.

Parameter	Value	Default
{=}	{= \| are \| is}	–
Name	string	–

Element Variable

Syntax: Element Variable {=} Name
Summary: Specifies the name of an element variable in which the volumetric heat source is stored. The units of this term are power per unit volume. Currently, this must be constant in space over each finite element.

Parameter	Value	Default
{=}	{= \| are \| is}	–
Name	string	–

Field Scaling

Syntax: Field Scaling {=} Scale_factor
Summary: This command is only relevant when the NODAL VARIABLE or ELEMENT VARIABLE command line option is present. The command enables scaling of the Field variable for the element blocks within this Volume Heat command block.

Parameter	Value	Default
{=}	{= \| are \| is}	–
Scale_factor	real	–

Integer Data

Syntax: Integer Data Values…
Summary: List of integer data values to be used by the FORTRAN user subroutine. Copies of these values are provided to the subroutine hence changes to these values within the subroutine are not saved.

Parameter	Value	Default
Values	integer…	–

Integrated Power Output

Syntax: Integrated Power Output VariableName
Summary: Calculate the total power associated with this flux boundary condition.
Description: This line command specifies that, as a postprocess, the normal flux associated with this boundary condition be integrated over the surface to obtain the total power which is then stored into a global variable named “VariableName”. This global variable may then be output to history files, or accessed in user subroutines, etc.

Parameter	Value	Default
VariableName	string	–

Joule Heating

Syntax: Joule Heating
Summary: Specifies that Joule heating will be applied. This model requires that either a VOLTAGE or CURRENT Equation be defined on the specified element block(s). Additionally the corresponding electrical conductivity must be defined.

Nodal Variable

Syntax: Nodal Variable {=} Name
Summary: Specifies the name of a nodal variable in which the volumetric heat source is stored. The units of this term are power per unit volume.
Description: The nodal variable could be user defined, which could originate from a transfer in the case of coupled mechanics, or from some user subroutine. The nodal values are interpolated to the Gauss points and then integrated over each element.

Parameter	Value	Default
{=}	{= \| are \| is}	–
Name	string	–

Real Data

Syntax: Real Data Values…
Summary: List of real data values to be used by the FORTRAN user subroutine. Copies of these values are provided to the subroutine hence changes to these values within the subroutine are not saved.

Parameter	Value	Default
Values	real…	–

Scaling Time Function

Syntax: Scaling Time Function {=} Function
Summary: This command is only relevant when the NODAL VARIABLE or ELEMENT VARIABLE command line option is present. This command enables time function scaling of the field variable for the element blocks within this Volume Heat command block.

Parameter	Value	Default
{=}	{= \| are \| is}	–
Function	string	–

Scaling With Global Variable

Syntax: Scaling With Global Variable {=} name
Summary: This command is only relevant when the NODE VARIABLE or ELEMENT VARIABLE command line option is present. The command enables scaling of the source Field by a global variable for the surfaces within the Volume Heat command block. The scalar global variable itself must be defined at the Region scope as type double with length 1.

Parameter	Value	Default
{=}	{= \| are \| is}	–
name	string	–

Source Fortran Subroutine

Syntax: Source Fortran Subroutine {=} Name
Summary: Specify the name of a FORTRAN user subroutine that will be used to calculate the volumetric source.

Parameter	Value	Default
{=}	{= \| are \| is}	–
Name	string	–

Temperature Function

Syntax: Temperature Function {=} Function
Summary: Specifies a temperature dependent function name for a volumetric heat source to be applied in the named volume.

Parameter	Value	Default
{=}	{= \| are \| is}	–
Function	string	–

Time Function

Syntax: Time Function {=} Function
Summary: Specifies a time function dependent name for a volumetric heat source to be applied in the named volume.

Parameter	Value	Default
{=}	{= \| are \| is}	–
Function	string	–

Use Data Block

Syntax: Use Data Block Name
Summary: Reference to predefined data to be used by the user subroutine. These values may be changed by the user subroutine.

Parameter	Value	Default
Name	string	–

Use Toggle Block

Syntax: Use Toggle Block ToggleName [ {on} ElementBlockList… ]
Summary: Specification for toggling entities in the computational model based on Toggle Block parameters. When used at the region level, the list of element blocks to be toggled must be provided. Otherwise a listing of entities is not needed as the Toggle Block will be associated with the command line or the enclosing command block.

Parameter	Value	Default
ToggleName	string	–

Use Verdi

Syntax: Use Verdi
Summary: Specifies that the external Goodyear code VERDI should be used to calculate the volumetric heating source term. The value is assumed to be constant in space over each finite element. WARNINGS: There are some caveats: the code will abort (1) with multi-processor runs, since Verdi is inherently serial; (2) with 3-d simulations, since Verdi expects a 2D heat problem to be solved; (3) whenever mesh adaptivity is in use, since Verdi uses three different meshes in its work that must remain very closely related; and (4) whenever Verdi is called from an executable other than eagle (including Calore), since only eagle links against Verdi.

Value

Syntax: Value {=} vhs
Summary: Specifies a constant value for a volumetric heat source to be applied in the named volume.

Parameter	Value	Default
{=}	{= \| are \| is}	–
vhs	real	–

Verdi Qdot Scaling

Syntax: Verdi Qdot Scaling {=} Scale_factor For Keyval…
Summary: This command is only relevant when the USE VERDI command line option is present. The command enables scaling of the element Qdot scale factor for a collection of element blocks. This command can appear within the command block several times with different scaling factors for each set of elements. Qdot scaling for element blocks not appearing in a VERDI QDOT SCALING command line is set to unity.

Parameter	Value	Default
{=}	{= \| are \| is}	–
Scale_factor	real	–
Keyval	string…	–