Skip to main content
https://raw.githubusercontent.com/mobiusklein/ms_deisotope/master/docs/_static/logo.png

Documentation | PYPIBADGE | GHAB

A Library for Deisotoping and Charge State Deconvolution For Mass Spectrometry

This library combines brainpy and ms_peak_picker to build a toolkit for MS and MS/MS data. The goal of these libraries is to provide pieces of the puzzle for evaluating MS data modularly. The goal of this library is to combine the modules to streamline processing raw data.

Deconvolution

The general-purpose averagine-based deconvolution procedure can be called by using the high level API function deconvolute_peaks, which takes a sequence of peaks, an averagine model, and a isotopic goodness-of-fit scorer:

import ms_deisotope

deconvoluted_peaks, _ = ms_deisotope.deconvolute_peaks(peaks, averagine=ms_deisotope.peptide,
                                                       scorer=ms_deisotope.MSDeconVFitter(10.))

The result is a deisotoped and charge state deconvoluted peak list where each peak’s neutral mass is known and the fitted charge state is recorded along with the isotopic peaks that gave rise to the fit.

Refer to the Documentation for a deeper description of isotopic pattern fitting.

Averagine

An “Averagine” model is used to describe the composition of an “average amino acid”, which can then be used to approximate the composition and isotopic abundance of a combination of specific amino acids. Given that often the only solution available is to guess at the composition of a particular m/z because there are too many possible elemental compositions, this is the only tractable solution.

This library supports arbitrary Averagine formulae, but the Senko Averagine is provided by default: {“C”: 4.9384, “H”: 7.7583, “N”: 1.3577, “O”: 1.4773, “S”: 0.0417}

from ms_deisotope import Averagine
from ms_deisotope import plot

peptide_averagine = Averagine({"C": 4.9384, "H": 7.7583, "N": 1.3577, "O": 1.4773, "S": 0.0417})

plot.draw_peaklist(peptide_averagine.isotopic_cluster(1266.321, charge=1))
ms_deisotope includes several pre-defined averagines (or “averagoses” as may be more appropriate):
  1. Senko’s peptide - ms_deisotope.peptide

  2. Native N- and O-glycan - ms_deisotope.glycan

  3. Permethylated glycan - ms_deisotope.permethylated_glycan

  4. Glycopeptide - ms_deisotope.glycopeptide

  5. Sulfated Glycosaminoglycan - ms_deisotope.heparan_sulfate

  6. Unsulfated Glycosaminoglycan - ms_deisotope.heparin

Please see the Documentation for more information on mass spectrum data file reading/writing, peak sets, and lower-level signal processing tools.

Installing

ms_deisotope uses PEP 517 and 518 build system definition and isolation to ensure all of its compile-time dependencies are installed prior to building. Normal installation should work with pip, and pre-built wheels are available for Windows.

$ pip install ms_deisotope

C Extensions

ms_deisotope and several of its dependencies use C extensions to make iterative operations much faster. If you plan to use this library on a large amount of data, I highly recommend you ensure they are installed:

>>> import ms_deisotope
>>> ms_deisotope.DeconvolutedPeak
<type 'ms_deisotope._c.peak_set.DeconvolutedPeak'>

Building C extensions from source requires a version of Cython >= 3.0.3

Compiling C extensions requires that numpy, brain-isotopic-distribution, and ms_peak_picker be compiled and installed prior to building ms_deisotope:

pip install numpy
pip install -v brain-isotopic-distribution ms_peak_picker
pip install -v ms_deisotope

If these libraries are not installed, ms_deisotope will fall back to using pure Python implementations, which are much slower.

Release files for ms-deisotope 0.0.60

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ms-deisotope 0.0.60
File Size Uploaded
ms_deisotope-0.0.60.tar.gz 5.8 MB Details

Built distributions (wheels)

Table of built distributions (wheels) for ms-deisotope 0.0.60
File
ms_deisotope-0.0.60-cp312-cp312-win_amd64.whl CPython 3.12 CPython 3.12 Windows x86-64 Details
ms_deisotope-0.0.60-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl CPython 3.12 CPython 3.12 Linux glibc 2.17+ x86-64 Details
ms_deisotope-0.0.60-cp312-cp312-macosx_11_0_arm64.whl CPython 3.12 CPython 3.12 macOS 11.0+ ARM64 Details
ms_deisotope-0.0.60-cp311-cp311-win_amd64.whl CPython 3.11 CPython 3.11 Windows x86-64 Details
ms_deisotope-0.0.60-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl CPython 3.11 CPython 3.11 Linux glibc 2.17+ x86-64 Details
ms_deisotope-0.0.60-cp311-cp311-macosx_11_0_arm64.whl CPython 3.11 CPython 3.11 macOS 11.0+ ARM64 Details
ms_deisotope-0.0.60-cp310-cp310-win_amd64.whl CPython 3.10 CPython 3.10 Windows x86-64 Details
ms_deisotope-0.0.60-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl CPython 3.10 CPython 3.10 Linux glibc 2.17+ x86-64 Details
ms_deisotope-0.0.60-cp310-cp310-macosx_11_0_arm64.whl CPython 3.10 CPython 3.10 macOS 11.0+ ARM64 Details

Total release size: 114.4 MB

Release files / ms_deisotope-0.0.60.tar.gz

Download URL ms_deisotope-0.0.60.tar.gz
Size 5.8 MB
Tags Source
SHA-256 checksum
How to use checksums
a7141ad90e60e67e843d14c7396e925ea1f97e343248515452ecc40dff79b23c
BLAKE2b-256 checksum
How to use checksums
bed71e5fdbdbd8b4698486b6e592c873101323988a57400e1726e47bd54e4ed8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.13

Release files / ms_deisotope-0.0.60-cp312-cp312-win_amd64.whl

Download URL ms_deisotope-0.0.60-cp312-cp312-win_amd64.whl
Size 7.9 MB
Tags CPython 3.12 Windows x86-64
SHA-256 checksum
How to use checksums
bae54fe9100a0677761e2c2d9a463661b9352dd8799dcb2918bd9c21a4795b4c
BLAKE2b-256 checksum
How to use checksums
9a4236d8d9637a4403a2b52237322e3e0566d93c8e9384d8f9a3513c3a8a06b7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.13

Release files / ms_deisotope-0.0.60-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL ms_deisotope-0.0.60-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 20.3 MB
Tags CPython 3.12 Linux glibc 2.17+ x86-64
SHA-256 checksum
How to use checksums
f171a8b76e0217b46e3ef9b08811c965172d5e21a348128e3ece5adec522d9d1
BLAKE2b-256 checksum
How to use checksums
cde0d154b58af8ac2ad1b12e638fc0db0fac1dce8370df3e4c1364fb3628f586
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.13

Release files / ms_deisotope-0.0.60-cp312-cp312-macosx_11_0_arm64.whl

Download URL ms_deisotope-0.0.60-cp312-cp312-macosx_11_0_arm64.whl
Size 8.0 MB
Tags CPython 3.12 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
7ea518852ec9ce0296491d1789fd86b90c6d7910f0f29880f19b9f6d40bbd912
BLAKE2b-256 checksum
How to use checksums
731c43cacdd83003e9afc65cf1d299f333f03b52d4d22d540a563d7922d46c9a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.13

Release files / ms_deisotope-0.0.60-cp311-cp311-win_amd64.whl

Download URL ms_deisotope-0.0.60-cp311-cp311-win_amd64.whl
Size 7.9 MB
Tags CPython 3.11 Windows x86-64
SHA-256 checksum
How to use checksums
d384c6a7ea8dabb8a3ebf228b758208b49367756076538a3e07edc8cae47718c
BLAKE2b-256 checksum
How to use checksums
0be606fd032624f4b2c12fc0fab492333a91926fa7a311acfd93b6fc1349272f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.13

Release files / ms_deisotope-0.0.60-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL ms_deisotope-0.0.60-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 20.8 MB
Tags CPython 3.11 Linux glibc 2.17+ x86-64
SHA-256 checksum
How to use checksums
27b9349a09119293dfc82b9b03768c2c6965cb632de3782dff3db81292e3686c
BLAKE2b-256 checksum
How to use checksums
58b0b1afa7f268bccea77f6c1dcec06b612c759028e50bc13ffaba71ce9036b5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.13

Release files / ms_deisotope-0.0.60-cp311-cp311-macosx_11_0_arm64.whl

Download URL ms_deisotope-0.0.60-cp311-cp311-macosx_11_0_arm64.whl
Size 8.0 MB
Tags CPython 3.11 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
af794e9b08ae5e25b1d1443d01ba2fbd33b9921e81ecff486dc957aa3a5be330
BLAKE2b-256 checksum
How to use checksums
4571ff07fdd389723ff2bf06e8034ed617235c1f33635c63efff12ac26aeb167
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.13

Release files / ms_deisotope-0.0.60-cp310-cp310-win_amd64.whl

Download URL ms_deisotope-0.0.60-cp310-cp310-win_amd64.whl
Size 7.9 MB
Tags CPython 3.10 Windows x86-64
SHA-256 checksum
How to use checksums
ed231c25a43453ea6b0d30c947bd8213b86b7e7345669641a170d8848ea41882
BLAKE2b-256 checksum
How to use checksums
4d41b5033eb4a32574ac2717dab47685a705b82ab6e283fd5462307749c52dbb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.13

Release files / ms_deisotope-0.0.60-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL ms_deisotope-0.0.60-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 19.8 MB
Tags CPython 3.10 Linux glibc 2.17+ x86-64
SHA-256 checksum
How to use checksums
14a1ca8ec7bbb4208f13a7afb91b12e8f69fe9628dc11ff118ec722b21a4711c
BLAKE2b-256 checksum
How to use checksums
036c27a3a46631226302ce9c9b942415a9a007c3a037de8568e638c5e85c08f7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.13

Release files / ms_deisotope-0.0.60-cp310-cp310-macosx_11_0_arm64.whl

Download URL ms_deisotope-0.0.60-cp310-cp310-macosx_11_0_arm64.whl
Size 8.0 MB
Tags CPython 3.10 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
3b0d92490b22b5013205307dac5d67ec793bdef8064af8c9ba719ae811774d80
BLAKE2b-256 checksum
How to use checksums
1e834e94f792d4cbe65bcf92850f0cb4e0f72e650848dd7e372163dd07c45a33
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.13

Release history Release notifications | RSS feed

This release

0.0.60 This release

10 release files

0.0.40

3 release files

0.0.39

3 release files

0.0.38

3 release files

0.0.36

9 release files

0.0.35

9 release files

0.0.34

0.0.27

9 release files

0.0.26

9 release files

0.0.24

8 release files

0.0.21

8 release files

0.0.19

2 release files

0.0.16

4 release files

0.0.15

2 release files

0.0.14

4 release files

0.0.12

3 release files

0.0.9

5 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page