|
| 1 | +[](https://github.com/shimwell/data/actions/workflows/test_urls.yml) |
| 2 | + |
| 3 | +[](https://github.com/openmc-data-storage/openmc_data/actions/workflows/test_package.yml) |
| 4 | + |
| 5 | +[](https://github.com/openmc-data-storage/openmc_data/actions/workflows/test_processing.yml) |
| 6 | + |
| 7 | + |
| 8 | +# OpenMC Data Scripts |
| 9 | + |
| 10 | +This repository contains a collection of scripts for generating HDF5 data |
| 11 | +libraries and xml chain files that can be used with OpenMC. Some of these |
| 12 | +scripts convert existing ACE libraries (such as those produced by LANL) whereas |
| 13 | +generate scripts use NJOY to process ENDF files directly. |
| 14 | + |
| 15 | +Another source of data libraries for OpenMC is the [Windowed Multipole Library](https://github.com/mit-crpg/WMP_Library) repository which enables on-the-fly Doppler broadening to an arbitrary temperature. |
| 16 | + |
| 17 | +# Prerequisites |
| 18 | + |
| 19 | +You should have already installed OpenMC, see the [docs](https://docs.openmc.org/en/stable/quickinstall.html) for installation instructions. |
| 20 | + |
| 21 | +# Installation |
| 22 | + |
| 23 | +Currently the package can be installed from this temporary repository. |
| 24 | + |
| 25 | +```bash |
| 26 | +pip install openmc_data |
| 27 | +``` |
| 28 | + |
| 29 | +# Usage |
| 30 | + |
| 31 | +Once installed several scripts are available in your terminal that are able to |
| 32 | +download and process nuclear data. |
| 33 | + |
| 34 | +The scripts accept input arguments, to find out the input arguments available |
| 35 | +for a particular script run the script name with ```--help``` after the name. |
| 36 | +For example: |
| 37 | + |
| 38 | +```convert_endf --help``` |
| 39 | + |
| 40 | +Some scripts (mainly the generate scripts) require NJOY to be installed and |
| 41 | +added to your path. |
| 42 | + |
| 43 | +A few categories of scripts are available: |
| 44 | +<ul> |
| 45 | +<li>Scripts that produce h5 cross section files:</li> |
| 46 | +<ul> |
| 47 | + <li>Convert ACE files to h5 files</li> |
| 48 | + <li>Generate h5 file from ENDF files</li> |
| 49 | + <li>Download h5 files</li> |
| 50 | +</ul> |
| 51 | +<li>Scripts that produce xml chain files:</li> |
| 52 | +<ul> |
| 53 | + <li>Generate xml chain files from ENDF files:</li> |
| 54 | + <li>Download xml chain files:</li> |
| 55 | +</ul> |
| 56 | +<li>Other scripts that don't fall into either category.</li> |
| 57 | +</ul> |
| 58 | + |
| 59 | +## Produce Cross Section Files |
| 60 | + |
| 61 | +### Convert cross sections |
| 62 | + |
| 63 | +| Script name | Library | Release | Processed by | |
| 64 | +|-|-|-|-| |
| 65 | +|convert_mcnp70 | ENDF/B | VII.0 | LANL | |
| 66 | +|convert_mcnp71 | ENDF/B | VII.1 | LANL | |
| 67 | +|convert_endf | ENDF/B | VII.1 | NNDC | |
| 68 | +|convert_lib80x | ENDF/B | VIII.0 | LANL | |
| 69 | +|convert_fendl | FENDL | 3.2b<br>3.2a<br>3.2<br>3.1d<br>3.1a<br>3.1<br>3.0<br>2.1 | |
| 70 | +|convert_jeff32 | JEFF | 3.2 | |
| 71 | +|convert_jeff33 | JEFF | 3.3 | |
| 72 | +|convert_tendl | TENDL | 2015<br>2017<br>2019<br>2021 | |
| 73 | + |
| 74 | +### Generate cross sections |
| 75 | + |
| 76 | +| Script name | Library | Release | Processed by | |
| 77 | +|-|-|-|-| |
| 78 | +| generate_cendl | CENDL | 3.1<br>3.2 | | |
| 79 | +| generate_endf | ENDF/B | VII.1<br>VIII.0 | NNDC | |
| 80 | +| generate_fendl | FENDL | 3.2b<br>3.2a<br>3.2<br>3.1d<br>3.1a<br>3.0 | | |
| 81 | +| generate_jendl | JENDL | 4.0<br>5.0 | | |
| 82 | + |
| 83 | + |
| 84 | +### Download cross sections |
| 85 | + |
| 86 | +| Script name | Library | Release | Processed by | |
| 87 | +|-|-|-|-| |
| 88 | +| download_endf | ENDF/B | VII.1<br>VIII.0 | NNDC | |
| 89 | +| download_tendl | TENDL | 2019<br>2021 | | |
| 90 | + |
| 91 | +<!-- | Script name | Library | Release | Processed by | Download available | Downloads ACE files and convert to HDF5 | Downloads ENDF files and convert to HDF5 | Convert local ACE files | |
| 92 | +|-|-|-|-|-|-|-|-| |
| 93 | +|generate_cendl| CENDL | 3.1<br>3.2 | | | | :heavy_check_mark: | | |
| 94 | +|convert_mcnp70| ENDF/B | VII.0 | LANL | [openmc.org](https://anl.box.com/shared/static/t25g7g6v0emygu50lr2ych1cf6o7454b.xz) | | | :heavy_check_mark: | |
| 95 | +|convert_mcnp71| ENDF/B | VII.1 | LANL | [openmc.org](https://anl.box.com/shared/static/d359skd2w6wrm86om2997a1bxgigc8pu.xz) | | | :heavy_check_mark: | |
| 96 | +|generate_endf| ENDF/B | VII.1 | NNDC | [openmc.org](https://anl.box.com/shared/static/9igk353zpy8fn9ttvtrqgzvw1vtejoz6.xz) | | :heavy_check_mark: | | |
| 97 | +|convert_endf| ENDF/B | VII.1 | NNDC | [openmc.org](https://anl.box.com/shared/static/9igk353zpy8fn9ttvtrqgzvw1vtejoz6.xz) | :heavy_check_mark: | :heavy_check_mark: | | |
| 98 | +|convert_lib80x| ENDF/B | VIII.0 | LANL | [openmc.org](https://anl.box.com/shared/static/nd7p4jherolkx4b1rfaw5uqp58nxtstr.xz) | | | :heavy_check_mark: | |
| 99 | +|generate_endf| ENDF/B | VIII.0 | NNDC | [openmc.org](https://anl.box.com/shared/static/uhbxlrx7hvxqw27psymfbhi7bx7s6u6a.xz) | | :heavy_check_mark: | | |
| 100 | +|convert_fendl| FENDL | 2.1<br>3.0<br>3.1a<br>3.1d<br>3.2 | | [openmc.org 3.2](https://anl.box.com/shared/static/3cb7jetw7tmxaw6nvn77x6c578jnm2ey.xz) | :heavy_check_mark: | | | |
| 101 | +|generate_jendl| JENDL | 4.0 | | | | :heavy_check_mark: | | |
| 102 | +|convert_jeff32| JEFF | 3.2 | | [openmc.org](https://anl.box.com/shared/static/pb94oxriiipezysu7w4r2qdoufc2epxv.xz) | :heavy_check_mark: | | | |
| 103 | +|convert_jeff33| JEFF | 3.3 | | [openmc.org](https://anl.box.com/shared/static/ddetxzp0gv1buk1ev67b8ynik7f268hw.xz) | :heavy_check_mark: | | | |
| 104 | +|convert_tendl| TENDL | 2015<br>2017<br>2019<br>2021| | | :heavy_check_mark: | | | --> |
| 105 | + |
| 106 | +## Produce Depletion Chain files |
| 107 | + |
| 108 | +### Generate chain files |
| 109 | + |
| 110 | +| Script name | Library | Release | |
| 111 | +|-|-|-| |
| 112 | +|generate_endf_chain | ENDF/B | VII.1<br>VIII.0 | |
| 113 | +|generate_jeff_chain | JEFF | 3.3 | |
| 114 | +|generate_serpent_fissq | | | |
| 115 | +|generate_tendl_chain | TENDL | 2019<br>2021 | |
| 116 | +|generate_endf71_chain_casl | ENDF/B | | |
| 117 | + |
| 118 | +### Download chain files |
| 119 | + |
| 120 | +| Script name | Library | Release | Branching options| |
| 121 | +|-|-|-|-| |
| 122 | +|download_endf_chain | ENDF/B | VII.1<br>VIII.0 | None<br>SFR<br>PWR |
| 123 | + |
| 124 | +<!-- | Sctipt name | Library | Release | Download available | Download ENDF files and generates XML chain files | |
| 125 | +|-|-|-|-|-| |
| 126 | +|generate_endf71_chain_casl|ENDF/B|-|[https://github.com/openmc-dev/data/tree/master/depletion](https://github.com/openmc-dev/data/tree/master/depletion)|:heavy_check_mark:| |
| 127 | +|generate_endf_chain|ENDF/B|-|[https://github.com/openmc-dev/data/tree/master/depletion](https://github.com/openmc-dev/data/tree/master/depletion)|:heavy_check_mark:| |
| 128 | +|generate_serpent_fissq|-|-|[https://github.com/openmc-dev/data/tree/master/depletion](https://github.com/openmc-dev/data/tree/master/depletion)|:heavy_check_mark:| |
| 129 | +|generate_tendl_chain|TENDL|2019<br>2021|[https://github.com/openmc-dev/data/tree/master/depletion](https://github.com/openmc-dev/data/tree/master/depletion)|:heavy_check_mark:| --> |
| 130 | + |
| 131 | +## Other scripts |
| 132 | + |
| 133 | +| Script name | Description | |
| 134 | +|-|-| |
| 135 | +| convert_tendl_rand | Download random TENDL libraries from PSI and convert it to a HDF5 library for use with OpenMC. Only certain nuclides are available from PSI. This script generates a cross_sections_tendl.xml file with random TENDL evaluations plus a standard library located in 'OPENMC_CROSS_SECTIONS' | |
| 136 | +| sample_sandy | This scripts generates random (gaussian) evaluations of a nuclear data file following its covariance matrix using SANDY, and converts them to HDF5 for use in OpenMC. Script generates a cross_sections_sandy.xml file with the standard library plus the sampled evaluations. | |
| 137 | +| make_compton | | |
| 138 | +| make_stopping_powers | | |
| 139 | +| add_branching_ratios | add branching ratios for n,gamma reactions to a preexisting chain files. | |
| 140 | +| reduce_chain | | |
| 141 | +| combine_libraries | Combines multiple cross_section.xml files into a single cross_section.xml. | |
0 commit comments