Difference between revisions of "Input syntax manual"

Revision as of 14:14, 27 May 2023

Serpent has no interactive user interface. All communication between the code and the user is handled through one or several input files and various output files.

The format of the input file is unrestricted. The file consists of white-space (space, tab or newline) separated words, containing alphanumeric characters(’a-z’, ’A-Z’, ’0-9’, ’.’, ’-’). If special characters or white spaces need to be used within the word (file names, etc.), the entire string must be enclosed within quotes.

The input file is divided into separate data blocks, denoted as cards. The file is processed one card at a time and there are no restrictions regarding the order in which the cards should be organized. The input cards are listed below. Additional options are followed by key word "set". All input cards and options are case-insensitive (note to developers: make it so). Each input card is delimited by the beginning of the next card. It is hence important that none of the parameter strings used within the card coincide with the card identifiers.

The percent-sign ('%') is used to define a comment line. Anything from this character to the end of the line is omitted when the input file is read. Unlike Serpent 1, hashtag ('#') can no longer be used to mark comment lines in Serpent 2 input. The alternative is to use C-style comment sections beginning with "/*" and ending with "*/". Everything between these delimiters is omitted, regardless of the number of newlines or special characters.

This page will contain the whole input syntax of Serpent 2, with links to more detailed descriptions where needed. For reference see also the Serpent 1 input manual^[1].

Input cards

NOTE: Serpent command words are in boldface and input parameters entered by the user in CAPITAL ITALIC. Optional input parameters are enclosed in [ square brackets ], and when the number of values is not fixed, the remaining values are marked with three dots (...).

branch (branch definition)

branch NAME [ repm MAT₁ MAT₂ ]
            [ repu UNI₁ UNI₂ ]
            [ stp MAT DENS TEMP THERM₁ SABL₁ SABH₁ THERM₂ SABL₂ SABH₂ ... ]
            [ tra TGT TRANS ] 
            [ xenon OPT ] 
            [ samarium OPT ] 
            [ norm NSF ] 
            [ gcu UNI₂ ] 
            [ reptrc FILE₁ FILE₂ ]
            [ var VNAME VAL ]
            [ incl MODFILE ]

Defines the variations invoked for a branch in the automated burnup sequence. The first parameter:

NAME : branch name

The remaining parameters are defined by separate key words followed by the input values.

Notes:

The branch card can be combined with the coef card, hisv card, and casematrix card.
The branch name identifies the branch BR_m,i in the variation matrix defined by the coef card, hisv card, and casematrix card.
The input parameters consist of a number variations, which are invoked when the branch is applied. A single branch card may include one or several variations.
For more information, see detailed description on the automated burnup sequence.

Variation types:

Branch material variation (repm):

`MAT₁`	: name of the replaced material
`MAT₂`	: name of the replacing material

Notes:

The material variation can be used to replace one material with another, for example, to change coolant boron concentration.
The material replacement works as if MAT₁ were created using the mat or mix card of MAT₂.
The name of the material present in the geometry will still be MAT₁ after the replacement, but the material specification (composition, density, tmp, moder, rgb, etc.) will correspond to MAT₂.
- This means that all other input-cards that are linked to a specific material name such as det dm, src sm, set trc and set iter nuc can be linked to the original material (MAT₁) and they will automatically apply to whatever material MAT₂ replaces MAT₁ for the branch calculation.
The replaced material MAT₁ is also replaced inside mixtures.
- This means one can not replace a material with a mixture defined with mix card containing the replaced material (for example replacing pure water defined with mat card by a mixture of boron and water defined with a mix card containing the same pure water material).
The replacing material MAT₂ can not be included in the geometry using other cards than the branch card, from version 2.1.30 and on.

Branch universe variation (repu):

`UNI₁`	: name of the replaced universe
`UNI₂`	: name of the replacing universe

Notes:

The universe variation can be used to replace one universe with another, for example, to replace empty control rod guide tubes with rodded tubes for control rod insertion in 2D geometries.
The name of the universe present in the geometry will still be UNI₁ after the replacement, but the universe contents will correspond to UNI₂.
This means that all other input-cards that are linked to a specific universe name such as det du and src su can be linked to the original universe (UNI₁) and they will automatically apply to whatever universe UNI₂ replaces UNI₁ for the branch calculation.

Branch state variation, density/temperature (stp):

`MAT`	: name of the material for which density and temperature are adjusted
`DENS`	: material density after adjustment (positive value = atomic density [in b^-1cm^-1], negative value = mass density [in g/cm³])
`TEMP`	: material temperature after adjustment [in K], or "`-1`" if no adjustment in temperature
`THERM_n`	: n-th thermal scattering data associated with the material
`SABL_n`	: name of the n-th S(α, β) library for temperature below the given value
`SABH_n`	: name of the n-th S(α, β) library for temperature above the given value

Notes:

The state variation can be used to change material density and temperature.
There are two special entries for the DENS entry:
- "sum": to define the material density as the sum of the constituent nuclides densities (not supported from version 2.2.0 and on)
- "original": to keep unmodified the material density (introduced in version 2.2.1).
The adjustment is made using the built-in Doppler-broadening preprocessor routine and tabular interpolation for S(α, β) thermal scattering data.
The last three parameters of the card are provided only if the material has thermal scattering libraries attached to it (see the therm card).

Branch transformation variation (tra):

`TGT`	: target universe, surface or cell
`TRANS`	: name of the applied transformation

Notes:

The transformation variation can be used to move or rotate different parts of the geometry, for example, to adjust the position of control rods in 3D geometries.
The name of the transformation TRANS refers to the unit (universe, cell or surface) entry in the trans card.

Branch xenon variation (xenon):

OPT : option for setting Xe-poison concentrations (0 = set to zero, 1 = use values from restart file)

Notes:

The xenon variation can be set to enforced the Xe-135 concentration to zero. By default the concentration is read from the restart file.

Branch samarium variation (samarium):

OPT : option for setting Sm-poison concentrations (0 = set to zero, 1 = use values from restart file)

Notes:

The samarium variation can be set to enforced the Sm-149 concentration to zero. By default the concentration is read from the restart file.

Branch normalization variation (nsf):

NSF : normalization scaling factor

Notes:

The normalization variation can be used to change the normalization.
The adjustment is made applying the parameter NSF as a multiplicative scaling factor to the given normalization.

Branch group constant variation (gcu):

UNI₂ : name of the replacing universe

Notes:

The group constant variation can be used to replace the universe for group constant generation.
The variation is limited to a single-valued GCU-list (see set gcu option).

Branch transport-correction variation (reptrc):

`FILE₁`	: file path of the replaced transport correction curve data
`FILE₂`	: file path of the replacing transport correction curve data

Notes:

The transport-correction variation can be used to replace a transport correction file with another (see set trc option).

Branch variable variation (var):

`VNAME`	: variable name
`VAL`	: variable value

Notes:

The variable variation can be used to pass information into the output file, which may be convenient for the post-processing of the data.

Branch user-defined variation (incl):

MODFILE : file path to an additional/modified input file

Notes:

The user-defined variation can be used as a multi-purpose option to modify the base-input via the additional input file MODFILE.

casematrix (casematrix definition)

casematrix CASE_NAME
           NHIS [ HIS_BR₁ HIS_BR₂ ... HIS_BR_NHIS ]
           NBU  [ BU₁ BU₂ ... BU_NBU ] 
           NBR₁ [ BR_1,1 BR_1,2 ... BR_1,NBR₁ ]
           NBR₂ [ BR_2,1 BR_2,2 ... BR_1,NBR₂ ]
           ...

Defines the casematrix for the automated burnup sequence. Input values:

`CASE_NAME`	: name of the casematrix
`NHIS`	: number of history variations
`HIS_BR_k`	: name of the k-th history variation branch
`NBU`	: number of burnup points
`BU_n`	: burnup steps at which the momentary variation branches are invoked (positive value = burnup [in MWd/kg], negative value = time [in d])
`NBR_m`	: number branches in the m-th dimension of the burnup matrix
`BR_m,i`	: name of the i-th branch in the m-th dimension

Notes:

The casematrix card performs multiple depletions with NHIS (different) historical variations and performs restarts similar as the coef input card.
The casematrix card creates a multi-dimensional coefficient matrix (of size NBR₁ × NBR₂ × NBR₃ × ... ). The automated burnup sequence performs a restart for each of the listed burnup points, and loops over the branch combinations defined by the coefficient matrix. This is repeated for each different depletion history.
The casematrix card is used together with the branch card and -casematrix running option.
Multiple casematrix cards can be given in a single input file.
For more information, see detailed description on automated burnup sequence.

cell (cell definition)

cell NAME UNI₀ MAT [ SURF₁ SURF₂ ... ]

Defines a material cell. Input values:

`NAME`	: cell name
`UNI₀`	: universe where the cell belongs to
`MAT`	: material that fills the cell
`SURF_n`	: surface list

cell NAME UNI₀ fill UNI₁ [ SURF₁ SURF₂ ... ]

Defines a filled cell. Input values:

`NAME`	: cell name
`UNI₀`	: universe where the cell belongs to
`UNI₁`	: universe that fills the cell
`SURF_n`	: surface list

cell NAME UNI₀ outside [ SURF₁ SURF₂ ... ]

Defines an outside cell. Input values:

`NAME`	: cell name
`UNI₀`	: universe where the cell belongs to
`SURF_n`	: surface list

Notes:

There are three types of cells: material cells, filled cells and outside cells. Filled cells are identified by providing the key word fill, followed by the universe filling the cell. If the key word is missing, the third entry is interpreted as the material filling the cell. Outside cells are identified by replacing the material name with key word outside.
Cells defined without surfaces are treated as infinite, from version 2.1.32 on.
Void cells can be defined by setting the material name to "void"
When the geometry is set up, the root universe must always be defined. By default the root universe is named "0", and it can be changed with the set root option.
Outside cells are used to define the part of the geometry that does not belong to the model. When the particle enters an outside cell, boundary conditions are applied. It is important that the geometry model is non-re-entrant (convex) when vacuum boundary conditions are used. Delta-tracking might miss the boundary conditions in a re-entrant (concave) outer surface.
Outside cells are allowed only in the root universe. It is important that all space outside the model is defined.
The surface list defines the boundaries of the cell by listing the surface names (as provided in the surface card), together with the operator identifiers (nothing for intersection, ":" for union, "-" for complement and "#" for cell complement).
Universes are implicitly declared for example by using the UNI₀ key words on cell cards as there is no explicit universe input card.
For more information, see detailed description on the universe-based geometry type in Serpent.

coef (coefficient matrix definition)

coef NBU [ BU₁ BU₂ ... ] 
         [ NBR₁ BR_1,1 BR_1,2 ... ]
         [ NBR₂ BR_2,1 BR_2,2 ... ]
         ...

Defines the coefficient matrix for the automated burnup sequence. Input values:

`NBU`	: number of burnup points
`BU_n`	: burnup steps at which the branches are invoked (positive value = burnup [in MWd/kg], negative value = time [in d])
`NBR_m`	: number branches in the m-th dimension of the burnup matrix
`BR_m,i`	: name of the i-th branch in the m-th dimension

Notes:

The coef card creates a multi-dimensional coefficient matrix (of size NBR₁ × NBR₂ × NBR₃ × ... ). The automated burnup sequence performs a restart for each of the listed burnup points, and loops over the branch combinations defined by the coefficient matrix.
The coef card is used together with the branch card.
For multiple historical variations or historical conditions defined using a branch card, see the casematrix card.
For more information, see detailed description on automated burnup sequence.

datamesh (general data mesh definition)

The datamesh card allows the user to define various meshes that can be used for spatial discretization e.g. in detectors.

datamesh NAME 1 USE_LC N_X X_MIN X_MAX N_Y Y_MIN Y_MAX N_Z Z_MIN Z_MAX

Defines a regular Cartesian mesh that can be linked to detectors, interfaces etc.

`NAME`	: mesh name
`USE_LC`	: use lowest level coordinates (1/yes) instead of global coordinates (0/no) for the mesh search
`N_X`	: number of cells in the x-direction
`X_MIN`	: mesh lower x-boundary [in cm]
`X_MAX`	: mesh higher x-boundary [in cm]
`N_Y`	: number of cells in the y-direction
`Y_MIN`	: mesh lower y-boundary [in cm]
`Y_MAX`	: mesh higher y-boundary [in cm]
`N_Z`	: number of cells in the z-direction
`Z_MIN`	: mesh lower z-boundary [in cm]
`Z_MAX`	: mesh higher z-boundary [in cm]

datamesh NAME 2 USE_LC N_R R_MIN R_MAX N_PHI

Defines a regular 2D cylindrical mesh that can be linked to detectors, interfaces etc.

`NAME`	: mesh name
`USE_LC`	: use lowest level coordinates (1/yes) instead of global coordinates (0/no) for the mesh search
`N_R`	: number of cells in the radial direction
`R_MIN`	: mesh inner radial boundary [in cm]
`R_MAX`	: mesh outer radial boundary [in cm]
`N_PHI`	: number of cells in the polar angle direction

X-type hexagonal mesh horizontal indexing example for N_X = N_Y = 3.

datamesh NAME 4 USE_LC X₀ Y₀ PITCH Z_MIN Z_MAX N_X N_Y N_Z

Defines a regular x-type hexagonal mesh that can be linked to detectors, interfaces etc.

`NAME`	: mesh name
`USE_LC`	: use lowest level coordinates (1/yes) instead of global coordinates (0/no) for the mesh search
`X₀`	: mesh horizontal origin x-coordinate [in cm]
`Y₀`	: mesh horizontal origin y-coordinate [in cm]
`PITCH`	: mesh horizontal pitch (equal to cell flat-to-flat width) [in cm]
`Z_MIN`	: mesh lower z-boundary [in cm]
`Z_MAX`	: mesh higher z-boundary [in cm]
`N_X`	: number of cells in the x-direction
`N_Y`	: number of cells in the y-direction
`N_Z`	: number of cells in the z-direction

Y-type hexagonal mesh horizontal indexing example for N_X = N_Y = 3.

datamesh NAME 5 USE_LC X₀ Y₀ PITCH Z_MIN Z_MAX N_X N_Y N_Z

Defines a regular y-type hexagonal mesh that can be linked to detectors, interfaces etc.

`NAME`	: mesh name
`USE_LC`	: use lowest level coordinates (1/yes) instead of global coordinates (0/no) for the mesh search
`X₀`	: mesh horizontal origin x-coordinate [in cm]
`Y₀`	: mesh horizontal origin y-coordinate [in cm]
`PITCH`	: mesh horizontal pitch (equal to cell flat-to-flat width) [in cm]
`Z_MIN`	: mesh lower z-boundary [in cm]
`Z_MAX`	: mesh higher z-boundary [in cm]
`N_X`	: number of cells in the x-direction
`N_Y`	: number of cells in the y-direction
`N_Z`	: number of cells in the z-direction

datamesh NAME 6 USE_LC N_X N_Y N_Z  X₁ ... X_{N_X+1}  Y₁ ... Y_{N_Y+1}  Z₁ ... Z_{N_Z+1}

Defines an irregular Cartesian mesh that can be linked to detectors, interfaces etc.

`NAME`	: mesh name
`USE_LC`	: use lowest level coordinates (1/yes) instead of global coordinates (0/no) for the mesh search
`N_X`	: number of cells in the x-direction
`N_Y`	: number of cells in the y-direction
`N_Z`	: number of cells in the z-direction
`X_i`	: `N_X + 1` mesh boundaries in the x-direction [in cm]
`Y_i`	: `N_Y + 1` mesh boundaries in the y-direction [in cm]
`Z_i`	: `N_Z + 1` mesh boundaries in the z-direction [in cm]

datamesh NAME 8 USE_LC N_R N_PHI  R₁ ... R_{N_R+1}

Defines a radially irregular 2D cylindrical mesh that can be linked to detectors, interfaces etc.

`NAME`	: mesh name
`USE_LC`	: use lowest level coordinates (1/yes) instead of global coordinates (0/no) for the mesh search
`N_R`	: number of cells in the radial direction
`N_PHI`	: number of cells in the polar angle direction
`R_i`	: `N_R + 1` mesh boundaries in the radial direction [in cm]

datamesh NAME 9 USE_LC N_LEVEL  MESH₁ ... MESH_{N_LEVEL}

Defines a regular nested mesh that can be linked to detectors, interfaces etc.

`NAME`	: mesh name
`USE_LC`	: use lowest level coordinates (1/yes) instead of global coordinates (0/no) for the mesh search
`N_LEVEL`	: number of nested levels in this mesh
`MESH_i`	: sub mesh to use at level i

Notes:

When Serpent makes the mesh search for a specific collision point it will save the collision mesh cell temporarily so that the cell search is conducted at most once even when scoring multiple estimators using the same mesh.
The nested data meshes (type 9) take the coordinates' level from the USE_LC parameter defined in the nested mesh itself and use it in the subsequent sub-meshes, overriding the USE_LC parameter defined on those.

dep (depletion history)

dep STYPE [ STEP₁ STEP₂ ... ]

Defines depletion history with steps and activates depletion calculation mode. Input values:

`STYPE`	: step type
`STEP_n`	: depletion step list

The possible step types are:

Type	Description	Quantity	Unit
`bustep`	Depletion step	Burnup interval	MWd/kgHM
`butot`	Depletion step	Cumulative burnup	MWd/kgHM
`daystep`	Depletion step	Time interval	d
`daytot`	Depletion step	Cumulative time	d
`decstep`	Decay step	Time interval	d
`dectot`	Decay step	Cumulative time	d
`actstep`	Activation step	Time interval	d
`acttot`	Activation step	Cumulative time	d

Notes:

Transport cycle is omitted with the decstep and dectot options.
Transport cycle is run only once with the actstep and acttot options.

dep pro REP_NAME STYPE [ STEP₁ STEP₂ ... ]

Links a reprocessor to the depletion calculation. Input values:

`REP_NAME`	: reprocessor name
`STYPE`	: step type
`STEP_n`	: depletion step list

Notes:

The reprocessing system or reprocessor controller is defined using the rep card.

dep bra PTR_BRANCH

det (detector definition)

det NAME [ PART ]
         [ dr MT MAT ] 
         [ dv VOL ]
         [ dc CELL ]
         [ du UNI ]
         [ dm MAT ]
         [ dl LAT ] 
         [ dx X_MIN X_MAX N_X ]
         [ dy Y_MIN Y_MAX N_Y ]
         [ dz Z_MIN Z_MAX N_Z ]
         [ dn TYPE MIN₁ MAX₁ N₁ MIN₂ MAX₂ N₂ MIN₃ MAX₃ N₃ ] 1/2 [ dn TYPE N₁ N₂ N₃ LIM₁₁...LIM_1N+1 LIM₂₁...LIM_2N+1 LIM₃₁...LIM_3N+1 ] 3/4
         [ dh TYPE X₀ Y₀ PITCH N₁ N₂ Z_MIN Z_MAX N_Z ]
         [ dumsh UNI N_C CELL₀ BIN₀ CELL₁ BIN₁ ... ]
         [ de EGRID ]
         [ di TBIN ]
         [ ds SURF DIR ]
         [ dir COS_X COS_Y COS_Z ]
         [ dtl SURF ]
         [ df FILE FRACTION ]
         [ dt TYPE PARAM ]
         [ dhis OPT ]
         [ dfl FLAG OPT ]
         [ da MAT FLX ]
         [ dfet TYPE PARAMS ]
         [ dphb PHB ]
         [ dmesh MESH ]

Detector definition. The two parameters:

`NAME`	: detector name
`PART`	: particle type (n = neutron, p = photon)

The remaining parameters are defined by separate key words followed by the input values.

Notes:

The particle type PART is optional in single particle simulations.
The detectors represent integral values in space, angle, energy and time.
A detector with an associated discretization in space, angle, energy and/or time turns into multiple bins. Each bin results are correspondingly integrated over the discretization domain.
A single detector card may include one or several detector types. If multiple detectors are defined, the results are correspondingly divided into multiple bins.

Detector types:

Detector response (dr):

`MT`	: response number
`MAT`	: material name or "`void`" if the material at the collision point is used

Notes:

If the detector is assigned with multiple responses, the results are divided correspondingly into separate bins.
The response numbers are ENDF reaction MT's and special reaction types.
Positive response numbers are associated with microscopic cross sections and the result is independent of material density. Materials for microscopic cross sections must consist of a single nuclide.
Microscopic reactions to ground and isomeric states can be calculated by adding "g" or "m" at the end of the reaction number (e.g. 102g and 102m refer to radiative capture to ground and isomeric states, respectively). This option is available only for nuclides with branching ratios.
Negative response numbers are associated with macroscopic cross sections and special types, and the result is multiplied by material density.
The response material in the dr entry must not be confused with the material in the dm entry. The former defines the material for the response function, while the latter determines the volume of integration.
The "void" entry allows the response not to be pre-assigned with a specific material (when the detector scores in a collision, the cross-section is taken from the material at the collision point - e.g., to calculate integral reaction rates over regions composed of multiple materials) only can be used with negative response numbers.
By default, Serpent allows a detector to have at most 10,000,000 bins.

Detector volume (dv):

VOL : volume [in cm³] (3D geometry) or cross-sectional area [in cm²] (2D geometry)

Notes:

The results are divided by detector volume (default value: 1.0)
In the case of surface detectors, VOL represents the surface area [in cm²] (3D geometry) or the surface length [in cm] (2D geometry).

Detector cell (dc):

CELL : cell name where the detector is scored

Notes:

If multiple detector cells are defined, the results are correspondingly divided into multiple bins.

Detector universe (du):

UNI : universe name where the detector is scored

Notes:

If multiple detector universes are defined, the results are correspondingly divided into multiple bins.

Detector material (dm):

MAT : material name where the detector is scored

Notes:

If multiple detector materials are defined, the results are correspondingly divided into multiple bins.
The material entry defines the volume of integration, which must not be confused with the response material in the dr entry.

Detector lattice (dl):

LAT : lattice name where the detector is scored

Notes:

The lattice detector automatically divides the results into multiple bins corresponding to the lattice cells.

Cartesian mesh detector (dx, dy and dz):

`X_MIN`	: minimum x-coordinate of the detector mesh [in cm]
`X_MAX`	: maximum x-coordinate of the detector mesh [in cm]
`N_X`	: number of x-bins
`Y_MIN`	: minimum y-coordinate of the detector mesh [in cm]
`Y_MAX`	: maximum y-coordinate of the detector mesh [in cm]
`N_Y`	: number of y-bins
`Z_MIN`	: minimum z-coordinate of the detector mesh [in cm]
`Z_MAX`	: maximum z-coordinate of the detector mesh [in cm]
`N_Z`	: number of z-bins

Notes:

The mesh detectors can be used to sub-divide the results into multiple spatial bins.
For a Cartesian mesh the division is provided with separate entries in x-, y- and z- locations (dx, dy and dz, respectively).

Curvilinear and unevenly-spaced mesh detector (dn):

`TYPE`	: type of curvilinear mesh - 1 = cylindrical (dimensions r, θ, z), 2 = spherical (dimensions r, θ, φ), 3 = unevenly-spaced orthogonal (dimensions x, y, z), 4 = unevenly-spaced cylindrical (dimensions r, θ, z)
`MIN_n`	: minimum value of n-coordinate for the mesh division [in cm (r, z), in degrees (θ, φ)].
`MAX_n`	: maximum value of n-coordinate for the mesh division [in cm (r, z), in degrees (θ, φ)].
`N_n`	: number of bins in the n-coordinate direction (the radial division will be equal r, not equal volume, in evenly-spaced types 1/2).
`LIM_nm`	: mesh m-boundary in the n-coordinate direction [in cm (r, z), in degrees (θ, φ)].

Notes:

All parameters must be provided, even for one- or two-dimensional curvilinear meshes.
The results are not divided by cell volume (difference to MCNP mesh tally).
By default, the curvilinear mesh detectors use the global (universe 0) coordinate system for scoring. If the TYPE parameter is given as a negative value (e.g. -1) the lowest level coordinates are used instead.
The syntax for curvilinear (evenly-spaced) mesh detectors (1/-1, 2/-2) differs from the unevenly-spaced mesh ones (3/-3, 4/-4).

Hexagonal mesh detector (dh):

`TYPE`	: type of hexagonal mesh (2 = flat face perpendicular to x-axis, 3 = flat face perpendicular to y-axis)
`X₀`, `Y₀`	: coordinates of mesh center [in cm]
`PITCH`	: mesh pitch [in cm]
`N₁`, `N₁`	: mesh size
`Z_MIN`	: minimum z-coordinate of the detector mesh [in cm]
`Z_MAX`	: maximum z-coordinate of the detector mesh [in cm]
`N_Z`	: number of z-bins

Notes:

All parameters must be provided, even for a two-dimensional hexagonal meshes.

Unstructured mesh detector (dumsh):

`UNI`	: universe of the unstructured mesh based geometry
`N_C`	: number of mesh cell bins included in the output
`CELL_n`, `BIN_n`	: cell-bin index pairs defining the mapping

Notes:

The polyhedral cells in unstructured mesh based geometries are indexed.
This detector option allows collecting results from the cells into an arbitrary number of bins. One or multiple cells can be mapped into a single bin.

Detector energy binning (de):

EGRID : energy grid name

Notes:

The results are divided into multiple energy bins based on the grid structure.
Energy grid structures are defined using the ene card. Pre-defined energy group structures can not be directly used in detectors, they have to be redefined using for example the fourth type of ene card.
The energy boundaries of photon photon pulse-height and photon heat analog detectors are solely defined by the associated energy grid and not limited by the unionized energy grid defining the model. That means that analog detectors might collect scores below the physics model minimum energy bound, without a cut-off, if the energy grid sets it.

Detector time binning (di):

TBIN : time bin structure name

Notes:

The results are divided into multiple time bins.
Time bin structures are defined using the tme card.
Time bin division may require adjusting the average collision distance (set cfe option) to achieve sufficient statistical accuracy.

Surface current / flux detector (ds):

`SURF`	: surface name
`DIR`	: direction with respect to surface normal (-2 = flux, -1 = inward current, 1 = outward current, 0 = net current)

Notes:

With this option the detector calculates the particle flux over or current through a given surface.
The surface flux mode is invoked by setting the direction parameter to "-2", otherwise this parameter defines the current direction with respect to surface normal.
Responses are not allowed with current detectors, and with flux detectors, the material name at the collision point has to be specified ("void" is not allowed).
The use of single-bin mesh and cell detectors is allowed to further define the surface and integration domain of the detector, from version 2.1.32 on.
The surface is treated separate from the geometry, and its position is always relative to the origin of the root universe. This is the case even if the surface is part of the geometry in another universe.
The results are integrated over the surface area (other detectors integrate over volume).

Detector direction vector (dir):

`COS_X`	: component of the direction vector parallel to x-axis
`COS_Y`	: component of the direction vector parallel to y-axis
`COS_Z`	: component of the direction vector parallel to z-axis

Notes:

This option multiplies the detector scores with the scalar product between the particle direction of motion and the given direction vector.

Super-imposed track-length detector (dtl):

SURF : surface inside which the detector is scored

Notes:

This option can be used to apply the track-length estimator for calculating reaction rates inside regions defined by a single surface (sphere, cylinder, cuboid, etc.)
The purpose of the track-length detector is to provide better statistics for special applications (activation wire measurements, etc.).
The surface is treated separate from the geometry, and its position is always relative to the origin of the root universe. This is the case even if the surface is part of the geometry in another universe.

Detector file (df):

`FILE`	: file name where the scored points are written
`FRAC`	: fraction of recorded scores and ASCII/binary option (positive value = ASCII, negative value = binary)

Notes:

This option can be used to write the scored points in a file.
When used with the surface current detector this option can provide surface source distributions for other calculations.
The fraction parameters gives the probability that the score is written in the file and it can be used to reduce the file size in long simulations.
Source files can be read using the sf entry of source cards.

Special types (dt):

`TYPE`	: special type (see below)
`PARAM`	: additional parameters

The types are:

-1	= cumulative spectrum
-2	= division by energy width
-3	= division by lethargy width
-4	= sum over cell or material bins
-5	= importance weighting
-6	= sum over number of scores
2	= multiply result with another detector defined by `PARAM`
3	= divide result with another detector defined by `PARAM`
4	= multiply response function by (local) temperature

Notes:

Types -1, -2 and -3 are used with energy binning.
Type -4 can be used to calculate sum over multiple cell or material bins defined using the dc and dm options. By default separate bins are used for each entry.
Type 3 can be used to calculate flux-weighted averages (microscopic and macroscopic cross sections, etc.).
When the results are multiplied or divided by another detector, the number of bins must be compatible (single value or matching number of bins).

History collection option (dhis):

OPT : option to collect histories (0 = no, 1 = yes)

Notes:

When this option is set, the batch-wise results are printed in the history output file, [input]_stats.m.
Note to developers: statistical tests should be documented

Detector flagging (dfl):

`FLAG`	: flag number (between 1 and 64)
`OPT`	: flagging option (0 = reset if scored, 1 = set if scored, -2/2 score if set -3/3 score if not set)

Notes:

Detector flagging allows limiting detector scores to histories which have already contributed to another score.
The first two options reset or set the flag if the detector is scored, respectively. The remaining options test if the flag is set and score the detector accordingly. Positive values apply OR-type logic (detector is scored if any of the associated flags is set/unset) and negative values AND-type logic (detector is scored if all the associated flags are set/unset).

Activation detector (da):

`MAT`	: activated material
`FLX`	: flux applied to activation [in 1/cm²s]

Notes:

Activation detector allows performing activation calculation for materials that are not part of the geometry. The flux spectrum applied to neutron irradiation is taken from the detector scores. The absolute flux level can be set using the FLX parameter. If this parameter is set to -1, also the flux magnitude is taken from the detector scores.
Requires neutron transport simulation and burnup mode. The material provided with the entry must be burnable, and cannot part of the actual geometry. Volume of the material must be defined using the dv parameter.
Since the activated material is not part of the physical geometry, this option should be applied only to small samples and other activation calculations in which the isotopic changes do not significantly affect the neutronics.

Functional Expansion Tally detector (dfet):

`TYPE`	: functional expansion type
`PARAMS`	: other options, specific to each functional expansion type `TYPE`

Geometry	`PARAMS`	`TYPE`	Description	Functional Series	Indexing
Cartesian	`X_MIN X_MAX X_ORDER Y_MIN Y_MAX Y_ORDER Z_MIN Z_MAX Z_ORDER`	`1`	Legendre only	$\psi(\xi)_n = P_i(\xi_x) P_j(\xi_y) P_k(\xi_z)$	$n = k + J * \left( i * I + j\right)$
Cylindrical	`R_MAX R_ORDER H_MIN H_MAX H_ORDER H_ORIENTATION`	`2`	..	..	..

Notes:

"-1" can be supplied as an ORDER PARAM to use the built-in default values
It is not recommended to configure a single FET detector to span multiple different material regions—use individual detectors for each region instead
Specifics of this implementation:
- The FETs are based on nonseparable expansions, i.e. fully-convolved cross terms are included
  - For example, the Legendre-based Cartesian FET uses $\psi(\xi)_n = P_i(\xi_x) P_j(\xi_y) P_k(\xi_z)$ with $n$ as a linear indexer of $\{i,j,k\}$
  - Due to the properties of orthogonality, these cross terms can be neglected in post-analyses if only separable terms are desired
- A generalization of the Euler formulas for any orthogonal functional series is used
  - The generated FET coefficients $a_n$ already have all contributions from the orthonormalization constant pre-included, i.e. $c_n$ from $\frac{1}{c_n} = \lVert \psi_n \rVert^2 = \int_\Gamma \psi_n^2 \omega_n$
  - Thus, an FET can be simply reconstructed/sampled from the standard functional series as: $F(\xi) = \sum a_n \psi_n(\xi) \omega_n(\xi)$
From version 2.2.0 and on, FET-based detectors follow the standard normalization set in the calculation. The volume standards for detectors are set as default value for FET-based detectors, meaning detectors are not divided by the physical volume (allowing the use of volume detector dv).
In version 2.2.0, the relative error evaluation associated with FET-based detectors has been revisited.

Detector pulse-height energy broadening (dphb):

PHB : user-defined (Gaussian) energy broadening for pulse-height detector function name

Notes:

User-defined Gaussian energy broadening functions for pulse height detector are defined using the phb card.

Detector spatial integration domain and binning based on a generic data mesh (dmesh):

MESH : name of the datamesh to use for defining the spatial integration domain and binning for the detector scores

Notes:

Output mesh index will be flattened (one dimensional).

div (divisor definition)

div MAT [ sep LVL ] 
        [ subx N_X X_MIN X_MAX ] equal volume [ subx -N_X X₁ X₂ ... X_N+1 ] manually spaced limits
        [ suby N_Y Y_MIN Y_MAX ] equal volume [ suby -N_Y Y₁ Y₂ ... Y_N+1 ] manually spaced limits 
        [ subz N_Z Z_MIN Z_MAX ] equal volume [ subz -N_Z Z₁ Z₂ ... Z_N+1 ] manually spaced limits
        [ subr N_R R_MIN R_MAX ] equal volume [ subr -N_R R₁ R₂ ... R_N+1 ] manually spaced limits
        [ subs N_S S₀ ]       equal volume [ subs -N_S S₁ S₂ ... S_N+1 ] manually spaced limits
        [ peb PBED N_UNI [ UNI₁ ... UNI_N ]  ] 
        [ lims FLAG ]

Divides a material into a number of sub-zones. Input values:

`MAT`	: name of the divided material
`LVL`	: geometry level at which the cell-wise division takes place (0 = no division, 1 = last level, 2 = 2nd last level, etc.)
`N_X`	: number of x-zones
`X_MIN`	: minimum x-coordinate [in cm]
`X_MAX`	: maximum x-coordinate [in cm]
`X_n`	: x-coordinate boundaries [in cm]
`N_Y`	: number of y-zones
`Y_MIN`	: minimum y-coordinate [in cm]
`Y_MAX`	: maximum y-coordinate [in cm]
`Y_n`	: y-coordinate boundaries [in cm]
`N_Z`	: number of z-zones
`Z_MIN`	: minimum z-coordinate [in cm]
`Z_MAX`	: maximum z-coordinate [in cm]
`Z_n`	: z-coordinate boundaries [in cm]
`N_R`	: number of radial zones
`R_MIN`	: minimum radial coordinate [in cm]
`R_MAX`	: maximum radial coordinate [in cm]
`R_n`	: radial coordinate boundaries [in cm]
`N_S`	: number of angular sectors
`S₀`	: zero position of angular division [in degrees]
`S_n`	: angular-sector boundaries [in degrees]
`PBED`	: stochastic particle / pebble-bed structure
`N_UNI`	: number of universes to link related to the `PBED` structure (special case: 0 = link to all)
`UNI_N`	: list of universes to link (if `N_UNI` > 0)
`FLAG`	: flag for mapping regions outside (material) limits to divide material: on (1/yes) or off (0/no). The default option is off.

Notes:

The automated divisor feature can be used to sub-divide burnable materials into depletion zones, but the use is not limited to burnup mode.
If a material is not divided, all occurrences of it are treated as a single depletion zone (except for depleted materials defined in pin structures: pin-wise division).
The use of automated instead of manual depletion zone division saves memory, which may become significant in very large burnup calculation problems (see detailed description on memory usage).
The volumes of the divided materials must be set manually (see set mvol option) or automatically, via the Monte Carlo checker-routine (see set mcvol option or -checkvolumes command line option). For a more detailed description, check Defining material volumes).
The level sub-division sep is explained on page automated depletion zone division.
The spatial sub-division is based on either Cartesian (subx, suby, subz) or cylindrical mesh (subr, subs, subz)
The angular sub-division subs with manually-spaced angular-sector boundaries S_n must cover the full/360 degrees angular space.
The pebble bed-based sub-division peb divides each item in a pebble bed universe as its own item. It features a speed-up on the depletion zone division indexing process with large number of pebble bed structures.
For more information see detailed description on automated depletion zone division.

dtrans (detector mesh transformation)

Defines detector mesh transformations. Shortcut for "trans d".

Notes:

The parameters associated with the transformation follow the standard transformation cards syntax without trans TYPE identifier.
See transformations.

ene (energy grid definition)

ene NAME 1 E₀ E₁ ...

ene NAME 2 N E_min E_max

ene NAME 3 N E_min E_max

ene NAME 4 GRID

Defines an energy grid structure. Input values:

`NAME`	: energy grid name
`E_i`	: bin boundaries [in MeV]
`N`	: number of equi-width bins
`E_min`	: minimum energy [in MeV]
`E_max`	: maximum energy [in MeV]
`GRID`	: name of the pre-defined grid

Notes:

The first input parameter gives the type (1 = arbitrarily defined, 2 = equal energy-width bins, 3 = equal lethargy-width bins, 4 = pre-defined energy group structure).
Energy grid structures are used for several purposes, most commonly with detectors.

ftrans (fill transformation)

Defines fill transformations. Shortcut for "trans f".

Notes:

The parameters associated with the transformation follow the standard transformation cards syntax without trans TYPE identifier.
See transformations.

fun (function definition)

fun NAME TYPE [ ... ]

Defines a function that can be used with detector responses. Input values:

`NAME`	: function name
`TYPE`	: function type (currently only supported type is 1 = point-wise tabular data)

The syntax for type 1 is:

fun NAME 1 INTT X₁ F₁ X₂ F₂ ...

where:

`INTT`	: is the interpolation type (1 = histogram, 2 = lin-lin, 3 = lin-log, 4 = log-lin, 5 = log-log)
`X_i, F_i`	: are the tabulated variable-value pairs

Notes:

The defined function is linked to detector response using MT -100 (syntax: dr -100 NAME).
The defined function currently is only supported as a flux-based function, aka, flux multiplier.

hisv (history variation matrix definition)

hisv [ BU₁ NBR₁ BR_1,1 BR_1,2 ... BR_1,NBR₁ ]
     [ BU₂ NBR₂ BR_2,1 BR_2,2 ... BR_2,NBR₂ ]
      ...

Defines the history variation matrix for the automated burnup sequence. Input values:

`BU_n`	: burnup steps at which the branches are invoked (positive value = burnup [in MWd/kg], negative value = time [in d])
`NBR_n`	: number branches in the n-th burnup step
`BR_n,i`	: name of the i-th branch in the n-th burnup step

Notes:

The automated burnup sequence defined by the hisv card follows the same principle as the coef input card.
The hisv card performs multiple depletions within a single depletion calculation following the historical variation sequence, performing a restart at each of the listed burnup points, where it applies the variations defined in the listed branches for the given burnup point.
The hisv card is used together with the branch card.

ifc (interface file)

ifc FILE [setinmat N_MAT MAT₁ MAT₂ ... MAT_{N_MAT} ]
         [setoutmat N_MAT MAT₁ MAT₂ ... MAT_{N_MAT} ]

Links a multi-physics interface file to be used with the current input. Input values:

FILE : path to the multi-physics interface file

The optional cards are explained below.

setinmat adds the possibility to link multiple input materials to the same interface, i.e. the same interface gives temperatures and densities (density factors) for multiple materials.

setoutmat adds the possibility to link multiple output materials to the same interface, i.e. the same interface gives temperatures and densities (density factors) for multiple materials.

`N_MAT`	: number of materials to link to the interface
`MAT_i`	: name of the ith material linked to the interface

Notes:

If multiple materials are linked to the interface using the setinmat/setoutmat option, the densities in the interface file must be given as density factors, i.e. relative to the material card density (values between 0 and 1).
If the interface is not updated, setinmat/setoutmat options are not eligible. In the case of regular mesh-based, additionally to not updating the interface: a) the input materials cannot be specified using setinmat if power is tallied in pin-type objects; b) the output materials cannot be specified using setoutmat if power is not tallied on the same mesh.
The option setinmat is referred as setmat up to version 2.1.31.
See also Coupled multi-physics calculations.

include (read another input file)

include FILE

Reads another input file. Input values:

FILE : name of the input file

Notes:

The include card can be used to simplify the structure of complicated inputs.
The input parser starts reading and processing the new file from the point where the input card is placed. Processing of the original file continues after the new file is completed.
The included file must contain complete input cards and options, it cannot be used to read the values of another card.

lat (regular lattice definition)

See also Section 3.6 of Serpent 1 User Manual.

lat UNI TYPE X₀ Y₀ N_X N_Y PITCH UNI₁ UNI₂ ...

Defines a finite two-dimensional lattice in xy-plane with square or X- or Y-type hexagonal elements. The lattice is infinite in z-direction. Input values:

`UNI`	: universe name of the lattice
`TYPE`	: lattice type
`X₀`	: x-coordinate of the lattice origin (origin is in the center of the lattice) [in cm].
`Y₀`	: y-coordinate of the lattice origin (origin is in the center of the lattice) [in cm].
`N_X`	: number of lattice elements in x-direction
`N_Y`	: number of lattice elements in y-direction
`PITCH`	: lattice pitch [in cm]
`UNI_n`	: list of universes filling the lattice positions

Possible lattice types are:

Type	Description
1	Square lattice
2	X-type hexagonal lattice
3	Y-type hexagonal lattice
14	X-type triangular lattice

Lattice type 1 indexing example for N_X = N_Y = 3.

Lattice type 2 indexing example for N_X = N_Y = 3.

Lattice type 3 indexing example for N_X = N_Y = 3.

Notes:

Number of universes in list of universes must be N_X × N_Y.
For square lattices the x coordinate increases from left to right and the y coordinate increases from top to bottom, so the first N_X values in the list of universes create the bottommost (minimum y) row from minimum x to maximum x and the last N_X values in the list of universes create the topmost (maximum y) values. Example of the indexing is provided in the attached figure.
The line breaks usually present in the list of universes are only used to help visualizing the universe order for the user. Serpent ignores them when processing the list of universes.
The input of X- and Y-type hexagonal lattices is similar to each other, only the directions of the x- and y-axis change. The axis directions can be checked by using the geometry plotter. Examples of the indexing are provided in the attached figures.

lat UNI TYPE X₀ Y₀ PITCH UNI₁

Defines an infinite two-dimensional lattice in xy-plane with infinitely repeating square or X- or Y-type hexagonal element. The lattice is infinite in z-direction.

`UNI`	: universe name of the lattice
`TYPE`	: lattice type
`X₀`	: x-coordinate of the lattice origin [in cm]
`Y₀`	: y-coordinate of the lattice origin [in cm]
`PITCH`	: lattice pitch [in cm]
`UNI₁`	: universe name of the universe filling all lattice positions

Possible lattice types are:

Type	Description
6	Square lattice
7	Y-type hexagonal lattice
8	X-type hexagonal lattice

Notes:

The order of X- and Y-type hexagonal lattice type numbers is reversed when compared with finite hexagonal lattices.

lat UNI TYPE X₀ Y₀ N_R N_S,1 RADIUS₁ THETA₁ UNI_1,1 UNI_2,1 ... N_S,2 RADIUS₂ THETA₂ UNI_1,2 UNI_2,2 ... ...

Defines a finite two-dimensional circular cluster array lattice in xy-plane. The lattice is infinite in z-direction.

`UNI`	: universe name of the lattice
`TYPE`	: lattice type
`X₀`	: x-coordinate of the lattice origin [in cm]
`Y₀`	: y-coordinate of the lattice origin [in cm]
`N_R`	: number of rings in the array
`N_S,R`	: number of sectors in R-th ring
`RADIUS_R`	: central radius of R-th ring [in cm]
`THETA_R`	: angle of rotation of R-th ring [in degrees]
`UNI_N,R`	: list of universes filling the sector positions in R-th ring

Possible lattice type is:

Type	Description
4	Circular cluster array

Notes:

The circular cluster array can be used to define fuel assemblies used for example in AGR, CANDU, MAGNOX and RBMK reactors. It can also be used to define fuel rod layout used for example in TRIGA reactors.

lat UNI TYPE X₀ Y₀ N_L Z₁ UNI₁ Z₂ UNI₂ ...

Defines a finite one-dimensional vertical stack in z-direction. The stack is infinite in xy-plane.

`UNI`	: universe name of the lattice
`TYPE`	: lattice type
`X₀`	: x-coordinate of the lattice origin [in cm]
`Y₀`	: y-coordinate of the lattice origin [in cm]
`N_L`	: number of lattice elements in z-direction (number of axial layers)
`Z_n`	: z-coordinate of the n-th lattice element (lower boundary of the axial layer) [in cm]
`UNI_n`	: universe name filling the n-th lattice position

Possible lattice type is:

Type	Description
9	Vertical stack

Notes:

The z-coordinates must be given in ascending order.
Space below the lowest z-coordinate is not defined.
The top layer fills the entire space above the highest z-coordinate.
The number of Z_n-UNI_n pairs must be N_L.

lat UNI TYPE X₀ Y₀ Z₀ N_X N_Y N_Z PITCH_X PITCH_Y PITCH_Z UNI₁ UNI₂ ...

Defines a finite three-dimensional lattice in xyz-space with cuboidal or X- or Y-type hexagonal prism elements.

`UNI`	: universe name of the lattice
`TYPE`	: lattice type
`X₀`	: x-coordinate of the lattice origin [in cm]
`Y₀`	: y-coordinate of the lattice origin [in cm]
`Z₀`	: z-coordinate of the lattice origin [in cm]
`N_X`	: number of lattice elements in x-direction
`N_Y`	: number of lattice elements in y-direction
`N_Z`	: number of lattice elements in z-direction
`PITCH_X`	: lattice pitch in x-direction [in cm]
`PITCH_Y`	: lattice pitch in y-direction [in cm]
`PITCH_Z`	: lattice pitch in z-direction [in cm]
`UNI_n`	: list of universes filling the lattice positions

Possible lattice types are:

Type	Description
11	Cuboidal lattice
12	X-type hexagonal prism lattice
13	Y-type hexagonal prism lattice

Notes:

Number of universes in list of universes must be N_X × N_Y × N_Z.
For hexagonal prism lattices the x- and y-direction pitches must be equal.
The universe indexing is the similar as with lattice types 1-3. The lowermost z-level is given first, and the uppermost z-level is given last.

ltrans (lattice transformation)

Defines lattice transformations. Shortcut for "trans l".

Notes:

The parameters associated with the transformation follow the standard transformation cards syntax without trans TYPE identifier.
See transformations.

mat (material definition)

See Chapter 4 of Serpent 1 User Manual.

mat NAME DENS [ tmp TEMP ]
              [ tms TEMP ]
              [ tft T_MIN T_MAX ]
              [ rgb R G B ]
              [ vol VOL ]
              [ mass MASS ]
              [ burn N_R ]
              [ fix ID TEMP ] 
              [ moder THNAME ZA ]
  NUC₁ FRAC₁ 
[ NUC₂ FRAC₂ ]
[    ...     ]

Mandatory information:

`NAME`	: name of the material
`DENS`	: density of the material (positive value = atomic density [in b^-1cm^-1], negative value = mass density [in g/cm³]), or "sum" to calculate the density from given nuclide fractions
`NUC_n`	: Identifier of n-th nuclide in composition, e.g. "92235.03c" or "U-235.03c".
`FRAC_n`	: fraction of n-th nuclide in composition, positive values are interpreted as atomic fractions/densities, negative values as mass fractions/densities.

Optional cards:

tmp: Material temperature for Doppler-preprocessor

TEMP : temperature of the material [in K]

tms: Material temperature for on-the-fly TMS temperature treatment

TEMP : temperature of the material [in K]

tft: Temperature limits for material for coupled multi-physics calculations

`T_MIN`	: lower limit for material temperature [in K]
`T_MAX`	: upper limit for material temperature [in K]

rgb: RGB color coding for material representation in geometry plots

`R`	: value for the red channel (between 0 and 255)
`G`	: value for the green channel (between 0 and 255)
`B`	: value for the blue channel (between 0 and 255)

vol: Material volume

VOL : volume of the material [in cm³] (3D geometry) or cross-sectional area [in cm²] (2D geometry)

mass: Material mass

MASS : mass of the material [in g]

burn: Flag material for depletion

N_R : set to "1" in order to deplete material. The depletion zone division should be done using the div-card.

fix: Library information for decay nuclides

`LIB`	: library ID (e.g. "09c") for nuclides without cross section data.
`TEMP`	: temperature for nuclides without cross section data [in K]

moder: Use thermal scattering data library for a nuclide. The moder entry can be used several times to define thermal scattering libraries for multiple nuclides, such as hydrogen and deuterium in heavy water.

`THNAME`	: name of the thermal scattering data library defined using the therm card.
`ZA`	: nuclide ZA of the thermal scatterer (e.g. 1001 for H-1).

Notes:

This description is incomplete for both the descriptions and optional settings.
See defining material volumes and set mvol regarding other ways to set the material volumes for example in burnup calculations.
The nuclide identifier for nuclides with associated cross-sections corresponds to ZZAAA.ID and, for nuclides without associated cross-sections, e.g., decay nuclides, to ZZAAAI. The identifiers include Z, the atomic number; A, the mass number of the nuclide; I, the isomeric state (0 = ground state, 1 = metastable state); and ID, the library identifier. For nuclides without associated cross-sections, include the fix option to indicate the library and temperature of the given nuclides.

mesh (mesh plot definition)

mesh ORI XPIX YPIX [ SYM MIN₁ MAX₁ MIN₂ MAX₂ MIN₃ MAX₃ ]

mesh 8 CMAP DET ORI XPIX YPIX [ SYM MIN₁ MAX₁ MIN₂ MAX₂ MIN₃ MAX₃ ]

mesh 10 ORI XPIX YPIX

Produces a png-format mesh plot of various results. Input values:

`ORI`	: orientation with respect to coordinate axes
`XPIX`	: horizontal image size [in pixels]
`YPIX`	: vertical image size [in pixels]
`SYM`	: symmetry option (not used in Serpent 2)
`MIN_n MAX_n`	: boundaries of the plotted region [in cm]
`CMAP`	: color map used for plotting detector scores (positive entry for linear, negative for log-scale)
`DET`	: detector name

Notes:

The first format produces a mesh plot where fission rate and thermal flux distribution are plotted using hot and cold color schemes, respectively. This type of mesh plot is convenient for illustrating the neutronics of thermal systems. The orientation parameter defines the coordinate axis perpendicular to the plot plane: 1 - x-axis (projection on yz-plane); 2 - y-axis (projection on xz-plane); 3 - z-axis (projection on xy-plane).
The second format can be used for plotting scores that contribute to a detector. The additional input parameters are the detector name and the color map used in the plot.
The third format generates a mesh-plot of the temperature distribution. This can be a good way to check the temperature distribution, provided by an external solver, during a coupled calculation.
The color maps are: 1 - hot; 2 - cold; 4 - jet; 5 - black and white; 6 - hsv; 7 - spring; 8 - summer; 9 - autumn; 10 - winter; 11 - green-purple; 12 - purple-orange; 13 - blue-red. Many of these correspond to what is used in Matlab. Logarithmic scale is used if the number is given with a minus sign.
Detector scores are collected in the mesh cells (see the detector card and the list of ENDF reaction MT's and special reaction types for more information). The distribution is scaled according to the minimum and maximum values.
Some special detector types, such as pulse-height detectors and analog photon heating detectors cannot be associated with mesh plots.
The mesh plot always produces results that are integrated over space. If no boundaries are provided, the integration is carried over the entire geometry.
Setting the orientation parameter of a detector mesh plot to 4 produces a plot in cylindrical coordinates. Instead of Cartesian boundaries the entered values are then the radius and axial coordinate.
The symmetry option was used in Serpent 1. The parameter must be provided for Serpent 2 as well, even though it is not used. The value can be set to zero.
Mesh plot produced by the nth mesh-card is written in file [input]_mesh[n].png.

mflow (material flow definition)

mflow NAME
   NUC₁ λ₁
 [ NUC₂ λ₂ ]
 [   ...   ]

Defines the material flow. Input values:

`NAME`	: name of the material flow
`NUC_n`	: identifier of `n`-th nuclide in composition
`λ_n`	: reprocessing constant of `n`-th nuclide in composition [in s^-1]

Notes:

The nuclide ID can be replaced with "all", in which case all nuclides are included with the same reprocessing fraction λ.
The nuclide ID should follow the ZAI or ISO format (e.g., 922350 or U-235).

mix (mixture definition)

mix NAME [ rgb R G B ]
         [ vol VOL ]
         [ mass MASS ]
MAT₁ F₁
MAT₂ F₂
...

Defines a mixture of two or several materials. Input values:

Mandatory information:

`MAT_n`	: material name
`F_n`	: material fraction (positive values for volume, negative values for mass fractions)

Optional cards:

rgb: RGB color coding for material representation in geometry plots

`R`	: value for the red channel (between 0 and 255)
`G`	: value for the green channel (between 0 and 255)
`B`	: value for the blue channel (between 0 and 255)

vol: Material volume

VOL : volume of the material [in cm³] (3D geometry) or cross-sectional area [in cm²] (2D geometry)

mass: Material mass

MASS : mass of the material [in g]

Notes:

Mixtures can be used to define complicated material definitions consisting of two or more physical materials mixed homogeneously.
Serpent decomposes these mixtures into standard materials before running the transport simulation.
The decomposed material compositions can be written into file using the -mix command line option.
Nuclide specific thermal scattering data is automatically brought from component materials to the mixture.
Many other input cards such as set trc, set iter nuc, sens pert matlist are not automatically inherited by the mixture from the components and should be directly defined using the mixture material name (opposed to component material names) if they are to be applied to the mixture.
Burnable mixtures are not supported.

nest (nested universe definition)

nest U TYPE
  [ MAT₁ R₁ ] 
  [ MAT₂ R₂ ] 
  ...
  [ MAT_N ]

nest U 
  [ MAT₁ TYPE₁ PARAM₁₁ PARAM₁₂ ... ] 
  [ MAT₂ TYPE₂ PARAM₂₁ PARAM₂₂ ... ] 
   ...
  [ MAT_N ]

Defines a universe consisting of nested regions. Input values:

`U`	: universe name
`TYPE`	: nested surface type (single surface for all regions)
`MAT₁ ... MAT_N`	: material regions
`R₁ ... R_N-1`	: outer radii [in cm]
`TYPE₁ ... TYPE_N-1`	: nested surface type (different surfaces for each region)
`PARAM_nm ...`	: surface parameters

Notes:

The nest card defines an entire universe consisting of nested material regions. The boundaries are defined by surfaces nested inside each other. The outermost region is infinite.
The material entries can be replaced by fill U₀, in which case the region is filled by another universe.
The first format allows defining nests in which all surfaces are of same type and centred at the origin. Only surfaces that are characterized by a single outer radius are accepted (cylinders, spheres and some regular prisms). The pin and particle definitions are short-hand notations of the nest card.
The second format allows mixing different surface types. In this case all surface parameters need to be provided after the surface type.

particle (particle geometry definition)

particle U
       [ MAT₁ R₁ ] 
       [ MAT₂ R₂ ] 
       ...
       [ MAT_N ]

Defines a particle universe. Input values:

`U`	: universe name
`MAT₁ ... MAT_N`	: material regions
`R₁ ... R_N-1`	: outer radii [in cm]

Notes:

The particle card defines an entire universe consisting of nested spherical shells. The boundaries are defined by sphere surfaces. The outermost region is radially infinite.
The material entries can be replaced by fill U₀, in which case the region is filled by another universe.
Most typically used for defining TRISO fuel particles.
The particle card is special case of a nested universe type.
See also description of explicit stochastic geometry type.

pbed (explicit stochastic (pebble bed) geometry definition)

pbed UNI₀ UNI_bg FILE [ OPT ]

Defines a stochastic particle / pebble-bed geometry. Input values:

`UNI₀`	: universe name for the dispersed medium
`UNI_bg`	: background universe, i.e. universe filling the space between particles / pebbles
`FILE`	: input file containing the particle/pebble data
`OPT`	: additional options (currently only supported option pow = power distribution)

The syntax of the file containing the particle/pebble data is:

X₁ Y₁ Z₁ R₁ UNI₁

X₂ Y₂ Z₂ R₂ UNI₂

...

Where:

`X_n, Y_n, Z_n`	: are the coordinates [in cm]
`R_n`	: is the radius [in cm]
`UNI_n`	: is the universe

Notes:

Creates a universe (UNI₀), which is filled with spherical sub-universes for which the coordinates are read from a separate file.
The coordinates can be defined manually, or using the -disperse command line option which launches the particle disperser routine.
Can be used for modelling stochastic particle / pebble-bed geometries in multiple levels.
If the pow (power distribution) option is set, the pebble/particle-wise distribution is written in file [FILE]_pow[bu].m, where "bu" is the burnup step, from version 2.2.1 and on (in previous versions, [FILE].out).
See also HTGR geometry examples.

phb (pulse-height Gaussian energy broadening definition)

phb NAME TYPE [ ... ]

Defines a user-defined (Gaussian) energy broadening function for pulse-height detector (dphb). Input values:

`NAME`	: pulse-height (Gaussian) energy broadening function name
`TYPE`	: pulse-height function type (1 = energy-resolution interpolation, 2 = energy-FWHM interpolation, 3 = energy-resolution fitting, 4 = energy-FWHM fitting)

The syntax for the different types is as follows:

phb NAME 1 INTT E_max,1 R₁ E_max,2 R₂ ...

where:

`INTT`	: is the interpolation type (currently only supported type is 2 = lin-lin interpolation data)
`E_max,i, R_i`	: are the maximum energy-resolution tabulated pairs [in MeV (energy)]

Notes:

Full width at half maximum is calculated as: $FWHM(E_{max,i}) = R(E_{max,i}) E_{max,i}$
Energies should be given in ascending order.

phb NAME 2 INTT E_max,1 FWHM₁ E_max,2 FWHM₂ ...

where:

`INTT`	: is the interpolation type (currently only supported type is 2 = lin-lin interpolation data)
`E_max,i, FWHM_i`	: are the maximum energy-full width at half maximum pairs [in MeV (energy)]

Notes:

Energies should be given in ascending order.

phb NAME 3 a b

where:

a, b : are the parameters to define the energy resolution fit: $R = aE^b$

phb NAME 4 a b c

where:

a, b, c : are the parameters to define the energy full width at half maximum fit: $FWHM = a + b\sqrt{(E + cE^2)}$

pin (pin geometry definition)

pin U
  [ MAT₁ R₁ ] 
  [ MAT₂ R₂ ] 
  ...
  [ MAT_N ]

Defines a pin universe. Input values:

`U`	: universe name
`MAT₁ ... MAT_N`	: material regions
`R₁ ... R_N-1`	: outer radii [in cm]

Notes:

The pin card defines an entire universe consisting of nested annular material regions. The boundaries are defined by axially infinite cylindrical surfaces. The outermost region is radially infinite.
The material entries can be replaced by fill U₀, in which case the region is filled by another universe.
Most typically used for defining fuel pins, but can also be applied to guide tubes, control rods, etc.
The pin card is special case of a nested universe type.

plot (geometry plot definition)

plot TYPE XPIX YPIX [ POS MIN₁ MAX₁ MIN₂ MAX₂ ]

plot TYPE F_min F_max E XPIX YPIX [ POS MIN₁ MAX₁ MIN₂ MAX₂ ]

Produces a png-format geometry plot. Input values:

`TYPE`	: defines the plot type (orientation and plotting of boundaries)
`XPIX`	: horizontal image size [in pixels]
`YPIX`	: vertical image size [in pixels]
`POS`	: position of plot plane [in cm]
`MIN₁`	: minimum horizontal coordinate of plotted region [in cm]
`MAX₁`	: maximum horizontal coordinate of plotted region [in cm]
`MIN₂`	: minimum vertical coordinate of plotted region [in cm]
`MAX₂`	: maximum vertical coordinate of plotted region [in cm]
`F_min`	: minimum importance for importance map plots
`F_max`	: maximum importance for importance map plots
`E`	: particle energy for importance map plots [in MeV]

Notes:

The TYPE parameter consists of one or two concatenated values ('AB'):
- The first value ('A') defines the plot plane (1 = yz, 2 = xz, 3 = xy).
- The second value ('B') defines which boundaries are plotted (0 = no boundaries, 1 = cell boundaries, 2 = material boundaries, 3 = both).
  - If the second value in is not provided, material boundaries are plotted.
The relative dimensions of image size (XPIX, YPIX) should match that of the plotted region. Otherwise the image gets distorted.
The position parameter POS defines the location of the plot plane on the axis perpendicular to it (e.g. z-coordinate for xy-type plot).
The minimum and maximum coordinates: MIN_n, MAX_n, define the boundaries of the plotted region (e.g. minimum and maximum x- and y-coordinates for xy-type plot).
- If the coordinates are not provided, the plot is extended to the maximum dimensions of the geometry.

The second format allows to plot he importance maps read using the wwin card:
- They can be plotted on top of the geometry by setting the second value ('B') of the type parameter for:
  - Cell importances: 4 (linear color scheme) or 5 (logarithmic color scheme)
  - Source importances: 6 (linear color scheme) or 7 (logarithmic color scheme)
- The input parameters include the minimum and maximum importance (F_min, F_max) and the particle energy, E.
  - If importance maps are provided for both neutrons and photons, they can be plotted by entering positive and negative energy values, respectively.
  - If both, minimum and maximum importance values are set to "-1", Serpent automatically adjusts them based on the weight-window mesh data, from version 2.2.0 and on.
    - If the calculation fails on providing those minimum and maximum values due to the weight-window evaluation, the values are set by default to (1E-200, 1E+200).
- Note to developers: particle type should be included as an input parameter in importance map plots.

Material colors:
- Each material plotted with different color.
- The colors are sampled randomly, unless defined using the rgb entry in the material card (see mat) or mixture card (see mix)
- Special RGB-colors:

RGB value	Color	Description
(0, 0, 0)	COLOR	Outside cell or void-material
(0, 255, 0)	COLOR	No cell found at coordinates
(255, 0, 0)	COLOR	Overlap of multiple cells found at coordinates
(255, 0, 255)	COLOR	Undefined material density factor at coordinates

Geometry plotter requires compiling the source code with GD Graphics libraries.
Command line options:
- -plot stops the execution after the geometry plots are produced
- -qp invokes a quick plot mode, which does not check for overlaps
- -noplot skips the geometry plots altogether
See also detailed description on geometry plotter.
The geometry plot produced by the n-th plot-card is written in file [input]_geom[n].png.

rep (reprocessor definition)

rep NAME
   [ rc SRC TGT MFLOW MODE ]
   [ rm MAT₁ MAT₂ ]
   [ ru UNI₁ UNI₂ ]

Defines the reprocessing controllers. Input values:

`NAME`	: name of the reprocessor.
`SRC`	: name of the source material, from which the flow is moved
`TGT`	: name of the target material, to which the flow is moved
`MFLOW`	: name of the material flow
`MODE`	: continuous reprocessing mode
`MAT₁`	: name of the replaced material
`MAT₂`	: name of the replacing material
`UNI₁`	: name of the replaced universe
`UNI₂`	: name of the replacing universe

Notes:

The reprocessor name identifies the reprocessing regime in the depletion calculation dep card. The syntax corresponds to dep pro NAME.
The nuclides identifier of those included in both source SRC and target TGT materials in reprocessors should follow the same format, either ZA.ID or ISO.ID (for nuclides with cross sections), or ZAI (for nuclides without associated cross sections, and adding the fix entry to the mat card).
The (continuous) reprocessing implementation works with materials, not universes. Therefore, define the universes associated with those burnable materials as surface-cell type universes.
Multiple reprocessing controllers/regimes can be defined within the same reprocessor definition.
The rc continuous reprocessing option can be used to define the material flow between the source and the target materials.
- The material flow is defined using the mflow card.
- The continuous reprocessing MODE defines how to incorporate the material flow into the Bateman equations:

`MODE`	Material source	Material target	Material flow
0	$N_{src}(t)=N_{src}(0)$	$N_{tgt}(t)=N_{tgt}(0)+t\lambda N_{src}(0)$	$\dot{N}(t)=\lambda N_{src}(0)$
1	$N_{src}(t)=N_{src}(0)e^{-\lambda t}$	$N_{tgt}(t) = N_{tgt}(0) + (1-e^{-\lambda t})N_{src}(0)$	$\dot{N}(t)=\lambda N_{src}(t)$
2	$N_{src}(n+1)=(1-\Delta t_{n}\lambda)N_{src}(n)$	$N_{tgt}(n+1)=N_{tgt}(n)+\Delta t_{n}\lambda N_{src}(n)$	$\dot{N}(n)=\lambda N_{src}(n)$

MODE 0 : no changes at the source material and adds λN₀ from the source material to the target material when solving the Bateman equations (N₀ are initial compositions).
MODE 1 : subtracts λN from the source material and adds it to the target material when solving the Bateman equations.
MODE 2 : subtracts λN_n from the source material and adds it to the target material when solving the Bateman equations (compositions updated with each burnup step, n).

The rm material reprocessing option replaces one material with another, MAT₁ by MAT₂.
The ru universe reprocessing option replaces one universe with another, UNI₁ by UNI₂.

sample (temperature / density data sample definition)

sample  N_X X_MIN X_MAX  N_Y Y_MIN Y_MAX  N_Z Z_MIN Z_MAX

Samples values from the initial material temperatures and densities to a file using a Cartesian grid.

Input values:

`N_X`	: number of values to sample in the x-direction.
`X_MIN`	: minimum coordinate to sample from in the x-direction [in cm]
`X_MAX`	: maximum coordinate to sample from in the x-direction [in cm]
`N_Y`	: number of values to sample in the y-direction.
`Y_MIN`	: minimum coordinate to sample from in the y-direction [in cm]
`Y_MAX`	: maximum coordinate to sample from in the y-direction [in cm]
`N_Z`	: number of values to sample in the z-direction.
`Z_MIN`	: minimum coordinate to sample from in the z-direction [in cm]
`Z_MAX`	: maximum coordinate to sample from in the z-direction [in cm]

Notes:

The data from each sample is written in a separate [input]_sampleN.m file.
Positive values for the density data correspond to atomic densities, while negative values correspond to mass densities.
Materials with no temperature specified either in their mat-card or through an interface definition will show a temperature of 0.

sens (sensitivity calculation definition)

sens pert

sens resp

sens opt

Definitions for the perturbations, responses and options for sensitivity calculations.

solid (irregular 3D geometry definition)

solid 1 UNI BGUNI
MESH_SPLIT MESH_DIM SZ₁ SZ₂ ... SZ_{MESH_DIM}
POINTS_FILE
FACES_FILE
OWNER_FILE
NEIGHBOUR_FILE
MATERIALS_FILE

Creates an unstructured mesh-based geometry universe. Input values are:

`UNI`	: universe name for the irregular geometry
`BGUNI`	: name of the background universe filling all undefined space
`MESH_SPLIT`	: splitting criterion for the adaptive search mesh (maximum number of geometry cells in search mesh cell)
`MESH_DIM`	: number of levels in the adaptive search mesh
`SZ_i`	: size of the search mesh at level `i`
`POINTS_FILE`	: path to the unstructured mesh points file
`FACES_FILE`	: path to the unstructured mesh faces file
`OWNER_FILE`	: path to the unstructured mesh owner file
`NEIGHBOUR_FILE`	: path to the unstructured mesh neighbour file
`MATERIALS_FILE`	: path to the unstructured mesh materials file

solid 2 UNI BGUNI
MESH_SPLIT MESH_DIM SZ₁ SZ₂ ... SZ_{MESH_DIM}
MODE R0
body BODY₁ CELL₁ MAT₁
file BODY₁ FILE₁ SCALE₁ X₁ Y₁ Z₁
file BODY₁ FILE₂ SCALE₂ X₂ Y₂ Z₂
...
body BODY₂ CELL₂ MAT₂
file BODY₂ FILE₃ SCALE₃ X₃ Y₃ Z₃
file BODY₂ FILE₄ SCALE₄ X₄ Y₄ Z₄
...

Creates an STL-based geometry universe. Input values are:

`UNI`	: universe name for the irregular geometry
`BGUNI`	: name of the background universe filling all undefined space
`MESH_SPLIT`	: splitting criterion for the adaptive search mesh (maximum number of geometry cells in search mesh cell)
`MESH_DIM`	: number of levels in the adaptive search mesh
`SZ_i`	: Size of the search mesh at level `i`
`MODE`	: mode for handling the triangulated geometry (1 = "fast", 2 = "safe").
`R0`	: radius inside which two points of the STL-geometry are joined into one.
`BODY_i`	: name of solid body `i`
`CELL_i`	: name of geometry cell `i` linked with body `i`
`MAT_i`	: material filling cell `i`
`FILE_i`	: path to a file containing an STL solid model, multiple files can be linked to one body
`SCALE_i`	: scaling factor for the STL model in `FILE_i`
`X_i`	: shift in x-direction to the STL model in `FILE_i`
`Y_i`	: shift in y-direction to the STL model in `FILE_i`
`Z_i`	: shift in z-direction to the STL model in `FILE_i`

Notes:

The material entries can be replaced by fill UNI_i, in which case the cell i is filled by the given universe.

solid 3 
INTERFACE_FILE

Creates an unstructured mesh-based geometry universe with unstructured mesh-based temperature and/or density distributions. Input values are:

INTERFACE_FILE : path to the interface file containing the rest of the parameters

Notes:

For simple example of a CAD-based geometry, see the Stanford critical bunny.
For more information on the unstructured mesh based geometry see Unstructured mesh based input.
For a simple example of an unstructured mesh based geometry see the Simple umsh 8 cubes input.

src (source definition)

src NAME [ PART ]
         [ sw WGT ] 
         [ sc CELL ]
         [ su UNI ]
         [ sm MAT ]
         [ sp X Y Z ] 
         [ sx X_MIN X_MAX ]
         [ sy Y_MIN Y_MAX ]
         [ sz Z_MIN Z_MAX ]
         [ srad R_MIN R_MAX ]
         [ ss SURF ]
         [ sd U V W ]   
         [ sa PHI ]
         [ se E ]
         [ sb N INTT E₁ WGT₁ E₂ WGT₂ ... ]
         [ sr NUC MT ]
         [ st T_MIN T_MIN ]
         [ sf FILE TYPE ]
         [ si N P₁ P₂ ... ]
         [ sg MAT MODE ]

Source definition. The first parameter:

PART : particle type (n = neutron, p = photon)

is optional in single particle simulations. The remaining parameters are defined by separate key words followed by the input values.

Source weight (sw):

WGT : relative source weight

Notes:

When multiple sources are defined, each definition is sampled with equal probability. This probability can be changed by assigning different weights for each source.
The weights are automatically normalized before the calculation is started.

Source cell (sc):

CELL : cell inside which the source points are sampled

Notes:

Setting a source cell is one of the options that can be applied to define the spatial distribution of source particles.
The selection is based on rejection sampling, and if the source cell occupies a small volume of the geometry, the sampling efficiency can be increased by defining a bounding box/(vertical) cylinder around the cell (using the sx, sy and sz or sp, srad and sz options, respectively).
If no spatial distribution is defined, particles are sampled uniformly over the geometry.

Source universe (su):

UNI : universe inside which the source points are sampled

Source material (sm):

MAT : material inside which the source points are sampled

Notes:

Setting a source material is one of the options that can be applied to define the spatial distribution of source particles.
The selection is based on rejection sampling, and if the source material occupies a small volume of the geometry, the sampling efficiency can be increased by defining a bounding box/(vertical) cylinder around the cell (using the sx, sy and sz or sp, srad and sz options, respectively).
If no spatial distribution is defined, particles are sampled uniformly over the geometry.

Source point (sp):

X, Y, Z, : coordinates of the source point [in cm]

Notes:

Setting a point source is one of the options that can be applied to define the spatial distribution of source particles.
If no spatial distribution is defined, particles are sampled uniformly over the geometry.

Source boundaries (sx, sy, sz and srad):

`X_MIN`, `X_MAX`	: boundaries on X-axis [in cm]
`Y_MIN`, `Y_MAX`	: boundaries on Y-axis [in cm]
`Z_MIN`, `Z_MAX`	: boundaries on Z-axis [in cm]
`R_MIN`, `R_MAX`	: radial boundaries [in cm]

Notes:

Source boundaries are used to define a bounding box/(vertical) cylinder inside which the source particles are sampled.
The radial boundaries are centered around the point defined by sp and can be used in combination with sz.
Can be used in combination with cell and material sources to increase the sampling efficiency.
If no bounding box is defined, particles are sampled uniformly over the geometry.

Source surface (ss):

SURF : surface on which the source particles are sampled

Notes:

The surface source is currently limited to infinite vertical cylinder (cyl) and sphere (sph) surface types.
The default behavior is that particles are started in the direction of the outward surface normal.
Positive and negative surface entries refer to neutrons being emitted in the direction of the positive and negative surface normal, respectively (meaning: positive = outward, negative = inward - same convention as for the surface detectors).

Source direction (sd):

U, V, W, : direction vector of source particles

Notes:

The source direction option can be set to define a unidirectional source.
If no directional dependence is defined, the direction of source particles is sampled isotropically.

Source angular-aperture (sa):

PHI : polar angle [in degrees]

Notes

The source angular-aperture option can be set to define the semi-aperture with respect a direction.
The option requires the definition of a unidirectional source (sd).

Source energy (se):

`E`	: energy of source particles [in MeV]

Notes:

The source energy option can be used to define a monoenergetic source.
The default energy of neutrons and photons is 1 MeV.
This option can also be used together with the source reaction option (sr).

Source energy bins (sb):

`N`	: number of bins
`INTT`	: interpolation (0 = line spectrum, 1 = histogram, 2 = lin-lin, 4 = log-lin)
`E_n`	: upper boundary of the energy bin [in MeV]
`WGT_n`	: weight of the energy bin

Notes:

This option allows defining an arbitrary source spectrum in the form of tabular data.
The bins are entered in the order of ascending energy, and weight of the first bin must be set to zero.
Interpolation is given in a separate parameter from version 2.1.31 on.
Here, a simple test input that demonstrates the source spectrum definition.

Source reaction (sr):

`NUC`	: nuclide name
`MT`	: reaction number identifier

Notes:

The source reaction determines a distribution function for source energy (for example, ²³⁵U fission spectrum can be defined as: sr 92235.09c 18).
The reaction numbers are ENDF reaction MT's, and the data is obtained from standard cross section libraries.
Applies to neutrons only.
When the source energy parameter (se) is defined, the value is used as the energy of the incoming neutrons.

Source time (st):

T_MIN, T_MAX : time boundaries [in s]

Notes:

This parameter defines a time interval for the sampled source particles. The starting time is sampled uniformly between the given minimum and maximum.
All source particles are started at time zero by default.

Source file (sf):

`FILE`	: file path to source file
`TYPE`	: file type (-1 = binary, 1 = ASCII)

Notes:

Source files allow defining arbitrary distributions by reading the particle coordinates, direction, energy, weight and time from a file: [ x y z u v w E wgt t ] .
Source files can be produced using the df entry of detector cards, or the set csw or set gsw options.

User-defined source routine (si):

`N`	: number of parameters
`P_n`	: parameters passed as arguments into the subroutine

Notes:

This option allows defining an arbitrary source distributions with a user-defined subroutine.
The source parameters are passed as arguments into the subroutine, together, with sampled position, direction energy, weight and time.
For complete description see source file "usersrc.c".
The subroutine may be overwritten with the blank template file when installing updates.

Radioactive decay source (sg):

`MAT`	: material name or "-1" to refer to all radioactive materials
`MODE`	: sampling mode (1 = analog, 2 = implicit)

Notes:

Radioactive decay source combines material compositions to decay data read from ENDF format libraries and forms the normalized source distribution automatically.
Material compositions can be defined manually, or read from binary restart files produced by a burnup or activation calculation (see the set rfw and set rfr options).
The analog sampling mode preserves the average number of particles produced in radioactive decay, but may lead to poor sampling efficiency in geometries with both low and high-active materials.
The implicit sampling mode preserves the total statistical weight of emitted particles and produces a uniform source distribution over activated materials.
In version 2.1.28 the source is limited to photon line spectra.
The calculation produces an additional output file [input]_gsrc.m or [input]_nsrc.m that contains the gamma/neutron source spectra, respectively.
See practical example for more information.

srtrans (source transformation)

Defines source transformations. Shortcut for "trans sr".

Notes:

The parameters associated with the transformation follow the standard transformation cards syntax without trans TYPE identifier.
See transformations.

strans (surface transformation)

Defines surface transformations. Shortcut for "trans s".

Notes:

The parameters associated with the transformation follow the standard transformation cards syntax without trans TYPE identifier.
See transformations.

surf (surface definition)

surf NAME TYPE [ PARAM₁ PARAM₂ ... ]

Defines a surface. Input values:

`NAME`	: is the surface name
`TYPE`	: is the surface type
`PARAM_n`	: are the surface parameters

Notes:

The name is used to identify the surface, for example, in the cell card.
See separate description on surface types.
Surfaces can be moved and rotated using transformations.

therm and thermstoch (thermal scattering)

therm NAME LIB

therm NAME TEMP LIB₁ LIB₂

therm NAME 0 LIB₁ LIB₂ LIB₃ ...

thermstoch NAME TEMP LIB₁ LIB₂

Defines thermal scattering data that can be linked to nuclides using input entry moder in the material cards. When using thermal scattering data together with TMS on-the-fly temperature treatment, the third input value of the therm card is 0. In this case, Serpent interpolates the thermal scattering data automatically to the local temperature, as defined either using the tms input entry in the material definition (mat card) or via the multi-physics interface (ifc card).

Input values:

`NAME`	: name of the thermal scattering data
`LIB_i`	: thermal scattering data identifiers as defined in the directory file (acelib)
`TEMP`	: temperature to which the thermal scattering data is interpolated [in K]

Notes:

When using on-the-fly interpolation of thermal scattering data, LIB_i must cover the whole temperature range in which the materials appear in the geometry. I.e. extrapolation of the data is not supported.
Thermal scattering data is interpolated using the methodology of makxsf code
The interpolation can be performed using the stochastic mixing approach with thermstoch. This interpolation mode is not available for on-the-fly interpolation.
The continuous S(α, β) formalism is available from version 2.1.32 on.
Version 2.2.0 includes the on-the-fly temperature treatment for the continuous S(α,β) formalism.

tme (time binning definition)

tme NAME 1 LIM₁ LIM₂ ...

tme NAME 2 NB T_min T_max

tme NAME 3 NB T_min T_max

Defines a time binning structure. The second entry sets the binning type (1 = arbitrary, 2 = uniform, 3 = log-uniform). Remaining values:

`NAME`	: name of the time binning
`NB`	: number of bins
`LIM_n`	: time bin boundaries in arbitrary binning [in s]
`T_min`	: minimum time boundary in uniform or log-uniform binning [in s]
`T_max`	: maximum time boundary in uniform or log-uniform binning [in s]

Notes:

The first limit in the arbitrary type (type = 1), is the lower bound of the first bin. The second limit is the upper bound of the first bin and so on.
Time binning is used with detectors and dynamic simulation mode.

trans (transformations)

trans TYPE UNIT [ IDX ] LVL

trans TYPE UNIT [ IDX ] X Y Z

trans TYPE UNIT [ IDX ] X Y Z θ_x θ_y θ_z ORD

trans TYPE UNIT [ IDX ] X Y Z α₁ α₂ α₃ α₄ α₅ α₆ α₇ α₈ α₉ ORD

trans TYPE UNIT [ IDX ] rot X₀ Y₀ Z₀ I J K β

Defines surface, universe, fill, lattice, detector mesh or source transformation. Input values:

`TYPE`	: type of transformation (S = surface, F = fill, U = universe, L = lattice, D = detector mesh, SR = source)
`UNIT`	: surface, cell, universe, lattice, detector mesh or source name to which the transformation is applied
`IDX`	: index number in lattice transformation (type L)
`LVL`	: level number in universe level transformation
`X,Y,Z`	: translation vector [in cm]
`θ_x θ_y θ_z`	: rotation angles with respect to x-, y- and z-axes [in degrees]
`α₁ ... α₉`	: coefficients of the rotation matrix
`ORD`	: order in which translations and rotations are applied (1 = rotations first, 2 = translations first)
`X₀,Y₀,Z₀`	: origin of vector defining rotation axis [in cm]
`I,J,K`	: components of vector defining rotation axis.
`β`	: angle around rotation axis defined by a vector [in degrees]. NB: In Serpent 2.1.29 positive values correspond to rotation to the negative mathematical direction and vice versa.

Notes:

Fill transformation is applied in the universe filling the given cell.
Level transformation is a special type of universe transformation, in which the coordinates in the given universe are obtained relative to geometry level LVL.
Lattice transformation requires to provide the index for the transformation IDX.
Source transformation is inverted compared to how surface, universe, etc. are handled.
By default translations are applied before rotations, and the order can be switched using the ORD parameter.
Rotations can be defined either by providing the three angles with respect to the three coordinate axes, or by defining the rotation matrix. In the second case Serpent applies vector multiplication $\vec{r'} = \bold{A} \vec{r}$ where $\vec{r}$ and $\vec{r'}$ are the position vectors before and after the operation and coefficients α₁ ... α₉ define the 3 by 3 matrix $\bold{A}$ .
To preserve backwards compatibility, input parameters "strans", "utrans", "ftrans", "ltrans", "dtrans" and "srtrans" without the following type identifier are also accepted for defining surface, universe, fill, lattice, detector mesh and source transformations, respectively.
To preserve compatibility with Serpent 1, parameter "trans" without type identifier defines a universe transformation.

transb (burnup transformation)

transb STEP [ <trans> ]

Defines burnup-dependent surface, universe or fill transformation. Input values:

`STEP`	: depletion step (positive value = burnup [in MWd/kg], negative value = time [in d])
`<trans>`	: list of parameters associated with the transformation

Notes:

The parameters associated with the transformation follow the standard transformation cards syntax without trans identifier.
See transformations.
Geometry plots associated with burnup transformations are featured from version 2.2.1 and on.

transv and transa (velocity and acceleration transformations)

transv TYPE UNIT [ IDX ] [ tlim T₀ T₁ T_TYPE ] V_X V_Y V_Z

transa TYPE UNIT [ IDX ] [ tlim T₀ T₁ T_TYPE ] A_X A_Y A_Z

Defines surface, universe, fill, lattice, detector mesh or source transformation. Input values:

`TYPE`	: type of transformation (S = surface, F = fill, U = universe, L = lattice, D = detector mesh, SR = source)
`UNIT`	: surface, cell, universe, lattice, detector mesh or source name to which the transformation is applied
`IDX`	: index number in lattice transformation (type L)
`T₀`	: beginning time of the transformation [in s]
`T₁`	: end time of the transformation [in s]
`T_TYPE`	: transformation type after end time (1 = movement stops, 2 = transformation removed, 3 = initial acceleration and velocity removed, but velocity accumulated due to acceleration remains)
`V_X,V_Y,V_Z`	: initial velocity vector [in cm/s]
`A_X,A_Y,A_Z`	: initial acceleration vector [in cm/s²]

Notes:

Fill transformation is applied in the universe filling the given cell.
The transformation is updated at the simulation time-interval boundaries.
See UGM 2016 Moving geometry.
See Rotating Translating STL Bunny.

umsh (unstructured mesh-based geometry definition)

UNI BGUNI
MESH_SPLIT MESH_DIM SZ₁ SZ₂ ... SZ_{MESH_DIM}
POINTS_FILE
FACES_FILE
OWNER_FILE
NEIGHBOUR_FILE
MATERIALS_FILE

Defines an unstructured mesh-based geometry. Input values:

`UNI`	: universe name for the unstructured mesh-based geometry
`BGUNI`	: name of the background universe filling all undefined space
`MESH_SPLIT`	: splitting criterion for the adaptive search mesh (maximum number of geometry cells in search mesh cell)
`MESH_DIM`	: number of levels in the adaptive search mesh
`SZ_i`	: size of the search mesh at level `i`
`POINTS_FILE`	: path to the unstructured mesh points file
`FACES_FILE`	: path to the unstructured mesh faces file
`OWNER_FILE`	: path to the unstructured mesh owner file
`NEIGHBOUR_FILE`	: path to the unstructured mesh neighbour file
`MATERIALS_FILE`	: path to the unstructured mesh materials file

Notes:

See also description of solid (irregular 3D geometry definition), type 1.

utrans (universe transformation)

Defines universe transformations. Shortcut for "trans u".

Notes:

The parameters associated with the transformation follow the standard transformation cards syntax without trans TYPE identifier.
See transformations.

voro (stochastic Voronoi tessellation geometry definition)

voro UNI₀ UNI_bg R₀ -1 NP UNI₁ VF₁ [ UNI₂ VF₂ ... ]

voro  UNI₀ UNI_bg R₀ FILE

Defines a stochastic Voronoi tessellation geometry. Input values:

`UNI₀`	: universe name for the Voronoi medium
`UNI_bg`	: background universe name filling all undefined space
`R₀`	: test radius [in cm]
`NP`	: number of seed points
`UNI_m`	: sub-universe name for the m-th random fragmented polyhedral zone
`VF_m`	: volume fraction associated to m-th random fragmented polyhedral zone
`FILE`	: input file containing the Voronoi data

The syntax of the file containing the Voronoi seed points data is:

X_n Y_n Z_n UNI_m

where:

`X_n, Y_n, Z_n`	: seed points coordinates [in cm]
`UNI_m`	: sub-universe name for the m-th random zone associated to the given seed point

wwgen (response matrix based importance map solver)

wwgen NAME LIM NI MOD ERG MSH 
     MIN₁ MAX₁ SZ₁
     MIN₂ MAX₂ SZ₂
     MIN₃ MAX₃ SZ₃
     DET₁ W₁ [ DET₂ W₂ ... ]

wwgen NAME LIM NI MOD ERG MSH 
     SZ₁ SZ₂ SZ₃  
     LIM₁₁ LIM₁₂ ...
     LIM₂₁ LIM₂₂ ...
     LIM₃₁ LIM₃₂ ...
     DET₁ W₁ [ DET₂ W₂ ... ]

wwgen NAME LIM NI MOD ERG MSH 
     X₀ Y₀   
     P NX NY
     MIN₃ MAX₃ SZ₃
     DET₁ W₁ [ DET₂ W₂ ... ]

Defines the parameters for importance map calculation. Input values:

`NAME`	: a unique name to identify the calculation
`LIM`	: convergence criterion (typical value 1E-12)
`NI`	: maximum number of iterations
`MOD`	: solution mode (1 = single detector, 2 = multiple detectors, 3 = global variance reduction)
`ERG`	: energy group structure (or -1 if no energy dependence is included)
`MSH`	: mesh type (1 = Cartesian, 2 = Cylindrical, 4 = x-type hexagonal, 5 = y-type hexagonal, 6 = unevenly-spaced xyz, 8 = unevenly spaced cylindrical)
`MIN_n`	: minimum mesh boundary (n-th coordinate)
`MAX_n`	: maximum mesh boundary (n-th coordinate)
`SZ_n`	: number of mesh cells (n-th coordinate)
`LIM_nm`	: mesh boundary m-th (n-th coordinate)
`X₀, Y₀`	: mesh center of hexagonal mesh (currently must be centered at the origin)
`P`	: hexagonal cell pitch
`NX, NY`	: hexagonal mesh size
`DET_i`	: detectors used as target response functions
`W_i`	: weight factors for detector scores

Notes:

The solution mode provides various options on how the responses are used for calculating the importances.
The detector entries can be left out in global variance reduction mode (MOD = 3), in which case the mesh is optimized to uniformly populate the entire geometry.
Cartesian and cylindrical mesh are defined by outer mesh boundaries and number of mesh cells.
Unevenly-spaced meshes are defined by providing the mesh cell boundaries separately.
The coordinate axes 1, 2 and 3 in Cartesian mesh refer to (x,y,z) and in cylindrical mesh to (r,θ,z), with θ given in degrees.
The hexagonal mesh is defined by mesh center, cell pitch, number of cells in the radial dimensions (similar to the hexagonal lattice) and axial binning.
The mesh must be defined slightly larger than the geometry (the mesh boundaries should not coincide with the geometry boundaries).
Source points located on mesh cell boundaries cause fatal errors.
May not work if source distribution is biased with weight.
The importance mesh is printed in file [input].wwd.
Importance (weight window) meshes are read using the wwin card.
See also practical examples on Variance reduction.
This capability is still very much under development. The input syntax may be revised at some point.

wwin (weight window mesh definition)

wwin NAME 
   [ wf FILE FMT ]
   [ wn F X Y Z E ] 
   [ wx C G ] 
   [ wt SB TYPE MIN MAX ]
   [ wi ITP NI WWG₁ DF₁ WWG₂ DF₂ ... ]
   [ wi ITP NI WWG NX NY NZ NLOOP NTRK ISPL NSPL DSPL₁ SX₁ SY₁ SZ₁ DSPL₂ SX₂ SY₂ SZ₂ ...]

Defines a weight window mesh for variance reduction. The first parameter:

NAME : a unique name to identify the mesh

The remaining parameters are defined by separate key words followed by the input values.

Notes:

Only works in external source simulation mode.
Importance (weight window) meshes can be generated by running the response matrix based solver, or read in MCNP WWINP format^[2].
Importance maps can be visualized using the geometry plotter.
See also set wwb and set maxsplit for setting options for weight windows, splitting and Russian roulette.
See also practical examples on Variance reduction.
This capability is still very much under development. The input syntax may be revised at some point.

Weight-window mesh paramters:

Mesh file (wf):

`FILE`	: file path and name of the importance mesh file
`FMT`	: file format (1 = mesh produced by Serpent importance map generator, 2 = MCNP WWINP format weight window mesh file)

Notes:

By default the importance map is read from the mesh file and used as-is, the additional options are provided for adjustments.
Currently the MCNP format only supports simple mesh types (no sub-mesh).

Mesh normalization (wn):

`F`	: importance for renormalization
`X,Y,Z`	: coordinates of point used for renormalization
`E`	: energy used for renormalization [in MeV]

Notes:

The importances can be renormalized by fixing the value at a given position and energy.

Mesh adjustment (wx):

`C`	: constant multiplier for adjusting importances
`G`	: exponential for adjusting importances

Notes:

The importances can be adjusted by constant multiplier C and exponential factor G such that $F' = CF^G$ .

Types and options (wt):

`SB`	: option to set source biasing on (1/yes) or off (0/no) with Serpent-generated importance maps
`TYPE`	: bounds type for Serpent-generated weight-windows (1 = averaged, 2 = segment-wise)
`MIN`	: minimum truncation limit for importances
`MAX`	: maximum truncation limit for importances

Notes:

Source biasing is currently not available

Weight-window iterations, fixed mesh (wi):

`ITP`	: iteration type (1 = fixed mesh)
`NI`	: number of iterations between Monte Carlo simulation and the response matrix solver
`WWG_i`	: name of the WWG-structure used in the iteration
`DF_i`	: global density factor

Notes:

The fixed mesh option (ITP = 1) allows performing iterations using a single or multiple meshes generated using the response matrix based solver.
The global density factor is a multiplier applied to all material densities.

Weight-window iterations, adaptive mesh (wi):

`ITP`	: iteration type (2 = geometry-based adaptation, 3 = tracking-based adaptation)
`NI`	: number of iterations between Monte Carlo simulation and the response matrix solver
`WWG`	: name of the WWG-structure used in the iteration
`NX`	: number of x-divisions for the adaptive mesh
`NY`	: number of y-divisions for the adaptive mesh
`NZ`	: number of z-divisions for the adaptive mesh
`NLOOP`	: number of outer iteration loops in generation of adaptive mesh
`NTRK`	: number of tracks per loop in generation of adaptive mesh
`ISPL`	: importance split criterion
`NSPL`	: neighbor split criterion
`DSPL_i`	: density split criterion (positive value = atomic density [in b^-1cm^-1], negative values = mass density [in g/cm³])
`SZ_i`	: minimum cell dimension [in cm]

Notes:

The adaptive mesh option (ITP = 2 or 3) starts with a coarse base mesh, and refines the resolution iteratively.
There are two adaptive mesh options. In the geometry-based option (ITP = 2) Serpent covers the geometry with NTRK random tracks and splits cells according to density criteria. In the tracking-based option (ITP = 3) the tracks are started from the source instead. The procedure is repeated NLOOP times.
Cell splitting is defined using the NX, NY and NZ options. For example NX = 2, NY = 2, NZ = 2 results in each cell being split to 8 sub-cells (octree mesh). For 2D meshes the NZ parameter must be set to "1".
Splitting is carried out recursively, until limiting criteria are met. The DSPL parameters define upper density boundaries and minimum cell sizes for stopping the splits.
The importance split criterion defines the maximum relative difference between the importances of two adjacent cells. If the criterion is not met, both cells are split.
The neighbor split criterion defines the maximum number of neighbor allowed for a cell. If the criterion is not met, the cell is split.

Input options

Input options are used to set various calculation parameters that are not included in the main input cards. Each option is identified by key word "set". Optional values are enclosed within square brackets.

set absrate

set absrate A [ MAT ]

Sets normalization to total absorption rate. Input values:

`F`	: number of neutrons absorbed per second [in neutrons/s]
`MAT`	: dummy parameter

Notes:

Normalization is needed to relate the Monte Carlo reaction rate estimates to a user-given parameter.
Absorption includes all reactions in which the incident neutron is lost, i.e. all capture reactions and fission.
The default normalization is set: to unit total loss rate (neutron transport) and to unit total source rate (photon transport).
In coupled neutron-photon transport simulations the normalization is driven by the neutron normalization.
For other normalization options, see: set power, set powdens, set flux, set genrate, set fissrate, set lossrate, set srcrate, set sfrate.
See also Section 5.8 of Serpent 1 User Manual.

set acelib

set acelib LIB₁ [ LIB₂ LIB₃ ... ]

Sets the cross section directory file paths. Input values:

LIB_n : file paths to directory files

Notes:

If the file path contains special characters it is advised to enclose it within quotes.
A default directory path can be set by defining environment variable SERPENT_DATA. The code looks for cross section directory files in this path if not found at the absolute.
A default cross section directory file can be set by defining environment variable SERPENT_ACELIB. This file will be used if no other path is given with set acelib.

set adf

set adf UNI SURF SYM [ENF]

Sets parameters for the calculation of assembly discontinuity factors (ADFs) and related net and partial currents. Input values:

`UNI`	: universe where spatial homogenization is performed
`SURF`	: surface enclosing the universe
`SYM`	: symmetry option (see separate list)
`ENF`	: option to switch on (1/yes) or off (0/no) skipping the diffusion flux solver and enforce flat homogeneous flux distribution based on mean heterogeneous flux. The default option is "`off`"

Notes:

The surface enclosing the universe can be super-imposed (i.e. not part of the geometry definition), but it must enclose the entire universe.
The surface is super-imposed on the geometry, i.e. its parameters (coordinates) are relative to the root universe.
When the universe is surrounded by zero net-current (reflective) boundary conditions, the ADFs are calculated as the ratios of surface- and volume-averaged heterogeneous flux.
When the net current is non-zero, the calculation is based on the ratio of surface-averaged homogeneous and heterogeneous flux. The homogeneous flux is obtained from a built-in diffusion flux solver.
Calculation parameters for the diffusion flux solver can be set using the set dfsol option.
Calculation of ADFs is currently allowed only for planes and infinite square and hexagonal prisms.
Symmetry options are used to average out the statistical variation in the ADFs, which might otherwise lead to systematic errors in core calculations. It is important that the options are used only when the geometry has the corresponding symmetry.
See separate description of output parameters in the [input]_res.m.
The ADFs can be printed to the group constant output with set coefpara.
ADFs are calculated in the few-group structure used for group constant generation.
The ENF parameter should be switched on only in rare cases (and you should know what you are doing).
Sign moments of net and partial currents are not scored for Y-type infinite/truncated hexagonal prisms.

set alb

set alb UNI SURF DIR

Sets parameters for calculating albedos. Input values:

`UNI`	: universe where spatial homogenization is performed
`SURF`	: surface for which the albedos are calculated
`DIR`	: current direction (-1 = inward, 1 = outward)

Notes:

When this option is set, Serpent calculates both total albedos (ratio of currents) and partial albedos (response matrix).
The surface enclosing the universe can be super-imposed (i.e. not part of the geometry definition), but it must enclose the entire universe.
The surface is super-imposed on the geometry, i.e. its parameters (coordinates) are relative to the root universe
The current direction is given relative to the surface normal vectors
The universe is needed only for labelling the results in the output files.
See separate description of output parameters.
Albedos are calculated in the few-group structure used for group constant generation.

set arr

set arr MODEN [ MODEG ]

Sets analog reaction rate calculation on or off. Input values:

`MODEN`	: mode for neutrons (0 = no reactions included, 1 = include only reactions that affect neutron balance, 2 = include all reactions)
`MODEG`	: mode for photons (0 = no reactions included, 1 = include all reactions)

Notes:

Analog reaction rates are calculated by counting sampled events and printed in a separate output file [input]_arr[bu].m, where "bu" is the burnup step.
See detailed description on the reaction rate output file.

set ba

set ba ZAI₁ ZAI₂ ...

Defines isotopes handled separately as burnable absorbers. Input values:

ZAI_n : nuclide identifiers (ZAI)

Notes:

Some burnup applications require separate treatment for isotopes that are used as burnable absorbers but also produced in fission. This input parameter can be used to separate the transmutation chains.
Isotope handled as the burnable absorber is created by duplicating the original and renaming it as ZAI_n + 1000.
For Gd-155, for example, the fission product isotope would be assigned ZAI 641550 and the burnable absorber ZAI 642550.
The input parameter defines the entire transmutation chain. Listing Gd-isotopes 641540 641550 641560 641570 641580 creates a transmutation path from Gd-154 to Gd-158. Listing only the main absorbers (641550 641570) produces a different result, since the capture products of Gd-155 and Gd-157 are lost.

set bala

set bala OPT

Sets OpenMP load balancing on or off. Input values:

OPT : probability to store particles in common queue (0 = off, >0 = on)

Notes:

Load balancing may improve OpenMP parallel scalability in calculations with significant branching (most typically related to coupled neutron/photon calculations or variance reduction).
The option is ON with OPT= 1 with weight-window/variance reduction calculations and dynamic/time-dependent calculation modes. Otherwise, it is set OFF by default. Before version 2.2.0, the default behavior was always OFF.
When this option is set, the random number sequence is no longer preserved.

set bc

set bc MODE

Sets the boundary conditions for all outer boundaries of the geometry. Input values:

MODE : boundary type (1 = vacuum, 2 = reflective, 3 = periodic)

set bc MODE ALB

Sets the boundary conditions with albedo for all outer boundaries of the geometry. Input values:

`MODE`	: boundary type (1 = vacuum, 2 = reflective, 3 = periodic)
`ALB`	: albedo

set bc MODEX MODEY MODEZ

Sets the boundary conditions separately for x-, y- and z-directions. Input values:

`MODEX`	: boundary type in x-direction (1 = vacuum, 2 = reflective, 3 = periodic)
`MODEY`	: boundary type in y-direction (1 = vacuum, 2 = reflective, 3 = periodic)
`MODEZ`	: boundary type in z-direction (1 = vacuum, 2 = reflective, 3 = periodic)

set bc MODEX MODEY MODEZ ALB

Sets the boundary conditions with albedo separately for x-, y- and z-directions. Input values:

`MODEX`	: boundary type in x-direction (1 = vacuum, 2 = reflective, 3 = periodic)
`MODEY`	: boundary type in y-direction (1 = vacuum, 2 = reflective, 3 = periodic)
`MODEZ`	: boundary type in z-direction (1 = vacuum, 2 = reflective, 3 = periodic)
`ALB`	: albedo

Notes:

The boundary conditions can be set either for all directions at once (single parameter) or x-, y- and z-directions separately (three parameters). Albedos are provided by adding one more parameter in the list.
The boundary condition type numbers can also be given as strings, with "black" = 1, "reflective" = 2 and "periodic" = 3.
The default boundary condition is "vacuum" (= 1) in all directions.
Albedo boundary conditions are invoked by multiplying the particle weight with factor ALB each time a reflective or periodic boundary is hit.
Repeated boundary conditions (reflective or periodic) are based on universe transformations, which limits outer boundary to surfaces that form regular lattices (square and hexagonal prisms, rectangles, cubes and cuboids).
Repeated boundary conditions are applied on the first surface of outside cells (see definition of outside cells in the cell card)
For symmetry purposes Serpent provides the universe symmetry option.
For more information, see detailed description on boundary conditions.

set blockdt

set blockdt MAT₁ MAT₂ ...

Defines the list of materials where delta-tracking is never used. Input values:

MAT_n : material names

Notes:

This option is used to override selection of tracking mode based on the probability threshold (see set dt) in individual materials.
Use of delta-tracking can be forced in individual materials using set forcedt.
For more information on tracking modes, see the detailed description on delta- and surface-tracking.
Note to developers: should have different lists for neutrons and photons?

set bralib

set bralib LIB₁ [ LIB₂ LIB₃ ... ]

Sets isomeric branching data library file paths. Input values:

LIB_n : library file paths

Notes:

Isomeric branching data libraries are standard ENDF format files^[3] containing energy-dependent branching ratios. The data is read from ENDF files 9 and 10.
Serpent uses constant branching ratios by default. The default values can be overridden using the set isobra option. Energy-dependent data read from ENDF format files overrides the constant ratios.
If the file path contains special characters it is advised to enclose it within quotes.
A default directory path can be set by defining environment variable SERPENT_DATA. The code looks for decay data files in this path if not found at the absolute.
See also: example input
Example data from the File:JEFF-3.1 activation file.tgz.

set branchless

set branchless OPT [ WGT_LOW WGT_HIGH ]

Option that enables the branchless collision method for variance reduction. Input values:

`OPT`	: option to switch calculation on (1/yes) or off (0/no). The default option is "`off`".
`WGT_LOW`	: weight lower-boundary (default value: 0.2)
`WGT_HIGH`	: weight upper-boundary (default value: 10.0)

Notes:

The branchless algorithm suppresses the variability due to the simultaneous propagation of the several branches associated to a fission event
The branchless method uses analog scattering combined with forced fission so that after each collision, the neutron is either a scattering neutron or a fission neutron. In a non-multiplying method, the branchless method behaves as implicit capture.
The branchless method sets the following simulation configuration: reaction sampling (set nphys 1 1 1), reaction modes (set impl 0 1 1), and population control (set combing 1), overriding any user-defined option.
The current implementation does not support the use of the branchless collision method combined with the unresolved resonance probability table sampling (see set ures).

set bumode

set bumode MODE [ ORDER SSD ]

Sets the burnup calculation mode. Input values:

`MODE`	: burnup calculation mode (default value: 2 = CRAM)
`ORDER`	: CRAM order (default value: 14 - 14 PFD CRAM)
`SSD`	: number of substeps for CRAM decay steps (default value: 0 = use TTA)

The possible settings for mode are:

Mode	Description
`1, tta`	Transmutation Trajectory Analysis (TTA)
`2, cram`	Chebyshev Rational Approximation Method (CRAM)

The CRAM order parameter can only be given when choosing the CRAM mode. The possible settings for CRAM order are:

CRAM order
`2`
`4`
`6`
`8`
`10`
`12`
`14`
`16`
`-16`
`-48`

Notes:

Positive values refer to PFD form of CRAM. Negative values of CRAM order mean using IPF form of CRAM with order of the absolute value of the parameter.
Decay calculations (see dep (depletion history)) and burnup calculations with very low flux are always calculated with TTA disregarding this input before version 2.1.32. The latter, very low flux condition, only applies to calculations not involving continuous reprocessing.
Positive values of SSD enforce usage of CRAM with given number of substeps. A zero value of SSD enforces usage of TTA.
The Serpent 1 MODE 3, a variation TTA method, in which cyclic transmutation chains are handled by inducing small variations in the coefficients instead of solving the extended TTA equations, is overwritten by the standard TTA method MODE 1.
Version 2.2.0 includes the sub-step method for depletion calculations involving continuous reprocessing.

set bunorm

set bunorm NORM

Sets the burnup calculation normalization mode if it is not bound to a single material. Input values:

NORM : burnup calculation normalization mode (1 = all materials, 2 = burnable materials, 3 = non-burnable materials)

Notes:

The default normalization for burnup calculations includes all materials.

set ccmaxiter

set ccmaxiter NITER

Sets the maximum number of coupled calculation iterations. Input values:

NITER : number of iterations (default value: 1 = no iteration)

Notes:

The iteration is stopped when either the maximum number of iterations or the maximum active neutron population (set with set ccmaxpop) has been simulated.
See Coupled multi-physics calculations for further information.

set ccmaxpop

set ccmaxpop CPOP

Sets the maximum total live population to simulate in a coupled calculation. Input values:

CPOP : total active population to simulate (default value: INFTY/1E6)

Notes:

The iteration is stopped when either the maximum number of iterations (set with set ccmaxiter) or the maximum active neutron population has been simulated.
Only the population simulated during active cycles is included in this amount.
This is mostly useful if the neutron population per iteration is not constant.
See Coupled multi-physics calculations for further information.

set cdop

set cdop OPT

Sets the Doppler broadening method for the energy spectrum of the scattered photons. Input values:

OPT : option to set Doppler broadening method off (0/no) or on (1/yes). The default option is "on".

Notes:

If the Doppler broadening method is switched off, the incoherent scattering function approximation is used for calculating the energy.
In both cases, the direction of the photon is calculated using the incoherent scattering function.

set cea

set cea OPT

Sets the Compton electron angular distribution model on and off. Input values:

OPT : option to set the Compton electron angular distribution model off (0/no) or on (1/yes). The default option is "on".

Notes:

Electron travels in the direction of the momentum transfer vector. This is equal to the free-electron scattering angle when Doppler broadening is not used.

set cfe

set cfe LN [ TN LG TG ]

Defines the minimum mean distance for scoring the collision flux estimator (CFE) for photons and neutrons. Input values:

`LN`	: minimum mean distance for scoring the CFE for neutrons [in cm] (default value: 20.0)
`TN`	: minimum mean time interval for scoring the CFE for neutrons [in s]
`LG`	: minimum mean distance for scoring the CFE for photons [in cm] (default value: 20.0)
`TG`	: minimum mean time interval for scoring the CFE for photons [in s]

Notes:

The use of delta-tracking necessitates the use of CFE for scoring the integral reaction rates. The scoring is based on both real and virtual collision to improve the statistics in low density regions (and short time intervals).
The minimum mean distance is the statistical mean-free-path (mfp) of collisions that contribute to the CFE. Collisions are more frequent if the physical mfp is shorter.
In time-dependent simulations it may be more convenient to define the minimum mean time between two collisions, to get sufficient statistics for short time bins.
Adjusting the distance affects both statistics and running time, but it should be noted that no studies have been performed on what the optimal value should be.
Only one criterion can be provided for each particle type. If distance is given, time must be set to "-1" and vice versa.
For more information on tracking modes and CFE, see the detailed descriptions on delta- and surface-tracking and result estimators.
The collision flux estimator in Serpent is described in an article in Annals of Nuclear energy from 2017.^[4]
In version 2.1.27 and earlier the name of this input option was "set minxs".

set cmm

set cmm OPT

Sets calculation of diffusion coefficients using the cumulative migration method (CMM) on or off. Input values:

OPT : option to switch CMM calculation on (1/yes) or off (0/no)

Notes:

Calculation of diffusion coefficients using CMM might take considerable time. This option allows switching the calculation off if the data is not needed.
The calculation of CMM diffusion coefficients was revised in version 2.1.31 so that the calculated values may be different than with previous versions.
CMM diffusion coefficients can be calculated also when using implicit capture reactions beginning from version 2.1.31.
CMM diffusion coefficients and transport cross sections are reasonable only when they are calculated over entire geometry (homogenized region covers the entire geometry and is surrounded by periodic or reflective boundary conditions).
- This means that e.g. pin cell diffusion coefficients can not be calculated from a 2D fuel assembly calculation.
- One may try to approximate the CMM diffusion coefficients with TRC diffusion coefficients with transport correction for hydrogen for light water reactor applications.
Using private results array may be recommended when CMM diffusion coefficients are calculated.

set coefpara

set coefpara FMT [ PARAM₁ PARAM₂ ... ]

Defines the parameters included in the separate group constant output file. Input values:

`FMT`	: output format, currently used for including or excluding statistical errors (0 = not included, 1 = included)
`PARAM_n`	: list of parameters or detectors included in the file

Notes:

The group constant output file [input].coe is produced when the automated burnup sequence is invoked.
The available parameters are listed under homogenized group constants in the description of the [input]_res.m output file.
Detectors are identified by the name assigned to them in the detector card.

set combing

set combing MODE

Option that enables the combing approach for precursors population control as an alternative to Russian roulette and splitting in dynamic source simulations. Input values:

MODE : combing population-control mode (0 = none, 1 = weight-based, 2 = emission-based)

Notes:

The combing method can achieve variance reduction and save computer time by keeping the population size approximately constant over time steps. In super-critical systems, it prevents the population from growing without bound while, in sub-critical systems, it does it from dying. In critical systems, it avoids the divergence of the variance of the population due to fluctuations of fission chains.

set comfile

set comfile INFILE OUTFILE

Defines the communication files used in the file-based coupled calculation communications. Input values:

`INFILE`	: Path to inwards communication file (signals to Serpent).
`OUTFILE`	: Path to outwards communication file (signals from Serpent).

Notes:

Setting up a communication mode will enable the coupled calculation mode.
The communication options set comfile, set ppid and set pport are mutually exclusive, aka, multiple signalling modes are not allowed.
For more information see: External coupling

set confi

set confi OPT

Sets confidentiality flag on or off. Input values:

OPT : option to set confidentiality flag on (1/yes) or off (0/no)

Notes:

This option can be used to label calculations as confidential. If the option is set, text "(CONFIDENTIAL)" is printed in the run-time output next to the calculation title and the value of variable CONFIDENTIAL_DATA in the [input]_res.m output file is set to 1.

set coverxlib

set coverxlib LIB₁ [ LIB₂ LIB₃ ... ]

Sets COVERX-format multi-group covariance data file paths. Input values:

LIB_n : file paths to multi-group covariance data files in the COVERX format^[5] (ASCII or binary)

Notes:

If covariance data is linked when running Sensitivity calculations, Serpent will automatically apply the sandwich rule using the calculated sensitivity vectors and propagate the covariance data to uncertainties of the sensitivity responses.

set covlib

set covlib LIB₁ [ LIB₂ LIB₃ ... ]

Sets plain ASCII multi-group covariance data file paths. Input values:

LIB_n : file paths to multi-group covariance data files in the plain ASCII format (ASCII or binary)

Notes:

If covariance data is linked when running Sensitivity calculations, Serpent will automatically apply the sandwich rule using the calculated sensitivity vectors and propagate the covariance data to uncertainties of the sensitivity responses.

set cpd

set cpd DEPTH [ N_Z Z_MIN Z_MAX ] [ LVL1 LVL2 ]

Sets on the calculation of lattice-wise power distributions to output file [input]_core0.m on. Input values:

`DEPTH`	: The number of levels included. 1 is the first lattice calculated from universe 0 usually corresponding to assembly-wise distribution. 2 includes the first two levels usually corresponding to the assembly- and pin-wise distributions.
`N_Z`	: Number of equal sized axial bins into which the lattices are divided.
`Z_MIN`	: Minimum z-coordinate for the axial division.
`Z_MAX`	: Maximum z-coordinate for the axial division.
`LVL1`	: User-defined first level where to define the lattice-wise power distribution
`LVL2`	: User-defined second level where to define the lattice-wise power distribution

Notes:

The default values for N_Z, Z_MIN and Z_MAX are 1, -INFTY and INFTY, respectively.

set cpop

set cpop NPG NGEN NSKIP [ NSKIP2 ]

Sets parameters for simulated neutron population for corrector neutron transport solutions in burnup calculation. Typically used with the SIE burnup scheme. Input values:

`NPG`	: number of neutrons per generation
`NGEN`	: number of active generations
`NSKIP`	: number of inactive generations
`NSKIP2`	: number of inactive generations on further iterations for the same burnup point

Notes:

As the SIE burnup scheme executes the corrector step multiple times for each burnup step, combining the results from each iteration, it may be a good idea to run more iterations with less active neutron histories per iteration.

set csw

set csw FILE

Writes source points in criticality source simulation into a file. Input values:

FILE : file name where the source points are written

Notes:

Only source points from active cycles are included.
From version 2.2.1 and on, multi-step depletion source files can be generated [FILE]_[bu], where "bu" is the burnup step. Otherwise, simply, [FILE].

set dataout

set dataout TABLE_LIST

Defines the tables included in the nuclear and material data file [input].out. Input values:

TABLE_LIST : list of tables (default value: all/0)

Possible list of tables: Possible key-words/variables are:

Key-word	Table ID	Description
`0, all`		include all available tables
`1, nuc_summary`	Table 1: Summary of nuclide data
`2, nuc_readec`	Table 2: Reaction and decay data
`3, nuc_nfy`	Table 3: Fission yield data	only in burnp mode
`4, nuc_lostpath`	Table 4: Lost transmutation paths	only in burnup mode
`5, mat_summary`	Table 1: Summary of material compositions
`8, allnuc`		(nuclide) Tables 1-4
`9, allmat`		(material) Tables 1
`-1`		omit the `[input].out` file

Notes:

The output file data is divided into two sections: nuclear data (Tables 1-4) and material data (Table 1). Respectively, they include all the nuclides and their reactions as they are read from the nuclear data libraries, and the material data includes isotopic compositions and densities, as well as volumes and masses if available.
For more information, see detailed description of the nuclear and material data output.

set dbrc

set dbrc E_min E_max NUC₁ [ NUC₂ ... ]

Enables the use of doppler-broadening rejection correction (DBRC). Input values:

`E_min`	: Minimum energy for DBRC
`E_max`	: Maximum energy for DBRC
`NUC_n`	: Nuclide identifiers for which to apply DBRC to, with 0 K cross section data, e.g. "92238.00c"

Notes:

This description is not complete.
Use of DBRC requires 0 K cross section data.
See also Section 5.6 of Serpent 1 User Manual.
This input could be given without any nuclides before version 2.1.32. Then DBRC was not used at all.

set dd

set dd MODE [ X₀ Y₀ α₀ ]

Invokes domain decomposition. Input values:

`MODE`	: decomposition mode (0 = none, 1 = simple, 2 = sector, 3 = sector + center)
`X₀`	x-coordinate of the domain decomposition origin (origin is the centre of the angular division)
`Y₀`	y-coordinate of the domain decomposition origin (origin is the centre of the angular division)
`α₀`	angular position of the domain decomposition origin (origin is the initial position of the angular division)

Notes:

Domain decomposition works in MPI mode by separating burnable materials into different parallel tasks.
Number of domains is given by the number of MPI tasks
Only burnable materials separated into depletion zones using the "div sep" option are decomposed
MODE 1 decomposes the geometry based on the automatically assigned depletion zone indexes (not recommended).
MODE 2 decomposes the zones into sectors and MODE 3 adds a central zone if the number of domains is greater than 4.
The additional input options, X₀, Y₀ and α₀, are available for MODE 2 and 3 (default values are zero).
Decomposed materials are plotted in domain-specific colors (unless the rgb entry in the material card is used)
See practical example for more information.

set declib

set declib LIB₁ [ LIB₂ LIB₃ ... ]

Sets the decay data library file paths. Input values:

LIB_n : library file paths

Notes:

Decay libraries are standard ENDF format files^[3] containing decay data.
If the file path contains special characters it is advised to enclose it within quotes.
A default directory path can be set by defining environment variable SERPENT_DATA. The code looks for decay data files in this path if not found at the absolute.
From version 2.2.0 and on, a default decay data library directory file can be set by defining environment variable SERPENT_DECLIB. This file will be used if no other path is given with set declib.

set decomp

set decomp OPT [ ELEM₁ ELEM₂ ... ]

Decomposes elemental entries in material cards into isotopes. Input values:

`OPT`	: option to include (1) or exclude (0) elements from decomposed list
`ELEM_n`	: element names

Notes:

Elemental entries are identifed from zero A in ZA.
The decomposition is based on built-in isotope fractions.
If the list is not provided, all elemental entries are decomposed.

set delnu

set delnu OPT

Sets delayed neutron emission on or off. Input values:

OPT : option to switch delayed neutron emission on (1/yes) or off (0/no)

Notes:

Delayed neutron emission is on by default in neutron criticality source and off by default in (static/dynamic) external source simulation mode.
In time-dependent calculations, driven by the set dynsrc option, precursor based delayed neutron emission is included in the calculation: off at fission, but on at delayed nubar in total nubar.
See separate description of physics options in Serpent for differences to other codes.

set depmtx

set depmtx MODE

Print burnup matrixes to [input]_depmtx_[mat]_[bu]_[ss].m file during burnup calculation, where "bu" is the burnup step and "ss" is the substep. Input values:

MODE : Set printing on (1/yes) or off (0/no).

Notes:

With non-constant predictor, this option will stop the simulation up to version 2.1.31.
With multiple substeps, only the last one is kept after the simulation up to version 2.1.31.
The burnup matrix output is named depmtx_[mat][bu].m up to version 2.1.31.

set depout

set depout MODE [STEP]

Controls which burnable material compositions are printed into the [input]_dep.m output file in case of divided materials. Input values:

`MODE`	: value indicating, which materials to output to the `[input]_dep.m` file (1 = only partials, 2 = only parents, 3 = both)
`STEP`	: value indicating the print-out interval of the `[input]_dep.m` file (0 = final step, 1 = all steps, 2 =none)

Notes:

Parent materials refer to materials defined by mat cards, and partials to depletion zones created automatically using the div card.
Default mode is 2 (only parents) and default print-out interval step is 1 (all steps).
Print-out interval step option 2, no [input]_dep.m generation, can be combined with post-processing re-depletion: "-rdep" command line option.
This option when is used with the domain decomposition feature, set dd, in a mode different from 2, generates multiple depletion files which are named adding _dd[mpiid] (domain decomposition identifier) to the standard file name. Each of them contains the partial materials information of the given domain/MPI task.

set deppara

 set deppara PARAM_LIST

Defines the material- and isotopic-wise variables included in the depletion output file [input]_dep.m. Input values:

PARAM_LIST : list of variables (default value: "all")

Possible key-words/variables are:

Key-word	Quantity	Output ID	Description
`atom`	atom density	`ADENS`	[in in b^-1 cm^-1]
`mass`	mass density	`MDENS`	[in g/cm³]
`activity`	activity	`A`	[in Bq]
`dh`	decay heat	`H`	[in W]
`sf`	spontaneous fission rate	`SF`	[in fissions/s]
`gsrc`	photon emission rate	`GSRC`	[in photons/s]
`ingtox`	ingestion toxicity	`ING_TOX`	[in Sv]
`inhtox`	inhalation toxicity	`INH_TOX`	[in Sv]
`all`			include full-set of variables
`none`			exclude full-set of variables

Notes:

For more information, see detailed description of the burnup calculation output.

set depstepbunorm

set depstepbunorm NORM

Sets the depletion step normalization in burnup calculations based on energy deposition. Input values:

NORM depletion step normalization mode based on energy deposition (1 = all materials, 2 = burnable materials)

Notes

By default, for energy deposition modes 0/1, the normalization includes only "burnable" materials while for energy deposition modes 2/3, the normalization includes "all" materials (see set edepmode).

set dfsol

set dfsol MODE [ DC NP ]

Options for homogeneous diffusion flux solver. Input values:

`MODE`	: boundary conditions for solver (1 = include net currents at boundary surfaces and corners, 2 = include only surface currents)
`DC`	: type of diffusion coefficient used in the calculation (1 = INF_DIFFCOEF, 2 = TRC_DIFFCOEF)
`NP`	: number of points for trapezoidal integration for homogeneous flux

Notes:

This input option is used to control how the deterministic diffusion flux solver used to obtain assembly discontinuity factors (set adf) and pin power distributions (set ppw) is run.
Default mode is 1 (include both surfaces and corners in solution).
Default diffusion coefficient is INF_DIFFCOEF, option 2 requires the set trc option.
Default number of points for trapezoidal integration is 100.
See also separate description of the built-in diffusion flux solver.
The format was revised in update 2.1.27 (DC option was added between MODE and NP).

set dix

set dix OPT

Sets double indexing for cross section energy grid look-up on or off. Input values:

MODE : option to set double indexing on (1/yes) or off (0/no)

Notes:

Double indexing^[6] is a method to speed-up the cross section look-up when energy grid unionization is not used for microscopic data.
The method can be used only in optimization modes 1 and 3 (modes 2 and 4 are based on energy grid unionization).

set dspec

set dspec EGRID_p EGRID_n

Sets the energy grid structure for decay spectra. Input values:

`EGRID_p`	: energy grid structure for photons
`EGRID_n`	: energy grid structure for neutrons

Notes:

The photon/neutron decay spectra is printed in the [input]_gsrc.m or [input]_nsrc.m output file, respectively.
The energy group spectra only include the contribution from the discrete/line spectra.
Setting "-1" instead of providing the energy grid structure disables the option for the given particle type.

set dt

set dt NTRSH [ GTRSH ]

Sets probability threshold for delta-tracking. Input values:

`NTRSH`	: probability threshold for neutrons
`GTRSH`	: probability threshold for photons

Notes:

Serpent uses delta-tracking by default for both neutrons and photons, but switches to surface-tracking if the probability of sampling virtual collisions (ratio between material total cross section and the majorant) exceeds the given threshold.
Default probability threshold for both particle types is 0.9, i.e. delta-tracking is used if the ratio between total cross section and majorant is above 0.1.
"set dt 1" means that delta-tracking is always used and "set dt 0" that it is never used.
Use of delta-tracking can be enforced or blocked in individual materials using the set forcedt and set blockdt options
Integral reaction rates are scored using the collision estimator of neutron flux, which has a few adjustable parameters (see set cfe).
For more information on tracking modes, see the detailed description on delta- and surface-tracking.

set dynccfile

set dynccfile OPT

Option to store precursors and neutrons between time steps in coupled dynamic simulations into a file. Input values:

OPT : option to switch on (1/yes) or off (0/no) the store/write dynamic data into a file. The default option is "on".

set dynsrc

set dynsrc PATH [ MODE ]

Links previously generated steady state source distributions to be used in a transient simulation with delayed neutron emission. Input values:

`PATH`	: The path of the previously generated source file (without the `.main` suffix)
`MODE`	: Precursor tracking mode (0 = mesh based, 1 = point-wise)

Notes:

Four source files will be required [PATH].main, [PATH].prec, [PATH].live and [PATH].precpoints

set ecut

set ecut EMIN_n EMIN_p

Sets minimum energy cut-off for neutrons and photons. Input values:

`EMIN_n`	: cut-off energy for neutrons [in MeV]
`EMIN_p`	: cut-off energy for photons [in MeV]

Notes:

The default cut-of energy for photons is 1 keV. Neutron energy cut-off is switched off by default.
Using energy cut-off for neutrons may lead to non-physical results, since fission and up-scattering may not be accurately modeled.
Versions 2.1.27 and earlier include only photon energy cut-off, which is now the second input parameter.

set ecutdens

set ecutdens DENS₁ EMIN_p,1 [ DENS₂ EMIN_p,2 ... ]

Sets density-wise minimum energy cut-off for photons. Input values:

`DENS_i`	: mass density [in g/cm³]
`EMIN_p,i`	: cut-off energy for photons [in MeV]

Notes:

Mass densities and energy cut-offs must be given in ascending order.

set ecutmat

set ecutmat MAT₁ EMIN_p,1 [ MAT₂ EMIN_p,2 ... ]

Sets material-wise minimum energy cut-off for photons. Input values:

`MAT_i`	: material name
`EMIN_p,i`	: cut-off energy for photons [in MeV]

set eddi

set eddi OPT

Option that enables the calculation of Eddington factors. Input values:

OPT : option to switch calculation on (1/yes) or off (0/no). The default option is "off".

Notes:

Requires group constant generation to be set on (see set gcu).

set edepdel

set edepdel OPT [ LOCAL_EGD ]

Option to include the energy of delayed components in energy deposition calculations. Input values:

`OPT`	: include (1/yes) or exclude (0/no) the energy of delayed components in energy deposition estimates.
`LOCAL_EGD`	: deposit the energy of the delayed fission gammas to fission sites (1) or with the same distribution as the prompt fission gammas (0) (this option is used only in energy deposition mode 3)

Notes:

Delayed components include delayed neutrons, delayed fission gammas and delayed betas.
The energy of delayed neutrons can be excluded using this option only in energy deposition mode 1.
The energy of the delayed components is deposited at the time of fission so the time dependence of the energy deposition is not accounted for properly in transient simulations.
Default options are to include delayed components (1) and to deposit the energy of the delayed fission gammas with the same distribution as the prompt fission gammas (0).
Option to deposit the energy of the delayed fission gammas with the same distribution as the prompt fission gammas works only in criticality source simulations.

set edepkcorr

set edepkcorr OPT

Option to apply correction for energy deposition estimates when simulating non-critical systems with criticality source mode. Input values:

OPT : option to switch the correction on (1/yes) or off (0/no). The default option is "on".

Notes:

The methodology is described in related paper. ^[7]

set edepmode

set edepmode MODE [ E_CAPT ]

Sets energy deposition mode for energy deposition calculations. Input values:

`MODE`	: energy deposition mode: 0, 1, 2 or 3 (default value: 0)
`E_CAPT`	: additional energy release in capture reactions given [in MeVs per fission] (used only in energy deposition mode 1)

Notes:

The energy deposition modes are described in related paper ^[7].
The choice of energy deposition mode affects also the normalization of the results, if normalization to total power or power density is used.
Energy deposition modes 1, 2 and 3 require data which is not available in the standard ACE-format cross section files used by Serpent. Separately distributed ACE-files (file endfb71_edep.tar.gz) containing additional data are required to use these modes.
KERMA coefficients used in energy deposition modes 2 and 3 are not Doppler-broadened correctly by the built-in preprocessor. See Doppler-broadening preprocessor.

set egrid

set egrid TOL [ EMIN EMAX ]

Sets the unionized energy grid reconstruction parameters. Input values:

`TOL`	: fractional reconstruction tolerance
`EMIN`	: minimum energy in the grid [in MeV]
`EMAX`	: maximum energy in the grid [in MeV]

Notes:

The default fractional reconstruction tolerance is 0.0 in transport calculation mode and 5E-5 in burnup calculation mode.
A higher energy grid reconstruction tolerance means lower memory consumption and possibly higher computation speed but also reduced accuracy of the calculation.
The default minimum energy is 1E-11 MeV (neutrons) and 1E-03 MeV (photons).
The default maximum energy is 20.0 MeV (neutrons) and 100.0 MeV (photons).
See also Section 5.3 of Serpent 1 User Manual.

set ekn

set ekn E

Sets the Klein-Nishina equation to approximate a Compton scattering event. Input values:

`E`	: energy cut-off for modelling energy and direction of the scattered photon [in MeV] (default value: INFTY)

Notes:

The Klein-Nishina equation is used above E for calculating both the energy and direction of the scattered photon. Below E, the Doppler brodening method is used if switched on. Otherwise, the incoherent scattering function approximation is in use.

set elcond

set elcond MAT₁ COND₁ [ MAT₂ COND₂ ... ]

Sets material-wise conductivity state for electrons in photon transport calculations. Input values:

`MAT_i`	: material name
`COND_i`	: conductivity state (0 = non-conductor, 1 = conductor, 2 = conduction electron dependent).

Notes:

The default option to run the simulation with is "2/conduction electron dependent".
If the material is set as a conductor and no-conduction electrons are found, the material conductivity state is overwritten to non-conductor.
Option 2, conduction electron dependent, establishes that a single element material is a conductor if conduction electrons are found, otherwise is a non-conductor. A compound is always a non-conductor.

set elgas

set elgas MAT₁ GAS₁ [ MAT₂ GAS₂ ... ]

Sets material-wise phase for electrons in photon transport calculations. Input options:

`MAT_i`	: material name
`GAS_i`	: phase state (0 = condensed or non-gas, 1 = gas).

Notes:

The default option to run the simulation with is "0/condensed" and only affects mixtures.
The gas phase does not affect the mean excitation energy of a single material: if set elmee option is set for a material, the material is considered as non-gas.

set elmee

set elmee MAT₁ MEE₁ [ MAT₂ MEE₂ ... ]

Sets material-wise mean excitation energy for electrons in photon transport calculations. Input values:

`MAT_i`	: material name
`MEE_i`	: electrons mean excitation energy [in MeV] or "-1"

Notes:

The default value is "-1" interpreted as calculated during runtime for compounds and extracted from data for single element materials.
The maximum mean excitation energy for electrons is 1 MeV.

set elspn

set elspn EGRID_E

Sets the stopping power energy grid size for electrons/positrons in photon transport calculations. Input values:

EGRID_E : energy grid size (default value: 200)

Notes:

The thick-target bremsstrahlung model (set ttb option) assumes that the energy array is uniformly distributed in a log-energy scale.

set entr

set entr N_X N_Y N_Z [ X_MIN X_MAX Y_MIN Y_MAX Z_MIN Z_MAX ]

Defines the mesh structure used for calculating fission source entropy. Input values:

`N_X`	: number of mesh cells in x-direction (default value: 5)
`N_Y`	: number of mesh cells in y-direction (default value: 5)
`N_Z`	: number of mesh cells in z-direction (default value: 5)
`X_MIN`	: minimum mesh boundary in x-direction
`X_MAX`	: maximum mesh boundary in x-direction
`Y_MIN`	: minimum mesh boundary in y-direction
`Y_MAX`	: maximum mesh boundary in y-direction
`Z_MIN`	: minimum mesh boundary in z-direction
`Z_MAX`	: maximum mesh boundary in z-direction

Notes:

Shannon entropy is used to monitor fission source convergence, in criticality source simulations, by recording the distribution of source points on mesh.
The calculation is invoked by setting the generation history record option on (set his).
If no mesh boundaries are specified, the mesh extends over the entire geometry.
For more information, see detailed description on fission source convergence.

set fininitfile

set fininitfile FILEPATH

Links a file containing an initial fuel behavior solution used as a starting point for a coupled calculation with the FINIX fuel behavior module. Input values:

FILEPATH : path to the file

Notes:

The file should be a type 6 fuel behavior interface containing a previous solution from a coupled FINIX calculation.
The axial and radial nodalization as well as the included fuel rods should be the same in the file as in the calculation.

set fissh

set fissh ZAI₁ E₁ ZAI₂ E₂ ...

Overrides default fission heating values. Input values:

`ZAI_n`	: nuclide identifiers (ZAI)
`E_n`	: energy deposited per fission [in MeV] (default value: 202.27)

Notes:

The energy deposited per fission includes additional energy released in capture reactions when fission neutrons are absorbed.
By default the energy release per U-235 fission is set to 202.27 MeV, and the values for other actinides scaled based the Q-values found in the cross section libraries.
See also set U235H.
See also Section 5.8 of Serpent 1 User Manual.

set fissrate

set fissrate F [ MAT ]

Sets normalization to fission rate. Input values:

`F`	: number of fission reactions per second [in 1/s]
`MAT`	: dummy parameter

Notes:

Normalization is needed to relate the Monte Carlo reaction rate estimates to a user-given parameter.
The default normalization is set: to unit total loss rate (neutron transport) and to unit total source rate (photon transport).
In coupled neutron-photon transport simulations the normalization is driven by the neutron normalization
For other normalization options, see: set power, set powdens, set flux, set genrate, set absrate, set lossrate, set srcrate, set sfrate.
See also Section 5.8 of Serpent 1 User Manual.

set fissye

set fissye INTT

Sets the energy-dependent interpolation scheme for the fission yields. Input values:

INTT : energy-dependent interpolation (0 = none, 1 = linear-linear, 2 = histogram). The default option is "1/linear-linear".

Notes:

The default option "1/linear-linear" is based on the two-dimensional interpolation scheme dictated by the ENDF data (File 8: Decay and Fission Product Yields - sec. 0.5.2.2)^[3]. The interpolation is defined by the neutron energy spectrum.
The option "0/none" excludes the energy-dependency from the fission yields, i.e. single-value defined at the lower limit.
The option "2/histogram" implies that the function is constant and equal to the value given at the lower limit of the interval (e.g., thermal, epithermal, fast values) in connection with how the data were measured in thermal and fast systems. (Note that the option is under evaluation).

set flux

set flux F [ MAT ]

Sets normalization to total flux. Input values:

`F`	: flux
`MAT`	: dummy parameter

Notes:

Normalization is needed to relate the Monte Carlo reaction rate estimates to a user-given parameter.
The default normalization is set: to unit total loss rate (neutron transport) and to unit total source rate (photon transport).
In coupled neutron-photon transport simulations the normalization is driven by the neutron normalization.
For other normalization options, see: set power, set powdens, set genrate, set fissrate, set absrate, set lossrate, set srcrate, set sfrate.
See also Section 5.8 of Serpent 1 User Manual.

set fluxlimtrc

set fluxlimtrc OPT

Option that enables the calculation of flux limited TRC diffusion coefficients. Input values:

OPT : option to switch calculation on (1/yes) or off (0/no). The default option is off.

Notes:

In infinite-spectrum calculations the anisotropic component of the non-TRC nuclides/materials is removed
S1 and SP1 are non-corrected for non-TRC nuclides/materials and below energy limit for TRC nuclides/materials (see set trc option)

set fmtx

set fmtx 1 MAT₁ MAT₂ ...

set fmtx 2 UNI₁ UNI₂ ...

set fmtx 3 LVL

set fmtx 4 X_MIN X_MAX N_X Y_MIN Y_MAX N_Y Z_MIN Z_MAX N_Z

Set the calculation of fission matrixes. Input values:

`MAT_n`	: material list
`UNI_n`	: universe list
`LVL`	: level number
`X_MIN`	: minimum x-coordinate mesh boundary [in cm]
`X_MAX`	: maximum x-coordinate mesh boundary [in cm]
`N_X`	: number of x-mesh cells
`Y_MIN`	: minimum y-coordinate mesh boundary [in cm]
`Y_MAX`	: maximum y-coordinate mesh boundary [in cm]
`N_Y`	: number of y-mesh cells
`Z_MIN`	: minimum z-coordinate mesh boundary [in cm]
`Z_MAX`	: maximum z-coordinate mesh boundary [in cm]
`N_Z`	: number of z-mesh cells

Notes:

There are four options for defining the regions that compose the matrix: 1 = material, 2 = universe, 3 = level, 4 = Cartesian mesh.
The output is printed in file [input]_fmtx[bu].m, where "bu" is the burnup step. Output values are given in pairs: matrix element and associated relative error, for total, prompt and delayed (analog) fission matrixes.

set forcedt

set forcedt MAT₁ MAT₂ ...

Defines the list of materials where delta-tracking is always used. Input values:

MAT_n : material names

Notes:

This option is used to override selection of tracking mode based on the probability threshold (see set dt) in individual materials.
Use of delta-tracking can be blocked in individual materials using set blockdt.
For more information on tracking modes, see the detailed description on delta- and surface-tracking.
Note to developers: should have different lists for neutrons and photons?

set fpcut

set fpcut FPCUT

Sets the fission product yield cut-off. Input values:

FPCUT : fission product yield cut-off (default value: 0.0)

Notes:

Fission product yield cut-off FPCUT acts on cumulative fission yields, and the given number is the lower limit for the maximum cumulative yield in each mass chain. So "set fpcut 1E-2" means that every mass chain (nuclides with same mass number) with all cumulative yields below 1% are discarded from the calculation.
Setting the FPCUT cut-off to a higher value (~1E-4 or so) is an effective way to reduce the number of nuclides in the calculation, but at some point it will start affecting the results.

set fsp

set fsp OPT NSKIP

Sets fission source passing between two transport simulations in burnup or coupled calculation. The fission source at the end of one transport calculation is used as the initial source for the next transport calculation. Input values:

`OPT`	: option to switch fission source passing on (1/yes) or off (0/no). The default option is off.
`NSKIP`	: number of inactive generations on subsequent steps

Notes:

Number of inactive generations is taken from set pop card on the first step and from set fsp on all later steps.

set fum

set fum ERG [ BTCH MODE LIM ]

set fum ERG [ BTCH MODE LIM TGT ITER INIT ]

set fum ERG [ BTCH MODE DC LIM TGT ITER INIT ]

Activates fundamental mode calculation for collapsing intermediate multi-group constant data into few-group constants with a critical spectrum. Input values:

`ERG`	: Intermediate multi-group structure for calculation of the leakage-corrected critical spectrum
`BTCH`	: When set to 2, results are averaged over all criticality cycles
`MODE`	: Critical spectrum calculation type (default value: 0, i.e. old B₁ calculation)
`DC`	: Multi-group diffusion coefficients to be used with FM fundamental mode calculation (default value INF_DIFFCOEF). This value is not read with other modes.
`LIM`	: Convergence criterion of k_eff in fundamental mode calculation calculated as the absolute value difference of k_eff between successive iterations (default value: 1E-7)
`TGT`	: Target value for fundamental mode k_eff (default value: 1.0, not used with the old B₁ calculation mode)
`ITER`	: Maximum number of fundamental mode calculation iterations (default value: 25, not used with the old B₁ calculation mode)
`INIT`	: First guess for absolute value of critical B² (default value: 1E-6, not used with the old B₁ calculation mode)

The possible values for mode are:

Mode	Description
`o, O, 0`	Old B₁ calculation (use the same method as before version 2.1.31)
`b, B, 1`	New B₁ calculation
`p, P, 2`	P₁ calculation
`f, F, 3`	FM calculation

The possible values for FM mode multi-group diffusion coefficients are:

Mode	Description
`1`	Use out-scattering diffusion coefficients
`2`	Use transport corrected diffusion coefficients
`3`	Use cumulative migration method diffusion coefficients

Notes:

When invoked, Serpent applies a fundamental mode leakage correction on group constants and produces a second set of output parameters.
Before version 2.1.31, the mode parameter was not read, and the old B₁ calculation mode was always used regardless of the parameter given here.
The group constants are named with B1_ prefix, but they are calculated with fundamental mode calculation type defined with the mode parameter.
The multi-group structure may be an energy grid defined using the ene card or a name of a pre-defined energy group structure.
Setting the fundamental mode calculation overrides the default 70-group structure used for macroscopic data calculation in infinite spectrum.
Averaging the results over all cycles may improve convergence and speed up the calculation, but all information on statistical errors is lost.
This option does not affect the flux spectrum used during burnup calculations.
The calculation modes other than the old B₁ calculation mode were added in version 2.1.31.
The descriptions of the other methods than the old B₁ method will be presented later in a publication.
Note that in general the intermediate multi-group structure should have more groups than the few-group structure to get reasonable results for leakage corrected group constants and out-scatter diffusion coefficients.
Mode 0 (old B₁ calculation) might be very slow with a large intermediate multi-group structure (for example with approximately 2000 groups). Modes 1-3 should run much faster.

set gbuf

set gbuf FAC [ BNK ]

Sets the size of photon buffer and event bank. Input values:

`FAC`	: factor (> 1) defining the buffer size
`BNK`	: event bank size

Notes:

Photon buffer refers to pre-allocated memory block used to store photon particle data. This memory is needed for putting secondary photons in que, etc..
The buffer factor defines the buffer size relative to simulated batch size.
The event bank refers to pre-allocated memory block used to store history data on particle events. This bank is used only with certain special options, such as importance detectors and track plotter.
The default values depend on simulation mode, and there is no need to adjust the values unless the calculation terminates with an error.
Note to developers: event bank is now the same for both neutrons and photons.

set gct

set gct OPT

Option that enables the calculation of group constant statistics tests. Input values:

OPT : option to switch calculation on (1/yes) or off (0/no). The default option is off.

Notes:

When this option is set, the batch-wise statistical tests are printed in the file [input]_stat.m.
Requires group constant generation to be set on (see set gcu).
Note to developers: statistical tests should be documented

set gcu

set gcu UNI₁ [ UNI₂ UNI₃ ... ]

Sets the universes for group constant generation. Input values:

UNI_n : universe where group constants are generated or "-1" to switch group constant generation off (default value: 0 = root universe)

Notes:

By default, group constants are generated in the root universe.
Group constant generation should be switched off when the results are not needed (this may speed up the calculation).
See separate description of output parameters.
Super-imposed group constant generation universes (i.e. not part of the geometry definition) should not be used so that they cover (partly or totally) the same geometry region as some other group constant generation universe (super-imposed or part of the geometry definition), if group constants are generated only on a single geometry level.

set gcut

set gcut GMAX

Sets generation cut-off for neutrons. Input values:

gmax : number of simulated generations before cut-off

Notes:

The generation cut-off can be used in neutron external source simulations, to limit the length of fission chains.
Applicable only to neutron external source simulation (invoked using set nps)
Generation or time cut-off (set tcut) is always needed for neutron external source simulations in super-critical systems.

set genrate

set genrate G [ MAT ]

Sets normalization to fission neutron generation rate. Input values:

`G`	: number of fission neutrons emitted per second [in neutrons/s]
`MAT`	: material in which the fission neutrons are generated. The default is all materials

Notes:

Normalization is needed to relate the Monte Carlo reaction rate estimates to a user-given parameter.
If the material name is omitted, the value corresponds to total fission neutron generation rate in the system.
The neutron generation rate includes only prompt and delayed neutrons emitted in fission.
The default normalization is set: to unit total loss rate (neutron transport) and to unit total source rate (photon transport).
In coupled neutron-photon transport simulations the normalization is driven by the neutron normalization.
For other normalization options, see: set power, set powdens, set flux, set fissrate, set absrate, set lossrate, set srcrate, set sfrate.
See also Section 5.8 of Serpent 1 User Manual.

set gpop

set gpop MAX_HIS MAX_POP C

Sets the on-the-fly neutron growing population size algorithm. Input values:

`MAX_HIS`	: maximum number of histories
`MAX_POP`	: maximum population size
`C`	: parameter to control the population growth

Notes:

The on-the-fly neutron growing population size algorithm is used in criticality calculations to accelerate the fission source convergence.
The growing algorithm methodology is described in related paper. ^[8]

set gsw

set gsw FILE [ OPT ]

Writes secondary photon source points in coupled neutron-photon transport simulation into a file. Input values:

`FILE`	: file name where the source points are written
`OPT`	: option to include (1/yes) or exclude (0/no) secondary photons in transport calculation. The default option is off.

Notes:

Applicable only to coupled neutron-photon transport simulation (invoked using set ngamma).
Only source points from active cycles are included in criticality source simulations.
From version 2.2.1 and on, multi-step depletion source files can be generated [FILE]_[bu], where "bu" is the burnup step. Otherwise, simply, [FILE].

set his

set his OPT

Sets batch history record on or off. Input values:

OPT : option to switch batch history record on (1/yes) or off (0/no). The default option is off.

Notes:

When invoked, Serpent collects batch-wise data on k_eff, fission source entropy etc. and produces a separate output file.
Setting the history option also invokes the calculation of fission source (Shannon) entropy. The entropy mesh parameters can be adjusted using set entr.

set ifp

set ifp GEN

Sets the number of generations to use for calculating the iterated fission probability. Input values:

GEN : Number of generations (default value: 15).

set imp

set imp TYPE G

Defines energy-dependent importances. Input values:

`TYPE`	: type of dependency (e = energy)
`G`	: exponential for adjusting importances (default value: -0.5)

set imp TYPE r₁ I₁ [ r₂ I₂ ... ]

Defines geometry-dependent importances for given region(s). Input values:

`TYPE`	: type of (geometrical) dependency (c = cell, m = material, u = universe)
`r_n`	: region identifier (cell, material or universe name)
`I_n`	: importance

Notes:

Geometry-dependent importances (only) used for variance reduction
Only cell (geometry-dependent) type importances supported for now
Geometry-dependent importances requires using surface-tracking (see set dt)

set impl

set impl ICAPT [ INXN INUBAR ILEAK ]

Sets implicit reaction modes on or off. Input values:

`ICAPT`	: option to switch implicit capture reactions on (1/yes) or off (0/no)
`INXN`	: option to switch implicit nxn reactions on (1/yes) or off (0/no)
`INUBAR`	: number of fission neutrons to emit in each fission (nonzero = implicit treatment, 0 = analog treatment)
`ILEAK`	: option to switch implicit implicit leakage on (1/yes) or off (0/no)

Notes:

Group constant generation requires implicit nxn reactions to be set on.
If an implicit nubar is given, the weights of the fission neutrons are scaled to conserve the physical number of fission neutrons.
Implicit leakage requires group constant generation to be set on.
See separate description of physics options in Serpent for differences to other codes.

set inftrk

set inftrk LOOP_n [ ERR_n LOOP_p ERR_p ]

Sets parameters for terminating infinite tracking loops. Input values:

`LOOP_n`	: number of neutron tracking loops interpreted as a geometry error (default value 1E6)
`ERR_n`	: flag to terminate neutron tracking when an infinite loop occurs: on (0/no) or off (1/ yes). The default option is on
`LOOP_p`	: number of photon tracking loops interpreted as a geometry error (default value 1E6)
`ERR_p`	: flag to terminate photon tracking when an infinite loop occurs: on (0/no) or off (1/ yes). The default option is on

Notes:

Serpent checks for tracking loop length to avoid simulation being stuck in an infinite loop.
Long loops can occur by chance in complicated geometries, and this parameter allows continuing the simulation without terminating with error message.
Even if the problem can be solved by switching the infinite loop error off, it is advised to check the geometry for possible errors.

set inventory

set inventory ID₁ ID₂ ...

Defines the nuclides or elements to include in the depletion output file [input]_dep.m. Input values:

ID_n : Identifier for nuclide, or element or special entry.

Notes:

Nuclides are entered using element symbol and mass number (e.g U-235, Am-242m, etc.) or ZAI (922350, 952421, etc.). In the ZAI format the last digit refers to the isomeric state (0 = ground state, 1 = isomeric state).
Elements are entered using symbol or numerical (U, 92, etc.). The output includes the sum over all isotopes.
Special entries include:

Key-word	Description
`all`	all nuclides
`accident`	nuclides with significant health impact & high migration probability in accident conditions^[9]
`actinides`	actinides (Z>88) for which cross section data are found in JEFF-3.1.1
`burnupcredit`	nuclides commonly considered in burnup credit criticality analyses for PWR fuels ^[10]
`burnupindicators`	burnup indicators (commonly measured from spent fuel) ^[10]
`cosi6`	inventory list used by the COSI6 code (excluding lumped fission products)
`lanthanides`	lanthanides (56<Z<72) for which cross section data are found in JEFF-3.1.1
`longterm`	relevant radionuclides in long-term waste analyses ^[11]
`minoractinides`	minor actinides (actinides - thorium - uranium - plutonium) for which cross section data are found in JEFF-3.1.1
`fp`	fission products
`dp`	actinide decay products
`ng`	noble gases

set inventory top N PARA

Defines the criterion or variable based on which to include the most significant contributors under that category in the depletion output file [input]_dep.m. Input values:

`N`	: Number of nuclides
`PARAM`	: Parameter name

Notes:

The contribution criterion is based on the variables evaluated in the depletion calculation and outputted in the bunurp output.
The possible key-words/variables are:

Key-word	Description
`mass`	contribution to mass fraction
`activity`	contribution to activity
`dh`	contribution to decay heat
`sf`	contribution to spontaneous fission rate
`gsrc`	contribution to gamma emission rate
`ingtox`	contribution to ingestion toxicity
`inhtox`	contribution to inhalation toxicity

For example: "top 10 dh" gives the top 10 contributors to decay heat.
The special entries and the calculation of top contributors do not work with the re-depletion -rdep command line option.

set isobra

set isobra ZAI₁ MT₁ FG₁
           ZAI₂ MT₂ FG₂
           ...

Defines constant branching ratios to isomeric states. Input values:

`ZAI_n`	: nuclide identifiers (ZAI)
`MT_n`	: ENDF reaction MT
`FG_n`	: fraction of reactions leading to the ground state of the product nuclide

Notes:

Serpent uses constant branching ratios by default. This option overrides the default values.
Energy-dependent data read read from ENDF format files defined by the set bralib overrides the constant ratios.

set iter alb

set iter alb [ CYCLES KEFF F_X F_Y F_Z ]

Option that iterates the albedo boundary conditions given a target k-eff for the evaluation. Input values:

`CYCLES`	: number of additional inactive cycles to run for the convergence of the iteration (default value: 50)
`KEFF`	: target k_eff for the iteration (default value: 1.0)
`F_X`	: albedo factor in x-direction to normalize the albedo leakage rate (default value: 1.0)
`F_Y`	: albedo factor in y-direction to normalize the albedo leakage rate (default value: 1.0)
`F_Z`	: albedo factor in z-direction to normalize the albedo leakage rate (default value: 1.0)

Notes:

The albedo boundary conditions result from the product of the iterated albedo leakage rate by the albedo factor in each direction.

set iter nuc

set iter nuc CYCLES KEFF N_ZAI ZAI₁ ZAI₂ ... ZAI_{N_ZAI} [ N_MAT MAT₁ MAT₂ ... MAX_{N_MAT} ]

`CYCLES`	: number of additional inactive cycles to run for the convergence of the iteration
`KEFF`	: target k_eff for the iteration
`N_ZAI`	: number of different nuclides (ZAI) included in the iteration
`ZAI_i`	: the ZAI of the nuclide to be included in the iteration (e.g. 50100 for boron 10 ground state)
`N_MAT`	: number of different materials included in the iteration (optional parameter)
`MAT_i`	: the name of the material to be included in the iteration

Notes:

If a list of materials is not given, all materials that contain the included nuclides are included in the iteration.
The initial density of the nuclides to be iterated should be larger than zero.
The critical density iteration only works for nuclides that have a reactivity effect mainly through neutron absorption.
- Specifically, critical densities of fissile, moderating or reflecting nuclides cannot be reliably iterated using this card.
The atomic density of the nuclides is updated according to the batching interval set in the set pop option.
- Having a large batching interval means that the atomic density may take a large number of cycles to converge.

See Critical density iteration.

set keff

set keff K_EFF

Option to scale fission neutron production in external source simulations. Input values:

K_EFF : Fission neutron production scaling factor (default value: 1.0)

Notes:

The k-effective to use for scaling the fission neutron production. The inverse of K_EFF is used as a multiplicative constant for the nubar, i.e. a value of 2.0 will cut the fission neutron production in half.
The option affects both prompt and delayed neutron production from fissions.
In versions prior to 2.1.31: does not affect delayed neutron precursor production, which will cause unexpected behaviour in Transient simulations that track delayed neutron precursor concentrations.

set lossrate

set lossrate L [ MAT ]

Sets normalization to total loss rate. Input values:

`L`	: number of lost neutrons per second [in neutrons/s]
`MAT`	: dummy parameter

Notes:

Normalization is needed to relate the Monte Carlo reaction rate estimates to a user-given parameter.
Loss rate includes absorption rate and leakage.
The default normalization is set: to unit total loss rate (neutron transport) and to unit total source rate (photon transport).
In coupled neutron-photon transport simulations the normalization is driven by the neutron normalization.
For other normalization options, see: set power, set powdens, set flux, set genrate, set fissrate, set absrate, set srcrate, set sfrate.
See also Section 5.8 of Serpent 1 User Manual.

set lost

set lost LIM

Option to treat undefined geometry regions as void. Input values:

LIM : maximum number of collisions allowed in undefined regions or "-1" if no limit is set (default value: 0)

Notes:

This option allows the calculation to proceed even if the geometry routine encounters undefined cells.
The option is intended, for example, for complex geometries in which the boundaries of adjacent cells may not fully coincide.
When the option is set, the number of lost particles is printed in variable LOST_PARTICLES in the [input]_res.m output file.
The option should not be used to get away with errors in incomplete or poorly defined geometries.

set maxsplit

set maxsplit MAX MIN

Sets limiting values for splitting and Russian roulette. Input values:

`MAX`	: maximum number of splits (default value: 1E4)
`MIN`	: minimum survival probability in Russian roulette (default value: 1.0E-18)

Notes:

Used with weight-windows (see weight window mesh definition).

set mbtch

set mbtch N

Adjusts the batch used with MPI data transfer. Input values:

`N`	: batch size in double floats, i.e. 8 bytes (default value: 1E4)

Notes:

The batch size determines the division of data blocks in MPI data transfer. The value may have some effect on parallel performance.

set mcleak

set mcleak OPT [ ERG ]

Option that enables the implicit leakage correction via MC-Fundamental Mode. Input values:

`OPT`	: option to switch the calculation on (1/yes) or off (0/no). The default option is off.
`ERG`	: intermediate multi-group structure used for group constant generation

Notes:

Requires group constant generation to be set on (see set gcu).
The calculation mode deactivates any other leakage correction option defined in set fum.
The Monte Carlo transport process is modified to produce inherently critical spectrum burnup calculations and, therefore, all results estimates are leakage corrected.
The FM-leakage-modified transport equation is solved with continuous energy Monte Carlo and the data is directly tallied to the preferred few-group structure with exception of the diffusion coefficients. The diffusion coefficients used in the evaluation are based on a multi-group CMM approach.
The implicit leakage correction via MC-Fundamental Mode methodology is described in a related paper^[12].

set mcvol

set mcvol NP [ DENS ]

Runs the Monte Carlo volume-checker routine to set material volumes before running the transport simulation. Input values:

`NP`	: number of points sampled in the geometry
`DENS`	: option to set material density adjustment on (1/yes) or off (0/no). The default option is off.

Notes:

The Monte Carlo based volume calculation routine works by sampling random points in the geometry, and counting the number of hits in every material.
When invoked, all materials given volumes are overridden by the results given by the checker routine (MC-estimated volume).
The -checkvolumes command line option can also be used to produce a separate input file for the volume entries (see detailed description on defining material volumes).
The DENS option enables the adjustment of material densities by the ratio of given and MC-estimated volume. The adjustment is only applied to materials with given volumes. (Implemented to preserve masses in Voronoi geometries (voro card), but could be also applied to account for thermal expansion).

set mdep

set mdep UNI VOL N MAT₁ MAT₂ ... MAT_N 
         ZAI₁ MT₁
         ZAI₂ MT₂
         ...

Sets parameters for calculating homogenized microscopic cross sections. Input values:

`UNI`	: universe where universe where homogenized microscopic cross sections are generated
`VOL`	: volume of the universe [in cm³] (3D geometry) or cross-sectional area [in cm²] (2D geometry)
`N`	: number of materials included in the calculation
`MAT₁ MAT₂ ... MAT_N`	: material names
`ZAI_i`	: nuclide identifier (ZAI)
`MT_i`	: ENDF reaction MT

Notes:

When this option is set, Serpent calculates homogenized few-group microscopic cross sections for the listed nuclides and reactions.
The cross sections are always calculated in the actual spectrum of the problem, never with the critical spectrum.
The results are printed in a separate output file.
The results can be included in the group constant output by adding MDEP_XS in the set coefpara list.
If the number of materials is zero, the calculation is carried over all burnable materials.
If the list of nuclides and reactions is substituted by "all", Serpent will generate a micro-depletion output [input]_mdep.inc including all the nuclides and all reactions involved in the calculation at beginning of the simulation aiming to the extract the constant data (stopping the calculation right after).
The listed materials must be enclosed inside the homogenized universe.
The calculation requires the material volumes to be correctly set.
Transmutation reactions to ground and isomeric states can be calculated by adding 'g' and 'm' after the reaction MT (e.g. 102m is the capture cross section corresponding to daughter nuclide being in isomeric state). Reaction rates are calculated to all states by default.
Fission reactions corresponding to a specific yield in ENDF can be calculated by adding 1, 2, 3, 4, ... after the reaction MT (e.g. 181 is total fission cross section corresponding to first fission product yield) depending on the fission yield data of the nuclide in the data library. This parameter was different before 2.1.32.
Sum of all capture reactions can be obtained using MT 101
Some actinides are missing the total fission channel, and setting the MT to 18 produces sum over MT's 19, 20, 21 and 38 (from version 2.1.29 on).
The nuclide identifiers are entered as ZAI, not ZA. For example, the ZAI for U-235 is 922350 and the ZAI for Am-242m is 952421.
Parameter VOL was VR in versions before 2.1.32 (volume ratio of materials included in micro depletion to total homogenized region).
Multiple set mdep cards can be given for a single homogenized universe.
The microscopic cross section calculation methodology is described in a related article.^[13]

set memfrac

set memfrac FRAC

Defines the fraction of total system memory Serpent can allocate to its use. Input values:

FRAC : the fraction of system memory that Serpent is allowed to use (default value: 0.8)

Notes:

Serpent tries to read the system total memory from the first line of the file /proc/meminfo
The fraction can also be set via a SERPENT_MEM_FRAC environmental variable.
If the fraction is exceeded, the simulation will abort. This is mainly to avert the use of swap-memory, which can make the system unresponsive.

set mfpcut

set mfpcut MFPMIN_p

Sets minimum mean-free-path cut-off for photons. Input values:

MFPMIN_p : cut-off mean-free-path for photons [in cm]

set mfpcutdens

set mfpcutdens DENS₁ MFPMIN_p,1 [ DENS₂ MFPMIN_p,2 ... ]

Sets density-wise minimum mean-free-path cut-off for photons. Input values:

`DENS_i`	: mass density [g/cm³]
`MFPMIN_p,i`	: cut-off mean-free-path for photons [in cm]

Notes:

Mass densities and mean-free-paths cut-offs must be given in ascending order.

set mfpcutmat

set mfpcutmat MAT₁ MFPMIN_p,1 [ MAT₂ MFPMIN_p,2 ... ]

Sets material-wise minimum mean-free-path cut-off for photons. Input values:

`MAT_i`	: material name
`MFPMIN_p,i`	: cut-off mean-free-path for photons [in cm]

set micro

set micro ERG [ BTCH ]

Defines the intermediate multi-group structure used for group constant generation. Input values:

`ERG`	: Intermediate multi-group structure used for group constant generation
`BTCH`	: When set to 2, results are averaged over all criticality cycles

Notes:

Serpent uses an intermediate multi-group structure to calculate homogenized few-group constants. This input parameter is used to override the default 70-group structure used in the calculation.
The multi-group structure may be an energy grid defined using the ene card or a name of a pre-defined energy group structure.
Averaging the results over all cycles may improve convergence and speed up the calculation, but all information on statistical errors is lost.
Note that in general the intermediate multi-group structure should have more groups than the few-group structure to get reasonable results for leakage corrected group constants and out-scatter diffusion coefficients.

set minxs

See set cfe.

set multilevelgcu

set multilevelgcu OPT

Option that enables the generation of group constants in multiple overlapping universes. Input values:

OPT : option to switch calculation on (1/yes) or off (0/no). The default option is off.

set mvol

set mvol MAT₁ ZONE_1,1 VOL_1,1
         MAT₁ ZONE_1,2 VOL_1,2
         ...
         MAT₂ ZONE_2,1 VOL_2,1
         ...

Sets the volumes of material regions. Input values:

`MAT_m`	: name of m-th material
`ZONE_m,n`	: index of n-th zone in m-th material
`VOL_m,n`	: volume of n-th zone in m-th material [in cm³] (3D geometry) or cross sectional area [in cm²] (2D geometry)

Notes:

This option is used to define material volumes manually. The input card is also produced when the Monte Carlo based volume checker routine is invoked.
The zone index is related to automated depletion zone division, invoked by the div card. If no division is used, the index must be set to zero for non-burnable materials. For burnable materials the indexing starts from "1". If no division is used, the corresponding index can be found using the Monte Carlo based volume checker routine.
Another option to define material volumes is to use the vol entry in the material card.
For more infomation, see detailed description on the definition of material volumes.

set nbuf

set nbuf FAC [ BNK ]

Sets the size of neutron buffer and event bank. Input values:

`FAC`	: factor (> 1) defining the buffer size
`BNK`	: event bank size

Notes:

Neutron buffer refers to pre-allocated memory block used to store neutron particle data. This memory is needed for banking fission neutrons for the next generation and putting secondary neutrons in que.
The buffer factor defines the buffer size relative to simulated batch size.
The event bank refers to pre-allocated memory block used to store history data on particle events. This bank is used only with certain special options, such as importance detectors and track plotter.
The default values depend on simulation mode, and there is no need to adjust the values unless the calculation terminates with an error.
With a large number of neutrons per generation, lowering the factor might be necessary due to excessive memory usage. The default values of the factor allows for large fluctuations of the neutron population due to poor statistics, which is seldom an issue with larger neutron populations.
Note to developers: event bank is now the same for both neutrons and photons.

set nfg

set nfg ERG

Defines the few-group structure used for group constant generation. Input values

ERG : Name of the few-group structure used for group constant generation

set nfg NE

Defines the few-group structure used for group constant generation. (This syntax should not be used anymore). Input values:

`NE`	: Number of energy groups (1/2/4) corresponding to Serpent 1 default 1-, 2- or 4-group structure.

set nfg NE E_NE-1 E_NE-2 ... E₁

Defines the few-group structure used for group constant generation. (This syntax should not be used anymore). Input values:

`NE`	: Number of energy groups. Must be at least 2 in this format.
`E_N`	: Energy group boundary value between groups N and N+1 [in MeV]. Values have to be given in ascending order.

Notes:

The few-group structure may be an energy grid defined using the ene card or a name of a pre-defined energy group structure.
The default is a two-group structure with boundary between fast and thermal group set to 0.625 eV.
Serpent uses an intermediate multi-group structure in the calculation. The default structure consists of 70 groups, and can be changed using the set micro or set fum options.
Note that in general the intermediate multi-group structure should have more groups than the few-group structure to get reasonable results for leakage corrected group constants and out-scatter diffusion coefficients.
The few-group structure must be a sub-set of the intermediate multi-group structure.
See also: group constant output.
The few-group structure will also be used for example for assembly discontinuity factors and albedos.

set nfylib

set nfylib LIB₁ [ LIB₂ LIB₃ ... ]

Sets the neutron-induced fission yield library file paths. Input values:

LIB_n : library file paths

Notes:

Fission yield libraries are standard ENDF format files^[3] containing neutron-induced fission yield data.
If the file path contains special characters it is advised to enclose it within quotes.
A default directory path can be set by defining environment variable SERPENT_DATA. The code looks for fission yield data files in this path if not found at the absolute.
From version 2.2.0 and on, a default neutron-induced fission yield library directory file can be set by defining environment variable SERPENT_NFYLIB. This file will be used if no other path is given with set nfylib.

set ngamma

set ngamma MODE [ WMIN NMAX ]

Sets the coupled neutron-photon transport simulation on. Input values:

`MODE`	: simulation mode (0 = off, 1 = analog, 2 = implicit). The default option is off
`WMIN`	: weight limit for implicit mode (default value: 0.1)
`NMAX`	: maximum number of emitted photons in implicit mode (default value: 10)

Notes:

This input card invokes the production of prompt gammas in neutron reactions. The coupled simulation mode requires that both neutron and photon data libraries are defined.
In analog mode, the average number of secondary photons produced per collision is defined by the ratio of photon production cross section to material total. Each emitted photon assumes the weight of the incident neutron.
The implicit mode can be used to produce more photons by allowing variation in their statistical weight. The weight limit defines the minimum allowed weight of emitted photons. This method is close to what is used in MCNP.
Both calculation modes produce photons in all collisions without any correlation to the sampled reaction mode.
The MODE option was incorrectly described until Dec. 12, 2017.

set nphys

set nphys FISS [ CAPT SCATT ]

Option to set reaction modes for neutrons on and off. Input values:

`FISS`	: option to handle fission (0 = not handled, 1 = handled). The default option is on.
`CAPT`	: option to handle capture (0 = not handled, 1 = handled). The default option is on.
`SCATT`	: option to handle scattering (0 = not handled, 1 = handled). The default option is on.

Notes:

If fission is switched off, it is handled as capture.

set nps

set nps PP [ BTCH TBI ]

Sets parameters for simulated particle population in external source mode. Input values:

`PP`	: total number of particles
`BTCH`	: number of batches (default value: 200)
`TBI`	: time binning for dynamic mode

Notes:

The total number of particles is divided by the given number of batches to give the number of particles per batch.
Using the nps card sets the mode to external source simulation. Criticality source simulation for neutrons is invoked using set pop. (The two cards are mutually exclusive).
If time binning is provided, the simulation is run in the dynamic mode with sequential population control. The bin structure is defined using the tme card.
Running an external source simulation requires a source, defined by the src card. Source definition also sets the transported particle type.
Neutron external source simulations are limited to sub-critical systems, unless dynamic mode, time cut-off (set tcut) or generation cut-off (set gcut) is invoked.
Neutron external source simulations in multiplying systems may require adjusting the neutron buffer (set nbuf).
Delayed neutron emission is switched off by default in neutron external source simulation. Delayed neutrons can be included with set delnu.
In transient simulations, where an initial transient source is linked using the set dynsrc option, PP particles are sampled for each time interval.

set opti

set opti MODE

Sets the optimization mode which affects the performance and memory usage. Input values:

MODE : optimization mode (default value: 4)

The possible settings for mode are:

`MODE`	Description
`1`	Minimum optimization and small memory usage. Suitable for very large burnup calculation problems involving tens or hundreds of thousands of depletion zones.
`2`	Good performance in burnup calculations involving several thousand depletion zones. Suitable for research reactor applications, but not the best choice for group constant generation.
`3`	Similar to mode 4, but lower memory demand. CPU time required by burnup and processing routines increases steeply along with the number of depletion zones, which makes the mode better suited for small burnup calculation problems.
`4`	Maximum performance at the cost of memory usage. Suitable for group constant generation and 2D assembly burnup calculations with a limited number of depletion zones.

Notes:

The mode 4 is essentially the same as the methodology in Serpent 1.
The methodology is described in a paper presented in PHYSOR 2012^[14].

set outp

set outp INT

Sets the interval (in cycles) for writing simulation output to files. Input values:

INT : number of cycles after which the output-files are updated (default value: 50)

Notes:

In coupled transient simulations the interval refers to time steps rather than batches.
Affects files such as [input]_res.m and [input]_det.m as well as mesh plots.

set pbuf

set pbuf FAC

Sets the size of the precursors buffer. Input values:

FAC : factor (>1) defining the buffer size

Notes:

Precursor buffer refers to pre-allocated memory block used to store precursors data. This memory is needed for banking/retrieving precursors for the next generation/time-interval.
The buffer factor defines the buffer size relative to simulated batch/cycle size.

set pcc

set pcc MODE [ SSP SSC ]

set pcc 5 PRED CORR [ SSP SSC ]

Sets the time integration method in burnup calculation. Input values:

`MODE`	: time integration method (default value: 1)
`PRED`	: predictor step integration scheme (0 = constant extrapolation, 1 = linear extrapolation)
`CORR`	: corrector step integration scheme (1 = linear interpolation, 2 = quadratic interpolation)
`SSP`	: number of substeps for predictor steps (default value: 1)
`SSC`	: number of substeps for corrector steps (default value: 1)

The possible settings for mode are:

Mode	Predictor method	Corrector method	Notes
`0, CE`	Constant extrapolation	-	Serpent 1 without substeps - "Euler's method"
`1, CELI`	Constant extrapolation	Linear interpolation	Serpent 1 without substeps - "old predictor-corrector method"
`2, LE`	Linear extrapolation	-	-
`3, LELI`	Linear extrapolation	Linear interpolation	-
`4, LEQI`	Linear extrapolation	Quadratic interpolation	-
`5`	Constant or linear extrapolation	Linear or quadratic interpolation	-
`6, CECE`	Constant extrapolation	Constant backwards extrapolation	-

Notes:

Number of substeps could not be given for constant predictor or corrector before 2.1.32.
Decay calculations were always calculated with single substep disregarding this input before 2.1.32.
The first burnup step extrapolation is always constant and with only single substeps before 2.1.32.
The custom mode, MODE 5, accepts constant or linear extrapolation for the predictor step and linear or quadratic interpolation for the correct step.

set pdatadir

set pdatadir DIR

Sets the file path for auxiliary photon data. Input values:

DIR : file path for directory where the data is located

Notes:

Serpent uses auxiliary data files for the modelling of photon interaction physics.
For more information, see instructions on setting up the data libraries.

set poi

set poi OPT VOL [ XE135M ]

Switches the calculation of poison cross sections on or off. Input values:

`OPT`	: option to switch the calculation of poison cross sections on (1/yes) or off (0/no)
`VOL`	: volume of the homogenized zone
`XE135M`	: option to treat ^135mXe separate from ground state ¹³⁵Xe - 0 = lumped with ¹³⁵Xe, 1 = separate treatment (default value: 0)

Notes:

Poison cross sections include the fission yields and microscopic and macroscopic absorption cross sections of fission product poisons ¹³⁵Xe and ¹⁴⁹Sm, as well as the fission yields and microscopic absorption cross sections of their precursors. The data is part of the homogenized group constant output.
The calculation requires setting the decay and fission yield library file paths.
The calculation requires the material volumes to be correctly set.
The volume is required for calculating microscopic absorption cross sections matching macroscopic absorption cross sections with poison nuclide densities smeared to the homogenization volume.
Separate treatment for ^135mXe requires cross sections for this isotope.
Parameter VOL was VR (optional) in versions before 2.1.32 (ratio of fuel volume to the volume of the homogenized zone).
From version 2.1.32 and on, the use of the 'set poi' card to evaluate the fission poison cross sections should be limited to homogenized universes enclosing all fissionable materials. Otherwise, use the micro-depletion set mdep input option.

set pop

set pop NPG NGEN NSKIP [ K0 BTCH NEIG ]

Sets parameters for simulated neutron population in criticality source mode. Input values:

`NPG`	: number of neutrons per generation
`NGEN`	: number of active generations
`NSKIP`	: number of inactive generations
`K0`	: initial guess for k_eff (default value: 1.0)
`BTCH`	: batching interval (default value: 1)
`NEIG`	: number of independent parallel eigenvalue calculations (default value: 1)

Notes:

The simulation is first run for a number of inactive generations to allow the fission source to converge. This is followed by a number of active generations, during which the results are collected. The statistics are divided in batches, and by default each generation forms its own batch.
Using the pop card sets the mode to criticality source simulation. External source simulation is invoked using set nps. (The two cards are mutually exclusive).
Convergence of fission source can be monitored using Shannon entropy (input parameters set his and set entr).
Setting an initial guess value manually may get the simulation going if it terminates on the first generation because of poor initial guess. The value does not affect fission source convergence.
See detailed descriptions on fission source convergence and statistical effects of batching.
The number of neutrons per generation also affects the memory usage together with set nbuf. With a large value, lowering the buffer size might be necessary for the simulation to be runnable.

set powdens

set powdens PDE [ MAT ]

Sets normalization to power density. Input values:

`PDE`	: power density [in kW/g] (typical value LWR: 20E-3 ... 50E-3)
`MAT`	: material in which the given power is produced. The default option is all materials.

Notes:

Normalization is needed to relate the Monte Carlo reaction rate estimates to a user-given parameter.
If the material name is omitted, the value corresponds to average power density produced in the system.
The default normalization is set: to unit total loss rate (neutron transport) and to unit total source rate (photon transport).
In coupled neutron-photon transport simulations the normalization is driven by the neutron normalization.
For other normalization options, see: set power, set flux, set genrate, set fissrate, set absrate, set lossrate, set srcrate, set sfrate.
See also Section 5.8 of Serpent 1 User Manual.

set power

set power P [ MAT ]

Sets normalization to total fission power. Input values:

`P`	: fission power [in W]
`MAT`	: material in which the given power is produced. The default option is all materials.

Notes:

Normalization is needed to relate the Monte Carlo reaction rate estimates to a user-given parameter.
If the material name is omitted, the value corresponds to total fission power produced in the system.
The default normalization is set: to unit total loss rate (neutron transport) and to unit total source rate (photon transport).
In coupled neutron-photon transport simulations the normalization is driven by the neutron normalization.
For other normalization options, see: set powdens, set flux, set genrate, set fissrate, set absrate, set lossrate, set srcrate, set sfrate.
See also Section 5.8 of Serpent 1 User Manual.

set ppid

set ppid PID

Defines the external code process identifier (PID) number to be used for communication in the POSIX-based coupled calculation communications. Input values:

PID : Process identifier (PID) of the (parent) process that Serpent should communicate with (theoretical maximum for 64-bit system: 2²²)

Notes:

Setting up a communication mode will enable the coupled calculation mode.
The communication options set comfile, set ppid and set pport are mutually exclusive, aka, multiple signalling modes are not allowed.
For more information see: External coupling

set pport

set pport PORT

Defines the external code port number to be used for communication in the SOCKET-based coupled calculation communications. Input values:

PORT : user given parent process port

Notes:

Setting up a communication mode will enable the coupled calculation mode.
The communication options set comfile, set ppid and set pport are mutually exclusive, aka, multiple signalling modes are not allowed.
For more information see: External coupling

set ppw

set ppw UNI LAT

Turns on the calculation of pin powers and pin power form factors. Input values:

`UNI`	: The universe where the pin power distribution is calculated.
`LAT`	: The lattice where the calculation is performed.

Notes:

See separate description of output parameters in the [input]_res.m.
The form factors can be printed to the group constant output with set coefpara.
Calculation of pin power form factors also requires calculation of assembly discontinuity factors using set adf.

set precsrcf

set precsrcf FACTOR

Set number of pointwise precursors to hold in memory in transient simulations. Input values:

FACTOR : The factor to multiply the number of neutrons per batch to obtain the number of pointwise precursors to hold in memory (default value: 10.0)

Notes:

A multiplicative factor for the number of neutrons per batch, i.e. setting FACTOR to 10 when running 1000 neutrons per batch will keep 10000 pointwise precursors in memory.
The number of pointwise precursors held in memory is controlled to the requested number at time interval boundaries. The physical number of precursors is conserved.
Storing a too low of a number of pointwise precursors can lead to undersampling of certain precursor groups or parts of geometry.

set precthresh

set precthresh THRESHOLD

Set the weight threshold for creating and storing a new delayed neutron precursor in transient simulations. Input values:

THRESHOLD : A weight threshold relative to the incoming neutron weight (default value: 1.0)

Notes:

If the weight of the delayed neutron precursor would be below the threshold, Russian roulette is played to either increase the weight to the threshold or not store the precursor at all.
Setting a lower threshold stores more precursors with lower weight whereas a higher threshold stores fewer precursors with higher weight.

set printelsp

set printelsp OPT

Prints out the stopping power data for electrons/positions generated by the thick-target bremsstrahlung model. Input values:

OPT : Option to output the stopping power data from the bremsstrahlung model off (0/no) or on (1/yes), in file [input]_elsp.m. The default option is off.

set printm

set printm MODE [ FRAC ]

Print material compositions to [input].bumat[bu] file during burnup calculation, where "bu" is the burnup step. Input values:

`MODE`	: Set printing on (1/yes) or off (0/no). The default option is off.
`FRAC`	: Optional atomic fraction for printing out decay nuclides, i.e. nuclides with no transport cross sections (default value: 1.0)

Notes:

A FRAC value 0.0 will print out all decay nuclides, while 1.0 will not print out any decay nuclides. Value FRAC will print out nuclides whose atomic fraction in the material is greater than or equal to FRAC.
The feature is outdated and not recommended to be used anymore. All information related to the depletion calculations is collected in the burnup calculation output file [input]_dep.m. For restart calculations, use the binary restart files (see set rfw and set rfr).

set qparam_dbrc

set qparam_dbrc QPARAM

Sets the Q-parameter (confidence interval) for temperature majorants to be used with Doppler-broadening rejection correction (set dbrc option). Input values:

QPARAM : confidence interval

Notes:

The parameter should be adjusted when the DBRC majorant cross section is exceeded frequently
The default value is 2E-5 for the revisited majorant (default method) and reasonable values are within [1E-5, 1E-4]
The default value is 3.0 for the traditional majorant and reasonable values are within [1.0, 10.0]

set qparam_tms

set qparam_tms QPARAM

Sets the Q-parameter (confidence interval) for temperature majorants to be used with target motion sampling method (mat card). Input values:

QPARAM : confidence interval

Notes:

The parameter should be adjusted when the TMS majorant cross section is exceeded frequently
The default value is 2E-5 for the revisited majorant (default method) and reasonable values are within [1E-5, 1E-4]
The default value is 3.0 for the traditional majorant and reasonable values are within [1.0, 10.0]

set relfactor

set relfactor FAC

Sets the underrelaxation factor for the power relaxation used in coupled multi-physics calculations. Input values:

FAC : underrelaxation factor (default value: 1.0)

Notes:

Setting the underrelaxation factor to 0, disables power relaxation altogether. The power distribution written to the output-files will be unrelaxed and only based on the most recent iteration.

set repro

set repro MODE

Sets the reproducibility mode in parallel calculations. Input values:

MODE : reproducibility mode (default value: 1)

The possible settings for mode are:

Mode	Description
`0`	No reproducibility
`1`	Reproducibility with OpenMP parallelization
`2`	Reproducibility with MPI and hybrid OpenMP / MPI parallelization

Notes:

The reproducibility in OpenMP parallelization means that the random number sequences are the same in spite of parallelization. This requires that the histories are calculated always in the same order. This is achieved by sorting the fission banks between batches. With large neutron populations per batches the sorting takes a substantial amount of time which might affect the obtained parallel calculation scalability.
The reproducibility is often a requirement for debugging the program. MODE 2 should only be used for debugging.

set rfr

set rfr STEP FILE [ NFILE ]

set rfr idx I FILE [ NFILE ]

Reads material compositions from a binary restart file. Input values:

`STEP`	: burnup step from which the compositions are obtained
`I`	: burnup step index from which the compositions are obtained
`FILE`	: name of the binary restart file
`NFILE`	: number of restart files (default value: 1)

Notes:

If it is not specified a burnup or days step explicitly by preceding the depletion step value by bu or days, respectively, then, positive values for step are interpreted as burnup units (MWd/kgU) and negative values as time units (days).
The continue option sets the restart at the latest calculated depletion step.
This option can be used together with the set rfw feature for applying changes in the modeled system during burnup calculation.
The name of the binary restart file is invariant to domain decomposition, set dd. It corresponds with the standard name of the restart file (without the _dd[MPIID] suffix).
This option reads a single restart file except if the domain decomposition feature is in place (reading the multiple/split restart files generated from the domain decomposition calculation).
If a non-domain decomposition simulation requires reading the multiple/split restart files from a former one, the number of restart files NFILE should be specified. In any other case, the number of domains/MPI tasks should match between the writing and reading simulations. The material depletion zone divisions between the writing and reading simulations should agree too.

set rfw

set rfw OPT [ FILE ]

Writes material compositions in burnup calculation into a binary restart file. Input values:

`OPT`	: option to switch writing on (0 = no, >0 = yes; with, 1= all nuclides, 2 = transport nuclides). The default option is off.
`FILE`	: name of the binary restart file. The default name is `[input].wrk`.

Notes:

Version 2.2.0 includes the option to select whether to write all nuclides (default behavior in previous versions) or only the transport nuclides. Before OPT was limited to 0/1.
This option can be used together with the set rfr feature for applying changes in the modeled system during burnup calculation
This option when is used with the domain decomposition feature, set dd, generates multiple restart files - as many as domains (MPI tasks) are defined; the files are named adding _dd[mpiid] (domain decomposition identifier) to the standard file name.

set rnddec

set rnddec DEC [ FY DH ]

Option to set decay and fission yield data randomized mode on or off. Input values:

`DEC`	: option to switch randomized decay constants on (1/yes) or off (0/no). The default option is off.
`FY`	: option to switch randomized fission yields on (1/yes) or off (0/no). The default option is off.
`DH`	: option to switch randomized decay heat on (1/yes) or off (0/no). The default option is off.

set root

set root UNI

Sets the root universe. Input values:

UNI : universe name. The default name is "0"

Notes:

Root universe is the universe at the lowest level of the geometry hierarchy, and must always be defined.
For more information, see the detailed description of the universe-based geometry type in Serpent.

set roulette

set roulette W0 P

Sets parameters for weight cut-off and Russian roulette. Input values:

`W0`	: minimum particle weight below which cut-off is applied
`P`	: survival probability for Russian roulette (default value: 0.5)

Notes:

Weight cut-off is applied after each collision.
Can be used together with implicit capture, default value: P = 0.001 (see set impl)

set runtme

set runtme T

Sets the maximum running time for the transport simulation. Input values:

`T`	: wall-clock running time [in minutes]

Notes:

When defined, the transport simulation is terminated after the maximum time is reached.
Setting the parameter does not override the set pop or set nps option.

set samarium

set samarium OPT [ MAT₁ MAT₂ ... ]

Sets equilibrium samarium calculation on or off. Input values:

`OPT`	: option to set equilibrium samarium calculation on (1/yes) or off (0/no). The default option is off.
`MAT_n`	: optional list of materials for which to set the option (on/off). The default option is all fissile materials.

Notes:

Setting equilibrium samarium calculation "off" for a list of materials sets it "on" for all other fissile materials.
The equilibrium concentration is calculated on depletion zone basis. You may want to divide your fuel material into depletion zones
The equilibrium concentration calculation requires the material volumes to be correctly set.
The equilibrium concentration calculation requires the fission yield and decay libraries.
The equilibrium concentration of samarium is updated according to the batching interval set in the set pop card. Having a large batching interval means that the equilibrium concentration may take a large number of cycles to converge.

set savesrc

set savesrc PATH [ PN PP N_X N_Y N_Z ]

Sets up the creation of an initial source to be used in a dynamic simulation with delayed neutron emission. Input values:

`PATH`	: The path of the source file to be created
`PN`	: Fraction of tentative neutrons to save (default value: 1.0)
`PP`	: Fraction of tentative precursors to save (default value: 1.0)
`N_X`	: Precursor mesh size in x-direction (default value: 1)
`N_Y`	: Precursor mesh size in y-direction (default value: 1)
`N_Z`	: Precursor mesh size in z-direction (default value: 1)

Notes:

The tentative fractions for neutrons PN and precursors PP to save only affects the criticality source simulation.
Four source files will be generated [PATH].main, [PATH].prec, [PATH].live and [PATH].precpoints
If used in criticality source simulation, the system should be critical and the values will correspond to steady state values.
If used in a dynamic simulation, the values will correspond to end-of-simulation values
Before version 2.2.0, if you are getting a warning from function WriteSourceFile "P larger than 1", you should lower the PN value.
See Transient simulations.

set sca

set sca NI NB MSH 
     MIN₁ MAX₁ SZ₁
     MIN₂ MAX₂ SZ₂
     MIN₃ MAX₃ SZ₃
     [ SUB₁ SUB₂ SUB₃ LIM ]

set sca NI NB MSH 
    X₀ Y₀   
    P NX NY
    MIN₃ MAX₃ SZ₃
    [ SUB₁ SUB₂ SUB₃ LIM ]

Invokes a response matrix solver to obtain an improved source guess for criticality source simulations. Input values:

`NI`	: Number of outer iterations
`NB`	: Number of source batches to collect results
`MSH`	: mesh type (1 = Cartesian, 2 = Cylindrical, 4 = x-type hexagonal, 5 = y-type hexagonal)
`MIN_n`	: minimum mesh boundary (n-th coordinate)
`MAX_n`	: maximum mesh boundary (n-th coordinate)
`SZ_n`	: number of mesh cells (n-th coordinate)
`X₀, Y₀`	: mesh center of hexagonal mesh (currently must be centered at the origin)
`P`	: hexagonal cell pitch
`NX, NY`	: hexagonal mesh size
`SUB_n`	: number of sub-mesh cells (nth coordinate)
`LIM`	: convergence criterion (typical value: 1E-12)

Notes:

The solver is used to accelerate fission source convergence.
Cartesian and cylindrical mesh are defined by outer mesh boundaries and number of mesh cells.
The coordinate axes 1, 2 and 3 in Cartesian mesh refer to (x,y,z) and in cylindrical mesh to (r,θ,z), with θ given in degrees.
The hexagonal mesh is defined by mesh center, cell pitch, number of cells in the radial dimensions (similar to the hexagonal lattice) and axial binning.
The mesh must be defined slightly larger than the geometry (the mesh boundaries should not coincide with the geometry boundaries).
Sub-division is used to improve the solution inside mesh cells.
The methodology is described in a related article.^[15]
The methodology is still under development and, the input syntax may change in future updates.

set seed

set seed RNG [ NBTCH ]

Sets the seed value for the random number sequence. Input values:

`RNG`	: seed value used for the random number sequence
`NBTCH`	: starting batch (positive value) or history (negative value)

Notes:

By default, Serpent gets the RNG seed from system time. This option overrides the value.

set sfbuf

set sfbuf SIZE

Sets the size of the source file buffer including, e.g., criticality source, secondary photon source, detector source or dynamic source modes. Input values:

SIZE : buffer size

set sfrate

set sfrate S [ MAT ]

Sets normalization to total spontaneous fission rate. Input values:

`S`	: number of spontaneous fission reactions per second [in 1/s]
`MAT`	: dummy parameter

Notes:

Normalization is needed to relate the Monte Carlo reaction rate estimates to a user-given parameter.
The default normalization is set: to unit total loss rate (neutron transport) and to unit total source rate (photon transport).
In coupled neutron-photon transport simulations the normalization is driven by the neutron normalization.
For other normalization options, see: set power, set powdens, set flux, set genrate, set fissrate, set absrate, set lossrate, set srcrate, set sfrate.
See also Section 5.8 of Serpent 1 User Manual.

set sfylib

set sfylib LIB₁ [ LIB₂ LIB₃ ... ]

Sets the spontaneous fission yield library file paths. Input values:

LIB_n : library file paths

Notes:

Spontaneous fission yield libraries are standard ENDF format files^[3] containing spontaneous fission yield data.
If the file path contains special characters it is advised to enclose it within quotes

set shbuf

set shbuf [ OPT_BUF OPT_RES2 ]

Option to use a shared or private scoring buffer or results array. Input values:

`OPT_BUF`	: use shared (1/yes) or private (0/no) scoring buffer (BUF, default private)
`OPT_RES2`	: use shared (1/yes) or private (0/no) results array (RES2, default shared)

Notes:

Serpent stores scores in a temporary buffer, which in OpenMP parallel mode can be either private (each thread writes in its own buffer) or shared (all threads write in same buffer using atomic operations). Using private buffers increases memory usage to some extent, but it should improve scalability since no barriers need to be set to protect memory.
Memory consumption of shared RES2 is usually larger than that of shared BUF.

set sie

set sie ITER

Chooses the Stochastic Implicit Euler burnup scheme to be used for the burnup calcualtion. Input values:

ITER : tolerance (negative value) or maximum number of iterations (positive value) for each burnup step

Notes:

The SIE burnup scheme is mainly intended for burnup calculations that develop instabilities using the default predictor corrector methods.
The convergence criteria is set either by the tolerance or the maximum number of iterations. If the tolerance is given, ITER < 0, the maximum number of iterations is set to 500. If the maximum number iterations is given, ITER > 0, the tolerance is set to 0.0.

set sourcescale

set sourcescale NB SF₁ SF₂ ...

Defines a time-interval dependent source scaling factor in dynamic external source calculations (set dynsrc). Input values:

`NB`	: number of time intervals
`SF_n`	: time-interval-wise source scaling factor

Notes:

The number of time-intervals NB should match the definition of the time-bin structure (see tme card)

set spa

set spa CMAP [ FRAC ]

Sets parameters for the source point animation. Input values:

`CMAP`	: color map used for plotting the source point animation
`FRAC`	: fraction for the color scheme, ratio minimum/maximum (default value: 1.0)

Notes:

The color maps are: 1 - hot; 2 - cold; 4 - jet; 5 - black and white; 6 - hsv; 7 - spring; 8 - summer; 9 - autumn; 10 - winter; 11 - green-purple; 12 - purple-orange; 13 - blue-red. Many of these correspond to what is used in Matlab.

set spd

set spd V_n V_p

Overrides the speed of simulated particles. Input values:

V_n	: speed of neutrons [in cm/s]
V_p	: speed of photons [in cm/s]

Notes:

This option is intended for adjusting particle speeds for better visualization in track plot animations.
Adjusting the speed (obviously) results in incorrect estimates for all time constants.
Exceeding the speed of light causes a fatal error in debug mode.

set srcrate

set srcrate S

Sets normalization to total source rate. Input values:

`S`	: source rate [in particles/s]

Notes:

Normalization is needed to relate the Monte Carlo reaction rate estimates to a user-given parameter.
The default normalization is set: to unit total loss rate (neutron transport) and to unit total source rate (photon transport).
In coupled neutron-photon transport simulations the normalization is driven by the neutron normalization.
For other normalization options, see: set powdens, set power, set flux, set genrate, set fissrate, set absrate, set lossrate, set sfrate.
See also Section 5.8 of Serpent 1 User Manual.

set stl

set stl EXD NLOOP

Sets options for a STL geometry model. Input values:

`EXD`	: facet uncertainty margin or exclusion distance (default value: 1.0E-05)
`NLOOP`	: maximum number of trials (default value: 1000)

Notes:

Delta-tracking is enforced by default in STL geometries.

set stlfile

set stlfile OPT

Sets option to read and write STL search mesh into a binary file, [input].smh. Input values:

OPT : option to switch reading/writing on (1/yes) or off (0/no). The default option is off.

set syscom

set syscom PT COMMAND

Sets option to execute a user-defined system command at given break point. Input values:

`PT`	: break point (1 = after reading the input, 2 = after reading the cross section data)
`COMMAND`	: user-defined system command

Notes:

The feature allows to work with compressed cross section data libraries: the data is decompressed to be read and compressed back right after (minimizing the disc memory demand).
This option comes in handy when a large number of cross section data libraries are in use, e.g., in systematic calculations for nuclear data uncertainty evaluation.

set tcut

set tcut T_max

Sets time cut-off for neutrons and photons. Input values:

T_max : time limit for simulated particle histories [in s] (default value: INFTY)

Notes:

The time cut-off can be used in both neutron and photon external source simulations, to limit the length of particle histories.
Time or generation cut-off (set gcut) is always needed for neutron external source simulations in super-critical systems.
Time cut-off is automatically set in the dynamic external source simulation mode.
Note to developers: this should take independent values for photons and neutrons

set title

set title NAME

Sets a title for the calculation. Input values:

NAME : title used for the calculation

Notes:

The title is printed in the run-time output. If the title is not set, the input file name is printed instead.

set tpa

set tpa T_min T_max TAIL NF EVB

Sets parameters for track plot animation. Input values:

`T_min`	: starting time of track plot animation [in s]
`T_max`	: end time of track plot animation [in s]
`TAIL`	: tail length of plotted particles [in cm]
`NF`	: number of frames
`EVB`	: event bank size

Notes:

The track plot animation works with the geometry plotter by creating a number of frames that visualize the motion of particles through the geometry.
The track plotter is invoked using the -tracks N command line option, where N is the number of simulated particle histories (if the set tpa option is not defined, the code plots particle tracks in a geometry plot output).
The routine produces NF frames [input]_trck[n]_frame[m].png, where "n" is an index corresponding to the geometry plot and "m" is the frame index. The frames can be converted into a gif animation using tools like Imagemagick.
The plotted particles have a tail to better visualize their movement from one collision to the next. The length of this tail is given in centimeters (similar to geometry dimensions). Neutrons are plotted in magenta, photons are plotted in green.
Storing the simulated collision points requires additional memory, determined by the event bank size. If the given size is insufficient the calculation is terminated with an error message ("Event bank is empty").
Producing track plot animations may require adjusting the particle buffers (set nbuf and set gbuf).
The calculation may require a lot of memory for storing the complete simulated histories in neutron-multiplying systems or when particles are split by variance reduction.
Motion of thermal and fast neutrons cannot be captured simultaneously because of the several orders of magnitude difference in their speed. Thermal systems are best visualized by enforcing all neutrons to travel at the same speed using the set spd option.
See also detailed description on track plotter and track plot animation.

set transmurea

set transmurea ZAI₁ MT₁ ZAI₂ MT₂ ...

Overrides the automatically generated transmutation paths with a user-provided list of reactions. Input values:

`ZAI_n`	: nuclide identifier.
`MT_n`	: reaction identifier (ENDF reaction MT).

Notes:

The transmutation chains in burnup calculation are by default generated automatically. This option overrides the behavior by including only the reactions included on the list.
The reactions are given as nuclide identifier - reaction identifier pairs, for example, the radiative capture cross section of ²³⁸U would be 922380 102.
The nuclide ID can be replaced with "all", in which case all reactions of the type are included.

set transnorm

set transnorm FACTOR

Multiplies the normalization from a transient source linked with set dynsrc by a factor. Input values:

FACTOR : factor to multiply the normalization with (default value: 1.0)

Notes:

The normalization in transient simulations is, by default, the same as in the transient criticality source generation calculation.
See separate description of transient simulations.

set transtime

set transtime FLAG

Sets the evaluation method applied to time dependent transformations. Input values:

FLAG : time dependent transformation evaluation method option (default value: 0)

Notes:

The option "0" evaluates the transformation using the beginning time of the time-interval being simulated (geometry static for each time interval).
The option "1" evaluates the transformation using the time when the tracking of the neutron being simulated began (geometry static for each neutron lifetime), resulting in a much smoother transformation.

set trc

set trc MAT FILE E_min [ ZAI₁ ZAI₂ ... ]

Defines transport correction for the calculation of transport cross section and diffusion coefficient. Input values:

`MAT`	: material to which the correction is applied
`FILE`	: file path to correction curve data
`E_min`	: minimum energy above which the correction is applied [in MeV]
`ZAI_n`	: nuclide identifiers (ZAI)

Notes:

The method calculates transport cross sections by multiplying material total cross sections by a user-defined energy-dependent transport correction ratio before collapsing the energy variable. These transport cross sections are used for calculating diffusion coefficients as $D = 1/3\Sigma_\mathrm{tr}$ .
If the correction ratios are properly defined, the transport cross section is equivalent with the in-scattering approximation.
The out-scattering approximation of transport cross section is used for materials without defined correction ratios and energies below the given minimum energy.
The produced homogenized cross sections are written in variables TRC_TRANSPXS and TRC_DIFFCOEF in the [input]_res.m and [input].coe output files.
See separate description of correction factor file format.
If nuclide identifiers are given the transport correction is applied only to the total cross sections of these nuclides in the given material. In this case the correction should also be given as the ratio of the sum of transport cross sections of these nuclides and the sum of total cross sections of these nuclides. Otherwise the correction is applied to the total cross section of the material.
Method can not be used for divided or burnable materials for the time being.

set ttacut

set ttacut TTACUT

Sets cut-off for linear chains method (TTA) based on passage. Input values:

TTACUT : linear chains method (TTA) cut-off (default value: 1.0E-28)

Notes:

Setting TTACUT cut-off to a higher value serves as a termination criterion where any chain accounting for less than the fraction TTACUT of the total atomic density is ignored.

set ttb

set ttb OPT

Sets the thick-target bremsstrahlung approximation for modelling electrons and positrons on and off. Input values:

OPT : option to set thick-target bremsstrahlung approximation off (0/no) or on (1/yes). The default option is on.

set ttbpm

set ttbpm OPT

Sets a separate bremsstrahlung model for positrons. Input values:

OPT : option to set a separate bremsstrahlung model off (0/no) or on (1/yes). The default option is on.

set ufs

set ufs MODE ORDER N_X N_Y N_Z

set ufs MODE ORDER LAT N_Z Z_MIN Z_MAX

set ufs MODE ORDER N_X X_MIN X_MAX N_Y X_MIN X_MAX N_Z Z_MIN Z_MAX

Turns on the uniform fission source method. Input values:

`MODE`	: reaction rate for the weighted mesh distribution (1 = total (collision), 2 = flux, 3 = fission)
`ORDER`	: exponential factor to adjust the steepness of the distribution
`N_X`	: number of x-mesh cells
`X_MIN`	: minimum x-coordinate mesh boundary [in cm]
`X_MAX`	: maximum x-coordinate mesh boundary [in cm]
`N_Y`	: number of y-mesh cells
`Y_MIN`	: minimum y-coordinate mesh boundary [in cm]
`Y_MAX`	: maximum y-coordinate mesh boundary [in cm]
`N_Z`	: number of z-mesh cells
`Z_MIN`	: minimum z-coordinate mesh boundary [in cm]
`Z_MAX`	: maximum z-coordinate mesh boundary [in cm]
`LAT`	: lattice name defining the mesh structure

Notes:

The UFS method collects the reaction rate distribution during inactive neutron cycles and adjust the number of emitted fission neutrons during the active cycles by a factor for a given mesh cell i: $\overline{f_j^r} / f_i^r$ for f the distribution and r the exponential factor.
The mesh definition can cover the whole geometry (type 1 definition, 3 parameters), be fixed to a lattice (type 2 definition, 4 parameters) or delimited within a region by the number of mesh cells and boundaries in x-, y- and z- directions (type 3 definition, 9 parameters).
The lattice definition fixes the mesh structure in x- and y- directions. The lattice can be 2D square or hexagonal type defined in the global coordinate system.
By defining the exponential factor ORDER to "1.0", the method results in a relatively uniform distribution of source points.
The uniform fission source method only has applicability in criticality calculations.
An additional mode, MODE 4, has been set to use the uniform fission method coupled with the built-in response matrix solver. The mesh definition is carried out by the response matrix mesh, see see set sca. (The exponential factor is set to 1.0).

set ures

set ures OPT [ NUC₁ NUC₂ ...  ][ DILUCUT ]

Sets unresolved resonance probability table sampling on or off. Input values:

`OPT`	: option to switch probability table sampling on (1/yes) or off (0/no). The default option is off.
`NUC_n`	: list of nuclides to which the option is applied to, e.g. "92238.09c". Setting unresolved resonance probability table sampling off for a list of nuclides will set it on for the rest of the nuclides.
`DILUCUT`	: infinite dilution cut-off (default value: 1.0E-9)

Notes:

The infinite dilution cut-off DILUCUT defines a limit for atomic fractions, and probability table sampling is used only for nuclides with concentration above this limit.
See separate description of physics options in Serpent for differences to other codes.

set usym

set usym UNI AX BC X₀ Y₀ θ₀ θ_w [ OPT ]

Defines a universe symmetry. Input values:

`UNI`	: universe name
`AX`	: symmetry axis (1 = x, 2 = y, 3 = z)
`BC`	: boundary condition (2 = reflective, 3 = periodic)
`X₀`	: x-coordinate of the origin [in cm]
`Y₀`	: y-coordinate of the origin [in cm]
`θ₀`	: azimuthal position where the symmetry segment starts [in degrees]
`θ_w`	: width of the segment [in degrees]
`OPT`	: option to use actual reflections and translations instead of coordinate transformations

Notes:

Universe symmetries can be used to simplify construction of complex geometries.
Symmetries can also be used to reduce the number of burnable material zones when automated depletion zone division is applied.
When symmetries are used, it is important to pay attention to the definition of material volumes.
When using symmetries together with lattices, the lattice positions overlapped by the symmetry should remain empty of fuel pins for example to prevent excess memory usage during depletion calculations.
Universe symmetries are applied by default using coordinate transformations. This means that the particle position and direction are not affected during tracking. This behavior can be overridden by setting the last option to "1".
The values of surface current and flux detectors and values produced by for example by set adf cards might not be correct when using actual reflections and transformations.
Track plots do not work properly with actual reflections and translations.
For more information, see examples on universe symmetries.
The supported Serpent 1 syntax-style: set usym UNI SYM [ X₀ Y₀ ] allows only quadrant symmetries (SYM = 4) in universe 0 (UNI = 0) centred in origin (X₀, Y₀) = (0,0).

set U235H

set U235H U235_FISSE

Sets the U-235 fission heating value. Input values:

U235_FISSE : fission heating value of U-235 [in MeV] (default value: 202.27)

Notes:

By default the U-235 fission heating value is set to 202.27 MeV and the values for other actinides scaled based the Q-values found in the cross section libraries.
See also set fissh.
See also Section 5.8 of Serpent 1 User Manual.

set voidc

set voidc OPT

Option that enables removing void cells to accelerate particle tracking in complex geometries with numerous void. Input values:

OPT : option to switch the removal mode on (1/yes) or off (0/no). The default option is off.

set wrnout

set wrnout OPT

Option that enables the generation of a warning-message output file. Input values:

OPT : option to switch the removal mode on (1/yes) or off (0/no). The default option is on.

Notes:

The warning-message output file [input].wrn collects, as a replica, the errors/warnings/notes printed out in the main (screen) output.

set wie

set wie FRAC_ITER

Option that enables the Wielandt’s method to accelerate the convergence of the fission source by setting the initial fraction iteration condition. Input values:

FRAC_ITER : initial guess of the probability of banking the neutron (negative value, ]-1, 0[) or the shifted eigenvalue (positive value, [0.5, 3])

set wwb

set wwb LO UP [ F ]

Defines the relation between importances and weight-window boundaries. Input values:

`LO`	: factor relating the lower weight-window boundary to importance (default value: 0.5)
`UP`	: factor relating the upper weight-window boundary to importance (default value: 2.0)
`F`	: Russian roulette survival probability factor (default value: 1.0)

Notes:

Weight window boundaries are inversely proportional to importance. These factors define the coefficients.
See also weight window mesh definition.

set xenon

set xenon OPT [ MAT₁ MAT₂ ... ]

Sets equilibrium xenon calculation on or off. Input values:

`OPT`	: option to set equilibrium xenon calculation on or off (0 = off/no, >0 = on/yes; with 1= include only ¹³⁵Xe, 2 = include ¹³⁵Xe and ^135mXe). The default option is off.
`MAT_n`	: optional list of materials for which to set the option (on/off). The default option is all fissile materials.

Notes:

Setting equilibrium xenon calculation "off" for a list of materials sets it "on" for all other fissile materials.
The equilibrium xenon concentration calculation forces the xenon number density to be in equilibrium with the current flux and xenon absorption level during the transport calculation.
The equilibrium xenon concentration calculation is meant for example to stabilize the burnup calculations.
The equilibrium concentration is calculated on depletion zone basis. You may want to divide your fuel material into depletion zones
The equilibrium concentration calculation requires the material volumes to be correctly set.
The equilibrium concentration calculation requires the fission yield and decay libraries.
The equilibrium concentration of xenon is updated according to the batching interval set in the set pop card. Having a large batching interval means that the equilibrium concentration may take a large number of cycles to converge.

set xscalc

set xscalc MODE

Calculation mode for transmutation cross sections. Input values:

MODE : Calculation mode (1 = direct tallies, 2 = spectrum-collapse)

Notes:

This parameter controls the way transmutation cross sections are calculated in burnup mode. In spectrum-collapse mode these cross sections are calculated after the transport simulation, using a fine-group spectrum collected for each material.
The spectrum-collapse mode leads to improved performance, but also increased memory footprint per depletion zone.
The option is automatically set when using optimization modes, and it is not recommended to be defined manually.
Many of the old example input files set spectrum collapse method on, which overrides the behaviour in lower optimization modes.
See also set opti.

set xsplot

set xsplot NP E_min E_max

Prints cross section data to [input]_xs0.m file. Input values:

`NP`	: Number of energy points to print (minimum value: 10).
`E_min`	: Lower boundary for the energy points [in MeV]
`E_max`	: Upper boundary for the energy points [in MeV]

The cross sections will be printed out at NP logarithmically spaced points between the energy boundaries.

References

^ Leppänen, J. "Serpent – a Continuous-energy Monte Carlo Reactor Physics Burnup Calculation Code." User manual, June 18, 2015.
^ Kulesza, J. A. (ed.), “MCNP code version 6.3.0 Theory & User Manual: Appendix A Mesh-Based WWINP, WWOUT, and WWONE File Format,” LA-UR-22-30006, Rev. 1, Los Alamos National Laboratory (2022).
^ Trkov, A., Herman, M. and Brown, D. A. "ENDF-6 Formats Manual." CSEWG Document ENDF-102 / BNL-90365-2009 Rev. 2 (2018)
^ Leppänen, J. "On the use of delta-tracking and the collision flux estimator in the Serpent 2 Monte Carlo particle transport code." Ann. Nucl. Energy 105 (2017) 161-167.
^ Wieselquist, W. A. and Lefebvre, R. A (ed.), "SCALE 6.3.1 User Manual: Sensitivity and Uncertainty Analysis - Appendix 6.3.4.1.6. COVERX format", ORNL/TM-SCALE-6.3.1, UT-Battelle, LLC, Oak Ridge National Laboratory, Oak Ridge, TN (2023)
^ Leppänen, J. "Two practical methods for unionized energy grid construction in continuous-energy Monte Carlo neutron transport calculation." Ann. Nucl. Energy 36 (2009) 878-885.
^ Tuominen, R., Valtavirta, V. and Leppänen, J. "New energy deposition treatment in the Serpent 2 Monte Carlo transport code." Ann. Nucl. Energy 129 (2019) 224-232.
^ Dufek, J. and Tuttelberg, K. "Monte Carlo criticality calculations accelerated by a growing neutron population." Ann. Nucl. Energy 94 (2016) 16-21.
^ "Chernobyl: Assessment of Radiological and Health Impacts", OECD/NEA2002 (2002)
^ "Spent Nuclear Fuel Assay Data for Isotopic Validation", NEA/NSC/WPNCS/DOC(2011)5 (2011)
^ "The identification of radionuclides relevant to long-term waste management in th United Kingdom", Nirex Report no. N/105 (2004)
^ Valtavirta, V. and Leppänen, J. "A novel Monte Carlo leakage correction for Serpent 2", In proceedings of ANS M&C 2021. Raleigh, NC, USA. October 3-7, 2021
^ Rintala, A., Valtavirta, V. and Leppänen, J. "Microscopic cross section calculation methodology in the Serpent 2 Monte Carlo code." Ann. Nucl. Energy 164 (2021) 108603
^ Leppänen, J. and Isotalo, A. "Burnup calculation methodology in the Serpent 2 Monte Carlo code." In proc. PHYSOR 2012, Knoxville, TN, Apr. 15-20, 2012.
^ Leppänen, J. "Acceleration of fission source convergence in the Serpent 2 Monte Carlo code using a response matrix based solution for the initial source distribution." Ann. Nucl. Energy 128 (2019) 63-68

[manual-1] Leppänen, J. "Serpent – a Continuous-energy Monte Carlo Reactor Physics Burnup Calculation Code." User manual, June 18, 2015.

[2] Kulesza, J. A. (ed.), “MCNP code version 6.3.0 Theory & User Manual: Appendix A Mesh-Based WWINP, WWOUT, and WWONE File Format,” LA-UR-22-30006, Rev. 1, Los Alamos National Laboratory (2022).

[endf-3] Trkov, A., Herman, M. and Brown, D. A. "ENDF-6 Formats Manual." CSEWG Document ENDF-102 / BNL-90365-2009 Rev. 2 (2018)

[cfe-4] Leppänen, J. "On the use of delta-tracking and the collision flux estimator in the Serpent 2 Monte Carlo particle transport code." Ann. Nucl. Energy 105 (2017) 161-167.

[coverx-5] Wieselquist, W. A. and Lefebvre, R. A (ed.), "SCALE 6.3.1 User Manual: Sensitivity and Uncertainty Analysis - Appendix 6.3.4.1.6. COVERX format", ORNL/TM-SCALE-6.3.1, UT-Battelle, LLC, Oak Ridge National Laboratory, Oak Ridge, TN (2023)

[dix-6] Leppänen, J. "Two practical methods for unionized energy grid construction in continuous-energy Monte Carlo neutron transport calculation." Ann. Nucl. Energy 36 (2009) 878-885.

[edep-7] Tuominen, R., Valtavirta, V. and Leppänen, J. "New energy deposition treatment in the Serpent 2 Monte Carlo transport code." Ann. Nucl. Energy 129 (2019) 224-232.

[gpop-8] Dufek, J. and Tuttelberg, K. "Monte Carlo criticality calculations accelerated by a growing neutron population." Ann. Nucl. Energy 94 (2016) 16-21.

[9] "Chernobyl: Assessment of Radiological and Health Impacts", OECD/NEA2002 (2002)

[soar-10] "Spent Nuclear Fuel Assay Data for Isotopic Validation", NEA/NSC/WPNCS/DOC(2011)5 (2011)

[11] "The identification of radionuclides relevant to long-term waste management in th United Kingdom", Nirex Report no. N/105 (2004)

[mckeak-12] Valtavirta, V. and Leppänen, J. "A novel Monte Carlo leakage correction for Serpent 2", In proceedings of ANS M&C 2021. Raleigh, NC, USA. October 3-7, 2021

[13] Rintala, A., Valtavirta, V. and Leppänen, J. "Microscopic cross section calculation methodology in the Serpent 2 Monte Carlo code." Ann. Nucl. Energy 164 (2021) 108603

[opti-14] Leppänen, J. and Isotalo, A. "Burnup calculation methodology in the Serpent 2 Monte Carlo code." In proc. PHYSOR 2012, Knoxville, TN, Apr. 15-20, 2012.

[15] Leppänen, J. "Acceleration of fission source convergence in the Serpent 2 Monte Carlo code using a response matrix based solution for the initial source distribution." Ann. Nucl. Energy 128 (2019) 63-68

[1]

[2]

[3]

[4]

[5]

[6]

[7]

[8]

[9]

[10]

[11]

[12]

[13]

[14]

[15]

@@ Line 4,493: / Line 4,493: @@
 <u>Notes:</u>
-*The default option is "0/condensed" and only affects mixtures.
+*The default option to run the simulation with is "0/condensed" and only affects mixtures.
 *The gas phase does not affect the mean excitation energy of a single material: if [[#set elmee|set elmee]] option is set for a material, the material is considered as non-gas.

Difference between revisions of "Input syntax manual"

Revision as of 14:14, 27 May 2023

Contents

Input cards

branch (branch definition)

casematrix (casematrix definition)

cell (cell definition)

coef (coefficient matrix definition)

datamesh (general data mesh definition)

dep (depletion history)

det (detector definition)

div (divisor definition)

dtrans (detector mesh transformation)

ene (energy grid definition)

ftrans (fill transformation)

fun (function definition)

hisv (history variation matrix definition)

ifc (interface file)

include (read another input file)

lat (regular lattice definition)

ltrans (lattice transformation)

mat (material definition)

mesh (mesh plot definition)

mflow (material flow definition)

mix (mixture definition)

nest (nested universe definition)

particle (particle geometry definition)

pbed (explicit stochastic (pebble bed) geometry definition)

phb (pulse-height Gaussian energy broadening definition)

pin (pin geometry definition)

plot (geometry plot definition)

rep (reprocessor definition)

sample (temperature / density data sample definition)

sens (sensitivity calculation definition)

solid (irregular 3D geometry definition)

src (source definition)

srtrans (source transformation)

strans (surface transformation)

surf (surface definition)

therm and thermstoch (thermal scattering)

tme (time binning definition)

trans (transformations)

transb (burnup transformation)

transv and transa (velocity and acceleration transformations)

umsh (unstructured mesh-based geometry definition)

utrans (universe transformation)

voro (stochastic Voronoi tessellation geometry definition)

wwgen (response matrix based importance map solver)

wwin (weight window mesh definition)

Input options

set absrate

set acelib

set adf

set alb

set arr

set ba

set bala

set bc

set blockdt

set bralib

set branchless

set bumode

set bunorm

set ccmaxiter

set ccmaxpop

set cdop

set cea

set cfe

set cmm

set coefpara

set combing

set comfile

set confi

set coverxlib

set covlib

set cpd

set cpop

set csw

set dataout

set dbrc