Metadata-Version: 2.4
Name: tidyms2
Version: 0.2.1
Summary: Tools to process mass spectrometry data.
Author-email: Gabriel Riquelme <griquelme.chm@gmail.com>
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27.2
Requires-Dist: numpy>=2.1.0
Requires-Dist: pydantic>=2.8.2
Requires-Dist: pyyaml>=6.0.2
Requires-Dist: scikit-learn>=1.5.2
Requires-Dist: scipy>=1.14.1
Requires-Dist: sqlalchemy>=2.0.35
Requires-Dist: uuid-utils>=0.9.0
Provides-Extra: dev
Requires-Dist: commitizen>=3.30.0; extra == 'dev'
Requires-Dist: pre-commit>=4.0.1; extra == 'dev'
Requires-Dist: pyright>=1.1.386; extra == 'dev'
Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
Requires-Dist: pytest-sugar>=1.0.0; extra == 'dev'
Requires-Dist: pytest>=8.3.3; extra == 'dev'
Requires-Dist: ruff>=0.7.1; extra == 'dev'
Requires-Dist: tach>=0.26.1; extra == 'dev'
Provides-Extra: docs
Requires-Dist: autodoc-pydantic>=2.2.0; extra == 'docs'
Requires-Dist: matplotlib>=3.10.0; extra == 'docs'
Requires-Dist: pydata-sphinx-theme>=0.16.0; extra == 'docs'
Requires-Dist: sphinx-autodoc-typehints>=2.5.0; extra == 'docs'
Requires-Dist: sphinx-copybutton>=0.5.2; extra == 'docs'
Requires-Dist: sphinx-design>=0.6.1; extra == 'docs'
Requires-Dist: sphinx-pyproject>=0.3.0; extra == 'docs'
Requires-Dist: sphinx>=8.1.3; extra == 'docs'
Description-Content-Type: text/markdown

# TidyMS2 [![PR](https://github.com/griquelme/tidyms2/actions/workflows/pr.yaml/badge.svg)](https://github.com/griquelme/tidyms2/actions/workflows/pr.yaml) [![publish to pypi](https://github.com/griquelme/tidyms2/actions/workflows/publish.yaml/badge.svg)](https://github.com/griquelme/tidyms2/actions/workflows/publish.yaml)

Tools to process mass spectrometry data.

TidyMS2 is an upgraded version from [TidyMS](https://github.com/griquelme/tidyms), built from scratch and designed
to work with Python latest practices.

TidyMS2 offers a highly customizable framework for processing mass spectrometry datasets:

**For processing MS datasets:**

- tools for processing LC-MS datasets: build pipelines to define how to process your data and TidyMS manages the rest.
- optimized for scalability: efficiently processes datasets with thousands of samples while maintaining a minimal memory footprint.
- test your pipelines with dataset simulation utilities
- data persistence for intermediate data and results 
- result visualization

**For creating new processing algorithms**

- a highly extensive data model for expressing features
- a data flow model that validates and manages data through your data pipeline. 

Installation
------------

> [!WARNING]
> TidyMS2 is currently in early development, and the API may be subject to breaking changes until the 1.0
> release. Please be aware that future updates may alter functionality or behavior. We recommend keeping
> an eye on the release notes and updating your usage accordingly. Once the library reaches version 1.0, the
> API will be considered stable, and breaking changes will adapt to the SemVer policy.

TidyMS is installed using pip:

```shell
pip install tidyms2
```

Documentation
-------------

The library documentation is available [here](https://tidyms.readthedocs.io/en/latest/).

Getting help
------------

The library documentation contains tutorials on a variety on topics. If you weren't able to find an answer
to your problem, you can use the project [discussion board](https://github.com/griquelme/tidyms2/discussions)

Development
-----------

If you encounter a problem or bug, you can report it using the [issue tracker](https://github.com/griquelme/tidyms2/issues).

Before submitting a new issue, please search the issue tracker to see if the problem has already been reported.

If your question is about how to achieve a specific task or use the library in a certain way, we recommend
posting it in the [discussions](https://github.com/griquelme/tidyms2/discussions) section.

When reporting an issue, it's helpful to include the following details:

- A code snippet that reproduces the problem.
- If an error occurs, please include the full traceback.
- A brief explanation of why the current behavior is incorrect or unexpected.

For guidelines on how to write an issue report, refer to this [post](https://matthewrocklin.com/minimal-bug-reports).


Contributing
------------

Checkout the developer and contributing guides in the library [documentation](https://tidyms.readthedocs.io/en/latest/)

Citation
--------

If you find TidyMS useful, we would appreciate citations:

Riquelme, G.; Zabalegui, N.; Marchi, P.; Jones, C.M.; Monge, M.E. A Python-Based Pipeline for Preprocessing
LC–MS Data for Untargeted Metabolomics Workflows. _Metabolites_ **2020**, 10, 416, doi:10.3390/metabo10100416.