Difference between revisions of "Kharon input manual"

From Kraken Wiki
Jump to: navigation, search
Line 14: Line 14:
 
=== Simulation control parameters ===
 
=== Simulation control parameters ===
  
The keyword that defines this group is ''simulationControl''. The following set of parameters can be set inside this group.
+
The keyword that defines this group is ''simulationControl''. The following parameters can be set inside this group. The bare minimum is to provide a value for the number of phases, ''nPhases''.
  
 
{|class="wikitable" style="text-align: left;"
 
{|class="wikitable" style="text-align: left;"
Line 27: Line 27:
 
| 1 = single-phase water or 2 = water and steam  
 
| 1 = single-phase water or 2 = water and steam  
 
|
 
|
| Number of phases
+
| Number of phases.
 
|-
 
|-
 
| {{highlight|nIterMax|PaleGreen}}
 
| {{highlight|nIterMax|PaleGreen}}
Line 33: Line 33:
 
| positive integer
 
| positive integer
 
| 500
 
| 500
| Number of solution (outer) iterations
+
| Number of solution (outer) iterations.
 
|-
 
|-
 
| {{highlight|urfU|PaleGreen}}
 
| {{highlight|urfU|PaleGreen}}
 
| 1*real
 
| 1*real
| [0,1]
+
| [0, 1]
 
| 0.5
 
| 0.5
| Under-relaxation factor for velocity [-]
+
| Under-relaxation factor for velocity [-].
 
|-
 
|-
 
| {{highlight|urfP|PaleGreen}}
 
| {{highlight|urfP|PaleGreen}}
 
| 1*real
 
| 1*real
| [0,1]
+
| [0, 1]
 
| 0.5
 
| 0.5
| Under-relaxation factor for pressure [-]
+
| Under-relaxation factor for pressure [-].
 
|-
 
|-
 
| {{highlight|urfH|PaleGreen}}
 
| {{highlight|urfH|PaleGreen}}
 
| 1*real
 
| 1*real
| [0,1]
+
| [0, 1]
 
| 0.9
 
| 0.9
| Under-relaxation factor for enthalpy [-]
+
| Under-relaxation factor for enthalpy [-].
 
|-
 
|-
 
| {{highlight|gravity|PaleGreen}}
 
| {{highlight|gravity|PaleGreen}}
 
| 1*real
 
| 1*real
| [0,1]
+
| [<math> -\infty </math>, <math> \infty </math>]
| 0.9
+
| -9.81
| Under-relaxation factor for enthalpy [-]
+
| Gravitational acceleration (in the direction of positive z-coordinate; upwards) [m/s<sup>2</sup>]
 +
|-
 +
| {{highlight|readRestart|PaleGreen}}
 +
| 1*integer
 +
| 0 = No, 1 = Yes
 +
| 0
 +
| Start from a previously saved state?
 +
|-
 +
| {{highlight|standAlone|PaleGreen}}
 +
| 1*integer
 +
| 0 = Multiphysics coupling, 1 = Stand-alone simulation
 +
| 0
 +
| Start a stand-alone simulation?
 +
|-
 +
| {{highlight|writeFormat|PaleGreen}}
 +
| 1*word
 +
| ascii, binary
 +
| ascii
 +
| Write format for output fields
 +
|-
 +
| {{highlight|materialProperties|PaleGreen}}
 +
| 1*word
 +
| libTable, libFluid
 +
| libTable
 +
| Calculation of material properties: libTable = linear interpolation from a pretabulated set of material properties, libFluid = IAPWS standard polynomial functions.
 
|-
 
|-
 +
| {{highlight|thermalBC|PaleGreen}}
 +
| 1*word
 +
| power, heatFlux, wallTemperature
 +
| heatFlux
 +
| Thermal boundary condition: power = set the power to each cell (Kharon converts this to heat flux and calculates the surface temperature distribution), heatFlux = set the heat flux of the heated surfaces in each cell (Kharon converts this to power and calculates the surface temperature distribution), wallTemperature = set the surface temperature of the heated surfaces in each cell (Kharon calculates the heat flux and power distributions).
 
|}
 
|}
  
 
=== Inlet definition ===
 
=== Inlet definition ===
 +
 +
The keyword that defines this group is ''inlet''.
 +
 +
{|class="wikitable" style="text-align: left;"
 +
!Keyword
 +
!Size and type
 +
!Valid options
 +
!Default
 +
!Description
 +
|-
 +
| {{highlight|nPhases|tomato}}
 +
| 1*integer
 +
| 1 = single-phase water or 2 = water and steam
 +
|
 +
| Number of phases.
 +
|-
 +
| {{highlight|nIterMax|PaleGreen}}
 +
| 1*integer
 +
| positive integer
 +
| 500
 +
| Number of solution (outer) iterations.
 +
|}
  
 
=== Outlet definition ===
 
=== Outlet definition ===

Revision as of 13:10, 4 June 2019

The Kharon input is a keyword input. It consists of several grouped input parameters. Each group starts with the keyword that defines the group (name of the group), possibly followed by data entries associated with the keyword. The group can consist of several keyword (parameter name) and value pairs that are enclosed within a set of curly brackets.

  • A working input file consists of several input groups.
  • The order of the groups or the parameter name and value pairs within the group is not important.
  • The input file can contain comments: all characters after '#', '!', and '%' on each line are considered as comments.
  • All keywords, operators, and data entries must be separated by one or more spaces or line changes, since they are regarded as words.


Input groups

Simulation control parameters

The keyword that defines this group is simulationControl. The following parameters can be set inside this group. The bare minimum is to provide a value for the number of phases, nPhases.

Keyword Size and type Valid options Default Description
nPhases 1*integer 1 = single-phase water or 2 = water and steam Number of phases.
nIterMax 1*integer positive integer 500 Number of solution (outer) iterations.
urfU 1*real [0, 1] 0.5 Under-relaxation factor for velocity [-].
urfP 1*real [0, 1] 0.5 Under-relaxation factor for pressure [-].
urfH 1*real [0, 1] 0.9 Under-relaxation factor for enthalpy [-].
gravity 1*real [ -\infty ,  \infty ] -9.81 Gravitational acceleration (in the direction of positive z-coordinate; upwards) [m/s2]
readRestart 1*integer 0 = No, 1 = Yes 0 Start from a previously saved state?
standAlone 1*integer 0 = Multiphysics coupling, 1 = Stand-alone simulation 0 Start a stand-alone simulation?
writeFormat 1*word ascii, binary ascii Write format for output fields
materialProperties 1*word libTable, libFluid libTable Calculation of material properties: libTable = linear interpolation from a pretabulated set of material properties, libFluid = IAPWS standard polynomial functions.
thermalBC 1*word power, heatFlux, wallTemperature heatFlux Thermal boundary condition: power = set the power to each cell (Kharon converts this to heat flux and calculates the surface temperature distribution), heatFlux = set the heat flux of the heated surfaces in each cell (Kharon converts this to power and calculates the surface temperature distribution), wallTemperature = set the surface temperature of the heated surfaces in each cell (Kharon calculates the heat flux and power distributions).

Inlet definition

The keyword that defines this group is inlet.

Keyword Size and type Valid options Default Description
nPhases 1*integer 1 = single-phase water or 2 = water and steam Number of phases.
nIterMax 1*integer positive integer 500 Number of solution (outer) iterations.

Outlet definition

List of fuel types

Core definition

Load pattern

Assembly numbering (optional)