2.2. CSAS-Shift: Criticality Safety Analysis Sequence with Shift
K. B. Bekar, G. Davidson, B. Langley, B.J. Marshall
The CSAS-Shift sequence integrates the Shift advanced Monte Carlo solver into the CSAS framework as an alternative to the KENO transport solvers to perform reliable and efficient eigenvalue calculations for criticality safety and reactor physics analysis. It supports both KENO V.a and KENO-VI geometries and provides most widely used KENO capabilities available in the CSAS5 and CSAS6 sequences for both multigroup and continuous-energy transport modes. The highly scalable Shift Monte Carlo solver enables faster solutions when running on multiple cores, and it shows better performance to achieve the same level of accuracy compared to the CSAS sequences with the KENO codes.
2.2.1. Introduction
The CSAS-Shift sequence was designed to provide the modeling and simulation capabilities required for criticality safety and reactor physics analysis through the Shift Monte Carlo solver.
Shift is a massively parallel Monte Carlo radiation transport package in the Exnihilo radiation transport code suite [CSAS-ShiftPJE+16], [CSAS-ShiftESSC10]. Shift was developed including features such as support for both fixed-source and eigenvalue Monte Carlo transport capabilities with multiple geometry and physics engines, hybrid capabilities for variance reduction methods, and advanced parallel decompositions to scale well from laptops to small computing clusters to advanced supercomputers. Shift supports different geometry engines, including the Oak Ridge Adaptable Nested Geometry Engine (ORANGE) designed to provide particle transport capabilities on both KENO V.a and KENO-VI geometries as well as geometry visualization capabilities in the Fulcrum user interface. Shift with both versions of KENO geometries performs eigenvalue calculations in both continuous-energy and multigroup modes. Shift supports most widely used primary capabilities available with the KENO codes and provides some unique capabilities with ORANGE such as modeling randomly packed media and efficient parallel calculations for volume estimates.
CSAS-Shift provides all capabilities for both multigroup and continuous-energy transport modes. Like the CSAS5 and CSAS6 implementation, in the multigroup calculation mode, CSAS-Shift sequences automate the processing of the cross sections for temperature corrections and problem-dependent resonance self-shielding for utilization in multigroup neutron transport calculations using SCALE’s cross section processing module, XSProc. If continuous-energy calculation mode is selected, no resonance processing is needed, and the continuous-energy cross sections are used directly in the Shift code, with temperature corrections provided as the cross sections are loaded.
CSAS-Shift with the highly scalable Shift solver enables some unique capabilities and faster solutions when running on multiple cores, and it shows better performance to achieve the same level of accuracy compared to the CSAS sequences with the KENO codes. CSAS-Shift input requirements, supported and unsupported capabilities, and input and output details are described in the following sections.
2.2.2. CSAS-Shift Input Requirements
CSAS-Shift’s design is aimed to make a smooth transition between
KENO codes to the Shift transport code. Therefore, the original input
data layout available in CSAS sequence with the KENO transport codes
was kept the same for the CSAS sequence with Shift transport.
CSAS-Shift uses the same CSAS5 and CSAS6 inputs, the only input
modification that should be required is changing the sequence
name by appending -shift
to the sequence name, as shown in
Example 2.2.1.
Like CSAS sequences with KENO codes, CSAS-Shift sequences are named with the KENO geometry that they support: CSAS5-Shift for the models with KENO V.a geometry, and CSAS6-Shift for the models with KENO-VI geometry.
=csas5
Godiva sphere
ce_v7.1
read composition
u-234 1 0 0.000491995 300 end
u-235 1 0 0.0449996 300 end
u-238 1 0 0.002498 300 end
end composition
read parameter
html=no
end parameter
read geometry
sphere 1 1 8.741
end geometry
end data
end
=csas5-shift
Godiva sphere
ce_v7.1
read composition
u-234 1 0 0.000491995 300 end
u-235 1 0 0.0449996 300 end
u-238 1 0 0.002498 300 end
end composition
read parameter
html=no
end parameter
read geometry
sphere 1 1 8.741
end geometry
end data
end
Warning
CSAS-Shift sequence implementation may ask the user for some minor input updates for a successful calculation.
2.2.3. Sequence Capabilities
In the CSAS-Shift sequence framework, SCALE data handling is automated as much as possible. Similar to many other SCALE sequences, CSAS-Shift also applies a standardized procedure to provide appropriate number densities and cross sections for the calculation. XSProc is responsible for reading the standard composition data and other engineering-type specifications—including volume fraction or percent theoretical density, temperature, and isotopic distribution, as well as the unit cell data. XSProc then generates number densities and related information, prepares geometry data for resonance self-shielding and flux-weighting cell calculations, and (if needed) provides problem-dependent multigroup cross section processing.
Sequences that execute Shift transport include a data processor named ExnihiloInputBuilder to read and check the KENO data. This data processor processes the KENO data and creates a ParameterList input used by Shift to construct the problem and perform transport calculations. When the data checking has been completed, the CSAS-Shift sequence executes XSProc to prepare a resonance-corrected macroscopic cross section library in the AMPX working library format for the subsequent Shift transport calculation if a multigroup library has been selected.
Similar to CSAS sequences with KENO transport, the CSAS-Shift sequence supports both CELLMIX and Double-het capabilities. For each unit cell specified as being cell-weighted, XSProc performs the necessary calculations and produces a cell-weighted macroscopic cross-section library. Shift may be executed to calculate the k-effective, or neutron multiplication factor, using the cross section library that was prepared by the control sequence.
Computational capabilities available in CSAS sequences with KENO codes—including the determination of k-effective, flux densities, fission densities, mesh tallies, Shannon entropy tally, problem-dependent continuous-energy temperature treatments, parallel calculations, and many more—are also provided by the CSAS-Shift sequence.
CSAS-Shift also supports two new CSAS sequence data blocks, definitions and tallies data, to allow flexible definition and output control of mesh tallies. The mesh responses neutron flux, fission rate, and fission source can now be requested multiple times on different spatial and energy grids in the same calculation. This capability helps users efficiently manage computational resources when collecting detailed information, depending on their requirements.
Criticality safety tools in SCALE attain some unique capabilities provided by Shift with the new geometry engine ORANGE, such as parallel volume estimates for KENO-VI geometric regions and modeling randomly packed media, which is enabled by implementing a random-packing algorithm to place spherical particles within simple bounding geometries. This capability allows constructing tristructural isotropic (TRISO) particle models for advanced reactor modeling and simulation activities. See Sect. 2.2.4.1.2.1 for further details.
Details for some of these capabilities, their input methods, and output edits are provided in the following sections.
2.2.3.1. Multigroup limitations
Some of the limitations of the CSAS-Shift multigroup sequences are a result of using preprocessed multigroup cross sections. Inherent limitations in multigroup CSAS-Shift calculations are as follows:
Spatial effects such as fuel rods in assemblies where some positions are filled with control rod guide tubes, burnable poison rods, and/or fuel rods of different enrichments. The cross sections are processed as if the rods are in an infinite lattice of identical rods. If the user inputs a Dancoff factor for the cell (such as one computed by MCDancoff), XSProc can produce an infinite lattice cell which reproduces that Dancoff. This can mitigate some spatial lattice effects.
2.2.3.2. Continuous-energy limitations
The continuous-energy cross sections are directly used in Shift. An existing multigroup input file can easily be converted to a continuous-energy input file by simply specifying the continuous-energy library. In this case, all cell data is ignored. However, the following limitations exist:
If CELLMIX is defined in the cell data, the problem will not run in continuous-energy mode. CELLMIX implies new mixture cross sections are generated using XSDRNPM-calculated cell fluxes; therefore it is not applicable in continuous-energy mode.
Problems with DOUBLEHET cell data are not allowed, as they inherently utilize the CELLMIX feature.
2.2.3.3. Unsupported Capabilities
Although Shift Monte Carlo code was designed with several advanced capabilities, it does not currently support some of the unique features available in KENO codes. Therefore, CSAS-Shift does not provide some of the capabilities available in CSAS5 and CSAS6 sequences.
The missing capabilities are mostly considered as the outdated features or those seldomly used by CSAS users in their analysis. The equivalent capabilities will be activated in the Shift transport code in the next SCALE release, depending on the need basis.
Table 2.2.1 summarizes the capabilities currently supported by CSAS with KENO codes but not supported by CSAS-Shift sequences.
Capability |
Input method(s) to activate the capability |
Comments |
---|---|---|
Adjoint transport |
parameter data |
Adjoint transport capability is not available in Shift |
Prompt-only \(nu\) |
parameter |
Shift does not support using prompt neutron spectrum only in continuous-energy mode |
Use unionized mixture cross section |
parameter |
Shift does not support KENO-like mechanism to store cross sections on a material-based unionized energy grid for a faster cross section lookup in continuous-energy mode Although this method benefits for faster runtimes for some KENO models, storing all data may require prohibitively large amount of memory for problem with a large number of materials. Different approaches are being developed in Shift transport, and some experimental implementation is available in CSAS-Shift. See Table 2.2.4 for more details. |
Matrix k-effective |
parameters
|
An alternative k-effective calculation method available in KENO codes are not supported by Shift. |
Start data types 2, 3, 4, 5 and 9 |
|
Start data types 2 - 5 have not been implemented by ORANGE geometry engine used by Shift transport. Start type 9 designed to read starting distribution from a mesh source file is not currently supported by CSAS-Shift. |
Biasing or weighting data |
|
KENO-like biasing capability is not currently supported by Shift transport. |
Periodic and White Albedo boundary conditions |
|
Shift transport does not currently support PERIODIC and WHITE boundary conditions for both KENO V.a and KENO-VI geometries. |
Differential Albedos |
|
Material specific albedos available with KENO multigroup transport is not supported by Shift multigroup transport |
LOOP construct in array data |
|
LOOP construct in array data input block is not supported by ORANGE geometry engine as part of Shift code. |
Volume calculation (random sampling) |
|
Random volume estimates for KENO-VI geometry is not available in ORANGE geometry engine used by Shift transport |
Accumulate mesh fluxes |
parameter |
Shift does not support to tally mesh fluxes which are averaged over the region volumes in each mesh voxel. |
Compute and print mean free paths |
parameter |
This capability is not currently implemented in Shift. |
Region-dependent fissions and absorptions |
parameters |
Although these tallies are available in Shift transport they are not currently implemented in CSAS-Shift. |
Mixture-dependent reaction tallies |
|
Although these tallies are available in Shift transport they are not currently implemented in CSAS-Shift. |
Time controlled termination |
parameter |
Shift does not have job termination capability controlled by the user-defined time limit. |
Terminate execution on user signal |
by creating a file named
|
CSAS-Shift does not support this capability |
Restart capability |
parameters |
Restart capability is not available in Shift |
Print particle tracks |
parameter |
Although Shift has its own mechanisms to print information about each particle history, this capability is not fully integrated in CSAS-Shift sequence. It will be available in next releases. |
Problem Characterization Output Edit |
always ON |
This capability is not currently implemented in CSAS-Shift. |
Frequency Distributions |
always ON |
This capability is not currently implemented in CSAS-Shift |
Plots of avg. k-effective and Shannon entropy |
always ON |
CSAS-Shift does not plot the average k-effective by generations run, the k-effective by generations skipped, and Shannon entropy per generation. Instead of the char-plots, CSAS-Shift creates Ptolemy plots and stores them in a dedicated plot directory. Fulcrum may be used to visualize these plots. See Sect. 2.2.6.1.12 |
Summary of Source Convergence Diagnostics |
parameter |
CSAS-Shift does not perform the posterior entropy tests available in KENO. Instead, result of a single test performed by Shift is captured and printed in the relevant output section. |
Print capabilities for mixed cross section |
parameters |
Currently, no capability is available to print the cross sections used by Shift transport. |
Flux moments and angular flux calc. |
parameters |
CSAS-Shift does not support any of these capabilities. |
Print starting points |
|
This capability is not currently implemented in CSAS-Shift |
Plot capability |
parameter |
Old-style plotting capabilities available in KENO codes are not supported. Fulcrum can be used for geometry visualization. |
HTML output |
parameter |
Old-style HTML-based output method is not supported. |
2.2.4. Input Data Guide
This section describes the input data required for the CSAS-Shift
sequence. A typical CSAS6-Shift input, shown in
Example 2.2.2, starts
with the sequence identifier always preceded by the =
sign, and
it is followed by the problem title. Then, a cross section library
name is specified, and all these entries are followed by several
data blocks each starting with READ data_block and
ending with END data_block.
=CSAS6-Shift parm=(parm_options)
problem title
' ----- XSProc data
' cross section library name (REQUIRED)
ce_v7.1
' List of material specifications in standard SCALE format (REQUIRED)
read composition
...
end composition
' Specify data for resonance processing (OPTIONAL)
read celldata
...
end celldata
' ---- New CSAS sequence data blocks
' Used to define energy bounds and grid geometries for
' the tallies defined in tallies data block
' (REQUIRED if tallies data block exists)
read definitions
...
end definitions
' Used to define tallies in a more robust way (OPTIONAL)
read tallies
...
end tallies
' ---- KENO transport data
' Specify the problem geometry (REQUIRED)
read geometry
...
end geometry
' Other input data blocks (OPTIONAL)
Because CSAS-Shift uses the same input data used by CSAS5 and CSAS6, details of the input data blocks, compositions, celldata, definitions, and tallies will not be repeated here, and they can be seen in Sect. 2.1.4. Data blocks in the KENO transport data category will be discussed in the following section.
Note
For CSAS-Shift, the grid boundaries must be inside the specified geometry, while CSAS-KENO permits grid boundaries beyond the geometry.
2.2.4.1. KENO input data in CSAS-Shift
Table 2.2.2
presents the lists of the KENO input data blocks supported by CSAS-Shift
sequence. The input method in some data blocks may show some minor differences
between the CSAS-KENO and CSAS-Shift sequences. Similarly, some capabilities
provided by each input block also have some differences. All these details
are discussed in this section. KENO input data blocks, that are
reaction data
,
bias data
, mixt data
, and plot data
, are not currently
supported by the CSAS-Shift sequences.
Data block |
Status |
Comments |
Parameters* |
Supported |
See Sect. 2.2.4.1.1 for more details. |
Geometry |
Supported |
See Sect. 2.2.4.1.2 for more details. |
Array data |
Supported |
|
Boundary conditions |
Supported |
See Sect. 2.2.4.1.2 for more details. |
Volume data |
Supported |
See Sect. 2.2.4.1.2 for more details. |
Energy boundaries |
Supported |
|
Start data |
Supported |
See Sect. 2.2.4.1.3 for more details. |
Grid geometry data |
Supported |
|
Plot data |
Not available |
The data in this block will be ignored in the calculations |
Bias data |
Not available |
Execution will be terminated. |
Reaction data |
Not available |
The data in this block will be ignored in the calculations |
Mixt data |
Not available |
The data in this block will be ignored in the calculations |
* Must precede all other data blocks in this table. |
Similar to CSAS5 and CSAS6, geometry data
is the only KENO
data block required to perform Shift transport calculation as part of the CSAS-Shift
sequence. Other data blocks are optional, and the same default values
listed in various locations in Sect. 8.1 are also applied to the
data in each data block in CSAS-Shift. Note that parameter data must
precede all other KENO data blocks if it is entered.
When CSAS-Shift is run with a user input including
bias data
block, the execution will be terminated with the error
message given in Example 2.2.3.
Note that CSAS-Shift ignores the data entered in the unsupported
plot data
, mixt data
, and reaction data
blocks and
continues the calculation. User is notified with a warning message as
shown in Example 2.2.4.
***Error: Failed to run ExnihiloModule with assertion:
----------------------------------------------
These input cards are unsupported by Shift.
----------------------------------------------
They must be removed from the input to run.
----------------------------------------------
line: 19 column: 1 biasing
----------------------------------------------
^^^ at /ornldev/code/Scale/S63/Source/packages/Module/Exnihilo/InputProcessorBase.cpp:193
====================================================================================================
Input Warnings:
====================================================================================================
***Warning: Plot block found. This is not currently supported by Shift and will be ignored for now.
Note
CSAS5-Shift and CSAS6-Shift also support PARM=CHECK or PARM=CHK sequence parm options. This will allow checking the input data without performing cross section calculation as well as Shift transport calculations.
=CSAS6-SHIFT PARM=CHK
2.2.4.1.1. Parameter data
The KENO parameter data block in both CSAS5 and CSAS6 sequences provides many control parameters to activate the capabilities available in KENO transport for the problem being run. CSAS-Shift supports only a subset of these parameters, as listed in Table 2.2.3. Detailed description of these parameter can be seen in Sect. 8.1.3.3.
Parameters entered in the parameter data
input block are processed by
CSAS-Shift sequence implementation, and then the ParameterList input
is updated to accordingly activate/deactivate the equivalent capabilities
with Shift transport if the asking feature is currently supported by Shift.
CSAS-Shift usually ignores the unsupported parameters by notifying the user
with a warning message, and then it continues the calculation. For some
specific parameters, code can terminate the execution and ask the user to
remove this parameter from the input and rerun the code for a successful
calculation.
Caution
CSAS-Shift notifies users of the unsupported parameters with a warning message before Numeric and Logical Parameters edit in the output, and then it ignores this parameter. It is the user’s responsibility to examine which input parameter is ignored in the current calculation.
Note
CSAS-Shift defaults the value of a parameter, which is currently
supported but not defined in the parameter data
input block, to the KENO
default. In other words, both CSAS and CSAS-Shift use the same defaults
for the same parameters.
PARAMETERS: |
Format: See Sect. 8.1.3.3 for details. |
||||
---|---|---|---|---|---|
KEY |
DEFAULT |
DEFINITION |
KEY |
DEFAULT |
DEFINITION |
|
given |
random number |
|
10.0 |
thermal energy cutoff (eV) |
|
0.0 |
deviation limit |
|
0.4 |
DBRC lower energy cutoff (eV) |
|
0.5 |
average weight |
|
210 |
DBRC upper energy cutoff (eV) |
|
1/WTH |
Russian Roulette weight |
|
0.0 |
mesh size of the cubic mesh |
|
203 |
number of generations |
|
0 |
use DBRC for scattering |
|
1000 |
number per generation |
|
2 |
Doppler Broadening method |
|
3 |
generations skipped |
|
0 |
CE TSUNAMI calculation mode |
|
252 |
number of energy groups for tallying |
|
-1 |
number of latent generations for CE- SUNAMI |
|
YES |
use probability tables |
|
YES |
fission source convergence diag. |
|
NO |
collect and print region fluxes |
|
NO |
accumulate neutron production |
|
YES |
fission densities |
|
NO |
fission rate mesh tally |
|
YES |
neutrons per fission |
|
NO |
compute grid fluxes |
|
NO |
print F*(r) 3dmap |
|
NO |
use mesh for CLUTCH F*(r) calc. |
|
YES |
execute problem |
|
NO |
NOT FULLY IMPLEMENTED |
PARAMETERS: |
||
---|---|---|
KEY |
DEFAULT |
DEFINITION |
|
5 |
Legendre polynomial order |
|
0.0 |
Accelerate xsec calculation using double indexing |
|
0.0001 |
Tolerance to use thinning the unionized xsec grid |
In CSAS5 and CSAS6, users can control the number of scattering angles
in multigroup calculations by entering the SCT
parameter in the KENO
mixing data
block. The similar capability in CSAS-Shift was
provided by adding a new parameter, PN_ORDER=
, to the parameter data
block because the mixing data
block is not supported by CSAS-Shift sequences.
Its default is set as 5.
2.2.4.1.2. Geometry data
CSAS-Shift with ORANGE geometry supports all KENO V.a and KENO-VI geometry capabilities except the following:
LOOP
construct inarray data
blockMaterial-specific albedo boundary conditions
PERIODIC and WHITE albedo boundary conditions
Random volume estimates for KENO-VI geometry (
TYPE=random
option involume data
)
CSAS-Shift can perform volume calculations with the stochastic ray-tracing method concurrently on the replicated domain on multiple cores.
2.2.4.1.2.1. Random geometry
Another new capability in CSAS-Shift is the automatic placement of units within another unit. This capability is currently limited to the stochastic placement of spherical geometries without clipping within another geometry. Additional options such as the automatic placement in lattice structures and the extension to other geometries is planned for future SCALE releases.
This new capability is enabled through a new input block named randomgeom
.
The randomgeom
block is composed of randommix
specifications which is
again composed of key/value pairs. The basic structure of the randomgeom
block and the randommix
specifications is as follows:
read randomgeom
RANDOMMIX = ID
TYPE=random
UNITS= U1 U2 ... UN end
PFS= pf1 pf2 ... pfN end
CLIP= no
SEED= int
end RANDOMMIX
end randomgeom
with
RANDOMMIX - keyword with ID number or name
TYPE - distribution type of units (currently limited to random)
UNITS - list of unit number(s) to be distributed in geometry
PFS - fraction of volume occupied by units
U1 ... UN
CLIP - boundary clipping (currently limited to no)
SEED - random seed for random placement
Similar to the array block, this input block requires that the unit
specified as part of a randommix in the units list must exist in the geometry.
An additional requirement is that the the units must have a spherical outer boundary.
The PF
list must have the same length as the units list. The sum of the values
listed in PFS
must be less than 1.0. In practice, the actual limit to the
total PF depends on the size and number of the units specified by the user.
The TYPE
keyword specifies the distribution of the units within the geometry.
The type is currently limited to random which will call a stochastic
placement algorithm to randomly distribute the units in the geometry.
The CLIP
keyword controls the clipping of the units along the geometry in
which they are placed. This is currently limited to no, that is the units
are not clipped by the geometry. The SEED
keyword is specifying the random
seed used for the stochastic distribution of units. This assures the same random
distribution if the input is run multiple times.
Note
Given the stochastic algorithm that is currently called by the randommix block, in practice total packing fractions of up to approximately 20% are achieved.
A “fill” material—the interstitial media surrounding the random spherical
geometry units—is not present in the randomgeom
block. Instead, the fill
media is handled in the unit specification within the KENO geometry
block of the input file: A region in a unit is filled with both a media and a
randommix
record. Then the media is filling the space of the region that is
not occupied by units placed through the units defined in the randommix
record.
A randommix
block can be used in multiple different units with varying fill
materials. The basic unit format along with a randommix
on the media record itself is as follows:
Note
A randommix
can currently be filled only into regions that have
an outer boundary of a sphere, cuboid, or cylinder.
read randomgeom
randommix=ID
...
end randommix
end randomgeom
read geometry
...
unit U
surfaces ...
media ...
media F biasID surfaces randommix=ID
boundary S
...
end geometry
In the sample case shown in Example 2.2.6, a single pebble is filled with a single TRISO particle type. Fig. 2.2.1 shows how TRISO particles are placed in a single pebble with the randomgeom capability. The individual location of particles is written in the Shift Hierarchical Data Format (HDF5) output file, so these locations can be used for verification or other purposes as needed.
=csas6-shift
...
read geometry
unit 1
com='kernel1'
sphere 1 2.50e-02
sphere 2 3.40e-02
sphere 3 3.80e-02
sphere 4 4.15e-02
sphere 5 4.55e-02
media 100 1 1
media 101 1 2 -1
media 102 1 3 -2
media 103 1 4 -3
media 104 1 5 -4
boundary 5
global unit 10
com='pebble'
sphere 1 2.5
sphere 2 3.0
cuboid 3 6p5.0
media 101 1 1 RANDOMMIX='trisos'
media 106 1 2 -1
media 0 1 3 -2
boundary 3
end geometry
read randomgeom
randommix = 'trisos'
type= random
units= 1 end
pfs= 0.05 end
clip= no
seed= 0
end randommix
end randomgeom
end data
end
2.2.4.1.3. Start data
CSAS-Shift supports only START types 0, 1, 6, 7, and 8.
CSAS-Shift start data implementation does not currently
support the PSP
option, which is used to print
source positions sampled by the Shift transport.
Implementations for start types 0, 1, 7, and 8 in CSAS-Shift are are similar to those in CSAS5 and CSAS6. However, there are some minor differences in start type 6.
In KENO start type 6 implementation, the following rules are applied when selecting the starting points (see Sect. 8.1.4.8 and Sect. 8.1.3.3 for more details).
Start NPG initial fission neutrons at first-NPG starting points defined by start type 6 data if NPG < LNU. Remaining starting points beyond NPG will be discarded.
Start NPG initial fission neutrons at LNU starting points defined by start type 6 data if NPG = LNU.
Start LNU initial fission neutrons at the starting points defined by start type 6 data, then randomly select the remaining fission source points (NPG-LNU) from these starting points if NPG > LNU.
where LNU, a start type 6 data parameter, is the total number of starting points specified in the start data block; and NPG, a parameter in the parameter data block, is the number of neutrons per generations.
Unlike KENO, the CSAS-Shift input processor does not follow the above rules when selecting positions for the initial fission neutrons. It calculates the probability of each point being selected and passes all starting points with this information to the Shift module. The Shift module always samples NPG initial fission source points using these data.
For example, the KENO code processes the following input and then samples the initial fission points.
=csas6 parm=bonami
Godiva test problem
test-8grp
read composition
u-234 1 0 0.000491995 300 end
u-235 1 0 0.0449996 300 end
u-238 1 0 0.002498 300 end
end composition
read parameter
htm=no gen=10 npg=15
end parameter
read geometry
global unit 1
sphere 1 8.67
media 1 1 1
boundary 1
end geometry
read start
nst=6 ps6=yes psp=yes
tfx=1.0 tfy=1.0 tfz=1.0 lnu=5
tfx=2.0 tfy=2.0 tfz=2.0 lnu=20
end start
end data
end
The summary of the sampling process is printed in KENO output, as shown in Fig. 2.2.2. KENO first starts 5 neutrons at (1.0, 1.0, 1.0) and the remaining 10 neutrons at (2.0, 2.0, 2.0) since LNU=20 > NPG=15.
However, CSAS-Shift creates a probability distribution from the defined start type 6 points and samples starting positions for NPG=15 particles using this distribution, as shown in Fig. 2.2.3.
2.2.5. Notes to CSAS-Shift Users
In Monte Carlo calculation, the variance of the eigenvalue (k-effective) at each generation is calculated as a sample variance, which is the quantity obtained by assuming no correlation over the generations. However, there is a correlation among the fission sources over generations since the deviation of fission source at a generation from its equilibrium distribution is transferred to the following generations. To resolve this issue, KENO codes use an iterative method to estimate the real variance. [CritSafetyUMN97]
The same methodology is also implemented inside Shift transport, so that printed k-effective uncertainties in both message and output files are derived from the real variance estimates.
Caution
User may observe differences in k-effective uncertainty values estimated by CSAS and CSAS-Shift sequences when running the identical problem. This is mainly due to the use of a different k-effective estimator in both KENO and Shift transport codes. Note that, KENO implements absorption estimator in CE mode and collision estimator in MG mode, whereas Shift implements track-length estimator for both CE and MG modes.
Warning
k-effective values and associated information from Shift
calculation and some diagnostics messages originated by Shift are
always printed to the standard output (and .msg
file).
There is no user option to suppress these.
2.2.6. CSAS-Shift Output
The CSAS-Shift sequence output is similar to the CSAS5 and CSAS6 outputs, except the output section dedicated to the transport module. See Sect. 2.1.5 for the layout of the output, mixture table edit, and cross section processing summary edits for a typical CSAS sequence.
This section contains a brief description of the output section dedicated to the Shift transport module. This section provides representative samples of the output format. The actual data contained in this section are not necessarily consistent with results computed by the current version of CSAS-Shift.
2.2.6.1. Shift output
The output layout of the Shift transport module is generally similar to the typical KENO output edits printed in the CSAS sequence output. However, some output edits are printed in a very different format, and these are discussed in this section.
Warning and error messages show stylistic differences compared to the traditional CSAS and KENO messages, and their details are not documented in this manual.
2.2.6.1.1. Program verification information
Program verification information Fig. 2.2.4 is printed after the header page. It lists the name of the program, the date the load module was created, the library that contains the load module, the computer code name from the configuration control table, and the revision number. The job name, date, and time of execution are also printed. This information may be used for quality assurance purposes.
2.2.6.1.2. General problem information
A general problem information output edit, shown in Fig. 2.2.5, follows the program verification information table. This table is printed by all SCALE Shift sequence implementations. After printing the title given in the input, it summarizes some high-level information for the physics setup of the Shift code.
2.2.6.1.3. Input Warnings
CSAS-Shift captures the warning messages emitted from the ExnihiloInputBuilder when processing KENO data for the Shift transport. All these stacked warning messages are printed in the input warnings output table as shown in Fig. 2.2.6.
2.2.6.1.4. Tables of parameter data
The CSAS-Shift parameter edits list both numeric and logical parameters in the same table. In each table row, the name of the KENO parameter, its short description, the current value of the parameter, and its input method are printed. If the parameter value has been entered by user in the KENO parameter data block, the input method is printed as ( input * ). Otherwise, the input method is printed as ( default ). The user should always verify that the parameter data block was entered as desired. An example of the parameters table is shown in Fig. 2.2.7.
2.2.6.1.5. Energy boundaries data
The CSAS-Shift implementation supports multiple sets of energy boundaries specifications for some of the tallies. This can be done by using the definitions data block as described in the CSAS manual Sect. 2.1.4. However, it prints only the default energy group bounds in the energy boundaries data edit, as illustrated in Fig. 2.2.8. Energy group boundaries used for each mesh tally will be printed in the mesh tallies output edit.
2.2.6.1.6. Mixing table data edits
CSAS-Shift uses the same format and contents as those described for KENO codes in Sect. 8.1.3.10 for the mixing table data edits. In this table, the mixture number, density, and temperature are first printed, followed by a table of the nuclides which make up the mixture. This table contains the following data: nuclide ID number, nuclide mixture ID number, atom density, weight fraction of nuclide in mixture, ZA number, atomic weight, temperature, and nuclide title. Mixture temperature is the same as the nuclides’ temperatures for the multigroup calculations, but it may show some differences in continuous-energy calculations. See Sect. 8.1.3.10 for details.
A sample mixing table data edit is shown in Fig. 2.2.9 for a multigroup calculation.
2.2.6.1.7. Geometry data edits
CSAS-Shift captures the output edit from ORANGE and prints these data as the overview of the geometry. Its format is completely different from the traditional KENO geometry output format but includes more descriptive sections for each geometry piece, as shown in Fig. 2.2.10.
2.2.6.1.8. Volume information
Volume tables for both KENO V.a and KENO-VI geometries are always printed by CSAS-Shift using the KENO-style volume editing format and cannot be suppressed. KENO V.a and KENO-VI volume tables show some differences, and all these details are described in KENO manual. See Sect. 8.1.5.17 for further details.
A sample volume output edit for KENO-VI geometry printed by CSAS-Shift is shown in Fig. 2.2.11.
2.2.6.1.9. Initial source edits
A summary table is always printed for start types 0, 1, 6, 7, and 8.
The table format is the same for both KENO V.a and KENO-VI geometries.
Fig. 2.2.12 illustrates typical starting
data for start type 0. The parameter used in this example was NST=0
.
2.2.6.1.10. K-effectives by generation
At the completion of each generation, CSAS-Shift prints the k-effective for that generation and associated information obtained from the Shift transport module. An example of this printout is given in Fig. 2.2.13.
The data printed include (1) the generation number, (2) the k-effective
calculated for the generation, (3) the average value of k-effective
through the current generation (excluding the nskip
-1 generations),
(4) the deviation associated with the average k-effective, and (5) Shannon
entropy for the generation.
After the last generation, a message is printed to indicate why execution was terminated. The user should examine this portion of the printed results to ensure that k-effective is in acceptable agreement and to verify that the average value of k-effective has become relatively stable. If the k-effectives appear to be oscillating or drifting significantly, then the user should consider rerunning the problem with a larger number of histories per generation.
Note
k-effective values from Shift calculations are always printed
to the standard output (and .msg
file). There is no user
option to suppress this.
2.2.6.1.11. Final k-effective edit
The final k-effective edit prints the average k-effective, its associated deviation, and the limits of k-effective for the 67, 95, and 99% confidence intervals. The number of histories used in calculating the average k-effective is also printed. This is done by skipping various numbers of generations. The user should carefully examine the final k-effective edit to determine whether the average k-effective is relatively stable. If a noticeable drift is apparent as the number of initial generations skipped increases, then it may indicate a problem in converging the source. If this appears to be the case, the problem should be rerun with a better initial source distribution and should be run for sufficient number of generations so that the average k-effective becomes stable. The final k-effective edit is printed as shown in Fig. 2.2.14.
2.2.6.1.12. Plot of average k-effective by generations run and by generations skipped
ASCII character plots of the average k-effective versus
the number of generations run, and the average k-effective versus
the number of generations skipped, are not printed by CSAS-Shift
in the code output. Instead, two Ptolemy plot files are created
and copied into the plots directory in ${OUTDIR}
. The name of
the plot files and their final destinations are printed in
the output, followed by the final k-effective edit as illustrated in
Fig. 2.2.15. These plot files can be
loaded and visualized by Fulcrum.
2.2.6.1.13. Shannon Entropy Diagnostics
CSAS-Shift does not perform any posterior entropy tests like those available in KENO codes. Instead, it captures diagnostic test results performed by Shift and prints its details in the Shannon entropy diagnostics output edit, as shown in Fig. 2.2.16
2.2.6.1.14. Fission densities
The fission density edit is optional. CSAS-Shift prints
the neutron production density and the fission density
for each geometry region if parameters FDN=YES
and NUB=YES
are specified in the parameter data (these are the default values).
If NUB=NO
is specified but FDN=YES
, then only the
production density will be given. An example of the fission
density edit is shown in Fig. 2.2.17
2.2.6.1.15. Flux Edit
Printing the fluxes is optional; they are printed only if
FLX=YES
is specified in the parameter data.
The fluxes are printed for each unit and each
geometry region in the unit for every energy group.
A sample of a flux edit is given in Fig. 2.2.18.
2.2.6.1.16. Final results table
The final results table contains the best-estimate system k-effective with one standard deviation, the number of warning and error messages generated during code execution, and a final statement on the convergence of the \(\chi^2\) test results as shown in Fig. 2.2.19.
2.2.6.1.17. Final timing report table
The final timing report table summarizes the time elapsed for input processing, cell processing (for multigroup mode), cross section processing (for multigroup mode), the entire transport process (Shift transport), and post-processing performed by the CSAS-Shift sequence after obtaining all results from the Shift transport calculation. A sample timing report obtained for a multigroup calculation is shown in Fig. 2.2.20.
References
- CSAS-ShiftESSC10
Thomas M. Evans, Alissa S. Stafford, Rachel N. Slaybaugh, and Kevin T. Clarno. Denovo: A new three-dimensional parallel discrete ordinates code in SCALE. Nuclear technology, 171(2):171–200, 2010.
- CSAS-ShiftPJE+16
T. M. Pandya, S. R. Johnson, Evans, T.M., G. G. Davidson, S. P. Hamilton, and A. T. Godfrey. Implementation, capabilities, and benchmarking of shift, a massively parallel monte carlo radiation transport code. Journal of Computational Physics, 308:239–272, 2016. Publisher: Elsevier.