Skip to content

MS-Quality-Hub/pymzqc

Repository files navigation

MZQC python library

unit-tests Documentation Status Docker Repository on Quay PyPi version Open In Colab

A python library to create and use mzQC files. Specifically, the library facilitates access to mzQC files in form of a directly usable object representation of mzQC and offers additional functionality to:

  • serialise
  • deserialise
  • check syntax
  • check semantics

The library follows the formats versioning (which is 'v(Major).(Minor).(Patch)').

This library implements python modules for (de-)serialisation and validity checks of the PSI fileformat mzQC. Find the specification document, examples, and and further documentation there.

Install

Latest Release

Most people will want to install the latest release version of pymzqc. Please install pymzqc via pypi:

pip install pymzqc

From Git

If you want the latest development version, use:

pip install -U git+https://github.com/MS-Quality-hub/pymzqc.git#egg=pymzqc

Containers

However, we recommend using the ready-built containers to check out the latest updates.

Documentation

To get a nice and simple overview of how pymzqc works, visit here. successfully installed the library and want to jump right in and use the library, we suggest the a peek at the codestructure.

If you however just want to get your toes wet, have a look at the interactive guides.

Interactive pymzqc

Have a go with our interactive python notebooks to explore what is possible.

Development

Contributions are welcome! (Just fork, develop, and open PR.)

Repository structure

The python package's code is located in the mzqc folder, continuous testing code in tests, the documentation in doc. The libray-use container descriptions are in containers, if you want a container for library-development, you can use the container description within .devcontainer, more development presets can be found in .vscode. The jupyter and accessories folders are subprojects making use of the library. See their README in the respective sub-folders.

Documentation

The code documentation style convention is of the type Sphinx/numpy.