BoratedWater

Description

BoratedWater is a CriticalitySearch that performs a criticality search based on the natural boron weight ppm in water. This object will clear the nuclides in the provided material, and overwrite with natural water and natural boron, to the specific boron weight ppm. The density of the material remains unchanged (but it may still be being set by a coupled thermal-fluid application).

commentnote

This object does not search in your cross section library to see what nuclides are present (some libraries do not include O18, for instance). OpenMC will throw an error if your library is missing a nuclide that BoratedWater is trying to add. To circumvent this, please explicitly note which of the natural nuclides from hydrogen (H1, H2), boron (B10, B11), and oxygen (O16, O17, O18) are missing from your material with absent_nuclides. Currently, only O18 is supported.

warningwarning

This object does not currently add S(a,b) tables. To correctly account for thermal scattering in water, the starting material definition in OpenMC must include the correct thermal scattering library.

Example Input File Syntax

The following input will perform a criticality search for each OpenMC solve by searching via the boron ppm of material 2.

[Problem<<<{"href": "../../syntax/Problem/index.html"}>>>]
  type = OpenMCCellAverageProblem
  density_blocks = '0'
  cell_level = 0
  verbose = true

  [CriticalitySearch<<<{"href": "../../syntax/Problem/CriticalitySearch/index.html"}>>>]
    type = BoratedWater
    absent_nuclides = 'O18'
    material_id = 2
    minimum = 0
    maximum = 1000
    tolerance = 1e-2
  []
[]
(test/tests/criticality/borated_water/openmc.i)

Input Parameters

  • material_idMaterial ID to modify

    C++ Type:int

    Controllable:No

    Description:Material ID to modify

  • maximumMaximum for values to search over; the root must occur at a value smaller than the maximum

    C++ Type:double

    Unit:(no unit assumed)

    Controllable:No

    Description:Maximum for values to search over; the root must occur at a value smaller than the maximum

  • minimumMinimum for values to search over; the root must occur at a value greater than the minimum

    C++ Type:double

    Unit:(no unit assumed)

    Controllable:No

    Description:Minimum for values to search over; the root must occur at a value greater than the minimum

Required Parameters

  • absent_nuclidesNatural nuclides of hydrogen, oxygen, or boron which are missing from your cross section library; some cross section libraries do not have entries for O17 and O18. If your library does not have these nuclides you will get an error from this object trying to add them. For these missing nuclides, specify them here and their abundance will be applied to the main isotope of each element. Currently, only O18 is supported.

    C++ Type:std::vector<std::string>

    Controllable:No

    Description:Natural nuclides of hydrogen, oxygen, or boron which are missing from your cross section library; some cross section libraries do not have entries for O17 and O18. If your library does not have these nuclides you will get an error from this object trying to add them. For these missing nuclides, specify them here and their abundance will be applied to the main isotope of each element. Currently, only O18 is supported.

  • estimatorcombinedType of eigenvalue estimator to use

    Default:combined

    C++ Type:MooseEnum

    Options:collision, absorption, tracklength, combined

    Controllable:No

    Description:Type of eigenvalue estimator to use

  • target1Target value of k effective to search for

    Default:1

    C++ Type:double

    Unit:(no unit assumed)

    Range:target > 0.0

    Controllable:No

    Description:Target value of k effective to search for

  • tolerance0.001Absolute tolerance to converge multiplication factor; be aware that if too few particles are used, statistical noise may require many criticality calculations to converge.

    Default:0.001

    C++ Type:double

    Unit:(no unit assumed)

    Range:tolerance > 0

    Controllable:No

    Description:Absolute tolerance to converge multiplication factor; be aware that if too few particles are used, statistical noise may require many criticality calculations to converge.

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:No

    Description:Set the enabled status of the MooseObject.

Advanced Parameters

Input Files