# mne-pipeline-hd
### A Pipeline-GUI for [MNE-Python](https://mne.tools/stable/index.html) from MEG-Lab Heidelberg
![mne-pipeline-hd Logo](mne_pipeline_hd/resource/mne_pipeline_logo_evee_smaller.jpg)
## Installation
1. Install MNE-python as instructed on
the [website](https://www.martinos.org/mne/stable/install_mne_python.html),
I would recommend to install in a separate conda environment with:
`conda env create -n mne_p -f environment.yml`
2. `conda activate mne_p`
3. `pip install https://github.com/marsipu/mne-pipeline-hd/zipball/main`
## Update
Run `pip install --upgrade --no-deps --force-reinstall https://github.com/marsipu/mne-pipeline-hd/zipball/main`
for an update to the development version
or `pip install --upgrade mne-pipeline-hd` for the latest release.
## Start
Run `mne_pipeline_hd` in your mne_pipeline-environment (`conda activate mne_p`)
**or**
run \_\_main\_\_.py from the terminal or an IDE like PyCharm, VSCode, Atom,
etc.
***When using the pipeline and its functions bear in mind that the pipeline is
still in development!
The basic functions supplied are just a suggestion and you should verify before
usage if they do what you need.
They are also partly still adjusted to specific requirements which may not
apply to all data.***
## Bug-Report/Feature-Request
Please report bugs on GitHub as an issue or to me (dev@earthman-music.de)
directly.
And if you got ideas on how to improve the pipeline or some feature-requests,
you are welcome to open an issue too or send an e-mail (dev@earthman-music.de)
## Contribute and build your own functions/fix bugs
I you want to help by contributing, I would be very happy:
You need a [GitHub-Account](https://github.com/)
and should
have [git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
installed.
1. Fork this repository on GitHub
2. Move to the folder where you want to clone to
3. Clone **your forked repository** with git from a
terminal: `git clone <url you get from the green clone-button from your forked repository on GitHub>`
4. Add upstream to git for
updates: `git remote add upstream git://github.com/marsipu/mne-pipeline-hd.git`
5. Install development version with pip: `pip install -e ./`
6. Create a branch for changes: `git checkout -b <branch-name>`
7. Commit changes: `git commit -am "<your commit message>"`
8. Push changes to your forked repository on GitHub: `git push`
9. Make "New pull request" from your new feature branch
You can always [write me](mailto:dev@earthman-music.de), if you have questions
about the contribution-process
or about the program-structure.
## Acknowledgments
This Pipeline is build on top
of [MNE-Python](https://mne.tools/stable/index.html)
> A. Gramfort, M. Luessi, E. Larson, D. Engemann, D. Strohmeier, C. Brodbeck,
> L. Parkkonen, M. Hämäläinen,
> MNE software for processing MEG and EEG data, NeuroImage, Volume 86, 1
> February 2014, Pages 446-460, ISSN 1053-8119,
> [DOI](https://doi.org/10.1016/j.neuroimage.2013.10.027)
It was inspired by a pipeline
from [Lau M. Andersen](https://doi.org/10.3389/fnins.2018.00006)
> Andersen LM. Group Analysis in MNE-Python of Evoked Responses from a Tactile
> Stimulation Paradigm: A Pipeline for
> Reproducibility at Every Step of Processing, Going from Individual Sensor
> Space Representations to an across-Group
> Source Space Representation. Front Neurosci. 2018 Jan 22;12:6. doi:
> 10.3389/fnins.2018.00006. PMID: 29403349;
> PMCID: PMC5786561.
This program also
integrates [autoreject](https://doi.org/10.1016/j.neuroimage.2017.06.030)
> Mainak Jas, Denis Engemann, Yousra Bekhti, Federico Raimondo, and Alexandre
> Gramfort. 2017.
> “Autoreject: Automated artifact rejection for MEG and EEG data”. NeuroImage,
> 159, 417-429.
Many ideas and basics for GUI-Programming where taken
from [LearnPyQt](https://www.learnpyqt.com/) and numerous
stackoverflow-questions/solutions.
The development is financially supported
by [Heidelberg University](https://www.uni-heidelberg.de/de/forschung/forschungsprofil/fields-of-focus/field-of-focus-i).
Thank you to the members of my laboratory (especially my
supervisor [Andre Rupp](https://www.klinikum.uni-heidelberg.de/personen/pd-dr-phil-andre-rupp-271))
for their feedback and testing in the early stages of development.
Raw data
{
"_id": null,
"home_page": "",
"name": "mne-pipeline-hd",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "mne-python,meg,eeg,pipeline,gui,heidelberg",
"author": "",
"author_email": "Martin Schulz <dev@mgschulz.de>",
"download_url": "https://files.pythonhosted.org/packages/e3/13/dc55bac0aca47370a98371caca70ba4ed2309a5917e67811b9f96fe4c095/mne-pipeline-hd-0.3.3a0.tar.gz",
"platform": null,
"description": "# mne-pipeline-hd\n\n### A Pipeline-GUI for [MNE-Python](https://mne.tools/stable/index.html) from MEG-Lab Heidelberg\n\n![mne-pipeline-hd Logo](mne_pipeline_hd/resource/mne_pipeline_logo_evee_smaller.jpg)\n\n## Installation\n\n1. Install MNE-python as instructed on\n the [website](https://www.martinos.org/mne/stable/install_mne_python.html),\n I would recommend to install in a separate conda environment with:\n `conda env create -n mne_p -f environment.yml`\n2. `conda activate mne_p`\n3. `pip install https://github.com/marsipu/mne-pipeline-hd/zipball/main`\n\n## Update\n\nRun `pip install --upgrade --no-deps --force-reinstall https://github.com/marsipu/mne-pipeline-hd/zipball/main`\nfor an update to the development version\nor `pip install --upgrade mne-pipeline-hd` for the latest release.\n\n## Start\n\nRun `mne_pipeline_hd` in your mne_pipeline-environment (`conda activate mne_p`)\n\n**or**\n\nrun \\_\\_main\\_\\_.py from the terminal or an IDE like PyCharm, VSCode, Atom,\netc.\n\n***When using the pipeline and its functions bear in mind that the pipeline is\nstill in development!\nThe basic functions supplied are just a suggestion and you should verify before\nusage if they do what you need.\nThey are also partly still adjusted to specific requirements which may not\napply to all data.***\n\n## Bug-Report/Feature-Request\n\nPlease report bugs on GitHub as an issue or to me (dev@earthman-music.de)\ndirectly.\nAnd if you got ideas on how to improve the pipeline or some feature-requests,\nyou are welcome to open an issue too or send an e-mail (dev@earthman-music.de)\n\n## Contribute and build your own functions/fix bugs\n\nI you want to help by contributing, I would be very happy:\n\nYou need a [GitHub-Account](https://github.com/)\nand should\nhave [git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)\ninstalled.\n\n1. Fork this repository on GitHub\n2. Move to the folder where you want to clone to\n3. Clone **your forked repository** with git from a\n terminal: `git clone <url you get from the green clone-button from your forked repository on GitHub>`\n4. Add upstream to git for\n updates: `git remote add upstream git://github.com/marsipu/mne-pipeline-hd.git`\n5. Install development version with pip: `pip install -e ./`\n6. Create a branch for changes: `git checkout -b <branch-name>`\n7. Commit changes: `git commit -am \"<your commit message>\"`\n8. Push changes to your forked repository on GitHub: `git push`\n9. Make \"New pull request\" from your new feature branch\n\nYou can always [write me](mailto:dev@earthman-music.de), if you have questions\nabout the contribution-process\nor about the program-structure.\n\n## Acknowledgments\n\nThis Pipeline is build on top\nof [MNE-Python](https://mne.tools/stable/index.html)\n> A. Gramfort, M. Luessi, E. Larson, D. Engemann, D. Strohmeier, C. Brodbeck,\n> L. Parkkonen, M. H\u00e4m\u00e4l\u00e4inen,\n> MNE software for processing MEG and EEG data, NeuroImage, Volume 86, 1\n> February 2014, Pages 446-460, ISSN 1053-8119,\n> [DOI](https://doi.org/10.1016/j.neuroimage.2013.10.027)\n\nIt was inspired by a pipeline\nfrom [Lau M. Andersen](https://doi.org/10.3389/fnins.2018.00006)\n> Andersen LM. Group Analysis in MNE-Python of Evoked Responses from a Tactile\n> Stimulation Paradigm: A Pipeline for\n> Reproducibility at Every Step of Processing, Going from Individual Sensor\n> Space Representations to an across-Group\n> Source Space Representation. Front Neurosci. 2018 Jan 22;12:6. doi:\n> 10.3389/fnins.2018.00006. PMID: 29403349;\n> PMCID: PMC5786561.\n\nThis program also\nintegrates [autoreject](https://doi.org/10.1016/j.neuroimage.2017.06.030)\n> Mainak Jas, Denis Engemann, Yousra Bekhti, Federico Raimondo, and Alexandre\n> Gramfort. 2017.\n> \u201cAutoreject: Automated artifact rejection for MEG and EEG data\u201d. NeuroImage,\n> 159, 417-429.\n\nMany ideas and basics for GUI-Programming where taken\nfrom [LearnPyQt](https://www.learnpyqt.com/) and numerous\nstackoverflow-questions/solutions.\n\nThe development is financially supported\nby [Heidelberg University](https://www.uni-heidelberg.de/de/forschung/forschungsprofil/fields-of-focus/field-of-focus-i).\n\nThank you to the members of my laboratory (especially my\nsupervisor [Andre Rupp](https://www.klinikum.uni-heidelberg.de/personen/pd-dr-phil-andre-rupp-271))\nfor their feedback and testing in the early stages of development.\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "A Pipeline-GUI for MNE-Python from MEG-Lab Heidelberg",
"version": "0.3.3a0",
"project_urls": {
"Homepage": "https://github.com/marsipu/mne-pipeline-hd",
"Repository": "https://github.com/marsipu/mne-pipeline-hd.git"
},
"split_keywords": [
"mne-python",
"meg",
"eeg",
"pipeline",
"gui",
"heidelberg"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b025f3178e050556f591a2a7df1f12645d13b2ed68ff0faf2f8e76b3fdfe7c21",
"md5": "ebe70906decff084a2915f9d605cd978",
"sha256": "d146e3863a9b5720fb1ece799f9c7ce1d261cfc203be37af043af9b601cefe00"
},
"downloads": -1,
"filename": "mne_pipeline_hd-0.3.3a0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ebe70906decff084a2915f9d605cd978",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 223708,
"upload_time": "2023-07-27T11:12:14",
"upload_time_iso_8601": "2023-07-27T11:12:14.703562Z",
"url": "https://files.pythonhosted.org/packages/b0/25/f3178e050556f591a2a7df1f12645d13b2ed68ff0faf2f8e76b3fdfe7c21/mne_pipeline_hd-0.3.3a0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e313dc55bac0aca47370a98371caca70ba4ed2309a5917e67811b9f96fe4c095",
"md5": "db0c06776046bc6e9e40d39cbd660973",
"sha256": "0a96fbb466ae058c9c18e391566cbc9be003a0fe370852e00fc94b20717bf947"
},
"downloads": -1,
"filename": "mne-pipeline-hd-0.3.3a0.tar.gz",
"has_sig": false,
"md5_digest": "db0c06776046bc6e9e40d39cbd660973",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 206681,
"upload_time": "2023-07-27T11:12:16",
"upload_time_iso_8601": "2023-07-27T11:12:16.490958Z",
"url": "https://files.pythonhosted.org/packages/e3/13/dc55bac0aca47370a98371caca70ba4ed2309a5917e67811b9f96fe4c095/mne-pipeline-hd-0.3.3a0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-07-27 11:12:16",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "marsipu",
"github_project": "mne-pipeline-hd",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "PyQt5",
"specs": []
},
{
"name": "qtpy",
"specs": []
},
{
"name": "pyobjc-framework-Cocoa",
"specs": []
},
{
"name": "pyqtdarktheme",
"specs": []
},
{
"name": "mne",
"specs": []
},
{
"name": "mne-connectivity",
"specs": []
},
{
"name": "mne-qt-browser",
"specs": []
},
{
"name": "autoreject",
"specs": []
},
{
"name": "h5io",
"specs": []
},
{
"name": "vtk",
"specs": []
},
{
"name": "nibabel",
"specs": []
},
{
"name": "psutil",
"specs": []
},
{
"name": "pandas",
"specs": []
}
],
"lcname": "mne-pipeline-hd"
}