Metadata-Version: 2.4
Name: multinmrfit
Version: 2.1.5
Summary: Fitting 1D NMR spectra
Home-page: https://github.com/NMRTeamTBI/MultiNMRFit
Author: Pierre Millard, Cyril Charlier
Author-email: charlier@insa-toulouse.fr
Project-URL: Bug Tracker, https://github.com/NMRTeamTBI/MultiNMRFit/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pandas>=1.3.4
Requires-Dist: numpy>=1.21.4
Requires-Dist: scipy>=1.12.0
Requires-Dist: nmrglue>=0.6
Requires-Dist: plotly>=5.18.0
Requires-Dist: streamlit>=1.3.1
Requires-Dist: sess-i>=0.0.2
Requires-Dist: streamlit-multipage>=0.0.18
Dynamic: license-file

# MultiNMRFit

[![Documentation Status](https://readthedocs.org/projects/multinmrfit/badge/?version=latest)](http://multinmrfit.readthedocs.io/?badge=latest)
[![Python 3.8+](https://img.shields.io/badge/python-%3E%3D3.8-blue)](https://www.python.org/downloads/release/python-380/)

## What is MultiNMRFit?

MultiNMRFit is a scientific tool designed to extract quantitative information (chemical shifts, signal intensity, coupling constants, etc) by fitting a serie of 1D spectra (acquired individually or as pseudo 2D spectra).

It is one of the routine tools that we use for NMR studies of metabolic systems at the [NMR](https://www.toulouse-biotechnology-institute.fr/en/poles/equipe-rmn-2/) and [MetaSys](https://www.toulouse-biotechnology-institute.fr/en/poles/equipe-metasys/) teams of the [Toulouse Biotechnology Institute](http://www.toulouse-biotechnology-institute.fr/en/).

The code is open-source, and available under a GPLv3 license. Additional information can be found in [MultiNMRFit publication](https://doi.org/10.1101/2024.12.19.629408).

Detailed documentation can be found online at Read the Docs ([https://multinmrfit.readthedocs.io/](https://multinmrfit.readthedocs.io/)).

## Key features

* **fit series of 1D spectra** (acquired as individual 1D spectra, as a pseudo 2D spectrum, or provided as tabulated text files),
* can be used with **all nuclei** (<sup>1</sup>H, <sup>13</sup>C, <sup>15</sup>N, <sup>31</sup>P, etc),
* estimation of several parameters for each signal of interest (**intensity**, **area**, **chemical shift**, **linewidth**, **coupling constant(s)**, etc),
* several **signal models** are provided, and users can add their own models
* **semi-automated analysis** for **peak picking** and **definition of multiplicity** for each signal,
* account for **overlaps** between peaks and **zero-order baseline correction**,
* **visual inspection of the fitted curves**,
* estimation of **uncertainty** on estimated parameters (standard deviation),
* shipped as a **library** with a **graphical user interface**,
* open-source, free and easy to install everywhere where Python 3 and pip run,
* biologist-friendly.

## Quick-start

MultiNMRFit requires Python 3.8 or higher and run on all platforms (Windows, MacOS and Unix).
Please check [the documentation](https://multinmrfit.readthedocs.io/en/latest/quickstart.html) for complete
installation and usage instructions.

Use `pip` to **install PhysioFit from GitHub**:

```bash
$ pip install multinmrfit
```

Then, start the graphical interface with:

```bash
$ nmrfit
```

MultiNMRFit is also available as a Python library.

## Bug and feature requests

If you have an idea on how we could improve MultiNMRFit please submit a new *issue*
to [our GitHub issue tracker](https://github.com/NMRTeamTBI/MultiNMRFit/issues).

## Developers guide
### Contributions

Contributions are very welcome! :heart:

### Local install with pip

In development mode, do a `pip install -e /path/to/MultiNMRFit` to install
locally the development version.

### Build the documentation locally

Build the HTML documentation with:

```bash
$ cd doc
$ make html
```

The PDF documentation can be built locally by replacing `html` by `latexpdf`
in the command above. You will need a recent latex installation.

## How to cite

MultiNMRFit: A software to fit 1D and pseudo-2D NMR spectra. Pierre Millard, Loïc Le Grégam, Svetlana Dubiley, Thomas Gosselin-Monplaisir, Guy Lippens, Cyril Charlier, bioRxiv preprint, 2024, [doi: 10.1101/2024.12.19.629408](https://doi.org/10.1101/2024.12.19.629408).

## Authors

Pierre Millard, Cyril Charlier

## Contact

:email: charlier@insa-toulouse.fr
:email: millard@insa-toulouse.fr
