<img src="https://raw.githubusercontent.com/alsinmr/SLEEPY_tutorial/refs/heads/main/JupyterBook/logo_dark.png" alt="drawing" width="600"/>
# SLEEPY
Spins in Liouville space for rElaxation and Exchange in PYthon
SLEEPY is software intended for the simulation of NMR spin-systems including exchange processes and relaxation. Includes easy setup of the spin system, and allows application of arbitrary pulse sequences in both the rotating- and lab-frames.
Requires standard python packages plus numpy/scipy/matplotlib. Multiprocess is recommended, and ipywidgets are used for creating zoomable plots, e.g. Google Colab, although is not required. Note that we highly recommend using the Intel MKL libraries with numpy/scipy at least if you're using an Intel CPU. Anaconda installs these by default on Intel machines (Miniconda does not!). Note that we have not been able to run MKL with Python 12 or 13.
Benchmarked version
* Python: 3.11.13
* Numpy: 1.24.3
* Scipy: 1.10.1
* Multiprocessing: 0.70.15
Other tested versions (speed may vary):
* Python: 3.8.8, 3.9.3, 3.11.11, 3.13.2
* numpy: 1.20.1, 2.0.2, 2.2.3
* scipy: 1.6.2, 1.14.1, 1.15.2
* matplotlib: 3.3.4, 3.10.0
Testing has been performed on the various notebooks found at [https://github.com/alsinmr/SLEEPY_tutoria/](https://github.com/alsinmr/SLEEPY_tutoria/) using Jupyter Notebooks on MacOS and on myBinder.org, and also on Google Colab.
Installation is possible via pip. Please run
```
pip install sleepy-nmr
```
This will create the "sleepy" module (not sleepy-nmr!). Typical install time is ~5 seconds (install time will be significantly longer if numpy, scipy, and matplotlib are not already installed, since these will be installed as dependencies).
The SLEEPY tutorial provides extensive examples of applications of SLEEPY and is available online at
[http://sleepy-nmr.org](http://sleepy-nmr.org)
or
[https://alsinmr.github.io/SLEEPY](https://alsinmr.github.io/SLEEPY)
These examples may be downloaded as Jupyter notebooks or run online via Google Colab (demo).
We also provide example scripts here, in the folder 'examples', which may be run as Python3 scripts. To run these, please navigate to the examples folder and then run either
```
python3 ShortExamples.py
```
or
```
python3 Figure3.py
```
Both scripts will run a number of examples and create a folder of the corresponding figures. The former calculation takes on the order of 1 minute for 6 examples, and the latter on the order of 10 minutes for 9 examples (these correspond to Figure 3 of the corresponding manuscript).
Copyright 2025 Albert Smith-Penzel, Kai Zumpfe
All files are copyrighted under the GNU General Public License. A copy of the license has been provided in the file LICENSE
Funding for this project provided by:
Deutsche Forschungsgemeinschaft (DFG) grant 450148812
Raw data
{
"_id": null,
"home_page": null,
"name": "sleepy-nmr",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "NMR, relaxation, exchange, Liouville",
"author": "Kai Zumpfe, Albert Smith-Penzel",
"author_email": "Albert Smith-Penzel <albert.smith-penzel@medizin.uni-leipzig.de>",
"download_url": "https://files.pythonhosted.org/packages/77/95/8008f2a2eaf8a19334fb9230924580f041aedf96f4751c35d183ed221663/sleepy_nmr-0.1.4.tar.gz",
"platform": null,
"description": "<img src=\"https://raw.githubusercontent.com/alsinmr/SLEEPY_tutorial/refs/heads/main/JupyterBook/logo_dark.png\" alt=\"drawing\" width=\"600\"/>\n\n# SLEEPY\nSpins in Liouville space for rElaxation and Exchange in PYthon\n\nSLEEPY is software intended for the simulation of NMR spin-systems including exchange processes and relaxation. Includes easy setup of the spin system, and allows application of arbitrary pulse sequences in both the rotating- and lab-frames.\n\nRequires standard python packages plus numpy/scipy/matplotlib. Multiprocess is recommended, and ipywidgets are used for creating zoomable plots, e.g. Google Colab, although is not required. Note that we highly recommend using the Intel MKL libraries with numpy/scipy at least if you're using an Intel CPU. Anaconda installs these by default on Intel machines (Miniconda does not!). Note that we have not been able to run MKL with Python 12 or 13.\n\nBenchmarked version\n* Python: 3.11.13\n* Numpy: 1.24.3\n* Scipy: 1.10.1\n* Multiprocessing: 0.70.15\n\nOther tested versions (speed may vary):\n* Python: 3.8.8, 3.9.3, 3.11.11, 3.13.2\n* numpy: 1.20.1, 2.0.2, 2.2.3\n* scipy: 1.6.2, 1.14.1, 1.15.2\n* matplotlib: 3.3.4, 3.10.0\n\nTesting has been performed on the various notebooks found at [https://github.com/alsinmr/SLEEPY_tutoria/](https://github.com/alsinmr/SLEEPY_tutoria/) using Jupyter Notebooks on MacOS and on myBinder.org, and also on Google Colab.\n\nInstallation is possible via pip. Please run\n```\npip install sleepy-nmr\n```\nThis will create the \"sleepy\" module (not sleepy-nmr!). Typical install time is ~5 seconds (install time will be significantly longer if numpy, scipy, and matplotlib are not already installed, since these will be installed as dependencies).\n\nThe SLEEPY tutorial provides extensive examples of applications of SLEEPY and is available online at \n[http://sleepy-nmr.org](http://sleepy-nmr.org)\nor\n[https://alsinmr.github.io/SLEEPY](https://alsinmr.github.io/SLEEPY)\n\n\n\nThese examples may be downloaded as Jupyter notebooks or run online via Google Colab (demo). \n\nWe also provide example scripts here, in the folder 'examples', which may be run as Python3 scripts. To run these, please navigate to the examples folder and then run either\n\n```\npython3 ShortExamples.py\n```\nor\n```\npython3 Figure3.py\n```\nBoth scripts will run a number of examples and create a folder of the corresponding figures. The former calculation takes on the order of 1 minute for 6 examples, and the latter on the order of 10 minutes for 9 examples (these correspond to Figure 3 of the corresponding manuscript).\n\n\nCopyright 2025 Albert Smith-Penzel, Kai Zumpfe\n\nAll files are copyrighted under the GNU General Public License. A copy of the license has been provided in the file LICENSE\n\nFunding for this project provided by:\n\nDeutsche Forschungsgemeinschaft (DFG) grant 450148812\n",
"bugtrack_url": null,
"license": "GPL-3.0-or-later",
"summary": "Spins in Liouville-space for rElaxation and Exchange in PYthon",
"version": "0.1.4",
"project_urls": {
"Homepage": "https://alsinmr.github.io/SLEEPY",
"Issues": "https://github.com/alsinmr/SLEEPY/issues",
"Repository": "https://github.com/alsinmr/SLEEPY.git"
},
"split_keywords": [
"nmr",
" relaxation",
" exchange",
" liouville"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "94ab2f9fdaa54ef6ded829816d7b65f73e22048ac1b81c673b37c1e238a649e0",
"md5": "4f28f8ca7541fb16cd16b01fa41de189",
"sha256": "c3593d1fa8eb57228cfda21d86233ba1c3a3082b0edd7560621e854b44ae4a7b"
},
"downloads": -1,
"filename": "sleepy_nmr-0.1.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4f28f8ca7541fb16cd16b01fa41de189",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 556398,
"upload_time": "2025-07-08T21:40:00",
"upload_time_iso_8601": "2025-07-08T21:40:00.474366Z",
"url": "https://files.pythonhosted.org/packages/94/ab/2f9fdaa54ef6ded829816d7b65f73e22048ac1b81c673b37c1e238a649e0/sleepy_nmr-0.1.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "77958008f2a2eaf8a19334fb9230924580f041aedf96f4751c35d183ed221663",
"md5": "12e753ba955e6899e36ddb655e36e9e6",
"sha256": "6daf4576bd33499d311de604d1a0545ca877b4d1b8cc4a81be61f713cebae822"
},
"downloads": -1,
"filename": "sleepy_nmr-0.1.4.tar.gz",
"has_sig": false,
"md5_digest": "12e753ba955e6899e36ddb655e36e9e6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 634550,
"upload_time": "2025-07-08T21:40:01",
"upload_time_iso_8601": "2025-07-08T21:40:01.763958Z",
"url": "https://files.pythonhosted.org/packages/77/95/8008f2a2eaf8a19334fb9230924580f041aedf96f4751c35d183ed221663/sleepy_nmr-0.1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-08 21:40:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "alsinmr",
"github_project": "SLEEPY",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "sleepy-nmr"
}
JSON
