- gap_kThermal conductivity variable across the gap.
C++ Type:std::vector<VariableName>
Unit:(no unit assumed)
Controllable:No
Description:Thermal conductivity variable across the gap.
- variableTemperature variable
C++ Type:std::vector<VariableName>
Unit:(no unit assumed)
Controllable:No
Description:Temperature variable
GasGapConductance
Stores computed gap conductance for gas-filled gap.
This object can be set up automatically by using the Thermal Contact LWR Action action.
Theory related to gap heat transfer can be found in Gap Plenum Models. The following describes specific instructions how to setup the models.
Gap Conductance Model
The default values are contact_coef=10.0 and roughness_coef=1.5. To utilize the Toptan model by Toptan et al. (2020), set gap_conductance_model=TOPTAN.
[thermal_contact]
...
gap_conductance_model = TOPTAN
...
[]
Fill Gas Thermal Conductivity
Two modeling options are available in BISON to compute the fill gas thermal conductivity of each constituent and its dependence on temperature and/or pressure.
DEFAULT, a temperature-dependent model from MATPRO (Allison et al., 1993)
[ThermalContact<<<{"href": "../../syntax/Modules/HeatTransfer/ThermalContact/index.html"}>>>]
[thermal_contact]
type = GasGapHeatTransfer
variable = temp
primary = 3
secondary = 2
plenum_pressure = plenum_pressure
initial_gas_types = He
initial_fractions = 1
roughness_coef = 0
emissivity_primary = 0
emissivity_secondary = 0
jumpdistance_primary = 0.0
jumpdistance_secondary = 0.0
[]
[](test/tests/fill_gas_thermal_conductivity/gas_type.i)ADVANCED, a temperature- and pressure-dependent model (Tournier and El-Genk, 2008; Toptan et al., 2019)
Add the line
gas_thermal_conductivity_model = ADVANCED
to the input block shown above.
Varying Fill Gas Fractions
See Gas Mixture for syntax regarding varying the fill gas as a function of time.
Temperature Jump Distance
Two modeling options are available in BISON to compute the temperature jump distance and its dependence on the gas properties.
LANNING, Kennard's model based on a review by Lanning and Hann (1975)
The Kennard coefficient, kennard_coefficient is 5756 (default).
[ThermalContact<<<{"href": "../../syntax/Modules/HeatTransfer/ThermalContact/index.html"}>>>]
[thermal_contact]
type = GasGapHeatTransfer
variable = temp
primary = cladInSurf
secondary = fuelOutSurf
jump_distance_model = LANNING
plenum_pressure = plenumPressure
roughness_coef = 0
emissivity_primary = 0
emissivity_secondary = 0
[]
[](test/tests/temperature_jump_distance/He_legacy.i)TOPTAN, Kennard's model based on a review by Toptan et al. (2019)
The Kennard coefficient, kennard_coefficient is 0.2173 for the monatomic gases, 0.1149 for the diatomic gases, and 0.1242 for the polyatomic gases.
[ThermalContact<<<{"href": "../../syntax/Modules/HeatTransfer/ThermalContact/index.html"}>>>]
[thermal_contact]
type = GasGapHeatTransfer
variable = temp
primary = cladInSurf
secondary = fuelOutSurf
jump_distance_model = TOPTAN
kennard_coefficient = 0.2173
plenum_pressure = plenumPressure
roughness_coef = 0
emissivity_primary = 0
emissivity_secondary = 0
[]
[](test/tests/temperature_jump_distance/He_toptan.i)Thermal Accommodation Coefficient
Two modeling options are available in BISON to compute the thermal accommodation coefficient and its dependence on the gas properties.
DEFAULT, a model from MATPRO (Allison et al., 1993) based on Lanning and Hann (1975)
[ThermalContact<<<{"href": "../../syntax/Modules/HeatTransfer/ThermalContact/index.html"}>>>]
[thermal_contact]
type = GasGapHeatTransfer
variable = temp
primary = cladInSurf
secondary = fuelOutSurf
jump_distance_model = LANNING
plenum_pressure = plenumPressure
roughness_coef = 0
emissivity_primary = 0
emissivity_secondary = 0
[]
[](test/tests/thermal_accommodation_coeff/He_legacy.i)TOPTAN, a model that is recommended by Toptan et al. (2019).
[ThermalContact<<<{"href": "../../syntax/Modules/HeatTransfer/ThermalContact/index.html"}>>>]
[thermal_contact]
type = GasGapHeatTransfer
variable = temp
primary = cladInSurf
secondary = fuelOutSurf
jump_distance_model = LANNING
thermal_accommodation_model = TOPTAN
plenum_pressure = plenumPressure
roughness_coef = 0
emissivity_primary = 0
emissivity_secondary = 0
[]
[](test/tests/thermal_accommodation_coeff/He_toptan.i)Meyer's Hardness of Cladding
The default value of the Meyer hardness is 680MN/m. Alternatively, the following temperature-dependent correlation (Hagrman et al., 1980) is available in the code.
[ThermalContact<<<{"href": "../../syntax/Modules/HeatTransfer/ThermalContact/index.html"}>>>]
[thermal_contact]
type = GasGapHeatTransfer
variable = temp
primary = 3
secondary = 2
roughness_primary = 2e-6
roughness_secondary = 2e-6
roughness_coef = 0
emissivity_primary = 0
emissivity_secondary = 0
min_gap = 1e-5
meyer_hardness_model = MATPRO
quadrature = true
tangential_tolerance = 1e-5
contact_pressure = contact_pressure
warnings = true
[]
[](test/tests/gap_heat_transfer/gap_heat_transfer_contact_pressure2m.i)Input Parameters
- appended_property_nameName appended to material properties to make them unique
C++ Type:std::string
Controllable:No
Description:Name appended to material properties to make them unique
- blockThe list of blocks (ids or names) that this object will be applied
C++ Type:std::vector<SubdomainName>
Controllable:No
Description:The list of blocks (ids or names) that this object will be applied
- boundaryThe list of boundaries (ids or names) from the mesh where this object applies
C++ Type:std::vector<BoundaryName>
Controllable:No
Description:The list of boundaries (ids or names) from the mesh where this object applies
- computeTrueWhen false, MOOSE will not call compute methods on this material. The user must call computeProperties() after retrieving the MaterialBase via MaterialBasePropertyInterface::getMaterialBase(). Non-computed MaterialBases are not sorted for dependencies.
Default:True
C++ Type:bool
Controllable:No
Description:When false, MOOSE will not call compute methods on this material. The user must call computeProperties() after retrieving the MaterialBase via MaterialBasePropertyInterface::getMaterialBase(). Non-computed MaterialBases are not sorted for dependencies.
- conductivity_namethermal_conductivityThe name of the MaterialProperty associated with conductivity ("thermal_conductivity" in the case of heat conduction).
Default:thermal_conductivity
C++ Type:MaterialPropertyName
Unit:(no unit assumed)
Controllable:No
Description:The name of the MaterialProperty associated with conductivity ("thermal_conductivity" in the case of heat conduction).
- constant_onNONEWhen ELEMENT, MOOSE will only call computeQpProperties() for the 0th quadrature point, and then copy that value to the other qps.When SUBDOMAIN, MOOSE will only call computeQpProperties() for the 0th quadrature point, and then copy that value to the other qps. Evaluations on element qps will be skipped
Default:NONE
C++ Type:MooseEnum
Controllable:No
Description:When ELEMENT, MOOSE will only call computeQpProperties() for the 0th quadrature point, and then copy that value to the other qps.When SUBDOMAIN, MOOSE will only call computeQpProperties() for the 0th quadrature point, and then copy that value to the other qps. Evaluations on element qps will be skipped
- contact_coef10The leading coefficient on the solid-solid conduction relation (1/sqrt(m)).
Default:10
C++ Type:double
Unit:(no unit assumed)
Controllable:No
Description:The leading coefficient on the solid-solid conduction relation (1/sqrt(m)).
- contact_pressureThe contact pressure variable.
C++ Type:std::vector<VariableName>
Unit:(no unit assumed)
Controllable:No
Description:The contact pressure variable.
- cylinder_axis_point_1Start point for line defining cylindrical axis
C++ Type:libMesh::VectorValue<double>
Unit:(no unit assumed)
Controllable:No
Description:Start point for line defining cylindrical axis
- cylinder_axis_point_2End point for line defining cylindrical axis
C++ Type:libMesh::VectorValue<double>
Unit:(no unit assumed)
Controllable:No
Description:End point for line defining cylindrical axis
- declare_suffixAn optional suffix parameter that can be appended to any declared properties. The suffix will be prepended with a '_' character.
C++ Type:MaterialPropertyName
Unit:(no unit assumed)
Controllable:No
Description:An optional suffix parameter that can be appended to any declared properties. The suffix will be prepended with a '_' character.
- emissivity_primary1The emissivity of the primary surface
Default:1
C++ Type:double
Unit:(no unit assumed)
Controllable:No
Description:The emissivity of the primary surface
- emissivity_secondary1The emissivity of the secondary surface
Default:1
C++ Type:double
Unit:(no unit assumed)
Controllable:No
Description:The emissivity of the secondary surface
- external_pressure0Input external pressure in Pascals.
Default:0
C++ Type:double
Unit:(no unit assumed)
Controllable:No
Description:Input external pressure in Pascals.
- gap_conductance_modelDEFAULTGap conductance model: DEFAULT=computed according to the original model;TOPTAN=computed according to Toptan et al., 2020
Default:DEFAULT
C++ Type:MooseEnum
Controllable:No
Description:Gap conductance model: DEFAULT=computed according to the original model;TOPTAN=computed according to Toptan et al., 2020
- gap_geometry_typeGap calculation type.
C++ Type:MooseEnum
Controllable:No
Description:Gap calculation type.
- gap_tempTemperature on the other side of the gap
C++ Type:std::vector<VariableName>
Unit:(no unit assumed)
Controllable:No
Description:Temperature on the other side of the gap
- gas_mixtureThe name of the VectorPostprocessor that will compute the gas mixture.
C++ Type:VectorPostprocessorName
Unit:(no unit assumed)
Controllable:No
Description:The name of the VectorPostprocessor that will compute the gas mixture.
- gas_thermal_conductivity_modelDEFAULTFill gas thermal conductivity model: DEFAULT=traditional model from MATPRO-11, =f(T));ADVANCED=model from Toptan et al. (2019), =f(T,P)
Default:DEFAULT
C++ Type:MooseEnum
Controllable:No
Description:Fill gas thermal conductivity model: DEFAULT=traditional model from MATPRO-11, =f(T));ADVANCED=model from Toptan et al. (2019), =f(T,P)
- gascond_scalef1Scaling factor for gas conductivity.
Default:1
C++ Type:double
Unit:(no unit assumed)
Controllable:No
Description:Scaling factor for gas conductivity.
- jump_distance_modelDIRECTJump distance model: DIRECT=specify distances directly;LANNING=computed as a function of gas properties (Lanning and Hahn, 1975)TOPTAN=computed as a function of gas properties (Toptan et al., 2019)
Default:DIRECT
C++ Type:MooseEnum
Controllable:No
Description:Jump distance model: DIRECT=specify distances directly;LANNING=computed as a function of gas properties (Lanning and Hahn, 1975)TOPTAN=computed as a function of gas properties (Toptan et al., 2019)
- jumpdistance_primary0The temperature jump distance for the primary surface (m).
Default:0
C++ Type:double
Unit:(no unit assumed)
Controllable:No
Description:The temperature jump distance for the primary surface (m).
- jumpdistance_secondary0The temperature jump distance for the secondary surface (m).
Default:0
C++ Type:double
Unit:(no unit assumed)
Controllable:No
Description:The temperature jump distance for the secondary surface (m).
- layer_thicknessThe layer thickness variable computed in LayerThickness auxiliary kernel
C++ Type:std::vector<VariableName>
Unit:(no unit assumed)
Controllable:No
Description:The layer thickness variable computed in LayerThickness auxiliary kernel
- max_gap1e+06A maximum gap (denominator) size
Default:1e+06
C++ Type:double
Unit:(no unit assumed)
Controllable:No
Description:A maximum gap (denominator) size
- meyer_hardness6.8e+08The Meyer hardness of the softer material (Pa).
Default:6.8e+08
C++ Type:double
Unit:(no unit assumed)
Controllable:No
Description:The Meyer hardness of the softer material (Pa).
- meyer_hardness_modelDIRECTMeyer hardness model of the softer material: DIRECT=specify hardness directly;MATPRO=computed as a function of temperature
Default:DIRECT
C++ Type:MooseEnum
Controllable:No
Description:Meyer hardness model of the softer material: DIRECT=specify hardness directly;MATPRO=computed as a function of temperature
- min_gap1e-06A minimum gap (denominator) size
Default:1e-06
C++ Type:double
Unit:(no unit assumed)
Controllable:No
Description:A minimum gap (denominator) size
- min_gap_order0Order of the Taylor expansion below min_gap
Default:0
C++ Type:unsigned int
Controllable:No
Description:Order of the Taylor expansion below min_gap
- plenum_pressureThe name of the plenum_pressure postprocessor value.
C++ Type:PostprocessorName
Unit:(no unit assumed)
Controllable:No
Description:The name of the plenum_pressure postprocessor value.
- roughness_coef1.5The coefficient for the roughness summation.
Default:1.5
C++ Type:double
Unit:(no unit assumed)
Controllable:No
Description:The coefficient for the roughness summation.
- roughness_primary1e-06The roughness of the primary surface (m).
Default:1e-06
C++ Type:double
Unit:(no unit assumed)
Controllable:No
Description:The roughness of the primary surface (m).
- roughness_secondary1e-06The roughness of the secondary surface (m).
Default:1e-06
C++ Type:double
Unit:(no unit assumed)
Controllable:No
Description:The roughness of the secondary surface (m).
- secondary_sideTrueWhether the boundary corresponds to the secondary side in mechanical contact.
Default:True
C++ Type:bool
Controllable:No
Description:Whether the boundary corresponds to the secondary side in mechanical contact.
- sphere_originOrigin for sphere geometry
C++ Type:libMesh::VectorValue<double>
Unit:(no unit assumed)
Controllable:No
Description:Origin for sphere geometry
- stefan_boltzmann5.67037e-08The Stefan-Boltzmann constant
Default:5.67037e-08
C++ Type:double
Unit:(no unit assumed)
Controllable:No
Description:The Stefan-Boltzmann constant
- thermal_accommodation_modelDEFAULTThermal accommodation model: DEFAULT=traditional model from Lanning and Hahn (1975);TOPTAN=model from Toptan et al. (2019b).
Default:DEFAULT
C++ Type:MooseEnum
Controllable:No
Description:Thermal accommodation model: DEFAULT=traditional model from Lanning and Hahn (1975);TOPTAN=model from Toptan et al. (2019b).
- warningsFalseWhether to output warning messages concerning nodes not being found
Default:False
C++ Type:bool
Controllable:No
Description:Whether to output warning messages concerning nodes not being found
Optional Parameters
- control_tagsAdds user-defined labels for accessing object parameters via control logic.
C++ Type:std::vector<std::string>
Controllable:No
Description:Adds user-defined labels for accessing object parameters via control logic.
- enableTrueSet the enabled status of the MooseObject.
Default:True
C++ Type:bool
Controllable:Yes
Description:Set the enabled status of the MooseObject.
- implicitTrueDetermines whether this object is calculated using an implicit or explicit form
Default:True
C++ Type:bool
Controllable:No
Description:Determines whether this object is calculated using an implicit or explicit form
- kennard_coefficient5756Nominal leading model coefficient for LANNING.
Default:5756
C++ Type:double
Unit:(no unit assumed)
Controllable:No
Description:Nominal leading model coefficient for LANNING.
- seed0The seed for the master random number generator
Default:0
C++ Type:unsigned int
Controllable:No
Description:The seed for the master random number generator
- use_displaced_meshTrueWhether or not this object should use the displaced mesh for computation. Note that in the case this is true but no displacements are provided in the Mesh block the undisplaced mesh will still be used.
Default:True
C++ Type:bool
Controllable:No
Description:Whether or not this object should use the displaced mesh for computation. Note that in the case this is true but no displacements are provided in the Mesh block the undisplaced mesh will still be used.
Advanced Parameters
- gap_conductivity1The thermal conductivity of the gap material
Default:1
C++ Type:double
Unit:(no unit assumed)
Controllable:No
Description:The thermal conductivity of the gap material
- gap_conductivity_functionThermal conductivity of the gap material as a function. Multiplied by gap_conductivity.
C++ Type:FunctionName
Unit:(no unit assumed)
Controllable:No
Description:Thermal conductivity of the gap material as a function. Multiplied by gap_conductivity.
- gap_conductivity_function_variableVariable to be used in the gap_conductivity_function in place of time
C++ Type:std::vector<VariableName>
Unit:(no unit assumed)
Controllable:No
Description:Variable to be used in the gap_conductivity_function in place of time
Gap Conductivity Parameters
- gap_distanceDistance across the gap
C++ Type:std::vector<VariableName>
Unit:(no unit assumed)
Controllable:No
Description:Distance across the gap
Gap Size Parameters
- orderFIRSTThe finite element order
Default:FIRST
C++ Type:MooseEnum
Controllable:No
Description:The finite element order
- quadratureFalseWhether or not to do quadrature point based gap heat transfer. If this is true then gap_distance and gap_temp should NOT be provided (and will be ignored); however, paired_boundary and variable are then required.
Default:False
C++ Type:bool
Controllable:No
Description:Whether or not to do quadrature point based gap heat transfer. If this is true then gap_distance and gap_temp should NOT be provided (and will be ignored); however, paired_boundary and variable are then required.
Integration Parameters
- output_propertiesList of material properties, from this material, to output (outputs must also be defined to an output type)
C++ Type:std::vector<std::string>
Controllable:No
Description:List of material properties, from this material, to output (outputs must also be defined to an output type)
- outputsnone Vector of output names where you would like to restrict the output of variables(s) associated with this object
Default:none
C++ Type:std::vector<OutputName>
Controllable:No
Description:Vector of output names where you would like to restrict the output of variables(s) associated with this object
Outputs Parameters
- paired_boundaryThe boundary to be penetrated
C++ Type:BoundaryName
Controllable:No
Description:The boundary to be penetrated
Gap Surface Definition Parameters
- prop_getter_suffixAn optional suffix parameter that can be appended to any attempt to retrieve/get material properties. The suffix will be prepended with a '_' character.
C++ Type:MaterialPropertyName
Unit:(no unit assumed)
Controllable:No
Description:An optional suffix parameter that can be appended to any attempt to retrieve/get material properties. The suffix will be prepended with a '_' character.
- use_interpolated_stateFalseFor the old and older state use projected material properties interpolated at the quadrature points. To set up projection use the ProjectedStatefulMaterialStorageAction.
Default:False
C++ Type:bool
Controllable:No
Description:For the old and older state use projected material properties interpolated at the quadrature points. To set up projection use the ProjectedStatefulMaterialStorageAction.
Material Property Retrieval Parameters
References
- C. M. Allison, G. A. Berna, R. Chambers, E. W. Coryell, K. L. Davis, D. L. Hagrman, D. T. Hagrman, N. L. Hampton, J. K. Hohorst, R. E. Mason, M. L. McComas, K. A. McNeil, R. L. Miller, C. S. Olsen, G. A. Reymann, and L. J. Siefken.
SCDAP/RELAP5/MOD3.1 code manual, volume IV: MATPRO-A library of materials properties for light-water-reactor accident analysis.
Technical Report NUREG/CR-6150, EGG-2720, Idaho National Engineering Laboratory, 1993.[BibTeX]
- D L Hagrman, G A Reymann, and R E Manson.
MATPRO-Version 11 (rev. 1): A Handbook of Materials Properties for Use in the Analysis of Light Water Reactor Fuel Rod Behavior.
USNRC Report NUREG/CR-0497, TREE-1290, Idaho National Engineering Laboratories, February 1980.
doi:10.2172/6442256.[BibTeX]
- D. D. Lanning and C. R. Hann.
Review of methods applicable to the calculation of gap conductance in zircaloy-clad uo2 fuel rods.
Technical Report BWNL-1894, UC-78B, Pacific Northwest National Laboratory, 1975.[BibTeX]
- A Toptan, D J Kropaczek, and M N Avramova.
Gap conductance modeling I: theoretical considerations for single- and multi-component gases in curvilinear coordinates.
Nuclear Engineering and Design, 353:110283, 2019.
doi:10.1016/j.nucengdes.2019.110283.[BibTeX]
- A Toptan, D J Kropaczek, and M N Avramova.
On the validity of the dilute gas assumption for gap conductance calculations in nuclear fuel performance codes.
Nuclear Engineering and Design, 350:1–8, 2019.
doi:10.1016/j.nucengdes.2019.04.042.[BibTeX]
- Aysenur Toptan, Jason D. Hales, Richard L. Williamson, Stephen R. Novascone, Giovanni Pastore, and David J. Kropaczek.
Modeling of gap conductance for LWR fuel rods applied in the BISON code.
Journal of Nuclear Science and Technology, 57(8):963–974, 2020.
doi:10.1080/00223131.2020.1740808.[BibTeX]
- J-M P Tournier and M S El-Genk.
Properties of noble gases and binary mixtures for closed brayton cycle applications.
Energy Conversion and Management, 49(3):469–492, 2008.
doi:10.1016/j.enconman.2007.06.050.[BibTeX]