openmrslab / suspect

MRS processing tools
https://suspect.readthedocs.io/en/latest/
MIT License
33 stars 23 forks source link
magnetic-resonance-spectroscopy spectroscopy

suspect

============ ================= CI |build_status| Coveralls |coverage_status| Code Climate |code_climate| ============ =================

.. |build_status| image:: https://github.com/openmrslab/suspect/actions/workflows/ci-workflows.yaml/badge.svg?branch=master :target: https://github.com/openmrslab/suspect/actions/workflows/ci-workflows.yaml?query=branch%3Amaster

.. |coverage_status| image:: https://coveralls.io/repos/github/openmrslab/suspect/badge.svg?branch=master :target: https://coveralls.io/github/openmrslab/suspect?branch=master

.. |code_climate| image:: https://codeclimate.com/github/openmrslab/suspect/badges/gpa.svg :target: https://codeclimate.com/github/openmrslab/suspect

Suspect is a Python package for processing MR spectroscopy data. It supports reading data from most common formats (with more on the way) and many different algorithms for core processing steps. Suspect allows researchers to build custom data processing scripts from reliable, modular building blocks and easily share their techniques with other labs around the world.

Installation ^^^^^^^^^^^^

Suspect itself is a pure Python package and is easy to install with pip_. However it does depend on various other packages, some of which are not so easy to install.

  1. Obtain Python and the SciPy stack:

    Suspect requires Python 3 and makes heavy use of numpy and other parts of the Scientific Python stack. The easiest way to obtain this, along with a large number of other useful scientific packages, is to download the free Anaconda package. Alternatively check here for other ways to install these core packages.

  2. Install suspect

    pip install suspect will automatically download and install the latest version of suspect, along with all remaining other dependencies.

.. _pip: https://pip.pypa.io/en/stable/ .. _pydicom: https://pydicom.readthedocs.io/en/stable/index.html .. _Anaconda: https://www.continuum.io/downloads .. _here: http://www.scipy.org/install.html

Getting Started ^^^^^^^^^^^^^^^

Suspect is still a young package and we are working hard to get useful examples out there. Documentation for the project is available at http://suspect.readthedocs.io/en/latest/

Contributing ^^^^^^^^^^^^

If you are interested in helping out with any part of suspect or the OpenMRSLab project, we would love to hear from you.

License ^^^^^^^

Suspect is released under the MIT license