mne-tools / mne-python

MNE: Magnetoencephalography (MEG) and Electroencephalography (EEG) in Python
https://mne.tools
BSD 3-Clause "New" or "Revised" License
2.74k stars 1.33k forks source link
ecog eeg electrocorticography electroencephalography machine-learning magnetoencephalography meg neuroimaging neuroscience python statistics visualization

.. -- mode: rst --

|MNE|

MNE-Python

MNE-Python is an open-source Python package for exploring, visualizing, and analyzing human neurophysiological data such as MEG, EEG, sEEG, ECoG, and more. It includes modules for data input/output, preprocessing, visualization, source estimation, time-frequency analysis, connectivity analysis, machine learning, statistics, and more.

Documentation ^^^^^^^^^^^^^

Documentation_ for MNE-Python encompasses installation instructions, tutorials, and examples for a wide variety of topics, contributing guidelines, and an API reference.

Forum ^^^^^^

The user forum_ is the best place to ask questions about MNE-Python usage or the contribution process. The forum also features job opportunities and other announcements.

If you find a bug or have an idea for a new feature that should be added to MNE-Python, please use the issue tracker <https://github.com/mne-tools/mne-python/issues/new/choose>__ of our GitHub repository.

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

To install the latest stable version of MNE-Python with minimal dependencies only, use pip_ in a terminal:

.. code-block:: console

$ pip install --upgrade mne

For more complete instructions, including our standalone installers and more advanced installation methods, please refer to the installation guide_.

Get the development version ^^^^^^^^^^^^^^^^^^^^^^^^^^^

To install the latest development version of MNE-Python using pip_, open a terminal and type:

.. code-block:: console

$ pip install --upgrade https://github.com/mne-tools/mne-python/archive/refs/heads/main.zip

To clone the repository with git <https://git-scm.com/>__, open a terminal and type:

.. code-block:: console

$ git clone https://github.com/mne-tools/mne-python.git

Dependencies ^^^^^^^^^^^^

The minimum required dependencies to run MNE-Python are:

.. ↓↓↓ BEGIN CORE DEPS LIST. DO NOT EDIT! HANDLED BY PRE-COMMIT HOOK ↓↓↓

.. ↑↑↑ END CORE DEPS LIST. DO NOT EDIT! HANDLED BY PRE-COMMIT HOOK ↑↑↑

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

Please see the contributing guidelines <https://mne.tools/dev/development/contributing.html>__ on our documentation website.

About ^^^^^

+---------+------------+----------------+ | CI | |Codecov| | |Bandit| | +---------+------------+----------------+ | Package | |PyPI| | |conda-forge| | +---------+------------+----------------+ | Docs | |Docs| | |Discourse| | +---------+------------+----------------+ | Meta | |Zenodo| | |OpenSSF| | +---------+------------+----------------+

License ^^^^^^^

MNE-Python is licensed under the BSD-3-Clause license.

.. _Documentation: https://mne.tools/dev/ .. _user forum: https://mne.discourse.group .. _installation guide: https://mne.tools/dev/install/index.html .. _pip: https://pip.pypa.io/en/stable/

.. |PyPI| image:: https://img.shields.io/pypi/dm/mne.svg?label=PyPI :target: https://pypi.org/project/mne/

.. |conda-forge| image:: https://img.shields.io/conda/dn/conda-forge/mne.svg?label=Conda :target: https://anaconda.org/conda-forge/mne

.. |Docs| image:: https://img.shields.io/badge/Docs-online-green?label=Documentation :target: https://mne.tools/dev/

.. |Zenodo| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.592483.svg :target: https://doi.org/10.5281/zenodo.592483

.. |Discourse| image:: https://img.shields.io/discourse/status?label=Forum&server=https%3A%2F%2Fmne.discourse.group%2F :target: https://mne.discourse.group/

.. |Codecov| image:: https://img.shields.io/codecov/c/github/mne-tools/mne-python?label=Coverage :target: https://codecov.io/gh/mne-tools/mne-python

.. |Bandit| image:: https://img.shields.io/badge/Security-Bandit-yellow.svg :target: https://github.com/PyCQA/bandit

.. |OpenSSF| image:: https://www.bestpractices.dev/projects/7783/badge :target: https://www.bestpractices.dev/projects/7783

.. |MNE| image:: https://mne.tools/dev/_static/mne_logo_gray.svg :target: https://mne.tools/dev/