mudpy

MUon (MUD) Data file IO package.

mudpy is a lightwieght Python package aimed to aid in the analysis of muon spin rotation (μSR) and β-detected nuclear magnetic/quadrupole resonance (β-NMR and β-NQR) data taken at TRIUMF. These techniques are similar to "conventional" nuclear magnetic resonance (NMR), but use radioactive nuclei or a muon as the NMR probe in place of a stable isotope.

The intended user of mudpy is anyone analyzing data in TRIUMF's MUD file format. A key goal of the project is to alleviate much of the technical tedium that is often encountered during any analysis.

mudpy has been written to fullfill the following needs:

Provide a pythonic means of interfacing with MUD files in Python.
Provide low-level wrappers of the mud_friendly API.

Citing

If you use mudpy in your work, please cite:

D. Fujimoto. bfit: A Python Application For Beta-Detected NMR. arXiv:2004.10395 [physics.data-an].

Community Guidelines

Please submit contributions to mudpy via a pull request
To report issues or get support, please file a new issue

Installation and Use

Dependencies

The following packages/applications are needed prior to installation:

Python 3.6 or higher: a dynamically typed programming language. [install]
Cython : C-language extensions for Python. [install]
NumPy : array programming library for Python. [install]

Install Instructions

	Command
From the PyPI as user (recommended)	`pip install --user mud-py`
From the PyPI as root	`pip install mud-py`
From source	`python3 setup.py install`

Note the hyphen in mud-py. The pip command should point to a (version 3) Python executable (e.g., python3, python3.8, etc.). If the above does not work, try using pip3 or python3 -m pip instead.

mud_friendly [C wrapper]: python access to MUD C functions
mdata [object]: access general MUD files pythonically
containers.mcontainer [object]: special container base class
containers.mdict [object]: enhanced dictionary class for sub-level lookup and attribute access
containers.mcomment [object]: special container for comments
containers.mhist [object]: special container for histograms
containers.mscaler [object]: special container for scalers
containers.mlist [object]: enhanced list class for sub-level lookup
containers.mvar [object]: special container for variables

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mud-py-1.2.4.tar.gz (232.0 kB view details)

Uploaded Aug 26, 2021 Source

File details

Details for the file mud-py-1.2.4.tar.gz.

File metadata

Download URL: mud-py-1.2.4.tar.gz
Upload date: Aug 26, 2021
Size: 232.0 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/3.4.2 importlib_metadata/4.6.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.61.2 CPython/3.8.10

File hashes

Hashes for mud-py-1.2.4.tar.gz
Algorithm	Hash digest
SHA256	`670e71d28d442abdcc058e2df3c4e38f888529f24f60f0f7624b6091d8c46b28`
MD5	`fa56b24585ec78726dc601fc2232ab87`
BLAKE2b-256	`e9a6f5a503338707bad2f7a4739e2589f50c8a060fcec4b0a6e16d37e6562653`