MNE-NIRS: Near-Infrared Spectroscopy Analysis
=============================================
.. image:: https://img.shields.io/badge/docs-master-brightgreen
:target: https://mne.tools/mne-nirs/
.. image:: https://github.com/mne-tools/mne-nirs/workflows/linux%20/%20pip/badge.svg
:target: https://github.com/mne-tools/mne-nirs/actions?query=workflow%3A%22linux+%2F+pip%22
.. image:: https://github.com/mne-tools/mne-nirs/workflows/macos%20/%20conda/badge.svg
:target: https://github.com/mne-tools/mne-nirs/actions?query=workflow%3A%22macos+%2F+conda%22
.. image:: https://github.com/mne-tools/mne-nirs/workflows/linux%20/%20conda/badge.svg
:target: https://github.com/mne-tools/mne-nirs/actions?query=workflow%3A%22linux+%2F+conda%22
.. image:: https://codecov.io/gh/mne-tools/mne-nirs/branch/main/graph/badge.svg
:target: https://codecov.io/gh/mne-tools/mne-nirs
.. image:: https://badge.fury.io/py/mne-nirs.svg
:target: https://badge.fury.io/py/mne-nirs
**MNE-NIRS** is an `MNE-Python <https://mne.tools>`_ compatible near-infrared spectroscopy processing package.
MNE-Python provides support for fNIRS analysis, this package extends that functionality and adds GLM analysis, helper functions, additional algorithms, data quality metrics, plotting, and file format support.
Documentation
-------------
Documentation for this project is hosted `here <https://mne-tools.github.io/mne-nirs>`_.
You can find a list of `examples within the documentation <https://mne.tools/mne-nirs/stable/auto_examples/index.html>`_.
Features
--------
.. features-start
MNE-NIRS and MNE-Python provide a wide variety of tools to use when processing fNIRS data including:
* Loading data from a `wide variety of devices <https://mne.tools/mne-nirs/stable/auto_examples/general/plot_01_data_io.html>`_, including `SNIRF files <https://mne.tools/mne-nirs/stable/auto_examples/general/plot_19_snirf.html>`_.
* `Apply 3D sensor locations <https://mne.tools/stable/overview/implementation.html#supported-formats-for-digitized-3d-locations>`_ from common digitisation systems such as Polhemus.
* Standard preprocessing including `optical density calculation and Beer-Lambert Law conversion <https://mne.tools/mne-nirs/stable/auto_examples/general/plot_15_waveform.html#id2>`_, filtering, etc.
* Data quality metrics including `scalp coupling index <https://mne.tools/mne-nirs/stable/auto_examples/general/plot_15_waveform.html#id3>`_ and `peak power <https://mne.tools/mne-nirs/stable/auto_examples/general/plot_22_quality.html#peak-power>`_.
* GLM analysis with a wide variety of customisation including `including FIR <https://mne.tools/mne-nirs/stable/auto_examples/general/plot_13_fir_glm.html>`_ or `canonical HRF <https://mne.tools/mne-nirs/stable/auto_examples/general/plot_11_hrf_measured.html>`_ analysis, higher order `autoregressive noise models <https://mne.tools/mne-nirs/stable/auto_examples/general/plot_10_hrf_simulation.html#using-autoregressive-models-in-the-glm-to-account-for-noise-structure>`_, `short channel regression, region of interest analysis <https://mne.tools/mne-nirs/stable/auto_examples/general/plot_11_hrf_measured.html>`_, etc.
* Visualisation tools for all stages of processing from raw data to processed waveforms, GLM result visualisation, including both sensor and cortical surface projections.
* Data cleaning functions including popular short channel techniques and negative correlation enhancement.
* Group level analysis using `(robust) linear mixed effects models <https://mne.tools/mne-nirs/stable/auto_examples/general/plot_12_group_glm.html>`_ and `waveform averaging <https://mne.tools/mne-nirs/stable/auto_examples/general/plot_16_waveform_group.html>`_.
* And much more! Check out the documentation `examples <https://mne.tools/mne-nirs/stable/auto_examples/index.html>`__ and the API `for more details <https://mne.tools/mne-nirs/stable/api.html>`_.
.. features-end
Contributing
------------
Contributions are welcome (more than welcome!). Contributions can be feature requests, improved documentation, bug reports, code improvements, new code, etc. Anything will be appreciated. *Note*: this package adheres to the same contribution `standards as MNE <https://mne.tools/stable/install/contributing.html>`_.
Acknowledgements
----------------
This package is built on top of many other great packages. If you use MNE-NIRS you should also acknowledge these packages.
MNE-Python: https://mne.tools/dev/overview/cite.html
Nilearn: http://nilearn.github.io/authors.html#citing
statsmodels: https://www.statsmodels.org/stable/index.html#citation
Until there is a journal article specifically on MNE-NIRS, please cite `this article <https://doi.org/10.1117/1.NPh.8.2.025008>`_.
Docker
------
To start a jupyter lab server with a specified MNE-NIRS version, and mount a local directory on a mac or nix computer use:
.. code-block:: console
docker run -p 8888:8888 -v `pwd`:/home/mne_user ghcr.io/mne-tools/mne-nirs:v0.1.2 jupyter-lab --ip="*"
Or on windows:
.. code-block:: console
docker run -p 8888:8888 -v %cd%:/home/mne_user ghcr.io/mne-tools/mne-nirs:v0.1.2 jupyter-lab --ip="*"
Raw data
{
"_id": null,
"home_page": "https://mne.tools/mne-nirs/",
"name": "mne-nirs",
"maintainer": "Robert Luke",
"docs_url": null,
"requires_python": "",
"maintainer_email": "robert.luke@mq.edu.au",
"keywords": "neuroscience neuroimaging fNIRS NIRS brain",
"author": "",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/ac/ec/aa96475da5e5a75c01c333c0020076b9017b7a7042a4ef5003268eb4593d/mne-nirs-0.6.0.tar.gz",
"platform": null,
"description": "MNE-NIRS: Near-Infrared Spectroscopy Analysis\n=============================================\n\n.. image:: https://img.shields.io/badge/docs-master-brightgreen\n :target: https://mne.tools/mne-nirs/\n \n.. image:: https://github.com/mne-tools/mne-nirs/workflows/linux%20/%20pip/badge.svg\n :target: https://github.com/mne-tools/mne-nirs/actions?query=workflow%3A%22linux+%2F+pip%22\n \n.. image:: https://github.com/mne-tools/mne-nirs/workflows/macos%20/%20conda/badge.svg\n :target: https://github.com/mne-tools/mne-nirs/actions?query=workflow%3A%22macos+%2F+conda%22\n \n.. image:: https://github.com/mne-tools/mne-nirs/workflows/linux%20/%20conda/badge.svg\n :target: https://github.com/mne-tools/mne-nirs/actions?query=workflow%3A%22linux+%2F+conda%22\n \n.. image:: https://codecov.io/gh/mne-tools/mne-nirs/branch/main/graph/badge.svg\n :target: https://codecov.io/gh/mne-tools/mne-nirs\n \n.. image:: https://badge.fury.io/py/mne-nirs.svg\n :target: https://badge.fury.io/py/mne-nirs\n\n**MNE-NIRS** is an `MNE-Python <https://mne.tools>`_ compatible near-infrared spectroscopy processing package.\n\nMNE-Python provides support for fNIRS analysis, this package extends that functionality and adds GLM analysis, helper functions, additional algorithms, data quality metrics, plotting, and file format support.\n\n\nDocumentation\n-------------\n\nDocumentation for this project is hosted `here <https://mne-tools.github.io/mne-nirs>`_.\n\nYou can find a list of `examples within the documentation <https://mne.tools/mne-nirs/stable/auto_examples/index.html>`_.\n\n\nFeatures\n--------\n\n.. features-start\n\nMNE-NIRS and MNE-Python provide a wide variety of tools to use when processing fNIRS data including:\n\n* Loading data from a `wide variety of devices <https://mne.tools/mne-nirs/stable/auto_examples/general/plot_01_data_io.html>`_, including `SNIRF files <https://mne.tools/mne-nirs/stable/auto_examples/general/plot_19_snirf.html>`_.\n* `Apply 3D sensor locations <https://mne.tools/stable/overview/implementation.html#supported-formats-for-digitized-3d-locations>`_ from common digitisation systems such as Polhemus.\n* Standard preprocessing including `optical density calculation and Beer-Lambert Law conversion <https://mne.tools/mne-nirs/stable/auto_examples/general/plot_15_waveform.html#id2>`_, filtering, etc.\n* Data quality metrics including `scalp coupling index <https://mne.tools/mne-nirs/stable/auto_examples/general/plot_15_waveform.html#id3>`_ and `peak power <https://mne.tools/mne-nirs/stable/auto_examples/general/plot_22_quality.html#peak-power>`_.\n* GLM analysis with a wide variety of customisation including `including FIR <https://mne.tools/mne-nirs/stable/auto_examples/general/plot_13_fir_glm.html>`_ or `canonical HRF <https://mne.tools/mne-nirs/stable/auto_examples/general/plot_11_hrf_measured.html>`_ analysis, higher order `autoregressive noise models <https://mne.tools/mne-nirs/stable/auto_examples/general/plot_10_hrf_simulation.html#using-autoregressive-models-in-the-glm-to-account-for-noise-structure>`_, `short channel regression, region of interest analysis <https://mne.tools/mne-nirs/stable/auto_examples/general/plot_11_hrf_measured.html>`_, etc.\n* Visualisation tools for all stages of processing from raw data to processed waveforms, GLM result visualisation, including both sensor and cortical surface projections.\n* Data cleaning functions including popular short channel techniques and negative correlation enhancement.\n* Group level analysis using `(robust) linear mixed effects models <https://mne.tools/mne-nirs/stable/auto_examples/general/plot_12_group_glm.html>`_ and `waveform averaging <https://mne.tools/mne-nirs/stable/auto_examples/general/plot_16_waveform_group.html>`_.\n* And much more! Check out the documentation `examples <https://mne.tools/mne-nirs/stable/auto_examples/index.html>`__ and the API `for more details <https://mne.tools/mne-nirs/stable/api.html>`_.\n\n.. features-end\n\nContributing\n------------\n\nContributions are welcome (more than welcome!). Contributions can be feature requests, improved documentation, bug reports, code improvements, new code, etc. Anything will be appreciated. *Note*: this package adheres to the same contribution `standards as MNE <https://mne.tools/stable/install/contributing.html>`_.\n\n\nAcknowledgements\n----------------\n\nThis package is built on top of many other great packages. If you use MNE-NIRS you should also acknowledge these packages.\n\nMNE-Python: https://mne.tools/dev/overview/cite.html\n\nNilearn: http://nilearn.github.io/authors.html#citing\n\nstatsmodels: https://www.statsmodels.org/stable/index.html#citation\n\nUntil there is a journal article specifically on MNE-NIRS, please cite `this article <https://doi.org/10.1117/1.NPh.8.2.025008>`_.\n\n\nDocker\n------\n\nTo start a jupyter lab server with a specified MNE-NIRS version, and mount a local directory on a mac or nix computer use:\n\n.. code-block:: console\n\n docker run -p 8888:8888 -v `pwd`:/home/mne_user ghcr.io/mne-tools/mne-nirs:v0.1.2 jupyter-lab --ip=\"*\"\n\nOr on windows:\n\n.. code-block:: console\n\n docker run -p 8888:8888 -v %cd%:/home/mne_user ghcr.io/mne-tools/mne-nirs:v0.1.2 jupyter-lab --ip=\"*\"\n",
"bugtrack_url": null,
"license": "BSD (3-clause)",
"summary": "An MNE compatible package for processing near-infrared spectroscopy data.",
"version": "0.6.0",
"project_urls": {
"Documentation": "https://mne.tools/mne-nirs/",
"Download": "https://github.com/mne-tools/mne-nirs",
"Homepage": "https://mne.tools/mne-nirs/",
"Source": "https://github.com/mne-tools/mne-nirs/",
"Tracker": "https://github.com/mne-tools/mne-nirs/issues/"
},
"split_keywords": [
"neuroscience",
"neuroimaging",
"fnirs",
"nirs",
"brain"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "38e111d9f6abb0430ba027122b1a521ab660586abd520a68d27b7471ff8b49e7",
"md5": "d0dbea9d3853221ee2101e919df98b8f",
"sha256": "dcc3615f943a3ff68b34e92579f3a16f4926663c3483beb72dbbb30fd6ff62ad"
},
"downloads": -1,
"filename": "mne_nirs-0.6.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d0dbea9d3853221ee2101e919df98b8f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 98775,
"upload_time": "2023-11-21T03:16:38",
"upload_time_iso_8601": "2023-11-21T03:16:38.853486Z",
"url": "https://files.pythonhosted.org/packages/38/e1/11d9f6abb0430ba027122b1a521ab660586abd520a68d27b7471ff8b49e7/mne_nirs-0.6.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "acecaa96475da5e5a75c01c333c0020076b9017b7a7042a4ef5003268eb4593d",
"md5": "91c1364ce5f66696b0fb0777dd2f4abf",
"sha256": "cacda4022505781bca61b3a8dcefc82b20d54ccbbf08de44c083a79b64fbfeb1"
},
"downloads": -1,
"filename": "mne-nirs-0.6.0.tar.gz",
"has_sig": false,
"md5_digest": "91c1364ce5f66696b0fb0777dd2f4abf",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 622552,
"upload_time": "2023-11-21T03:16:41",
"upload_time_iso_8601": "2023-11-21T03:16:41.195466Z",
"url": "https://files.pythonhosted.org/packages/ac/ec/aa96475da5e5a75c01c333c0020076b9017b7a7042a4ef5003268eb4593d/mne-nirs-0.6.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-21 03:16:41",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mne-tools",
"github_project": "mne-nirs",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"circle": true,
"requirements": [],
"lcname": "mne-nirs"
}