General information

A relational database has been developed based on the original (n,n'γ) work carried out by A.M. Demidov et al., at the Nuclear Research Institute in Baghdad, Iraq [1]. For reference, the complete ATLAS is provided as a pdf accompanying this software. A summary article [A.M. Hurst, L.A. Bernstein, and K. Song, arXiv:2001.11140v2 [physics.app-ph]] providing an overview of the project may be downloaded from here.

The information from the ATLAS includes:

All of this is described in greater detail in the schema.

Taken together, this information allows for the extraction of the flux-weighted (n,n'γ) cross sections for a given transition relative to a defined value. In the examples presented here, we are currently using the fast-neutron flux-weighted partial cross section for the production of the 847-keV 2+1 → 0+gs transition in 56Fe, σγ=329.46 mb. This value can be changed to accommodate the user preference - see here for how to do this.

The (n,n'γ) data has been compiled into a series of ASCII comma separated value tables (the delimiter is a <TAB> in this case) in the CSV_DATA directory. The corresponding SQLite database is then created by executing the make && make run command and installed into the notebook_analysis and sql_codes directories after invoking the make install command. The installation procedure is described in detail elsewhere.

The database can then be interacted with directly via the SQLite engine. We have provided a suite of Structured Query Language (SQL) scripts in the sql_codes directory illustrating various methods for querying the data. The database can also be accessed via the Jupyter Notebook Python-browser interface. All of this is shown schematically below.


Getting started

The software provided with this package is intended to create a SQLite database on Linux and Mac OS X platforms. For Windows users, MinGW and Cygwin may provide a suitable alternative application environment/emulator (not tested). However, Windows-based environments have not been considered in the current project.

System requirements:


Python installation

This section is only intended for those who may need to install Python from the source or are missing some of the basic libraries required to use the Jupyter Notebook supplied with this package. The following procedures should only be considered as a set of guidelines rather than a strict set of rules and deviations may be necessary. But hopefully it provides a useful starting point, if needed.


Mac OS X

Running Jupyter

To start the notebook server, execute one of the following commands from the terminal:

	jupyter notebook # or...
	ipython notebook

The terminal will then display some information about the notebook server including the URL of the web application (default: http://localhost:8888/tree). All being well, the notebook should then open in your browser. To execute a cell in a Jupyter Notebook press <SHIFT> + <ENTER> or <CTRL> + <ENTER>. More information on this utility and the notebook provided with this package may be found here.