β-NMR/β-NQR MUD file reader and asymmetry calculator
bdata is a lightwieght Python package aimed to aid in the analysis of β-detected nuclear magnetic/quadrupole resonance (β-NMR and β-NQR) data taken at TRIUMF. These techniques are similar to muon spin rotation (μSR) and "conventional" nuclear magnetic resonance (NMR), but use radioactive nuclei as their NMR probe in place of the muon or a stable isotope.
The intended user of bdata is anyone analyzing data taken from TRIUMF's β-NMR or β-NQR spectrometers. A key goal of the project is to alleviate much of the technical tedium that is often encountered during any analysis.
- Provide an intuitive means of interfacing with MUD files in Python.
- Fetch missing local data from the archive.
- Support analyses by providing common data manipulations, such as calculating asymmetries or combining scans.
bdata[object]: access β-NMR and β-NQR MUD files
mdictobject]: dictionary of probe lifetimes.
containers[module]: specially defined
mdictobjects with set function.
exceptions[module]: custom exceptions and warnings for common issues
If you use bdata in your work, please cite:
- D. Fujimoto. Digging Into MUD With Python: mudpy, bdata, and bfit. arXiv:2004.10395 [physics.data-an].
- Please submit contributions to bdata via a pull request
- To report issues or get support, please file a new issue
Installation and Use
The following packages/applications are needed prior to bdata installation:
- iminuit : a Jupyter-friendly Python interface for the MINUIT2 library.
- mudpy : data structures for parsing TRIUMF MUD files.
- pandas : a fast, powerful, flexible and easy to use data analysis/manipulation tool.
- requests : an elegant and simple HTTP library for Python.
- SciPy : fundamental algorithms for scientific computing in Python.
|From the PyPI as user (recommended)||
|From the PyPI as root||
pip should point to a (version 3) Python executable
If the above does not work, try using
python3 -m pip instead.
you may want to tell bdata where the data is stored on your machine.
This is done by defining two environment variables:
This can be done, for example, in your
Both variables expect the data to be stored in directories with a particular
/path/ bnmr/ bnqr/ 2017/ 2018/ 045123.msr
Here, the folders
/path/bnqr/ both contain runs
.msr files) organized into subdirectories by year of aquasition.
In this case, you would set (in your
export BNMR_ARCHIVE=/path/bnmr/ export BNQR_ARCHIVE=/path/bnqr/
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size bdata-6.7.3.tar.gz (46.2 kB)||File type Source||Python version None||Upload date||Hashes View|