File: README.rst

package info (click to toggle)
python-pymzml 2.5.2%2Brepack1-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 27,792 kB
  • sloc: python: 6,495; pascal: 341; makefile: 233; sh: 30
file content (148 lines) | stat: -rw-r--r-- 3,731 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148

############
Introduction
############


*******************
General information
*******************

Module to parse mzML data in Python based on cElementTree

Copyright 2010-2021 by:

    | M. Kösters,
    | J. Leufken,
    | T. Bald,
    | A. Niehues,
    | S. Schulze,
    | K. Sugimoto,
    | R.P. Zahedi,
    | M. Hippler,
    | S.A. Leidel,
    | C. Fufezan,



===================
Contact information
===================

Please refer to:

    | Dr. Christian Fufezan
    | Group Leader Experimental Bioinformatics
    | Cellzome GmbH
    | R&D Platform Technology & Science
    | GSK
    | Germany
    | eMail: christian@fufezan.net
    |
    | https://fufezan.net


*******
Summary
*******

pymzML is an extension to Python that offers
    * a) easy access to mass spectrometry (MS) data that allows the rapid development of tools
    * b) a very fast parser for mzML data, the standard mass spectrometry data format
    * c) a set of functions to compare and/or handle spectra
    * d) random access in compressed files
    * e) interactive data visualization

**************
Implementation
**************

pymzML requires Python3.7+.
The module is freely available on pymzml.github.com or pypi,
published under MIT license and only requires numpy and regex, however there are several optional dependencies for extended functionality like interactive plotting and deconvolution.


********
Download
********

Get the latest version via github
    | https://github.com/pymzml/pymzML

The complete Documentation can be found as pdf
    | http://pymzml.github.com/dist/pymzml.pdf


********
Citation
********

M Kösters, J Leufken, S Schulze, K Sugimoto, J Klein, R P Zahedi, M Hippler, S A Leidel, C Fufezan; pymzML v2.0: introducing a highly compressed and seekable gzip format, Bioinformatics,
doi: https://doi.org/10.1093/bioinformatics/bty046


************
Installation
************

pymzML requires `Python`_ 3.7 or higher.

.. note::

    Consider to use a Python virtual environment for easy installation and use.
    Further, usage of python3.7+ is recommended.


Download pymzML using `GitHub`_ **or** the zip file:

* GitHub version: Start by cloning the GitHub repository::

   user@localhost:~$ git clone https://github.com/pymzML/pymzml.git
   user@localhost:~$ cd pymzml
   user@localhost:~$ pip install -r requirements.txt
   user@localhost:~$ python setup.py install

.. _Python:
   https://www.python.org/downloads/

.. _GitHub:
   https://github.com/pymzML/pymzml

* pypi version::

   user@localhost:~$ pip install pymzml # install standard version
   user@localhost:~$ pip install "pymzml[plot]" # with plotting support
   user@localhost:~$ pip install "pymzml[pynumpress]" # with pynumpress support
   user@localhost:~$ pip install "pymzml[deconvolution]" # with deconvolution support using ms_deisotope
   user@localhost:~$ pip install "pymzml[full]" # full featured


If you have troubles installing the dependencies, install numpy first separately,
since pynumpress requires numpy to be installed.

If you use Windows 7 please use the 'SDK7.1 command prompt' for installation
of pymzML to assure correct compiling of the C extensions.

=======
Testing
=======

To test the package and correct installation::

    tox


*************
Contributing
*************

Please read the contribution guidelines before contributing `here </CONTRIBUTING.rst>`_


****************
Code of Conduct
****************

Since pymzML is an open source project maintained by the community, we established a code of conduct
in order to facilitate an inclusive environment for all users, contributors and project memebers.
Before contributing to pymzML, please read the code of conduct `here </CODE_OF_CONDUCT.md>`_