nmrformd

NMRforMD is a python script for the calculation of NMR relaxation time T1 and T2 from molecular dynamics trajectory file.

https://github.com/simongravelle/nmrformd

Science Score: 46.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
    Links to: acs.org
  • Committers with academic emails
    1 of 2 committers (50.0%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (16.5%) to scientific vocabulary

Keywords

fair gromacs lammps molecular-dynamics nmr nmr-spectroscopy open-source python simulations
Last synced: 6 months ago · JSON representation

Repository

NMRforMD is a python script for the calculation of NMR relaxation time T1 and T2 from molecular dynamics trajectory file.

Basic Info
Statistics
  • Stars: 26
  • Watchers: 2
  • Forks: 5
  • Open Issues: 0
  • Releases: 11
Topics
fair gromacs lammps molecular-dynamics nmr nmr-spectroscopy open-source python simulations
Created about 4 years ago · Last pushed 10 months ago
Metadata Files
Readme License Citation

README.md

NMRforMD

Dipolar Nuclear Magnetic Resonance for Molecular Dynamics (NMRforMD) simulations is a Python toolkit designed for the computation of dipolar NMR relaxation times (the so called $T1$ and $T2$) from molecular dynamics simulations. Used in combination with MDAnalysis, NMRforMD allows for the analysis of trajectory files from any MDAnalysis-compatible simulation package, including LAMMPS and GROMACS.

Migration

This repository will progressively be migrated on here, and the most up-to-date page will be https://nmrdfrommd.github.io.

Documentation

Details about installation and use of NMRforMD are given in the documentation. The documentation also contains a description of the theory behind dipolar dipolar NMR calculations, as well as details on some common pitfalls of NMR calculations.

Figure: Examples of systems that can be analyzed using NMRforMD, from left to right: a bulk water system, a lennard-jones fluid, and a lysozyme in water.

Datasets

Two molecular dynamics datasets are available on Github. One is a polymer in water system generated using LAMMPS, the second is a water confined in silica generated using GROMACS. Both datasets are required to follow the tutorials provided in the documentation.

Warning

The code has mostly been tested in the case of 1H-NMR (i.e. spin 1/2). It is also important to keep in mind that NMRforMD only works for dipolar interaction, not quadrupolar interaction.

Known issues

For very large trajectory file, the code requires a lot of memory. The code is not adapted to triclinic box, convert your trajectory to orthorhombic prior to calculation. This code is still in development, please raise an issue here if you encounter another problem.

For developers

If you intend to make modification to the code, please raise an issue or send me an email first. Then, fork the repository, apply your changes, then make a pull request that will be reviewed.

Clone the repository with its submodules as follow:

bash git clone https://github.com/simongravelle/nmrformd.git --recurse-submodule

Find more instructions here.

Acknowledgments

This project has received funding from the European Union's Horizon 2020 research and innovation programme under the Marie Skodowska-Curie grant agreement No 101065060.

MSCA image

Owner

  • Name: Simon Gravelle
  • Login: simongravelle
  • Kind: user
  • Location: Grenoble
  • Company: LIPhy

MSCA research fellow

GitHub Events

Total
  • Watch event: 6
  • Push event: 3
  • Fork event: 1
Last Year
  • Watch event: 6
  • Push event: 3
  • Fork event: 1

Committers

Last synced: almost 3 years ago

All Time
  • Total Commits: 235
  • Total Committers: 2
  • Avg Commits per committer: 117.5
  • Development Distribution Score (DDS): 0.187
Top Committers
Name Email Commits
Simon Gravelle s****e@l****r 191
Simon Gravelle s****e@i****e 44
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 1
  • Total pull requests: 2
  • Average time to close issues: 1 day
  • Average time to close pull requests: 17 minutes
  • Total issue authors: 1
  • Total pull request authors: 1
  • Average comments per issue: 0.0
  • Average comments per pull request: 0.0
  • Merged pull requests: 2
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • simongravelle (1)
Pull Request Authors
  • simongravelle (2)
Top Labels
Issue Labels
Pull Request Labels

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 40 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 1
  • Total versions: 9
  • Total maintainers: 1
pypi.org: nmrformd

Calculate dipolar NMR relaxation time from molecular dynamics trajectory file

  • Versions: 9
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 40 Last month
Rankings
Downloads: 9.9%
Dependent packages count: 10.1%
Average: 15.3%
Stargazers count: 15.6%
Forks count: 19.1%
Dependent repos count: 21.5%
Maintainers (1)
Last synced: 6 months ago

Dependencies

docs/requirements.txt pypi
  • furo *
  • scipy *
  • sphinx *
requirements.txt pypi
  • coverage *
  • flake8 *
  • pytest *
setup.py pypi
  • mdanalysis *
  • numpy *
  • pytest *
  • scipy *
.github/workflows/python-app.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v2 composite