Difference between revisions of "Installing and running Serpent"

From Serpent Wiki
Jump to: navigation, search
(Miscellaneous input options)
(Elemental decomposition)
Line 76: Line 76:
 
=== Elemental decomposition ===
 
=== Elemental decomposition ===
  
This command line option can be used to decompose natural elements in [[Input syntax manual#mat (material definition)|material cards]] into individual isotopes. The parameters include the element symbol and density or fraction (positive values for atomic and negative values for mass densities / fractions). Optional third parameter is the nuclide id, which is printed after the nuclide ZA. The usage is illustrated below with examples.
+
This command line option can be used to decompose natural elements in [[Input syntax manual#mat (material definition)|material cards]] into individual isotopes. The parameters include the element symbol and density or fraction (positive values for atomic and negative values for mass densities / fractions). Optional third parameter is the library ID, which is printed after the nuclide ZA. The usage is illustrated below with examples.
  
 
Decomposing natural zirconium with mass 97.5% mass fraction:
 
Decomposing natural zirconium with mass 97.5% mass fraction:

Revision as of 19:48, 15 September 2016

Compiling the source code

Compiler options

Running Serpent

Serpent is run from the Linux command line interface. The general syntax is:

sss2 INPUT [ options ]

Where INPUT is the input file name and the available options are:

-version  : print version information and exit
-replay  : run simulation using random number seed from a previous run
-his  : run only burnup history in coefficient calculation
-coe  : run only restarts in coefficient calculation
-plot  : stop after geometry plot
-checkvolumes N  : calculate Monte Carlo estimates for material volumes by sampling N random points in the geometry (see detailed description)
-checkstl N M  : check for holes and errors in STL geometries by sampling M directions in N points (see detailed description)
-mpi N  : run simulation in MPI mode using N parallel tasks
-omp N  : run simulation in OpenMP mode using N parallel threads
-disperse  : generate random particle or pebble distribution files for HTGR calculations (see detailed description)
-rdep  : read binary depletion file from previous calculation and print new output according to inventory list
-tracks N  : draw N particle tracks in the geometry plots or invoke track plot animation
-comp MAT [ ID ]  : print standard material composition of listed material MAT that can be copy-pasted into the inputfile (see detailed description)
-elem SYM DENS [ ID ]  : decomposes natural element identified by symbol SYM at density DENS into its constituent isotopes (see detailed description)
-qp  : quick plot mode (ignore overlaps)
-nofatal  : ignore fatal errors

Most of the input options are self-explanatory, the rest are described below.

Running parallel calculations

Miscellaneous input options

Monte Carlo volume calculation routine

Checking for holes in STL geometries

Particle disperser routine

Standard compositions

Elemental decomposition

This command line option can be used to decompose natural elements in material cards into individual isotopes. The parameters include the element symbol and density or fraction (positive values for atomic and negative values for mass densities / fractions). Optional third parameter is the library ID, which is printed after the nuclide ZA. The usage is illustrated below with examples.

Decomposing natural zirconium with mass 97.5% mass fraction:

sss2 -elem Zr -0.975 06c

Isotopic composition for natural zirconium:

 40090.06c  -4.94385E-01
 40091.06c  -1.09014E-01
 40092.06c  -1.68461E-01
 40094.06c  -1.74438E-01
 40096.06c  -2.87019E-02

The isotopic fractions sum up to -0.975. Note that data for all nuclides may not be found in the Serpent cross section libraries. Similarly, decomposition of natural boron into atomic fractions:

sss2 -elem B 1.0 

Isotopic composition for natural boron:

  5010  1.99000E-01
  5011  8.01000E-01

The library ID is omitted.