A python toolbox for simulating fast real-time solid-state NMR spectra.
Project description
The Mrsimulator project
Deployment | |
Build Status | |
License | |
Metrics |
mrsimulator
is an open-source python package for fast computation/analysis of solid-state
magnetic resonance (NMR) spectra of both crystalline and amorphous materials.
Why use mrsimulator?
- It is open-source and free.
- It is a fast and versatile solid-state NMR simulator of one and two-dimensional static, MAS, and VAS spectra of nuclei experiencing chemical shift (nuclear shielding) and quadrupolar coupling interactions.
- It includes simulations of weakly coupled nuclei experiencing J and dipolar couplings.
- It is fully documented with a stable and simple API and is easily incorporated into your python scripts and web apps.
- It is compatible with modern python packages, such as scikit-learn, Keras, etc.
- Packages using mrsimulator:
Install
pip install mrsimulator
Please refer to our installation document for details.
A 1D static and MAS example
from mrsimulator import Simulator, SpinSystem, Site
from mrsimulator.method.lib import BlochDecaySpectrum
import matplotlib.pyplot as plt
# Make Site and SpinSystem objects
H_site = Site(isotope="1H", shielding_symmetric={"zeta": 13.89, "eta": 0.25})
spin_system = SpinSystem(sites=[H_site])
# Make static and MAS one-pulse acquire Method objects
static = BlochDecaySpectrum(channels=["1H"] )
mas = BlochDecaySpectrum(channels=["1H"], rotor_frequency=1000) # in Hz
# Setup and run the Simulation object
sim = Simulator(spin_systems=[spin_system], methods=[static, mas])
sim.run()
# Plot the spectra
fig, ax = plt.subplots(1, 2, figsize=(6, 3), subplot_kw={"projection": "csdm"})
ax[0].plot(sim.methods[0].simulation.real, color="black", linewidth=1)
ax[0].set_title("Static")
ax[1].plot(sim.methods[1].simulation.real, color="black", linewidth=1)
ax[1].set_title("MAS")
plt.tight_layout()
plt.show()
This should produce the following figure.
Check out our extensive documentation and more example.
Features
The mrsimulator
package currently offers the following
-
Fast simulation of one and two-dimensional solid-state NMR spectra.
-
Simulation of coupled and uncoupled spin system
- for spin I=1/2, and quadrupole I>1/2 nuclei
- at arbitrary macroscopic magnetic flux density
- at arbitrary rotor angles
- at arbitrary spinning frequency
-
A library of NMR methods,
- 1D Bloch decay spectrum
- 1D Bloch decay central transition spectrum
- 2D Multi-Quantum Variable Angle Spinning (MQ-VAS)
- 2D Satellite-transition Variable Angle Spinning (MQ-VAS)
- 2D Dynamic Angle Spinning (DAS)
- 2D isotropic/anisotropic sideband correlation spectrum (e.g. PASS and MAT)
- 2D Magic Angle Flipping (MAF)
- Custom user-defined 1D and 2D methods (Method)
-
Models for tensor parameter distribution in amorphous materials.
- Czjzek
- Extended Czjzek
- Custom user-defined models
For more information, refer to the documentation.
Reporting Bugs
Submit bug reports or feature requests on the Github issue tracker.
Discussions are welcome on the Github discussion page.
How to cite
If you use mrsimulator in your publication, please consider citing the following.
-
Deepansh J. Srivastava, Matthew Giammar, Maxwell C. Venetos, Shyam Dwaraknath, Philip J. Grandinetti, & Alexis McCarthy. (2021). mrsimulator: v0.6.1. Zenodo. https://doi.org/10.5281/zenodo.5559730
-
Srivastava DJ, Vosegaard T, Massiot D, Grandinetti PJ (2020) Core Scientific Dataset Model: A lightweight and portable model and file format for multi-dimensional scientific data. PLOS ONE 15(1): e0225953. https://doi.org/10.1371/journal.pone.0225953
Additionally, if you use lmfit for least-squares fitting, consider citing the lmfit package. Zenodo. http://doi.org/10.5281/zenodo.4516651
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.7.0rc2-cp310-cp310-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0d289751234f7a70366815359c1ea525d05fc7ee30766f8ff43a9fb4d605f00c |
|
MD5 | 73de9583ca68daa04df96076b7a8c039 |
|
BLAKE2b-256 | f95e8af615b291835affb7935d95f670bf3fa198287cf2bcba1a70369b818d38 |
Hashes for mrsimulator-0.7.0rc2-cp310-cp310-manylinux_2_12_x86_64.manylinux2010_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5e9ef7085dec5b976d713003e8601c45625873c7244f4146fd3d8707c937ce69 |
|
MD5 | 9adc13d939ed87aeaf0078569c577280 |
|
BLAKE2b-256 | ef14cb956af5a309e1af84581750a99ff92f3e77389bb688c5a464c41333685d |
Hashes for mrsimulator-0.7.0rc2-cp310-cp310-macosx_10_9_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2edd883bc1935de69903a460399e7961be833e228b1b08b7f75af71832d0cefb |
|
MD5 | d60ce07b7964a21fb5c193618c21796e |
|
BLAKE2b-256 | f864d56f7db34a2e852cf6a41b7d9444fd2384ec064340933278c2f5ea4b5500 |
Hashes for mrsimulator-0.7.0rc2-cp39-cp39-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7cb0a69f9fcf5683a492ea88a1cd08a52e28f6ee4654504ead5374bcabe2fa9c |
|
MD5 | e553e12186f2fd3c599c0813fa332eda |
|
BLAKE2b-256 | 0afeef0f00a3ce934887be2e0592d2225960326240974c6bd4d6e4acad96b129 |
Hashes for mrsimulator-0.7.0rc2-cp39-cp39-manylinux_2_12_x86_64.manylinux2010_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b68a923c8266becf97dfa6bf0efaf1185f6ea2f8e10aaee26ba151d6541f9721 |
|
MD5 | dc7825011b0282309788a53f55c57b57 |
|
BLAKE2b-256 | 84fb6387c6437750683cdef4a31c5614dfbc6210d7776c28fac15605d914eba3 |
Hashes for mrsimulator-0.7.0rc2-cp39-cp39-macosx_10_9_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7a99d441fa091f8f675569ca17ce01e98c7a84bceec981ccf4ce88b684c3acb7 |
|
MD5 | b6889e48eff61d7c44c5ba1644518a31 |
|
BLAKE2b-256 | 0d5c5058a3647250643a5efaddb3a2c9473afaa4c4925299dd06f342c5898919 |
Hashes for mrsimulator-0.7.0rc2-cp38-cp38-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1fb660612f49279fcc6e3930efeb550b045bf15c679a887dd23129e04e5bbdd3 |
|
MD5 | 42db614c7e23ef3bfcf480e66c58e723 |
|
BLAKE2b-256 | ba2e94071fc337b025b2b05e5f501b6bd57df9750df2d3def2ff1f93b1d2e539 |
Hashes for mrsimulator-0.7.0rc2-cp38-cp38-manylinux_2_12_x86_64.manylinux2010_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8bdac4e4e5a48922f5e153ad43ad7f18e180d275bb368ad4950da984280b00d4 |
|
MD5 | 1e0946c54ab0ed1432b676e2e86ee144 |
|
BLAKE2b-256 | cffb4330ef5c06e61f8c7a96f89329094f5989f4f11b3b34e9689edc9e4a11bd |
Hashes for mrsimulator-0.7.0rc2-cp38-cp38-macosx_10_9_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2660baa7124eea824b822e6b2dc179ec7beaca02f708530be573ef4fb448cc83 |
|
MD5 | 0a89299531f8affa3b3639d133f7d696 |
|
BLAKE2b-256 | 4e8e6bcb3c3cccbf024eda9174c313fe297a70f95db9f4867857b34fa1609912 |
Hashes for mrsimulator-0.7.0rc2-cp37-cp37m-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6f66318323c8b60e2ea02401bb8d0a5fafdb94e053bea08a9441b4cc36d19efd |
|
MD5 | 8591dbe48eaa44ce6becfb08b0325ca6 |
|
BLAKE2b-256 | ae4a80e3c2fda60d19fcdab3e96ca2c6bc9336d1e5b9496facae6b70b3bef811 |
Hashes for mrsimulator-0.7.0rc2-cp37-cp37m-manylinux_2_12_x86_64.manylinux2010_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3fd29c6835768d0fe7092897a6432bc24cb77f438b6e203ef49c43e05244657e |
|
MD5 | 6e91e33c3b937cf193e45aaf2da05e5b |
|
BLAKE2b-256 | 7d86853bef1aaf4ad26d8651f76fb970d062ddde54ef6c9444979204d0d05fbd |
Hashes for mrsimulator-0.7.0rc2-cp37-cp37m-macosx_10_9_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 44362a426744173f6a00e3ccfd51ee1eec82f3fdcec7b0e0715a7d496f655d1c |
|
MD5 | d3597b9e321d4eb50cca80773e5e4554 |
|
BLAKE2b-256 | 91be02fda5c9050e1d6365136ce12be1eec326d103df07499ecbd8216a116208 |
Hashes for mrsimulator-0.7.0rc2-cp36-cp36m-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a755d46ea9ef7de51bcc0818f8c951baee293d27a5a8835dbed6883d62747068 |
|
MD5 | d955071c1c40b14116d2ff3cb9719919 |
|
BLAKE2b-256 | 1ed4b368277f240a581638cab74919387e34dafc9451a60c96a2237e2140385f |
Hashes for mrsimulator-0.7.0rc2-cp36-cp36m-manylinux_2_12_x86_64.manylinux2010_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | efc0dbdeb46ad8ee010f31b38866feaf614154be644a76e835cde2cbc160b364 |
|
MD5 | b9cb28f52aa6b97f08d1af2d343f2847 |
|
BLAKE2b-256 | 8aad3909831ca6d1ff36d9f70dcb4f90fd1512da668d8397477a3cfa6e924976 |
Hashes for mrsimulator-0.7.0rc2-cp36-cp36m-macosx_10_9_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b5175d81bbdd06c3d534d7e36221b5a2dd6d654f89e7dd7f84a450e579f959be |
|
MD5 | 16698492a2603d4fc7aa67a32211eb45 |
|
BLAKE2b-256 | 89179ffa543cf7b03d63394af6a34c21b918c6e9c07151fa9444279b069b3b32 |