Commit 201df720 authored by Batson Iii's avatar Batson Iii
Browse files

Removing files to speed up RTD build

parent b1fabfd4
<!DOCTYPE html>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>BONAMI: Resonance Self-Shielding by the Bondarenko Method &#8212; SCALE Manual 0.0.1 documentation</title>
<link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="_static/css/custom.css" />
<link rel="stylesheet" type="text/css" href="_static/custom.css" />
<script id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script src="_static/jquery.js"></script>
<script src="_static/underscore.js"></script>
<script src="_static/doctools.js"></script>
<script src="_static/language_data.js"></script>
<script async="async" src=""></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="CENTRM: A Neutron Transport Code for Computing Continuous-Energy Spectra in General One-Dimensional Geometries and Two-Dimensional Lattice Cells" href="CENTRM.html" />
<link rel="prev" title="Standard Composition Library" href="stdcmp.html" />
<link rel="stylesheet" href="_static/custom.css" type="text/css" />
<meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="bonami-resonance-self-shielding-by-the-bondarenko-method">
<span id="id1"></span><h1>BONAMI: Resonance Self-Shielding by the Bondarenko Method<a class="headerlink" href="#bonami-resonance-self-shielding-by-the-bondarenko-method" title="Permalink to this headline"></a></h1>
<p><em>U. Mertyurek and M. L. Williams</em></p>
<p>BONAMI is a module of the SCALE code system that is used to perform
Bondarenko calculations for resonance self-shielding. BONAMI obtains
problem-independent cross sections and Bondarenko shielding factors from
a multigroup (MG) AMPX master library, and it creates a MG AMPX working
library of self-shielded, problem-dependent cross sections. Several
options may be used to compute the background cross section values using
the narrow resonance or intermediate resonance approximations, with and
without Bondarenko iterations. A novel interpolation scheme is used that
avoids many of the problems exhibited by other interpolation methods for
the Bondarenko factors. BONAMI is most commonly used in automated SCALE
sequences and is fully integrated within the SCALE cross section
processing module, XSProc.</p>
<p>The authors express gratitude to B. T. Rearden and M. A. Jessee for
their supervision of the SCALE project and review of the manuscript. The
authors acknowledge N. M. Greene, formerly of ORNL, for his original
development of and contributions to the BONAMI module and methodology.
Finally, the authors wish to thank Sheila Walker for the completion and
publication of this document.</p>
<div class="section" id="introduction">
<span id="id2"></span><h2>Introduction<a class="headerlink" href="#introduction" title="Permalink to this headline"></a></h2>
<p>BONAMI (<strong>BON</strong>darenko <strong>AM</strong>PX <strong>I</strong>nterpolator) is a SCALE
module that performs resonance self-shielding calculations based on the
Bondarenko method <a class="bibtex reference internal" href="Material%20Specification%20and%20Cross%20Section%20Processing%20Overview.html#ilich-bondarenko-group-1964" id="id3">[IlichB64]</a>. It reads Bondarenko shielding factors
(“f-factors”) and infinitely dilute microscopic cross sections from a
problem-<em>independent</em> nuclear data library processed by the AMPX
system <a class="bibtex reference internal" href="XSLib.html#wiarda-ampx-2015" id="id4">[WWCD15]</a>, interpolates the tabulated shielding factors to appropriate
temperatures and background cross sections for each nuclide in the
system, and produces a self-shielded, problem-dependent data set.</p>
<p>The code performs self-shielding for an arbitrary number of mixtures
using either the narrow resonance (NR) or intermediate resonance (IR)
approximation <a class="bibtex reference internal" href="#goldstein-theory-1962" id="id5">[GC62]</a>. The latter capability was introduced in SCALE 6.2.
BONAMI has several options for computing background cross sections,
which may include Bondarenko iterations to approximately account for the
impact of resonance interference for multiple resonance absorbers.
Heterogeneous effects are treated using equivalence theory based on an
“escape cross section” for arrays of slabs, cylinders, or spheres.
During the execution of a typical SCALE computational sequence using
XSProc, Dancoff factors for uniform lattices of square- or
triangular-pitched units are calculated automatically for BONAMI by
numerical integration over the chord length distribution. However, for
non-uniform lattices—such as those containing water holes, control rods,
and so on—the SCALE module MCDancoff can be run to compute Dancoff
factors using Monte Carlo for an arbitrary 3D configuration, and these
values are then provided in the sequence input.</p>
<p>The major advantages of the Bondarenko approach are its simplicity and
speed compared with SCALE’s more rigorous CENTRM/PMC self-shielding
method, which performs a pointwise (PW) deterministic transport
calculation “on the fly” to compute multigroup (MG) self-shielded cross
sections. With the availability of IR theory in BONAMI, accurate results
can be obtained for a variety of system types without the computation
expense of CENTRM/PMC.</p>
<div class="section" id="bondarenko-self-shielding-theory">
<span id="id6"></span><h2>Bondarenko Self-Shielding Theory<a class="headerlink" href="#bondarenko-self-shielding-theory" title="Permalink to this headline"></a></h2>
<p>In MG resonance self-shielding calculations, one is interested in
calculating effective cross sections of the form</p>
<div class="math notranslate nohighlight" id="equation-eq7-3-1">
<span class="eqno">(301)<a class="headerlink" href="#equation-eq7-3-1" title="Permalink to this equation"></a></span>\[\sigma^{(r)}_{X,g} = \frac{\int_{g}\sigma^{(r)}_{X}(E)\Phi(E)\text{dE}}{\int_{g}\Phi(E)\text{dE}} ,\]</div>
<p>where <span class="math notranslate nohighlight">\(\sigma^{(r)}_{X,g}\)</span> is the shielded MG cross section for reaction type <em>X</em> of
resonance nuclide <em>r</em> in group <em>g</em>; <span class="math notranslate nohighlight">\(\sigma^{(r)}_{X}(E)\)</span> is a PW cross section; and <span class="math notranslate nohighlight">\(\Phi(E)\)</span> is the PW
weighting function, which approximates the flux spectrum per unit of
energy for the system of interest. PW cross section values are known
from processing evaluated data in ENDF/B files; therefore, resonance
self‑shielding depends mainly on determining the problem-dependent flux
spectrum <span class="math notranslate nohighlight">\(\Phi(E)\)</span>, which may exhibit significant fine structure variations as a
result of resonance reactions.</p>
<p>The essence of the Bondarenko method is to parameterize the flux
spectrum corresponding to varying degrees of self-shielding, represented
by the background cross section parameter <span class="math notranslate nohighlight">\(\sigma_0\)</span> (called “sigma-zero”) and the
Doppler broadening temperature <em>T</em>. Hence,</p>
<div class="math notranslate nohighlight" id="equation-eq7-3-2">
<span class="eqno">(302)<a class="headerlink" href="#equation-eq7-3-2" title="Permalink to this equation"></a></span>\[\Phi \text{(E)}\to \Phi \text{(E;}\,\sigma _{\text{0,g}}^{\text{(r)}}\text{,T)}\ \ \,,\,\ \text{E}\in \text{g}\ ; \text{and} \
\sigma^{(r)}_{X,g} \rightarrow \sigma^{(r)}_{X,g}(\sigma^{(r)}_{0,g},\text{T})\]</div>
<p>With this approach, it is possible to preprocess MG data for different
background cross sections representing varying degrees of resonance
self-shielding. This allows the MG averaging to be performed during the
original MG library processing, so that BONAMI can do a simple
interpolation on the background cross section and temperature to obtain
self-shielded cross sections. This procedure is much faster than the
CENTRM/PMC method in SCALE, which computes a PW flux spectrum by solving
the neutron transport equation on a PW energy mesh in CENTRM and then
evaluates <a class="reference internal" href="#equation-eq7-3-1">(301)</a>. in PMC “on the fly” during a sequence execution.</p>
<p>BONAMI performs two main tasks: (a) computation of background cross
sections for all nuclides in each mixture in the system and (b)
interpolation of shielded cross sections from the library values
tabulated vs. background cross sections and temperature. The BONAMI
calculation is essentially isolated from the computation of the
tabulated shielded cross sections, which is performed by the AMPX
processing code system—the only connection is through the definition of
the background cross section used in processing the library values.
Various approximations can be used to parameterize the flux spectrum in
terms of a background XS, as required by the Bondarenko method. We will
first consider several approaches to representing the flux in an
infinite medium, which lead to different definitions of the background
cross section. BONAMI’s use of equivalence theory to extend the
homogeneous methods to address heterogeneous systems, such as reactor
lattices, is discussed in the following section.</p>
<div class="section" id="parameterized-flux-spectra">
<span id="id7"></span><h3>Parameterized Flux Spectra<a class="headerlink" href="#parameterized-flux-spectra" title="Permalink to this headline"></a></h3>
<p>Several approximations can be applied to the infinite medium transport
equation to parameterize the flux spectrum in terms of a background XS,
as required by the Bondarenko method. The resulting homogeneous spectra
are used in AMPX to process MG cross sections which can also can be
applied to heterogeneous systems (i.e., lattices) by using equivalence
theory; thus the key step is determining approximations that provide
parameterized solutions for homogeneous media. The neutron transport
equation for a homogeneous medium at temperature <em>T</em>, containing a
resonance nuclide <em>r</em> mixed with other nuclides can be expressed as</p>
<div class="math notranslate nohighlight" id="equation-eq7-3-3">
<span class="eqno">(303)<a class="headerlink" href="#equation-eq7-3-3" title="Permalink to this equation"></a></span>\[\left( \Sigma _{\text{t}}^{\text{(r)}}\text{(E,T)}\ +\sum\limits_{j\ne r}
{\Sigma _{\text{t}}^{\text{(j)}}\text{(E,T)}} \right)\ \Phi \text{(E,T)}\ \,\,\,=\ \ \,{{\text{S}}^{\text{(r)}}}(\text{E,T})\ \,+\,\sum\limits_{j\ne r}{{{\text{S}}^{\text{(j)}}}(\text{E,T})} ,\]</div>
<p>where <span class="math notranslate nohighlight">\(\Sigma _{\text{t}}^{\text{(r)}}\text{(E,T)}\)</span>
, <span class="math notranslate nohighlight">\(\text{S}_{{}}^{\text{(r)}}\text{(E,T)}\)</span> are the macroscopic total XS and
elastic scattering source for <em>r</em>, respectively; and <span class="math notranslate nohighlight">\(\Sigma _{\text{t}}^{\text{(j)}}\text{(E,T)}\)</span>,
<span class="math notranslate nohighlight">\(\text{S}_{{}}^{\text{(j)}}\text{(E,T)}\)</span> are the macroscopic total cross
section and elastic source, respectively, for a nuclide <em>j</em>. The cross sections in
all these expressions are Doppler-broadened to the temperature of the
medium. The nuclides in the summations (i.e., all nuclides except <em>r</em>)
are called background nuclides for the resonance absorber <em>r</em>.</p>
<p>The NR approximation can be used to approximate scattering sources of
nuclides for which the neutron energy loss is large compared with the
practical widths of resonances for the absorber materials of interest.
Applying the NR approximation for the scattering source of background
material <em>j</em> gives</p>
<div class="math notranslate nohighlight" id="equation-eq7-3-4">
<span class="eqno">(304)<a class="headerlink" href="#equation-eq7-3-4" title="Permalink to this equation"></a></span>\[\text{S}^{(j)}(\text{E,T}) \rightarrow \Sigma^{(j)}_{p}C(E) \text{for j = a NR-scatterer nuclide}\]</div>
<p>where C(E) is a slowly varying function representative of the asymptotic
(i.e., no absorption) flux in a homogeneous medium, which approximates
the flux between resonances. In the resolved resonance range of most
important resonance absorbers, the asymptotic flux per unit energy is
represented as,</p>
<div class="math notranslate nohighlight" id="equation-eq7-3-5">
<span class="eqno">(305)<a class="headerlink" href="#equation-eq7-3-5" title="Permalink to this equation"></a></span>\[C(\text{E})\ =\ \ \,\frac{{{\Phi }_{\infty }}}{E}\ \ \ ,\]</div>
<p>where <span class="math notranslate nohighlight">\({{\Phi }_{\infty }}\)</span> is an arbitrary normalization constant that cancels from the MG
cross section expression. In the thermal range a Maxwellian spectrum is
used for C(E), and in the fast range a fission spectrum is used. The
SCALE Cross Section Libraries section of the SCALE documentation gives
analytical expressions for C(E) used in AMPX to process MG data with the
NR approximation. AMPX also has an option to input numerical values for
C(E), obtained for example from a PW slowing-down calculation with
CENTRM. This method has been used to process MG data for some nuclides
on the SCALE libraries.</p>
<p>Conversely, the wide resonance (WR) approximation has been used to
represent elastic scattering sources of nuclides for which the neutron
energy loss is small compared with the practical width of the resonance.
This approximation tends to be more accurate for heavy nuclides and for
lower energies. The limit of infinite mass is usually assumed, so the WR
approximation is sometimes called the infinite mass (IM) approximation.
Because of the assumption of IM, there is no energy loss due to
collisions with WR scatterers. Applying the WR approximation for the
slowing-down source of background nuclide <em>j</em> gives</p>
<div class="math notranslate nohighlight" id="equation-eq7-3-6">
<span class="eqno">(306)<a class="headerlink" href="#equation-eq7-3-6" title="Permalink to this equation"></a></span>\[\text{S}^{(j)}(\text{E,T}) \rightarrow \Sigma^{(j)}_{s}(\text{E,T})\Phi(\text{E,T}) ;
\text{for} j = \text{a WR-scatterer nuclide}\]</div>
<p>The IR approximation was proposed in the 1960s for scatterers with
slowing-down properties intermediate between those of NR and WR
scatterers <a class="bibtex reference internal" href="#goldstein-theory-1962" id="id8">[GC62]</a>. The IR method represents the scattering source for
arbitrary nuclide <em>j</em> by a linear combination of NR and WR expressions.
This is done by introducing an IR parameter usually called lambda, such
<div class="math notranslate nohighlight" id="equation-eq7-3-7">
<span class="eqno">(307)<a class="headerlink" href="#equation-eq7-3-7" title="Permalink to this equation"></a></span>\[\text{S}_{{}}^{\text{(j)}}(\text{E,T)}\,\ \to \ \,\underbrace{\lambda _{\text{g}}^{\text{(j)}}\Sigma _{\text{p}}^{\text{(j)}}\,C(E)}_{\mathbf{NR scatterer}}\ +\ \ (1-\lambda _{\text{g}}^{\text{(j)}})\,\,\underbrace{\Sigma _{\text{s}}^{\text{(j)}}(\text{E,T})\Phi (\text{E,T})}_{\mathbf{WR scatterer}}\ \,\ \,\ ;\,\,\ \ \text{E}\in \text{g}\,\text{.}\]</div>
<p>A value of λ=1 reduces <a class="reference internal" href="#equation-eq7-3-7">(307)</a> to the NR expression, whereas λ=0 reduces the
equation to the WR expression. Fractional λ’s are for IR scatterers.
Since the type of scatterer can change with the energy, the IR lambdas
are functions of the energy group as well as the nuclide. The λ values
represent the moderation “effectiveness” of a given nuclide, compared to
hydrogen. The AMPX module LAMBDA was used to compute the IR parameters
on the SCALE libraries. (See AMPX documentation distributed with SCALE)
Substituting <a class="reference internal" href="#equation-eq7-3-7">(307)</a> into <a class="reference internal" href="#equation-eq7-3-3">(303)</a> and then dividing by the absorber number
density <em>N(r)</em> gives the following IR approximation for the infinite
medium transport equation in energy group g</p>
<div class="math notranslate nohighlight" id="equation-eq7-3-8">
<span class="eqno">(308)<a class="headerlink" href="#equation-eq7-3-8" title="Permalink to this equation"></a></span>\[\left( \sigma _{\text{t}}^{\text{(r)}}\text{(E,T)}\ \text{+}\ \sigma _{0}^{\text{(r)}}\text{(E,T) } \right)\,{{\Phi }^{\text{(r)}}}\text{(E,T)}\ \ =\,\ \frac{\text{1}}{{{\text{N}}^{\text{(r)}}}}{{\text{S}}^{\text{(r)}}}\text{(E,T)}\ +\ \frac{\text{1}}{{{\text{N}}^{\text{(r)}}}}\sum\limits_{j\ne r}{\lambda _{\text{g}}^{\text{(j)}}\,\Sigma _{\text{p}}^{\text{(j)}}C(E)\,}\]</div>
<p>where the background cross section of <em>r</em> in the homogeneous medium is
defined as</p>
<div class="math notranslate nohighlight" id="equation-eq7-3-9">
<span class="eqno">(309)<a class="headerlink" href="#equation-eq7-3-9" title="Permalink to this equation"></a></span>\[\sigma _{0}^{\text{(r)}}\text{(E,T)}\ \ =\ \ \frac{1}{{{\text{N}}^{\text{(r)}}}}\,\,\sum\limits_{j\ne r}{\left( \Sigma _{\text{a}}^{\text{(j)}}(\text{E,T})+\lambda _{\text{g}}^{\text{(j)}}\,\Sigma _{\text{s}}^{\text{(j)}}(\text{E,T})\,\, \right)}\]</div>
<p>Although <a class="reference internal" href="#equation-eq7-3-8">(308)</a> provides the flux spectrum as a function of the background
cross section <span class="math notranslate nohighlight">\(\sigma \,_{0}^{(r)}(u,T)\)</span> it is not in a form that can be
preprocessed when the MG library is generated, because the energy variation of
<span class="math notranslate nohighlight">\(\sigma \,_{0}^{(r)}(E,T)\)</span> must be known. If the total cross sections
of the background nuclides in <a class="reference internal" href="#equation-eq7-3-9">(309)</a> have different energy variations, the shape of
<span class="math notranslate nohighlight">\(\sigma \,_{0}^{(r)}(E,T)\)</span> depends on their relative concentrations—which
are not known when the MG library is processed.
However, if the cross sections in <a class="reference internal" href="#equation-eq7-3-9">(309)</a> are independent of energy,
so that the background cross section is <em>constant</em>,
<a class="reference internal" href="#equation-eq7-3-8">(308)</a> can be solved for any arbitrary value of <span class="math notranslate nohighlight">\(\sigma \,_{0}^{(r)}\)</span>
as a parameter. This obviously occurs for the special case in which nuclide
<em>r</em> is the only resonance nuclide in the mixture; i.e., the background materials
are nonabsorbing moderators for which the total cross section is equal to the potential
cross section. In this case, <span class="math notranslate nohighlight">\(\sigma \,_{0}^{(r)}(E,T)\quad \to \ \ \ \sigma \,_{0,g}^{(r)}\)</span>,
<div class="math notranslate nohighlight" id="equation-eq7-3-10">
<span class="eqno">(310)<a class="headerlink" href="#equation-eq7-3-10" title="Permalink to this equation"></a></span>\[\sigma \,_{0,g}^{(r)}\,\,=\quad \frac{1}{N_{{}}^{(r)}}\sum\limits_{j\,\ne \,i}{\ N_{{}}^{(j)}\,\lambda _{g}^{(j)}\sigma \,_{p}^{(j)}}\]</div>
<p>If the mixture contains multiple resonance absorbers, as is usually the
case, other approximations must be made to obtain a constant background
cross section.</p>
<p>The approximation of “no resonance interference” assumes that resonances
of background nuclides do not overlap with those of nuclide <em>r</em>, so
their total cross sections can be approximated by the potential values
within resonances of <em>r</em> where self-shielding occurs. In this
approximation, the expression in <a class="reference internal" href="#equation-eq7-3-10">(310)</a> is also used for the background
cross section.</p>
<p>Another approximation is to represent the energy-dependent cross
sections of the background nuclides by their group-averaged (i.e.,
self-shielded cross) values; thus</p>
<div class="math notranslate nohighlight" id="equation-eq7-3-11">
<span class="eqno">(311)<a class="headerlink" href="#equation-eq7-3-11" title="Permalink to this equation"></a></span>\[\sigma \,_{a}^{(j)}(E,T)\quad \to \ \ \ \sigma \,_{a,g}^{(j)}\ \quad ;\quad \ \ \quad \sigma \,_{s}^{(j)}(E,T)\quad \to \ \ \ \sigma \,_{s,g}^{(j)}\text{ for }E\in g\]</div>
<p>In this case, the background cross section in <a class="reference internal" href="#equation-eq7-3-9">(309)</a> for nuclide <em>r</em> is the
group-dependent expression,</p>
<div class="math notranslate nohighlight" id="equation-eq7-3-12">
<span class="eqno">(312)<a class="headerlink" href="#equation-eq7-3-12" title="Permalink to this equation"></a></span>\[\sigma _{0,g}^{\text{(r)}}\ \ =\ \ \frac{1}{{{\text{N}}^{\text{(r)}}}}\,\,\sum\limits_{j\ne r}{\left( \Sigma _{\text{a,g}}^{\text{(j)}}+\lambda _{\text{g}}^{\text{(j)}}\,\Sigma _{\text{s,g}}^{\text{(j)}}\, \right)}\]</div>
<p>An equation similar to <a class="reference internal" href="#equation-eq7-3-12">(312)</a> is used for the background cross sections of
all resonance nuclides; thus the self-shielded cross sections of each
resonance absorber depend on the shielded cross sections of all other
resonance absorbers in the mixture. When self-shielding operations are
performed with BONAMI for this approximation, “Bondarenko” iterations
are performed to account for the inter-dependence of the shielded cross
<p>Assuming that <span class="math notranslate nohighlight">\(\sigma \,_{0}^{(r)}\)</span> is represented as a groupwise-constant
based on one of the previous approximations, several methods can be used to
obtain a parameterized flux spectrum for preprocessing Bondarenko data in the MG
libraries. In the simpliest approach, the scattering source of the resonance
nuclide <em>r</em> in <a class="reference internal" href="#equation-eq7-3-8">(308)</a> is represented by the NR approximation,
<span class="math notranslate nohighlight">\({{\text{S}}^{\text{(r)}}}(\text{E,T})\)</span> to <span class="math notranslate nohighlight">\(\Sigma _{\text{p}}^{\text{(r)}}C(E)\)</span>.
In this case, <a class="reference internal" href="#equation-eq7-3-8">(308)</a> can be solved analytically to obtain the following
expression for the flux spectrum used to process MG data as a function of <span class="math notranslate nohighlight">\(\sigma \,_{0}^{(r)}\)</span>:</p>
<div class="math notranslate nohighlight" id="equation-eq7-3-13">
<span class="eqno">(313)<a class="headerlink" href="#equation-eq7-3-13" title="Permalink to this equation"></a></span>\[{{\Phi }^{\text{(r)}}}\text{(E;}\,\sigma _{0}^{\text{(r)}}\text{,T)}\ \ =\,\ \frac{\sigma _{\text{p}}^{\text{(r)}}\ +\ \,\frac{\text{1}}{{{\text{N}}^{\text{(r)}}}}\sum\limits_{j\ne r}{\,\Sigma _{\text{p}}^{\text{(j)}}\,}\ }{\sigma _{\text{t}}^{\text{(r)}}\text{(E,T)}\ \text{+}\ \sigma _{0}^{\text{(r)}}}C(E)\ \ \,\ \to \ \ \,\frac{C(E)\ }{\sigma _{\text{t}}^{\text{(r)}}\text{(E,T)}\ \text{+}\ \sigma _{0}^{\text{(r)}}}\]</div>
<p>where C(E) includes is an arbitrary constant multiplier that cancels
from <a class="reference internal" href="#equation-eq7-3-1">(301)</a>.</p>
<p>A more accurate approach that does not require using the NR
approximation is to directly solve the IR form of the neutron transport
equation using PW cross sections, with the assumption of no interference
between mixed absorber resonances. The IRFfactor module of AMPX uses
XSProc to calculate the self-shielded flux spectrum for MG data
processing using one of two options:</p>
<ol class="loweralpha simple">
<li><p>A homogeneous model corresponding to an infinite medium of the
resonance nuclide mixed with hydrogen, in which the ratio of the
absorber to hydrogen number densities is varied in CENTRM to obtain
the desired background cross section values;</p></li>
<li><p>A heterogeneous model corresponding to a 2D unit cell from an
infinite lattice, in which the cell geometry (e.g., pitch) as well
as the absorber number density is varied in CENTRM to obtain the
desired background cross section values.</p></li>
<p>Both of these models provide a numerical solution for the flux spectrum.
Details on these approaches are given in reference 2.</p>
<div class="section" id="self-shielded-cross-section-data-in-scale-libraries">
<span id="id9"></span><h3>Self-Shielded Cross Section Data in SCALE Libraries<a class="headerlink" href="#self-shielded-cross-section-data-in-scale-libraries" title="Permalink to this headline"></a></h3>
<p>The AMPX code system processes self-shielded cross sections using the
flux expressions described in the preceding section. For MG libraries in
SCALE-6.2 and later versions, the NR approximation in <a class="reference internal" href="#equation-eq7-3-13">(313)</a> is used to
represent the flux spectrum for nuclides with masses below A=40, since
the NR approximation is generally accurate for low-mass nuclides and/or
high energies. The standard AMPX weight functions are used to represent
C(E) over the entire energy range for all nuclides with A&lt;40, except for
hydrogen and oxygen which use a calculated C(E) from CENTRM. The NR
approximation with a calculated C(E) function is also used to represent
the spectrum above the resolved resonance range for nuclides with A&gt;40;
but in the resolved resonance range of these nuclides, AMPX processes
shielded cross sections with flux spectra obtained from CENTRM
calculations using either a homogeneous or heterogeneous model.
Regardless of the method used to obtain the flux spectrum, the
parameterized shielded cross sections for absorber nuclide “r” are
computed from the expression,</p>
<div class="math notranslate nohighlight" id="equation-eq7-3-14">
<span class="eqno">(314)<a class="headerlink" href="#equation-eq7-3-14" title="Permalink to this equation"></a></span>\[\sigma _{\text{X,g}}^{\text{(r)}}(\sigma \,_{0}^{(r)}\,,T)\quad =\quad \,\frac{\int_{g}{\ \ \,\sigma _{X}^{(r)}(E,T)\ \,\Phi (E;\,\,\sigma \,_{0}^{(r)}\,,T)\ dE}}{\int_{g}{\ \,\Phi (E;\,\,\sigma \,_{0}^{(r)}\,,T)\ \,dE}}\quad ,\]</div>
<p>where <span class="math notranslate nohighlight">\(\Phi (E;\,\,\sigma \,_{0}^{(r)}\,,T)\)</span> is the flux for a given value
of <span class="math notranslate nohighlight">\(\sigma \,_{0}^{(r)}\)</span> and <em>T</em>.</p>
<p>Rather than storing self-shielded cross sections in the master library,
AMPX converts them to Bondarenko shielding factors, also called
f-factors, defined as the ratio of the shielded cross section to the
infinitely dilute cross section. Thus the MG libraries in SCALE contain
Bondarenko data consisting of f‑factors defined as</p>
<div class="math notranslate nohighlight" id="equation-eq7-3-15">
<span class="eqno">(315)<a class="headerlink" href="#equation-eq7-3-15" title="Permalink to this equation"></a></span>\[f_{\text{X,g}}^{\text{(r)}}(\sigma \,_{0}^{{}}\,,T)\quad =\quad \,\frac{\sigma _{\text{X,g}}^{\text{(r)}}(\sigma \,_{0}^{{}},T)}{\sigma _{\text{X,g}}^{\text{(r)}}(\infty )}\quad ,\]</div>
<p>and infinitely dilute cross sections defined as,</p>
<div class="math notranslate nohighlight" id="equation-eq7-3-16">
<span class="eqno">(316)<a class="headerlink" href="#equation-eq7-3-16" title="Permalink to this equation"></a></span>\[\sigma _{\text{X,g}}^{\text{(r)}}(\infty )\quad =\quad \,\sigma _{\text{X,g}}^{\text{(r)}}(\sigma \,_{0}^{{}}=\infty ,T={{T}_{ref}}) \to \ \ \,\frac{\int_{g}{\ \sigma _{X}^{(r)}(E,{{T}_{ref}})\ C(E)\ \,dE}}{\int_{g}{\ \,C(E)\ \,dE}}\quad .\]</div>
<p>In AMPX, the reference temperature for the infinitely dilute cross
section is normally taken to be 293 K. Bondarenko data on SCALE
libraries are provided for all energy groups and for five reaction
types: total, radiative capture, fission, within-group scattering, and
elastic scatter. Recent SCALE libraries include f-factors at ~10–30
background cross section values (depending on nuclide) ranging from
~10<sup>−3</sup> to ~10<sup>10</sup> barns, which span the range of
self-shielding conditions. Typically the f-factor data are tabulated at
five temperature values. Background cross sections and temperatures
available for each nuclide in the SCALE MG libraries are given in the
SCALE Cross Section Libraries chapter.</p>
<div class="section" id="background-cross-section-options-in-bonami">
<span id="id10"></span><h3>Background Cross Section Options in BONAMI<a class="headerlink" href="#background-cross-section-options-in-bonami" title="Permalink to this headline"></a></h3>
<p>To compute self-shielded cross sections for nuclide <em>r</em>, BONAMI first
computes the appropriate background cross section for the system of
interest and then interpolates the library Bondarenko data to obtain the
f-factor corresponding to this σ<sub>0</sub> and nuclide temperature.
Several options are available in BONAMI to compute the background cross
section, based on <a class="reference internal" href="#equation-eq7-3-10">(310)</a> and <a class="reference internal" href="#equation-eq7-3-12">(312)</a> in the preceding section. The options are
specified by input parameter “<strong>iropt</strong>” and have the following
<ol class="loweralpha simple">
<li><p>iropt = 0 =&gt; NR approximation with Bondarenko iterations:</p></li>
<p>Background cross sections for all nuclides are computed using <a class="reference internal" href="#equation-eq7-3-12">(312)</a> with
λ=1; therefore,</p>
<div class="math notranslate nohighlight" id="equation-eq7-3-17">
<span class="eqno">(317)<a class="headerlink" href="#equation-eq7-3-17" title="Permalink to this equation"></a></span>\[\sigma _{0}^{\text{(r)}}\ =\ \frac{1}{{{\text{N}}^{\text{(r)}}}}\,\,\sum\limits_{j\ne r}{\Sigma _{\text{t,g}}^{\text{(j)}}} .\]</div>
<p>Since the background cross section for each nuclide depends on the shielded
total cross sections of all other nuclides in the mixture,
“Bondarenko iterations” are performed in BONAMI to obtain a consistent set of
shielded cross sections. Bondarenko iterations provide a crude method of
accounting for resonance interference effects that are ignored by the
approximation for <span class="math notranslate nohighlight">\(\sigma \,_{0}^{(r)}\)</span> in <a class="reference internal" href="#equation-eq7-3-10">(310)</a>. The BONAMI
iterative algorithm generally converges in a few iterations. Prior to
SCALE-6.2, this option was the only one available in BONAMI, and it is still the default for XSProc.</p>
<ol class="loweralpha simple" start="2">
<li><p>iropt = 1 =&gt; IR approximation with no resonance interference
(potential cross sections):</p></li>
<p>Background cross sections for all nuclides are computed using <a class="reference internal" href="#equation-eq7-3-10">(310)</a>. No
Bondarenko iterations are needed.</p>
<ol class="loweralpha simple" start="3">
<li><p>iropt t = 2 =&gt; IR approximation with Bondarenko iterations, but no
resonance scattering:</p></li>
<p>Background cross sections for all nuclides are computed using <a class="reference internal" href="#equation-eq7-3-12">(312)</a> with
the scattering cross section approximated by the potential value;
<div class="math notranslate nohighlight" id="equation-eq7-3-18">
<span class="eqno">(318)<a class="headerlink" href="#equation-eq7-3-18" title="Permalink to this equation"></a></span>\[\sigma _{0}^{\text{(r)}}\ \ =\ \ \frac{1}{{{\text{N}}^{\text{(r)}}}}\,\,\sum\limits_{j\ne r}{\left( \Sigma _{\text{a,g}}^{\text{(j)}}+\lambda _{\text{g}}^{\text{(j)}}\,\Sigma _{\text{p}}^{\text{(j)}}\, \right)}\]</div>
<p>Since the background cross section for each resonance nuclide includes the
shielded absorption cross sections of all other nuclides, Bondarenko
interactions are performed.</p>
<ol class="loweralpha simple" start="4">
<li><p>iropt = 3 =&gt; IR approximation with Bondarenko iterations:</p></li>
<p>Background cross sections for all nuclides are computed using the full
IR expression in <a class="reference internal" href="#equation-eq7-3-12">(312)</a>. Bondarenko interactions are performed.</p>
<p>Computation of the background cross sections in BONAMI generally
requires group-dependent values for the IR parameter λ. These are
calculated by a module in AMPX during the library process and are stored
in the MG libraries under the reaction identifier (MT number), MT=2000.</p>
<div class="section" id="self-shielded-cross-sections-for-heterogeneous-media">
<span id="id11"></span><h3>Self-Shielded Cross Sections for Heterogeneous Media<a class="headerlink" href="#self-shielded-cross-sections-for-heterogeneous-media" title="Permalink to this headline"></a></h3>
<p>Equivalence theory can be used to obtain shielded cross sections for
heterogeneous systems containing one or more “lumps” of resonance
absorber mixtures separated by moderators, such as reactor lattices. It
can be shown that if the fuel escape probability is represented by the
Wigner rational approximation, the collision probability formulation of
the neutron transport equation for an absorber body in a heterogeneous
medium can be reduced to a form identical to <a class="reference internal" href="#equation-eq7-3-3">(303)</a>. This can be done for
an “equivalent” infinite homogeneous medium consisting of the same
absorber body mixture plus an additional NR scatterer with a constant
cross section called the “escape cross section” <a class="bibtex reference internal" href="#lamarsh-introduction-1966" id="id12">[Lam66]</a>.
theory states that the self-shielded cross section for resonance
absorber <em>r</em> in the heterogeneous medium is equal to the self-shielded
cross section of <em>r</em> in the equivalent infinite homogeneous medium;
therefore the f-factors that were calculated for homogenous mixtures can
also be used to compute self-shielded cross sections for heterogeneous
media by simply interpolating the tabulated f-factors in the library to
the modified sigma-zero value of</p>
<div class="math notranslate nohighlight" id="equation-eq7-3-19">
<span class="eqno">(319)<a class="headerlink" href="#equation-eq7-3-19" title="Permalink to this equation"></a></span>\[\hat{\sigma }_{0}^{(r)}\quad =\quad \sigma _{0}^{(r)}\ +\ \ \,\sigma _{esc}^{(r)}\]</div>
<div><p><span class="math notranslate nohighlight">\(\hat{\sigma }_{0}^{(r)}\)</span> = background cross section of r in the absorber lump of the heterogeneous system;</p>
<p><span class="math notranslate nohighlight">\(\sigma \,_{0}^{(r)}\)</span> = background cross section defined in <a class="reference internal" href="#id7"><span class="std std-ref">Parameterized Flux Spectra</span></a> for an infinite homogeneous medium of the
absorber body mixture;</p>
<p><span class="math notranslate nohighlight">\(\sigma _{esc}^{(r)}\)</span> = microscopic escape cross section for nuclide <em>r</em>, defined as</p>
<div class="math notranslate nohighlight" id="equation-eq7-3-20">
<span class="eqno">(320)<a class="headerlink" href="#equation-eq7-3-20" title="Permalink to this equation"></a></span>\[\sigma _{esc}^{(r)}\quad =\quad \frac{{{\Sigma }_{esc}}}{{{N}^{(r)}}}\]</div>
<div><p><span class="math notranslate nohighlight">\({{\Sigma }_{esc}}\)</span> = macroscopic escape cross section for the absorber lump defined in BONAMI as</p>
<div class="math notranslate nohighlight" id="equation-eq7-3-21">
<span class="eqno">(321)<a class="headerlink" href="#equation-eq7-3-21" title="Permalink to this equation"></a></span>\[{{\Sigma }_{esc}}\quad =\quad \,\frac{(1\quad -\quad c)A}{\bar{\ell }\ \,\ \left[ 1\quad +\quad \left( A\quad -\quad 1 \right)c \right]}\]</div>
<div><p><span class="math notranslate nohighlight">\(\bar{\ell }\)</span> = average chord length of the absorber body = <span class="math notranslate nohighlight">\(4\ \ \,\times \ \frac{volume}{surface\ \ area}\)</span>;</p>
<p>A = Bell factor, used to improve the accuracy of the Wigner rational approximation;</p>
<p>c = lattice Dancoff factor, which is equal to the probability that a neutron escaping from one
absorber body will reach another absorber body before colliding in the intervening moderator.</p>
<p>Values for the mean chord length <span class="math notranslate nohighlight">\(\bar{\ell }\)</span> are computed in BONAMI for slab,
sphere, and cylinder absorber bodies. In the most common mode of operation where
BONAMI is executed through the XSProc module in SCALE, Dancoff factors for
uniform lattices are computed automatically and provided as input to BONAMI.
For nonuniform lattices—such as those containing water holes, control rods,
etc.—it may be desirable for the user to run the SCALE module MCDancoff to
compute Dancoff factors using Monte Carlo for an arbitrary 3D configuration.
In this case the values are provided in the MORE DATA input block of XSProc.
The Bell factor “A” is a correction factor to account for errors caused by use
of the Wigner rational approximation to represent the escape probability from a
lump. Two optional Bell factor corrections are included in BONAMI. The first uses
expressions developed by Otter that essentially force the Wigner escape
probability for an isolated absorber lump to agree with the exact escape
probability for the particular geometry by determining a value of A as a function of
<span class="math notranslate nohighlight">\({{\Sigma }_{T}}\bar{\ell }\)</span> for slab, cylindrical, or spherical
geometries. Since the Otter expression was developed for isolated bodies,
it does not account for errors in the Wigner rational approximation due to
lattice effects. BONAMI also includes a Bell factor correction based on a
modified formulation developed by Leslie <a class="bibtex reference internal" href="#leslie-improvements-1965" id="id13">[LHJ65]</a> that is a function of the Dancoff factor.</p>
<div class="section" id="interpolation-scheme">
<span id="id14"></span><h2>Interpolation Scheme<a class="headerlink" href="#interpolation-scheme" title="Permalink to this headline"></a></h2>
<p>After the background cross section for a system has been computed,
BONAMI interpolates f-factors at the appropriate σ<sub>0</sub> and
temperature from the tabulated values in the library. <a class="reference internal" href="#fig7-3-1"><span class="std std-numref">Fig. 202</span></a> shows
a typical variation of the f-factor vs. background cross sections for
the capture cross section of <sup>238</sup>U in the SCALE 252 group
<div class="figure align-center" id="id23">
<span id="fig7-3-1"></span><a class="reference internal image-reference" href="_images/fig1.png"><img alt="_images/fig1.png" src="_images/fig1.png" style="width: 500px;" /></a>
<p class="caption"><span class="caption-number">Fig. 202 </span><span class="caption-text">Plot of f-factor variation for <sup>238</sup>U capture reaction.</span><a class="headerlink" href="#id23" title="Permalink to this image"></a></p>
<p>Interpolation of the f-factors can be problematic, and several different
schemes have been developed for this purpose. Some of the interpolation
methods that have been used in other codes are constrained
Lagrangian, <a class="bibtex reference internal" href="#davis-sphinx-1977" id="id15">[DYB77]</a> arc-tangent fitting, <a class="bibtex reference internal" href="#kidman-improved-1974" id="id16">[Kid74]</a> and an approach developed by
Segev <a class="bibtex reference internal" href="#segev-interpolation-1981" id="id17">[Seg81]</a>. All of these were tested and found to be inadequate for use
with the SCALE libraries, which may have multiple energy groups within a
single resonance. BONAMI uses a unique interpolation method developed by
Greene, which is described in <a class="bibtex reference internal" href="#greene-method-1982" id="id18">[Gre82]</a>. Greene’s interpolation method
is essentially a polynomial approach in which the powers of the
polynomial terms can vary within a panel, as shown in <a class="reference internal" href="#equation-eq7-3-25">(325)</a>:</p>
<div class="math notranslate nohighlight" id="equation-eq7-3-22">
<span class="eqno">(322)<a class="headerlink" href="#equation-eq7-3-22" title="Permalink to this equation"></a></span>\[f\left( \sigma \right)\quad =\quad f\left( \sigma {{\,}_{1}} \right)\quad +\quad \frac{\sigma {{\,}^{q(\sigma )}}\quad -\quad \sigma \,_{1}^{q(\sigma )}}{\sigma \,_{2}^{q(\sigma )}\quad -\quad \sigma \,_{1}^{q(\sigma )}}\quad \left( f\left( {{\sigma }_{2}} \right)\quad -\quad f\left( {{\sigma }_{1}} \right) \right)\quad ,\]</div>
<div class="math notranslate nohighlight" id="equation-eq7-3-23">
<span class="eqno">(323)<a class="headerlink" href="#equation-eq7-3-23" title="Permalink to this equation"></a></span>\[q\left( \sigma \right)\quad =\quad q\left( \sigma {{\,}_{1}} \right)\quad +\quad \frac{\sigma \quad -\quad \sigma \,_{1}^{{}}}{\sigma \,_{2}^{{}}\quad -\quad \sigma \,_{1}^{{}}}\quad \left( q\left( {{\sigma }_{2}} \right)\quad -\quad q\left( {{\sigma }_{1}} \right) \right)\quad .\]</div>
<p><a class="reference internal" href="#fig7-3-2"><span class="std std-numref">Fig. 203</span></a> illustrates the expected behavior of <a class="reference internal" href="#equation-eq7-3-22">(322)</a> caused by varying
the powers in a panel.</p>
<p>By allowing the power <em>q</em> to vary as a function of independent
variable σ, we can move between the various monotonic curves on the
graph in a monotonic fashion. Note that when <em>p</em> crosses the
<em>p</em> = 1 curve, the shape changes from concave to convex, or vice versa.
This shape change means that we can use the scheme to introduce an
inflection point, which is exactly the situation needed for
interpolating f-factors.</p>
<div class="figure align-center" id="id24">
<span id="fig7-3-2"></span><a class="reference internal image-reference" href="_images/fig2.png"><img alt="_images/fig2.png" src="_images/fig2.png" style="width: 500px;" /></a>
<p class="caption"><span class="caption-number">Fig. 203 </span><span class="caption-text">Illustration of the effects of varying “powers” in the Greene interpolation method.</span><a class="headerlink" href="#id24" title="Permalink to this image"></a></p>
<p><a class="reference internal" href="#fig7-3-3"><span class="std std-numref">Fig. 204</span></a> and <a class="reference internal" href="#fig7-3-3"><span class="std std-numref">Fig. 204</span></a> show typical “fits” of the f-factors using
the Greene interpolation scheme for two example cases. Note, in
particular, that since this scheme has guaranteed monotonicity, it
easily accommodates the end panels that have the smooth asymptotic
variation. Even considering the extra task of having to determine the
powers for temperature and σ<sub>0</sub> interpolations, the method is not
significantly more time-consuming than the alternative schemes for most
<div class="figure align-center" id="id25">
<span id="fig7-3-3"></span><a class="reference internal image-reference" href="_images/fig3.png"><img alt="_images/fig3.png" src="_images/fig3.png" style="width: 500px;" /></a>
<p class="caption"><span class="caption-number">Fig. 204 </span><span class="caption-text">Use of Greene’s method to fit the σ<sub>0</sub> variation of Bondarenko factors for case 1.</span><a class="headerlink" href="#id25" title="Permalink to this image"></a></p>
<div class="figure align-center" id="id26">
<span id="fig7-3-4"></span><a class="reference internal image-reference" href="_images/fig4.png"><img alt="_images/fig4.png" src="_images/fig4.png" style="width: 500px;" /></a>
<p class="caption"><span class="caption-number">Fig. 205 </span><span class="caption-text">Use of Greene’s method to fit the σ<sub>0</sub> variation of Bondarenko factors for case 2.</span><a class="headerlink" href="#id26" title="Permalink to this image"></a></p>
<div class="section" id="input-instructions">
<span id="id19"></span><h2>Input Instructions<a class="headerlink" href="#input-instructions" title="Permalink to this headline"></a></h2>
<p>BONAMI is most commonly used as an integral component of XSProc through
SCALE automated analysis sequences. XSProc automatically prepares all
the input data for BONAMI and links it with the other self-shielding
modules. During a SCALE sequence execution, the data are provided
directly to BONAMI in memory through XSProc. Some of the input
parameters can be modified in the MOREDATA block in XSProc.</p>
<p>However, the legacy interface to execute stand-alone BONAMI calculations
has been preserved for expert users. The legacy input to BONAMI uses the
FIDO schemes described in the FIDO chapter of the SCALE manual. The
BONAMI input for standalone execution is given below, where the MOREDATA
input keywords are marked in bold.</p>
<p class="centered">
<strong>Data Block 1</strong></p><p>0$ Logical Unit Assignments [4]</p>
<div><ol class="arabic simple">
<li><p>masterlib— input master library (Default = 23)</p></li>
<li><p>mwt—not used</p></li>
<li><p>msc—not used</p></li>
<li><p>newlib—output master library (Default = 22)</p></li>
<p>1$ Case Description [6]</p>
<div><ol class="arabic">
<li><p>cellgeometry—geometry description</p>
<div><p>0 homogeneous</p>
<p>1 slab</p>
<p>2 cylinder</p>
<p>3 sphere</p>
<li><p>numzones—number of zones or material regions</p></li>
<p>3. mixlength—mixing table length. This is the total number of entries
needed to describe the concentrations of all constituents in all
mixtures in the problem.</p>
<ol class="arabic" start="4">
<li><p>ib—not used</p></li>
<li><p><strong>crossedt</strong>—output edit option</p>
<div><p>0 no output (Default)</p>
<p>1 input echo</p>
<p>2 iteration list, timing</p>
<p>3 background cross section calculation details</p>
<p>4 shielded cross sections, Bondarenko factors</p>
<li><p>issopt—not used</p></li>
<li><p><strong>iropt—</strong>resonance approximation option</p>
<div><p>0 NR (Default) (Bondarenko iterations)</p>
<p>1 IR with potential scattering</p>
<p>2 IR with absorption and potential scattering (Bondarenko iterations)</p>
<p>3 IR with absorption and elastic scattering (Bondarenko iterations)</p>
<li><p><strong>bellopt—</strong>Bell factor calculation option</p>
<div><p>0 Otter
1 Leslie (Default)</p>
<li><p><strong>escxsopt—</strong>escape cross section calculation option</p>
<div><p>0 consistent</p>
<p>1 inconsistent (Default)</p>
<p>2* Floating-Point Constants [2]</p>
<div><p>1. <strong>bonamieps</strong>—convergence criteria for the Bondarenko iteration
(Default = 0.001)</p>
<p>2. <strong>bellfact</strong>—geometrical escape probability adjustment factor. See
notes below on this parameter (Default = 0.0).</p>
<p>T Terminate Data Block 1.</p>
<p class="centered">
<strong>Data Block 2</strong></p><p>3$ Mixture numbers in the mixing table [mixlength]
4$ Component (nuclide) identifiers in the mixing table [mixlength]
5* Concentrations (atoms/b-cm) in the mixing table [mixlength]
6$ Mixtures by zone [numzones]
7* Outer radii (cm) by zone [numzones]
8* Temperature (k) by zone [numzones]
9* Escape cross section (cm<sup>-1</sup>) by zone [numzones]
10$ Not used