# IsoCor - **Iso**tope **Cor**rection for mass spectrometry labeling experiments
[](https://badge.fury.io/py/IsoCor)
[](https://pypi.python.org/pypi/isocor/)
[](https://travis-ci.com/MetaSys-LISBP/IsoCor)
[](http://isocor.readthedocs.io/?badge=latest)
[](https://isocor.readthedocs.io/en/latest/)
## What is IsoCor?
**IsoCor is a scientific software dedicated to the correction of mass spectrometry (MS) data for naturally
occuring isotopes**.
IsoCor corrects raw MS data (mass fractions) for
naturally-occurring isotopes of all elements and purity of the
isotopic tracer.
The output of IsoCor is the isotopologue distribution of the molecule
(i.e. the relative fractions of molecular entities differing only in the number
of isotopic substitutions of the tracer). IsoCor also calculates
the mean enrichment (i.e. the mean isotopic content in the molecule) in metabolites.
It is one of the routine tools that we use at the [MetaSys team](https://www.toulouse-biotechnology-institute.fr/en/poles/equipe-metasys/) and [MetaToul platform](https://www.metabohub.fr/home.html) in isotopic studies of metabolic systems.
The code is open-source, and available under a GPLv3 license. Additional information can be found in [IsoCor publication](https://doi.org/10.1093/bioinformatics/btz209).
Detailed documentation can be found online at Read the Docs ([https://isocor.readthedocs.io/](https://isocor.readthedocs.io/)).
Check out the [Tutorials](https://isocor.readthedocs.io/en/latest/tutorials.html) to use the best correction option!
## Key features
* **correction of naturally occuring isotopes**, both for non-tracer and tracer elements,
* **correction of tracer purity**,
* shipped as a library with both a **graphical and command line interface**,
* mass-spectrometer and resolution agnostic,
* can be applied to singly- and multiply-charged ions
* can be used with any tracer element (having two or more isotopes)
* account for the contribution of derivatization steps (if any),
* generate isotopic InChIs of tracer isotopologues,
* open-source, free and easy to install everywhere where Python 3 and pip run,
* biologist-friendly.
## Quick-start
IsoCor requires Python 3.7 or higher and run on all platforms.
Please check [the documentation](https://isocor.readthedocs.io/en/latest/quickstart.html) for complete
installation and usage instructions.
Use `pip` to **install IsoCor from PyPi**:
```bash
$ pip install isocor
```
Then, start the graphical interface with:
```bash
$ isocor
```
IsoCor is also available directly from command-line and as a Python library.
## Bug and feature requests
If you have an idea on how we could improve IsoCor please submit a new *issue*
to [our GitHub issue tracker](https://github.com/MetaSys-LISBP/IsoCor/issues).
## Developers guide
### Contributions
Contributions are very welcome! :heart:
Please work on your own fork,
follow [PEP8](https://www.python.org/dev/peps/pep-0008/) style guide,
and make sure you pass all the tests before a pull request.
### Local install with pip
In development mode, do a `pip install -e /path/to/IsoCor` to install
locally the development version.
### Unit tests
Isotope correction is a complex task and we use unit tests to make sure
that critical features are not compromised during development.
You can run all tests by calling `pytest` in the shell at project's root directory.
### 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
Millard P., Delépine B., Guionnet M., Heuillet M., Bellvert F. and Letisse F. IsoCor: isotope correction for high-resolution MS labeling experiments. Bioinformatics, 2019, [doi: 10.1093/bioinformatics/btz209](https://doi.org/10.1093/bioinformatics/btz209)
## Authors
Baudoin Delépine, Matthieu Guionnet, Pierre Millard
## Contact
:email: Pierre Millard, millard@insa-toulouse.fr
Raw data
{
"_id": null,
"home_page": "https://github.com/MetaSys-LISBP/IsoCor/",
"name": "IsoCor",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "",
"author": "Pierre Millard, Baudoin D\u00e9l\u00e9pine, Matthieu Guionnet",
"author_email": "millard@insa-toulouse.fr",
"download_url": "https://files.pythonhosted.org/packages/fd/3e/9dfdba9783d0425f8f30e132d5c76afe57673af2c336f3de1e8446114d21/IsoCor-2.2.2.tar.gz",
"platform": null,
"description": "# IsoCor - **Iso**tope **Cor**rection for mass spectrometry labeling experiments\n\n[](https://badge.fury.io/py/IsoCor)\n[](https://pypi.python.org/pypi/isocor/)\n[](https://travis-ci.com/MetaSys-LISBP/IsoCor)\n[](http://isocor.readthedocs.io/?badge=latest)\n\n[](https://isocor.readthedocs.io/en/latest/)\n\n\n## What is IsoCor?\n**IsoCor is a scientific software dedicated to the correction of mass spectrometry (MS) data for naturally\noccuring isotopes**.\nIsoCor corrects raw MS data (mass fractions) for\nnaturally-occurring isotopes of all elements and purity of the\nisotopic tracer.\nThe output of IsoCor is the isotopologue distribution of the molecule\n(i.e. the relative fractions of molecular entities differing only in the number\nof isotopic substitutions of the tracer). IsoCor also calculates\nthe mean enrichment (i.e. the mean isotopic content in the molecule) in metabolites.\n\nIt is one of the routine tools that we use at the [MetaSys team](https://www.toulouse-biotechnology-institute.fr/en/poles/equipe-metasys/) and [MetaToul platform](https://www.metabohub.fr/home.html) in isotopic studies of metabolic systems.\n\nThe code is open-source, and available under a GPLv3 license. Additional information can be found in [IsoCor publication](https://doi.org/10.1093/bioinformatics/btz209).\n\nDetailed documentation can be found online at Read the Docs ([https://isocor.readthedocs.io/](https://isocor.readthedocs.io/)).\nCheck out the [Tutorials](https://isocor.readthedocs.io/en/latest/tutorials.html) to use the best correction option!\n\n## Key features\n* **correction of naturally occuring isotopes**, both for non-tracer and tracer elements,\n* **correction of tracer purity**,\n* shipped as a library with both a **graphical and command line interface**,\n* mass-spectrometer and resolution agnostic,\n* can be applied to singly- and multiply-charged ions\n* can be used with any tracer element (having two or more isotopes)\n* account for the contribution of derivatization steps (if any),\n* generate isotopic InChIs of tracer isotopologues,\n* open-source, free and easy to install everywhere where Python 3 and pip run,\n* biologist-friendly.\n\n## Quick-start\nIsoCor requires Python 3.7 or higher and run on all platforms.\nPlease check [the documentation](https://isocor.readthedocs.io/en/latest/quickstart.html) for complete\ninstallation and usage instructions.\n\nUse `pip` to **install IsoCor from PyPi**:\n\n```bash\n$ pip install isocor\n```\n\nThen, start the graphical interface with:\n\n```bash\n$ isocor\n```\n\nIsoCor is also available directly from command-line and as a Python library.\n\n## Bug and feature requests\nIf you have an idea on how we could improve IsoCor please submit a new *issue*\nto [our GitHub issue tracker](https://github.com/MetaSys-LISBP/IsoCor/issues).\n\n\n## Developers guide\n### Contributions\nContributions are very welcome! :heart:\n\nPlease work on your own fork,\nfollow [PEP8](https://www.python.org/dev/peps/pep-0008/) style guide,\nand make sure you pass all the tests before a pull request.\n\n### Local install with pip\nIn development mode, do a `pip install -e /path/to/IsoCor` to install\nlocally the development version.\n\n### Unit tests\nIsotope correction is a complex task and we use unit tests to make sure\nthat critical features are not compromised during development.\n\nYou can run all tests by calling `pytest` in the shell at project's root directory.\n\n### Build the documentation locally\nBuild the HTML documentation with:\n\n```bash\n$ cd doc\n$ make html\n```\n\nThe PDF documentation can be built locally by replacing `html` by `latexpdf`\nin the command above. You will need a recent latex installation.\n\n## How to cite\nMillard P., Del\u00e9pine B., Guionnet M., Heuillet M., Bellvert F. and Letisse F. IsoCor: isotope correction for high-resolution MS labeling experiments. Bioinformatics, 2019, [doi: 10.1093/bioinformatics/btz209](https://doi.org/10.1093/bioinformatics/btz209)\n\n## Authors\nBaudoin Del\u00e9pine, Matthieu Guionnet, Pierre Millard\n\n## Contact\n:email: Pierre Millard, millard@insa-toulouse.fr\n",
"bugtrack_url": null,
"license": "",
"summary": "IsoCor: Isotope Correction for mass spectrometry labeling experiments",
"version": "2.2.2",
"project_urls": {
"Homepage": "https://github.com/MetaSys-LISBP/IsoCor/"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ad744f8c57ad54d785c1ee178e9ce52eae263b40233013d1f012d29766a33502",
"md5": "44b930e0a22b537c379a5a3cca4137d9",
"sha256": "d06358d59518324d09aa3985914acd822d87ef96312233e676620378eecbdcf0"
},
"downloads": -1,
"filename": "IsoCor-2.2.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "44b930e0a22b537c379a5a3cca4137d9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 62391,
"upload_time": "2023-11-02T15:48:48",
"upload_time_iso_8601": "2023-11-02T15:48:48.326406Z",
"url": "https://files.pythonhosted.org/packages/ad/74/4f8c57ad54d785c1ee178e9ce52eae263b40233013d1f012d29766a33502/IsoCor-2.2.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fd3e9dfdba9783d0425f8f30e132d5c76afe57673af2c336f3de1e8446114d21",
"md5": "8b7851146f03dd6dea17c5a066f4e65d",
"sha256": "eb4c91d2ed5b626adc6208454fd82b3e2ddd9a3ad0ccd964c8f16f9a310673e7"
},
"downloads": -1,
"filename": "IsoCor-2.2.2.tar.gz",
"has_sig": false,
"md5_digest": "8b7851146f03dd6dea17c5a066f4e65d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 53390,
"upload_time": "2023-11-02T15:48:49",
"upload_time_iso_8601": "2023-11-02T15:48:49.865072Z",
"url": "https://files.pythonhosted.org/packages/fd/3e/9dfdba9783d0425f8f30e132d5c76afe57673af2c336f3de1e8446114d21/IsoCor-2.2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-02 15:48:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "MetaSys-LISBP",
"github_project": "IsoCor",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "sphinx",
"specs": [
[
">=",
"1.4"
]
]
},
{
"name": "pandas",
"specs": [
[
">=",
"0.17.1"
]
]
},
{
"name": "scipy",
"specs": [
[
">=",
"0.12.1"
]
]
},
{
"name": "pytest",
"specs": []
},
{
"name": "jupyter_client",
"specs": []
},
{
"name": "ipykernel",
"specs": []
},
{
"name": "nbsphinx",
"specs": []
},
{
"name": "sphinx-argparse",
"specs": []
},
{
"name": "sphinxcontrib-napoleon",
"specs": []
},
{
"name": "sphinx-rtd-theme",
"specs": []
},
{
"name": "autodoc",
"specs": []
},
{
"name": "setuptools",
"specs": []
}
],
"tox": true,
"lcname": "isocor"
}
JSON
