westcott 0.2.1

Calculations of Westcott g-factors.

Westcott g-factor

Python package for calculating Westcott g-factors, which adjust thermal-neutron capture cross sections for non-1/v behavior at low energies. These are important in Neutron Activation Analysis (NAA) and Prompt Gamma-ray Activation Analysis (PGAA) when measuring nuclei that have low-energy resonances in their cross sections. Code calculates g-factors for Maxwellian neutron energy distributions and individual neutron source spectra, when available. A reference article describing this project is available on the arXiv [1].

Building and installation

This project can be built and installed by running the pip command in a Unix terminal:

$ pip install westcott

Alternatively, because this project is also maintained on GitHub, it can be installed by cloning the repository and running the installation script at the terminal command line of the project directory as described in README on the landing page.

Testing

A suite of Python modules containing unit tests has been developed for this project. These unit tests are distributed with the project on GitHub. This project has been successfully built and tested against multiple virtual Python environments from Python-3.6 to Python-3.13. To run the suite and ensure they work with the local Python environment, run tox in the project directory where the tox.ini file is also located:

$ tox -r

This project has the following Python-package dependencies: numpy, scipy, pandas, and pytest. The session is automatically started after building against the required Python environment.

Running the software

Following installation, the westcott scripts can be ran from any location by importing the library and making an instance of the Westcott class:

$ python

>>> import westcott
>>> gw = westcott.Westcott()

Various Jupyter Notebooks are also distributed with the project on GitHub. These Jupyter Notebooks can be used to demonstrate workflows and methods for interacting with the functionality available to the library.

Docstrings

Supporting docstrings for the westcott methods are currently under development.

References

[1] D.A. Matters, A.M. Hurst, T. Kawano, "Westcott g Factors Extended to Arbitrary Neutron Energy Spectra", https://doi.org/10.48550/arXiv.2602.05995