Automated burnup sequence
Homogenized group constants form the input data for core-level fuel cycle and transient simulator calculations. The data is parametrized according to discrete state-points, which are defined by the local thermal hydraulic conditions together with reactivity control. The process of group constant generation must cover the full range of operating states within the reactor core, which often requires repeating the assembly-level calculation thousands of times. Since the local operating conditions inside the fuel assembly also affect how the materials are depleted, the state-points by which the data is parametrized are not completely independent. The calculations are instead divided into:
- Branch variations, taking into account momentary changes in the operating conditions, such as fuel temperature, moderator density and temperature, boron concentration and insertion of control rods
- History variations, taking into account conditions that persist for an extended period of time, such as moderator temperature and density, boron concentration and positioning of control rods
In practice, the procedure involves burnup calculations covering all assembly types and history variations. Branch variations are accounted for by performing restart calculations for each burnup point, varying the local operating conditions accordingly.
Serpent provides an automated burnup sequence, capable of performing branch variations for a single history run. The procedure works by first running a burnup calculation, after which a number of restarts are performed for selected burnup points. For each restart the code invokes a number of user-defined variations in the input, corresponding to the branches to different state-points. The branches are defined using the branch card, and the combination of variations either by the coefficient matrix or casematrix. The group constant data is collected into one ore more separate output files easily read by post-processing scripts. The input and output formats are described below with examples.
The automated burnup sequence can be used either with coefficient matrixes or casematrixes. With coefficient matrixes, the automated burnup sequence is limited to performing branch variations, and variations in histories must be handled by writing separate input files. With casematrixes, both branch and historical variations are supported.
For complete examples, see the collection of example input files. There is a conversion script for homogenized cross sections for outputs produced with the coefficient matrixes.
Branch types
Each branch card defines one or several variations applied to the basic input. The currently supported variations can be used for:
- Replacing one material with another (repm)
- Replacing one universe with another (repu)
- Applying a universe, surface or fill transformation (tra)
- Changing the density and temperature of a material (stp)
Replacing materials
The typical use for the material replacement variation is to change the boron concentration in the coolant. Assume, for example, that there are three coolant compositions defined in the input:
- cool_0B without boron
- cool_750B with 750 ppm boron
- cool_1500B with 1500 ppm boron
as:
% --- Coolant without boron: mat cool_0B -0.77028 moder lwtr 1001 1001.06c 6.66670E-01 8016.06c 3.33330E-01 % --- Coolant with 750 ppm boron: mat cool_750B -0.77028 moder lwtr 1001 1001.06c 6.66161E-01 8016.06c 3.33076E-01 5010.06c 1.51847E-04 5011.06c 6.11204E-04 % --- Coolant with 1500 ppm boron: mat cool_1500B -0.77028 moder lwtr 1001 1001.06c 6.65653E-01 8016.06c 3.32821E-01 5010.06c 3.03690E-04 5011.06c 1.22239E-03 % --- Thermal scattering data: therm lwtr lwj3.11t
If the material used to fill the coolant channel in the original geometry is cool_750B, then this is the material used throughout the burnup calculation. Once the depletion history is completed, the code performs the restarts and invokes the branches. The boron concentration can be varied to 0 and 1500 ppm with branches:
% --- Branch to low boron concentration: branch Blo repm cool_750B cool_0B % --- Branch to high boron concentration: branch Bhi repm cool_750B cool_1500B
which simply replace material cool_750B with materials cool_0B and cool_1500B, respectively. Names Blo and Bhi are used to identify the branches in the coefficient matrix. The material replacement variation also works with mixtures, which may be a convenient way to define coolant compositions using water and boron. For, example, cool_750B above could be defined as:
% --- Water: mat water -0.76973 moder lwtr 1001 1001.06c 0.66667 8016.06c 0.33333 therm lwtr lwj3.11t % --- Natural boron: mat boron 1.00000 5010.06c 0.19900 5011.06c 0.80100 % --- Coolant with 750 ppm boron: mix cool_750B water -0.99925 boron -750E-6
The replacing materials or mixtures cannot be used as part of the original geometry.
Replacing universes
Universe replacement variations are useful for invoking changes to entire sub-regions of the geometry, for example, for the purpose of control rod insertion in 2D geometries. An empty guide tube and a tube with control rod inserted could be defined as:
% --- Empty guide tube: pin GTU cool 0.56134 zirc4 0.60198 cool % --- Rodded guide tube: pin ROD AIC 0.43310 steel 0.48387 cool 0.56134 zirc4 0.60198 cool
where cool, zirc4, AIC, and steel are the materials for coolant, guide tube, absorber and control rod tube, respectively. Insertion of control rods can then be invoked with branch:
% --- Insertion of control rods: branch CR repu GTU ROD
which simply replaces the empty guide tube with a rodded tube.
Applying transformations
When spatial homogenization is performed for a 2D geometry, the insertion of control rods can be accomplished by simply replacing one universe with another. In 3D geometries, however, the rods can be fully withdrawn, fully inserted or anything in between, and the most convenient way to move the rods is to apply a coordinate transformation that sets the position. Different transformations can be invoked at different branches, to account for the various positions.
The applied transformations are defined separately in the input. For example, if a homogenized 3D node has the height of 19.25 cm, transformations corresponding to fully inserted, half-way and fully with withdrawn control rod positions could be defined as:
utrans pos0 0.0 0.0 0.000 utrans pos1 0.0 0.0 9.625 utrans pos2 0.0 0.0 19.250
assuming that without any transformation the bottom of the absorber sits at the bottom of the node. Without branch calculation the first entries in the utrans cards would be interpreted as universe names, and if universes "pos0", "pos1" and "pos2" are not defined, Serpent would simply ignore these entries. Assuming that the universe defining the control rods is called "ROD", the branches invoking the movement could be defined as:
% --- Fully inserted: branch CR0 tra ROD pos0 % --- half-way: branch CR1 tra ROD pos1 % --- Fully withdrawn: branch CR2 tra ROD pos2
The transformation branch works by simply replacing the universe name in the transformation card with the one given in the branch card. For example, when branch "CR1" is invoked, the universe transformation applied for the geometry would become:
utrans ROD 0.0 0.0 9.625
which would lift the rods in the half-way position. Because of the way the variation is implemented, it is important that the names of the invoked transformations do not correspond to any actual universe in the geometry. If this is the case, Serpent will apply the transformations accordingly already during the burnup calculation.
The transformation branch can also be applied to surface and fill transformations. In such case the target in the branch card refers to a surface and cell, respectively. If multiple transformation types are used in the calculation, it is important to pay attention to how the associated universes, surfaces and cells are named. When the branch is invoked, Serpent identifies the transformation based on the name, without checking the type. So a universe transformation applied to universe 1 and surface transformation applied to surface 1, for example, become indistinguishable.
Transformations are not limited translations, but also rotations and any operations defined by transformation matrix can be applied.
Applying state variations
State variations can be used to change material temperatures and densities, for example, for the purpose of fuel or moderator temperature branches. When the material is not associated with thermal scattering data, the input for the branch card consists of the new density and temperature. This is typical for fuel materials, for example, branches:
% --- Branch to low fuel temperature: branch Flo stp fuel -10.338 600 % --- Branch to high fuel temperature: branch Fhi stp fuel -10.338 1200
change the temperature of material "fuel" to 600 and 1200 Kelvin, respectively. The routine works by looking for the cross section data for the nearest temperature below the given value and applying the built-in Doppler-broadening preprocessor routine to adjust the cross sections to the correct temperature.
Changes in materials with associated thermal scattering data require three additional input parameters for each library:
- The name of therm card associated with the material
- Name of a data library at temperature below or equal to the given value
- Name of a data library at temperature above or equal to the given value
For example, if the coolant is defined as:
% --- BWR coolant with 40% void fraction: mat cool -0.443760 moder lwtr 1001 1001.06c 0.66667 8016.06c 0.33333 % --- Thermal scattering data for light water at 600K therm lwtr lwe7.12t
a branch to a lower temperature could be defined as:
branch Clo stp cool -0.739605 560 lwtr lwe7.10t lwe7.12t
This increases the density from 0.443760 to 0.739605 g/cm^{3} and lowers the temperature from 600 to 550 Kelvin. The change in temperature for free-atom cross sections is handled by replacing the 600K library data with 300K data and broadening the cross sections to 560K. The change in thermal scattering data is handled using tabular interpolation. The provided library names lwe7.10t and lwe7.12t correspond to 550 and 600K temperatures, respectively. If the material is associated with multiple thermal scattering libraries, they must all be included in the branch card.
Multiple simultaneous variations
The number of variations per branch card is not limited. If the geometry consists of more than one fuel type, their temperatures can be varied with a single branch:
branch Fhi stp fuel1 -10.338 1200 stp fuel2 -10.338 1200 stp fuel3 -10.338 1200 stp fuel4 -10.338 1200 stp fuel5 -10.338 1200
Some core simulator codes apply polynomial interpolation between state points, which often does not require the full coefficient matrix with all possible state-point combinations. Instead of a multi-dimensional matrix it is then more convenient to define a one-dimensional list of branches, in which the necessary combinations are defined. For example, the calculation of a cross term involving variation in both coolant boron concentration and fuel temperature could be accomplished with branch:
branch BRA01 repm cool_750B cool_0B stp fuel -10.338 1200
State variations alone cannot be used to handle heat expansion, but the change in density can be accompanied by a universe replacement variation to account for the change in dimensions:
branch Fh stp fuel1 -10.1348 1200 repu FUE FUEH
assuming that universes FUE and FUEH describe the fuel pin at nominal and expanded dimensions, respectively.
Setting up the coefficient matrix
The coef card lists the burnup points at which the restarts are performed. These points must correspond to points in the depletion history (0 for initial composition). The burnup points are followed by the coefficient calculation matrix, which may be one or multi-dimensional. For example:
coef 11 0 0.1 1 3 5 10 15 20 30 40 50 3 nom Blo Bhi 3 nom Clo Chi 3 nom Flo Fhi 2 nom CR
invokes the branch calculation at 11 burnup points at 0, 0.1 1, 3, 5, 10 15, 20 30 40 and 50 MWd/kgU burnup. The coefficient matrix has four dimensions. The first row defines boron concentration branches: nominal, low and high (see the example on material replacement branch above). The second and third row define variations in coolant and fuel temperature (see the examples on state variation branches above). The last row defines insertion of control rods (see the example on universe replacement branch above). The first entry in each row is a branch with no variations at all, which corresponds to the nominal conditions in the burnup calculation.
Since the matrix has four dimensions, each run involves a combination of four branches. In total the matrix defines 3 × 3 × 3 × 2 = 54 combinations, of which the first 10 are:
1. | nom | + nom | + nom | + nom | (nominal state) |
2. | Blo | + nom | + nom | + nom | (boron at low concentration) |
3. | Bhi | + nom | + nom | + nom | (boron at high concentration) |
4. | nom | + Clo | + nom | + nom | (coolant at low temperature) |
5. | Blo | + Clo | + nom | + nom | (boron at low concentration and coolant at low temperature) |
6. | Bhi | + Clo | + nom | + nom | (boron at high concentration and coolant at low temperature) |
7. | nom | + Chi | + nom | + nom | (coolant at high temperature) |
8. | Blo | + Chi | + nom | + nom | (boron at low concentration and coolant at high temperature) |
9. | Bhi | + Chi | + nom | + nom | (boron at high concentration and coolant at high temperature) |
10. | nom | + nom | + Flo | + nom | (fuel at low temperature) |
... |
As mentioned above, some core simulator codes do not require all combinations of branches. To avoid running unnecessary combinations it is possible to define a one-dimensional list of branches, for example:
coef 11 0 0.1 1 3 5 10 15 20 30 40 50 10 BR01 BR02 BR03 BR04 BR05 BR03 BR07 BR08 BR09 BR10
and set up the combinations in the branch cards. This may complicate the input, but also save a lot of computing time since only branches that are used for forming the parametrized input data for the simulator are run.
Setting up the casematrix
The casematrix card lists the performed history calculations and the burnup points at which the restarts are performed. These points must correspond to points in the depletion history (0 for initial composition). The history variations and burnup points are followed by the coefficient calculation matrix, which may be one or multi-dimensional. For example:
casematrix cm_example 3 TFHIlo TFHInom TFHIhi 11 0 0.1 1 3 5 10 15 20 30 40 50 3 nom Blo Bhi 3 nom Clo Chi 3 Flo Fnom Fhi 2 nom CR 1 HIS
invokes the branch calculation at 11 burnup points at 0, 0.1 1, 3, 5, 10 15, 20 30 40 and 50 MWd/kgU burnup, from three different history calculations (TFHIlo TFHInom TFHIhi). The coefficient matrix has four dimensions. The first row defines boron concentration branches: nominal, low and high (see the example on material replacement branch above). The second and third row define variations in coolant and fuel temperature (see the examples on state variation branches above). The last row defines insertion of control rods (see the example on universe replacement branch above). The first entry in each row is a branch with no variations at all, which corresponds to the nominal conditions in the burnup calculation (which are independent of the three history variations TFHIlo, TFHInom and TFHIhi).
Since the matrix has four dimensions, each run involves a combination of four branches. In total the matrix defines 3 × 3 × 3 × 2 = 54 combinations for each history, of which the first 10 are:
1. | nom | + nom | + nom | + nom | (nominal state) |
2. | Blo | + nom | + nom | + nom | (boron at low concentration) |
3. | Bhi | + nom | + nom | + nom | (boron at high concentration) |
4. | nom | + Clo | + nom | + nom | (coolant at low temperature) |
5. | Blo | + Clo | + nom | + nom | (boron at low concentration and coolant at low temperature) |
6. | Bhi | + Clo | + nom | + nom | (boron at high concentration and coolant at low temperature) |
7. | nom | + Chi | + nom | + nom | (coolant at high temperature) |
8. | Blo | + Chi | + nom | + nom | (boron at low concentration and coolant at high temperature) |
9. | Bhi | + Chi | + nom | + nom | (boron at high concentration and coolant at high temperature) |
10. | nom | + nom | + Flo | + nom | (fuel at low temperature) |
... |
As mentioned above, some core simulator codes do not require all combinations of branches. To avoid running unnecessary combinations it is possible to define a one-dimensional list of branches, for example:
casematrix cm_example 3 TFHIlo TFHInom TFHIhi 11 0 0.1 1 3 5 10 15 20 30 40 50 10 BR01 BR02 BR03 BR04 BR05 BR03 BR07 BR08 BR09 BR10
and set up the combinations in the branch cards. This may complicate the input, but also save a lot of computing time since only branches that are used for forming the parametrized input data for the simulator are run. Additionally, if all branches are not performed for each history calculation, multiple casematrixes with possibly different restart calculation definitions can be defined in a single input file.
Output
Group constant data from the automated burnup sequence with coefficient matrix is written in a separate output file named:
[input].coe
Where:
[input] | : is the name of the input file |
Group constant data from the automated burnup sequence with casematrix is written in a separate output file named:
[input]_[casematrix_name]_h[j]_r[i].coe
Where:
[input] | : is the name of the input file |
[casematrix_name] | : is the name of the casematrix |
[j] | : is the 1-based index of the historical variation |
[i] | : is the 1-based index of the branch variation |
The structure of the file is intended to be easily read by post-processing scipts, as described below. The parameters included in the output are selected using the set coefpara card (see also the parameter names in group constant generation).
Passing additional information with variables
Additional information useful for the post-processing script can be passed from the input directly into the output using variables. For example:
% --- Branch to low fuel temperature: branch Flo stp fuel -10.338 600 var TFU 600
defines variable "TFU" and sets its value to "600" when the fuel temperature branch is invoked. When the post-processing script reads the the data, it has the information that this is a branch to lower fuel temperature. Variables are also useful for passing history information. This can be done by defining a branch with varibables only:
% --- History variables: branch HIS var BHI 450 % Boron concentration 450 ppm var WHI 550 % Coolant temperature 550K
and including this branch in the coefficient matrix as its own single-valued dimension:
coef 11 0 0.1 1 3 5 10 15 20 30 40 50 10 BR01 BR02 BR03 BR04 BR05 BR03 BR07 BR08 BR09 BR10 1 HIS
The same information is then included in the output at every branch.
Output format
The [input].coe/[input]_[casematrix_name]_h[j]_r[i].coe output file is in ASCII format and divided into blocks. Each block provides a complete header and the group constant data from a single run:
(loop over runs) I_{tot} N_{tot} I_{coe} N_{coe} N_{uni} N_{bra} BRA_{1} BRA_{2} ... N_{var} VAR_{1} VAL_{1} VAR_{2} VAL_{2} ... BU I_{bu} N_{bu} (loop over universes) UNI N_{para} (loop over group constant data) PARA N_{val} VAL_{1} VAL_{2} ... ... (end loop over group constant data) ... (end loop over universes) ... (end loop over runs)
The block begins with line:
I_{tot} N_{tot} I_{coe} N_{coe} N_{uni}
where the values are:
I_{tot} | : | Run index |
N_{tot} | : | Total number of runs (number of branch combinations times number of burnup points) |
I_{coe} | : | Coefficient calculation index |
N_{coe} | : | Total number of coeffient calculations (number of branch combinations in the coefficient matrix) |
N_{uni} | : | Number of universes in a single run |
The second line provides information on the branches invoked in current run:
N_{bra} BRA_{1} BRA_{2} ...
where the values are:
N_{bra} | : | The number of branches invoked (dimension of the coefficient matrix) |
BRA_{n} | : | The branch names (as provided in the branch card) |
The third line lists the variables:
N_{var} VAR_{1} VAL_{1} VAR_{2} VAL_{2} ...
where the values are:
N_{var} | : | The number of variable name-value pairs that follow |
VAR_{n} | : | The variable names (as defined in the branch cards) |
VAL_{n} | : | The variable values (as assigned in the branch cards) |
Three variables are always printed: VERSION, DATE and TIME, which provide the code version used, and the date and time the calculation was completed. The 4th line provides information on the burnup points:
BU I_{bu} N_{bu}
where the values are:
BU | : | Burnup (as listed in the coef card) |
I_{bu} | : | Burnup index |
N_{bu} | : | Total number of burnup points |
The common header part is followed by a loop over N_{uni} universes. The first line in each subsection is:
UNI N_{para}
where the values are:
UNI | : | The name of the universe where group constant calculation was performed |
N_{para} | : | Total number of output parameters that follow |
This is then followed by N_{para} lines of group constant data. Each line has the format:
PARA N_{val} VAL_{1} VAL_{2} ...
where the values are:
PARA | : | The name of the output variable (as listed in the "set coefpara" card as well as the [input]_res.m output) |
N_{val} | : | Total number of values that follow |
VAL_{n} | : | The output values |
The relative statistical errors are not printed by default, but they can be included with an option in the set coefpara card, which also defines list of parameters included in the output. In such case the data is provided in mean value - statistical error pairs and N gives the number of pairs. Detector names are printed with a "DET_" prefix. The order in which the blocks are printed out depends on how the branches are listed in the coefficient matrix. Serpent runs all burnup points for each branch combination before moving on to the next combination, so the loop over burnup points forms the inner and loop over branch combinations the outer loop.
Example output block
Below is an example of a single output block from the [input].coe file:
- Run 171/594
- Branch combination 16/54
- Burnup point 6/11 (10 MWd/kgU)
- Group constants generated in a single universe ("0")
- 5 user-defined variables ("TMO", "TFU", "LIB", "BHI", "WHI")
- 21 output parameters (see list of homogenized group constants)
- See: complete input file
171 594 16 54 1 5 nom Chi Flo nom HIS 8 VERSION 2.1.25 DATE 16/03/04 TIME 19:09:01 TMO 600 TFU 600 LIB ENDFB7 BHI 500 WHI 550 10 6 11 0 21 B1_RABSXS 2 9.17033E-03 8.86673E-02 B1_NSF 2 5.53544E-03 1.27584E-01 B1_DIFFCOEF 2 1.48497E+00 4.24641E-01 B1_S0 4 4.85153E-01 1.57558E-02 1.55850E-03 1.17917E+00 B1_KAPPA 2 2.04239E+02 2.03734E+02 B1_FISS 2 2.11832E-03 4.97341E-02 B1_INVV 2 5.58556E-08 2.41106E-06 B1_I135_MICRO_ABS 2 8.83197E-01 4.15544E+01 B1_XE135_MICRO_ABS 2 1.19167E+02 1.54736E+06 B1_XE135_MACRO_ABS 2 2.62886E-07 3.05495E-03 B1_PM149_MICRO_ABS 2 4.56047E+01 7.28309E+02 B1_I135_YIELD 2 6.53753E-02 6.36544E-02 B1_XE135_YIELD 2 2.47729E-03 4.82697E-03 B1_PM149_YIELD 2 1.28555E-02 1.12583E-02 B1_SM149_YIELD 2 7.29176E-11 2.30416E-10 B1_SM149_MICRO_ABS 2 9.63168E+01 4.67481E+04 B1_SM149_MACRO_ABS 2 1.84000E-06 7.99047E-04 BETA_EFF 9 5.72581E-03 1.53655E-04 9.72497E-04 8.62868E-04 2.57368E-03 8.80209E-04 2.82902E-04 0.00000E+00 0.00000E+00 LAMBDA 9 8.14138E-01 1.25006E-02 3.12833E-02 1.10106E-01 3.21349E-01 1.33216E+00 9.01192E+00 0.00000E+00 0.00000E+00 DF_SURF_DF 8 9.97091E-01 9.98014E-01 9.97091E-01 9.98014E-01 9.97091E-01 9.98014E-01 9.97091E-01 9.98014E-01 DF_CORN_DF 8 9.99472E-01 9.73397E-01 9.99472E-01 9.73397E-01 9.99472E-01 9.73397E-01 9.99472E-01 9.73397E-01