Difference between revisions of "Kharon input manual"

From Kraken Wiki
Jump to: navigation, search
Line 92: Line 92:
 
=== Inlet definition ===
 
=== Inlet definition ===
  
−
The keyword that defines this group is ''inlet''.
+
The keyword that defines this group is ''inlet''. There are four available inlet types to choose from: pressureInlet, velocityInlet, massFlowInlet, totalMassFlowInlet. The inlet type determines the parameter that is required to define the flow into the domain.
 +
 
 +
==== Pressure inlet ====
 +
 
 +
{|class="wikitable" style="text-align: left;"
 +
!Keyword
 +
!Size and type
 +
!Valid options
 +
!Description
 +
|-
 +
| {{highlight|type|tomato}}
 +
| 1*word
 +
| pressureInlet
 +
| Defines a pressure inlet.
 +
|-
 +
| {{highlight|pressure|tomato}}
 +
| 1*real
 +
| [0, <math> \infty </math>]
 +
| Absolute (static) pressure at inlet [Pa].
 +
|}
 +
 
 +
==== Velocity inlet ====
  
 
{|class="wikitable" style="text-align: left;"
 
{|class="wikitable" style="text-align: left;"
Line 98: Line 119:
 
!Size and type  
 
!Size and type  
 
!Valid options  
 
!Valid options  
−
!Default
 
 
!Description
 
!Description
 
|-
 
|-
−
| {{highlight|nPhases|tomato}}
+
| {{highlight|type|tomato}}
−
| 1*integer
+
| 1*word
−
| 1 = single-phase water or 2 = water and steam
+
| velocityInlet
−
|
+
| Defines a velocity inlet.
−
| Number of phases.
 
 
|-
 
|-
−
| {{highlight|nIterMax|PaleGreen}}
+
| {{highlight|velocity|tomato}}
−
| 1*integer
+
| nPhases*real
−
| positive integer
+
| [0, <math> \infty </math>], ([0, <math> \infty </math>])
−
| 500
+
| Phase velocities at inlet [m/s].
−
| Number of solution (outer) iterations.
+
|}
 +
 
 +
==== Mass flow inlet ====
 +
 
 +
{|class="wikitable" style="text-align: left;"
 +
!Keyword
 +
!Size and type
 +
!Valid options
 +
!Description
 +
|-
 +
| {{highlight|type|tomato}}
 +
| 1*word
 +
| massFlowInlet
 +
| Defines a mass flow inlet.
 +
|-
 +
| {{highlight|massFlowRate|tomato}}
 +
| nPhases*real
 +
| [0, <math> \infty </math>], ([0, <math> \infty </math>])
 +
| Phase mass flow rates per assembly [kg/s].
 +
|}
 +
 
 +
==== Total mass flow inlet ====
 +
 
 +
{|class="wikitable" style="text-align: left;"
 +
!Keyword
 +
!Size and type
 +
!Valid options
 +
!Description
 +
|-
 +
| {{highlight|type|tomato}}
 +
| 1*word
 +
| totalMassFlowInlet
 +
| Defines a total mass flow inlet.
 +
|-
 +
| {{highlight|massFlowRate|tomato}}
 +
| 1*real
 +
| [0, <math> \infty </math>]
 +
| Total mass flow rate into the core [kg/s].
 +
|}
 +
 
 +
==== Common inlet parameters ====
 +
 
 +
In addition to the inlet type specific parameters shown above, the following parameters need to be given for all inlet types:
 +
 
 +
{|class="wikitable" style="text-align: left;"
 +
!Keyword
 +
!Size and type
 +
!Valid options
 +
!Description
 +
|-
 +
| {{highlight|temperature|tomato}}
 +
| nPhases*real
 +
| [0, <math> \infty </math>], ([0, <math> \infty </math>])
 +
| Phase temperatures at inlet [K].
 +
|-
 +
| {{highlight|volumeFraction|tomato}}
 +
| nPhases*real
 +
| [0, 1], ([0, 1])
 +
| Phase volume fractions at inlet [-].
 
|}
 
|}
  
 
=== Outlet definition ===
 
=== Outlet definition ===
 +
 +
The keyword that defines this group is ''outlet''. The following parameters need to be provided:
 +
 +
{|class="wikitable" style="text-align: left;"
 +
!Keyword
 +
!Size and type
 +
!Valid options
 +
!Description
 +
|-
 +
| {{highlight|pressure|tomato}}
 +
| 1*real
 +
| [0, <math> \infty </math>]
 +
| Absolute (static) pressure at outlet [Pa].
 +
|-
 +
| {{highlight|temperature|tomato}}
 +
| nPhases*real
 +
| [0, <math> \infty </math>], ([0, <math> \infty </math>])
 +
| Phase temperatures at outlet (for backflow) [K].
 +
|-
 +
| {{highlight|volumeFraction|tomato}}
 +
| nPhases*real
 +
| [0, 1], ([0, 1])
 +
| Phase volume fractions at outlet (for backflow) [-].
 +
|}
  
 
=== List of fuel types ===
 
=== List of fuel types ===

Revision as of 13:01, 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. There are four available inlet types to choose from: pressureInlet, velocityInlet, massFlowInlet, totalMassFlowInlet. The inlet type determines the parameter that is required to define the flow into the domain.

Pressure inlet

Keyword Size and type Valid options Description
type 1*word pressureInlet Defines a pressure inlet.
pressure 1*real [0, \infty ] Absolute (static) pressure at inlet [Pa].

Velocity inlet

Keyword Size and type Valid options Description
type 1*word velocityInlet Defines a velocity inlet.
velocity nPhases*real [0, \infty ], ([0, \infty ]) Phase velocities at inlet [m/s].

Mass flow inlet

Keyword Size and type Valid options Description
type 1*word massFlowInlet Defines a mass flow inlet.
massFlowRate nPhases*real [0, \infty ], ([0, \infty ]) Phase mass flow rates per assembly [kg/s].

Total mass flow inlet

Keyword Size and type Valid options Description
type 1*word totalMassFlowInlet Defines a total mass flow inlet.
massFlowRate 1*real [0, \infty ] Total mass flow rate into the core [kg/s].

Common inlet parameters

In addition to the inlet type specific parameters shown above, the following parameters need to be given for all inlet types:

Keyword Size and type Valid options Description
temperature nPhases*real [0, \infty ], ([0, \infty ]) Phase temperatures at inlet [K].
volumeFraction nPhases*real [0, 1], ([0, 1]) Phase volume fractions at inlet [-].

Outlet definition

The keyword that defines this group is outlet. The following parameters need to be provided:

Keyword Size and type Valid options Description
pressure 1*real [0, \infty ] Absolute (static) pressure at outlet [Pa].
temperature nPhases*real [0, \infty ], ([0, \infty ]) Phase temperatures at outlet (for backflow) [K].
volumeFraction nPhases*real [0, 1], ([0, 1]) Phase volume fractions at outlet (for backflow) [-].

List of fuel types

Core definition

Load pattern

Assembly numbering (optional)

Retrieved from "https://serpent.vtt.fi/kraken/index.php?title=Kharon_input_manual&oldid=612"