A python toolbox for simulating NMR spectra
Project description
[![Build Status](https://travis-ci.org/DeepanshS/mrsimulator.svg?branch=master)](https://travis-ci.org/DeepanshS/mrsimulator) [![Documentation Status](https://readthedocs.org/projects/mrsimulator/badge/?version=stable)](https://mrsimulator.readthedocs.io/en/stable/?badge=stable)
# mrsimulator
mrsimulator is a library package with methods and tools for fast simulation of solid-state nuclear magnetic resonance (NMR) line-shapes. The library contains routines written in C which are wrapped and made available in python.
The package is currently under development. At present, mrsimulator features simulation of one-dimensional NMR line-shape of uncoupled spin I=1/2 isotopes for the following scenarios –
At arbitrary macroscopic magnetic flux density,
Magic angle spinning (MAS) at arbitrary spin rate,
Variable angle spinning (VAS) at arbitrary angle and spin rates,
Static line-shape.
For more information, refer to the [documentation](https://deepanshs.github.io/mrsimulator/).
## Installation
We recommend installing [anaconda](https://www.anaconda.com/distribution/) distribution for python version 3.6 or higher. The anaconda distribution ships with numerous packages and modules including Numpy, Scipy, and Matplotlib which are useful packages for scientific datasets.
### Download mrsimulator package
First, clone and download the mrsimulator package from Github. If you prefer git, type the following in the terminal,
$ git clone git://github.com/DeepanshS/mrsimulator.git
else, [download](https://github.com/DeepanshS/mrsimulator) the package using the browser. Once downloaded, use the terminal to navigate to the directory containing the package (usually, the folder is named mrsimulator).
$ cd mrsimulator
### Installing dependencies
Next, install the dependencies of the package. We recommend using conda to install the dependencies, as follows,
$ conda install -c conda-forge openblas –file requirements.txt
### Building and Installing mrsimulator package
Because the core of the mrsimulator package is written in C, you will require a C-compiler to build and install the package. We recommend the following C-compiler for the OS types:
Mac OS - clang
Linux - gcc
Windows - msvc
Install the package with,
$ python setup.py install
## Check your build
If the installation is successful, you should be able to run the following [test file](https://raw.github.com/DeepanshS/mrsimulator-test/master/test_file.py?raw=true) in your terminal.
$ python test_file.py
This should produce the following figure.
![alt text](https://raw.githubusercontent.com/DeepanshS/mrsimulator/master/docs/_static/test_output.png)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Hashes for mrsimulator-0.1.3-cp37-cp37m-manylinux2010_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1748a2575ead049b61f4dca3538a07d7c0d81fa0185446e110179214bd444e70 |
|
MD5 | 7a4e6ec3e770b0d1a8146f5185e9d765 |
|
BLAKE2b-256 | 0d74cc357a744387aaf971a20630024e175c05e90c0b385052454ebc03dd42f1 |
Hashes for mrsimulator-0.1.3-cp37-cp37m-manylinux1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 845f87c136b8252f99290aae9b4446b132c10bca9c9f1ed46dd9278b7a868201 |
|
MD5 | 501454b6214066302f8084ba40e23189 |
|
BLAKE2b-256 | e25c995414acf08f67ed69902e23eeb9d1bd92371789d355129eac51fc581b1c |
Hashes for mrsimulator-0.1.3-cp36-cp36m-manylinux2010_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | eb1c388643d94a83cb81d2dea876416af2bd3e56daa444c35ef80fa1230795d5 |
|
MD5 | 62a1fa06f7159a191ba57d8f4e1ac0bc |
|
BLAKE2b-256 | eb4192dece3e2a0d4009492a4bc2d8b3eba3e84409df348370cebf88a7b98cba |
Hashes for mrsimulator-0.1.3-cp36-cp36m-manylinux1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 909779a84c968f5c240f1eed92a618848b1d250602fd2a5f6724cafa0540370d |
|
MD5 | 45bdb2fd31e670c7aa85ed66f4c34e40 |
|
BLAKE2b-256 | 381e895923a38a24509d1d53375b5f4fb83cde0ac4ccbbba11fbc6efa129ac7a |