mne-nodes 0.1.0a4__tar.gz

mne_nodes-0.1.0a4/.gitignore

@@ -0,0 +1,19 @@
+# Python
+__pycache__/
+.pytest_cache/
+*.egg-info/
+dist/
+.venv/
+venv/
+.ipynb_checkpoints/
+
+# PyCharm Project-Settings
+.idea/
+
+# VSCode
+.vscode/
+
+# Documentation
+docs/build/
+docs/generated/
+docs/source/generated

mne_nodes-0.1.0a4/CONTRIBUTING.md

@@ -0,0 +1,27 @@
+# Contributing to mne-nodes
+
+_**Contributions are very welcome! Thank you for taking the time to contribute to mne-nodes.**_
+
+## Scope
+mne-nodes is supposed to be a **GUI framework** for building and running MEG/EEG workflows.
+It should not contain any analysis logic (core-functions being the exception during early development).
+All analysis logic should be implemented in separate, importable Python modules/packages and maintained in their own repositories (for example on GitHub).
+
+## Development Setup
+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 a remote branch _upstream_ to git for
+   updates from the main-branch: `git remote add upstream https://github.com/marsipu/mne-nodes.git`
+5. Install your forked version including development dependencies with pip: `pip install -e .[test,docs]`
+6. Install the pre-commit hooks with: `pre-commit install`
+
+**Alternative:** You can also use [mne-dev-setup](https://github.com/marsipu/mne-dev-setup) for the setup of a development environment.
+
+## Workflow for contributing
+1. Create a branch for changes: `git checkout -b <branch-name>`
+2. Commit changes: `git commit -am "<your commit message>"`
+3. Push changes to your forked repository on GitHub: `git push`
+4. Make a new _pull request_ from your new feature branch
+5. After review, your changes can be merged into the main-branch

mne_nodes-0.1.0a4/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) authors of mne-nodes
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1.  Redistributions of source code must retain the above copyright notice, this
+    list of conditions and the following disclaimer.
+
+2.  Redistributions in binary form must reproduce the above copyright notice,
+    this list of conditions and the following disclaimer in the documentation
+    and/or other materials provided with the distribution.
+
+3.  Neither the name of the copyright holder nor the names of its
+    contributors may be used to endorse or promote products derived from
+    this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

mne_nodes-0.1.0a4/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: mne-nodes
+Version: 0.1.0a4
+Summary: A GUI with Node-Layout for data analysis MNE-Python
+Project-URL: Homepage, https://github.com/marsipu/mne-nodes
+Project-URL: Repository, https://github.com/marsipu/mne-nodes.git
+Author-email: "Martin G. Schulz" <dev@mgschulz.de>
+License-Expression: BSD-3-Clause
+License-File: LICENSE
+Keywords: eeg,gui,heidelberg,meg,mne-python,pipeline
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.10
+Requires-Dist: autoreject
+Requires-Dist: darkdetect
+Requires-Dist: filelock
+Requires-Dist: h5io
+Requires-Dist: h5netcdf
+Requires-Dist: mne
+Requires-Dist: mne-bids
+Requires-Dist: mne-connectivity
+Requires-Dist: mne-qt-browser
+Requires-Dist: nibabel
+Requires-Dist: psutil
+Requires-Dist: pyobjc-framework-cocoa; sys_platform == 'Darwin'
+Requires-Dist: pyvistaqt
+Requires-Dist: qtawesome
+Requires-Dist: qtpy
+Requires-Dist: tqdm
+Requires-Dist: vtk
+Provides-Extra: docs
+Requires-Dist: pydata-sphinx-theme; extra == 'docs'
+Requires-Dist: sphinx; extra == 'docs'
+Provides-Extra: test
+Requires-Dist: pre-commit; extra == 'test'
+Requires-Dist: pytest; extra == 'test'
+Requires-Dist: pytest-qt; extra == 'test'
+Requires-Dist: ruff; extra == 'test'
+Description-Content-Type: text/markdown
+
+[![CIs](https://github.com/marsipu/mne-nodes/actions/workflows/run_tests.yml/badge.svg)](https://github.com/marsipu/mne-nodes/actions/workflows/run_tests.yml)
+
+[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/marsipu/mne-nodes/main.svg?badge_token=jA6ZWC-DQXm_QrZFVi3a-w)](https://results.pre-commit.ci/latest/github/marsipu/mne-nodes/main?badge_token=jA6ZWC-DQXm_QrZFVi3a-w)
+
+# mne-nodes
+![Overview](mne_nodes/extra/wip_overview.png "Overview of the mne-nodes GUI")
+
+## A Node-GUI for [MNE-Python](https://mne.tools/stable/index.html)
+This is a GUI to facilitate offline MEG/EEG data processing with MNE-python.
+To visualize the data-flow a node-based approach is used.
+
+## Installation
+1. Install MNE-python as instructed in the [documentation](https://mne.tools/stable/install/index.html)
+2. Open the command prompt and activate the conda-environment where you installed mne-python (or just open the command prompt when you installed mne-python with an [installer](https://mne.tools/stable/install/installers.html#installers))
+3. Install **mne-nodes**:
+    - Install the latest release with `pip install mne-nodes`
+
+   or
+
+    - Install the development version with `pip install git+https://github.com/marsipu/mne-nodes.git@main`
+
+
+## Update
+Run `pip install --upgrade --no-deps --force-reinstall git+https://github.com/marsipu/mne-nodes.git@main`
+for an update to the development version
+or `pip install --upgrade mne-nodes` for the latest release.
+
+## Start
+Run `mne_nodes` in the terminal of your conda-environment where you installed mne-python and mne-nodes
+
+**or**
+
+run \_\_main\_\_.py from the terminal or an IDE like PyCharm, VSCode, Atom,
+etc.
+
+
+## Bug-Report/Feature-Request
+Please report bugs on GitHub as an [issue](https://github.com/marsipu/mne-nodes/issues/new?template=bug_report.yml).
+And if you got ideas on how to improve the pipeline or some feature-requests,
+you are welcome to open an [issue](https://github.com/marsipu/mne-nodes/issues/new?template=feature_request.yml) as well.
+
+## Contribute
+Contributions on bug fixes and implementation of new features are very welcome.
+Have a look at the [contributing guidelines](CONTRIBUTING.md) for more information on how to contribute.
+
+## Acknowledgments
+- This application serves as a GUI for [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)
+- [mne-bids](https://mne.tools/mne-bids/) is used to read and write data in BIDS format and the tiny-bids-dataset is used for testing.
+- [mne-bids-pipeline](https://mne.tools/mne-bids-pipeline/) served as inspiration for the processing steps and their implementation of bids-derivatives.
+- Code from [NodeGraphQt](https://github.com/jchanvfx/NodeGraphQt) was used to implement the node-gui.
+- The colorpalettes for light and dark theme are inspired from [PyQtDarkTheme](https://github.com/5yutan5/PyQtDarkTheme).
+- The development was supported by Code Completion and Coding Agents (e.g. GitHub Copilot)
+
+## License
+The `mne-nodes` project is licensed under the [BSD\-3\-Clause license](LICENSE). It uses PySide6, which is licensed under the LGPL. When using [`qtpy`](https://github.com/spyder-ide/qtpy) with alternative Qt backends (e.g. PyQt6), the applicable licensing obligations are determined by the chosen backend.

mne_nodes-0.1.0a4/README.md

@@ -0,0 +1,56 @@
+[![CIs](https://github.com/marsipu/mne-nodes/actions/workflows/run_tests.yml/badge.svg)](https://github.com/marsipu/mne-nodes/actions/workflows/run_tests.yml)
+
+[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/marsipu/mne-nodes/main.svg?badge_token=jA6ZWC-DQXm_QrZFVi3a-w)](https://results.pre-commit.ci/latest/github/marsipu/mne-nodes/main?badge_token=jA6ZWC-DQXm_QrZFVi3a-w)
+
+# mne-nodes
+![Overview](mne_nodes/extra/wip_overview.png "Overview of the mne-nodes GUI")
+
+## A Node-GUI for [MNE-Python](https://mne.tools/stable/index.html)
+This is a GUI to facilitate offline MEG/EEG data processing with MNE-python.
+To visualize the data-flow a node-based approach is used.
+
+## Installation
+1. Install MNE-python as instructed in the [documentation](https://mne.tools/stable/install/index.html)
+2. Open the command prompt and activate the conda-environment where you installed mne-python (or just open the command prompt when you installed mne-python with an [installer](https://mne.tools/stable/install/installers.html#installers))
+3. Install **mne-nodes**:
+    - Install the latest release with `pip install mne-nodes`
+
+   or
+
+    - Install the development version with `pip install git+https://github.com/marsipu/mne-nodes.git@main`
+
+
+## Update
+Run `pip install --upgrade --no-deps --force-reinstall git+https://github.com/marsipu/mne-nodes.git@main`
+for an update to the development version
+or `pip install --upgrade mne-nodes` for the latest release.
+
+## Start
+Run `mne_nodes` in the terminal of your conda-environment where you installed mne-python and mne-nodes
+
+**or**
+
+run \_\_main\_\_.py from the terminal or an IDE like PyCharm, VSCode, Atom,
+etc.
+
+
+## Bug-Report/Feature-Request
+Please report bugs on GitHub as an [issue](https://github.com/marsipu/mne-nodes/issues/new?template=bug_report.yml).
+And if you got ideas on how to improve the pipeline or some feature-requests,
+you are welcome to open an [issue](https://github.com/marsipu/mne-nodes/issues/new?template=feature_request.yml) as well.
+
+## Contribute
+Contributions on bug fixes and implementation of new features are very welcome.
+Have a look at the [contributing guidelines](CONTRIBUTING.md) for more information on how to contribute.
+
+## Acknowledgments
+- This application serves as a GUI for [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)
+- [mne-bids](https://mne.tools/mne-bids/) is used to read and write data in BIDS format and the tiny-bids-dataset is used for testing.
+- [mne-bids-pipeline](https://mne.tools/mne-bids-pipeline/) served as inspiration for the processing steps and their implementation of bids-derivatives.
+- Code from [NodeGraphQt](https://github.com/jchanvfx/NodeGraphQt) was used to implement the node-gui.
+- The colorpalettes for light and dark theme are inspired from [PyQtDarkTheme](https://github.com/5yutan5/PyQtDarkTheme).
+- The development was supported by Code Completion and Coding Agents (e.g. GitHub Copilot)
+
+## License
+The `mne-nodes` project is licensed under the [BSD\-3\-Clause license](LICENSE). It uses PySide6, which is licensed under the LGPL. When using [`qtpy`](https://github.com/spyder-ide/qtpy) with alternative Qt backends (e.g. PyQt6), the applicable licensing obligations are determined by the chosen backend.

mne_nodes-0.1.0a4/docs/Makefile

@@ -0,0 +1,25 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = source
+BUILDDIR      = build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+view:
+	@python -c "import webbrowser; webbrowser.open_new_tab('file://$(PWD)/build/html/index.html')"
+
+show: view

mne_nodes-0.1.0a4/docs/make.bat

@@ -0,0 +1,35 @@
+@ECHO OFF
+
+pushd %~dp0
+
+REM Command file for Sphinx documentation
+
+if "%SPHINXBUILD%" == "" (
+	set SPHINXBUILD=sphinx-build
+)
+set SOURCEDIR=source
+set BUILDDIR=build
+
+%SPHINXBUILD% >NUL 2>NUL
+if errorlevel 9009 (
+	echo.
+	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
+	echo.installed, then set the SPHINXBUILD environment variable to point
+	echo.to the full path of the 'sphinx-build' executable. Alternatively you
+	echo.may add the Sphinx directory to PATH.
+	echo.
+	echo.If you don't have Sphinx installed, grab it from
+	echo.https://www.sphinx-doc.org/
+	exit /b 1
+)
+
+if "%1" == "" goto help
+
+%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+goto end
+
+:help
+%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+
+:end
+popd

mne_nodes-0.1.0a4/docs/source/_static/versions.json

@@ -0,0 +1,7 @@
+[
+  {
+    "name": "0.4 (development)",
+    "version": "dev",
+    "url": "https://github.com/marsipu/mne-nodes"
+  }
+]

mne_nodes-0.1.0a4/docs/source/api/index.rst

@@ -0,0 +1,8 @@
+.. automodule:: mne_nodes.gui.parameter_widgets
+   :no-members:
+   :no-inherited-members:
+
+.. toctree::
+   :maxdepth: 2
+
+   parameter_widgets.rst

mne_nodes-0.1.0a4/docs/source/api/parameter_widgets.rst

@@ -0,0 +1,30 @@
+Parameter Widgets
+=================
+
+.. currentmodule:: mne_nodes.gui.parameter_widgets
+
+All parameter GUI classes expose fully typed constructors to simplify
+configuration and documentation. Refer to the class docstrings for the
+annotated arguments.
+
+.. automodule:: mne_nodes.gui.parameter_widgets
+   :no-members:
+   :no-inherited-members:
+
+.. autosummary::
+   :toctree: ../generated
+
+   Param
+   BoolGui
+   CheckListGui
+   ComboGui
+   DictGui
+   FloatGui
+   FuncGui
+   IntGui
+   LabelGui
+   ListGui
+   MultiTypeGui
+   SliderGui
+   StringGui
+   DualTupleGui

mne_nodes-0.1.0a4/docs/source/conf.py

@@ -0,0 +1,95 @@
+# -*- coding: utf-8 -*-
+# Configuration file for the Sphinx documentation builder.
+#
+# This file only contains a selection of the most common options. For a full
+# list see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- Path setup --------------------------------------------------------------
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#
+from datetime import datetime, timezone
+from importlib.metadata import version
+
+# import sys
+
+# from os.path import dirname, abspath, join
+
+# curdir = dirname(__file__)
+# sys.path.append(abspath(join(curdir, "..", "..", "mne_nodes")))
+
+# # Import module because of annoying import problem on CIs
+from mne_nodes.gui import parameter_widgets
+
+module_list = list()
+module_list.append(parameter_widgets)
+
+# -- Project information -----------------------------------------------------
+project = "mne-nodes"
+author = "Martin G. Schulz"
+
+td = datetime.now(tz=timezone.utc)
+copyright = (
+    f"2019-{datetime.now().year}, {author}, "
+    f'Last updated {td.strftime("%Y-%m-%d %H:%M %Z")}'
+)
+
+# The full version, including alpha/beta/rc tags
+release = version("mne_nodes")
+# The short X.Y version.
+version = ".".join(release.split(".")[:2])
+
+# -- General configuration ---------------------------------------------------
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = ["sphinx.ext.autodoc", "sphinx.ext.autosummary", "sphinx.ext.napoleon"]
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This pattern also affects html_static_path and html_extra_path.
+exclude_patterns = []
+
+# -- Options for HTML output -------------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+#
+html_theme = "pydata_sphinx_theme"
+switcher_version_match = "dev" if ".dev" in version else version
+html_theme_options = {
+    "icon_links": [
+        dict(
+            name="GitHub",
+            url="https://github.com/marsipu/mne-nodes",
+            icon="fa-brands fa-square-github fa-fw",
+        ),
+    ],
+    "icon_links_label": "External Links",
+    "navbar_end": [
+        "theme-switcher",
+        "version-switcher",
+        "navbar-icon-links",
+    ],
+    "navbar_align": "left",
+    "navbar_persistent": ["search-button"],
+    "footer_start": ["copyright"],
+    "secondary_sidebar_items": ["page-toc", "edit-this-page"],
+    # Todo: Insert versions url from webpage
+    # "switcher": {
+    #     "json_url": "<version-url>/versions.json",
+    #     "version_match": switcher_version_match,
+    # },
+}
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ["_static"]

mne_nodes-0.1.0a4/docs/source/development/index.rst

@@ -0,0 +1 @@
+This is the development main page.

mne_nodes-0.1.0a4/docs/source/documentation/custom_modules.rst

@@ -0,0 +1,23 @@
+Custom Modules/Functions
+========================
+To extend the functionality of **mne-nodes**, you can add custom modules.
+.. ToDo: From the gui, you can add custom modules by
+
+The configuration file (JSON) is expected to be in the same directory as the module.
+
+Inputs
+------
+The inputs are expected to be all arguments from the function without a default value (args).
+Their name needs to be identical to the names of return statements from other functions.
+
+Outputs
+-------
+Outputs need to be a name variable that is returned from the function. If you want to return static values, just define any variable so they can appear as outputs in the nodes.
+
+Parameters
+----------
+
+
+Plot Functions
+--------------
+There are mutliple possibilities to use plots in a custom function. For example you could plot a matplotlib plot interactively with the PyQt backend. Or you could decide to not show the plot and just save it to a file to use later. To make the plot interactively, make sure to set ``block=True`` for example in ``raw.plot(block=True)`` or with ``plt.show(block=True)``.

mne_nodes-0.1.0a4/docs/source/documentation/functions.rst

@@ -0,0 +1,16 @@
+Functions
+=========
+Function names must be always unique.
+
+Parameters
+==========
+Parameters are stored per function, thus parameters with the same name can exist in different functions with different values.
+The parameters are configured per function.
+
+Parameter Names
+---------------
+While parameters of different functions can have the same name, parameter names within a function must be unique.
+
+Set a parameter to None
+-----------------------
+To set a parameter to None, uncheck the checkbox next to the parameter name. To allow this, *none_select* has to be set to ``True`` in the parameter configuration.

mne_nodes-0.1.0a4/docs/source/documentation/settings.rst

@@ -0,0 +1,7 @@
+Settings
+========
+There are two different ways, application settings are stored in MNE-Nodes.
+It depends on whether the settings is device-specific or project-specific.
+For device-specific settings, such as the number of jobs or whether cuda is enabled, are stored either with *Settings* in a JSON file located in an OS-dependent directory.
+The user-specific settings are used to store user preferences, such as the image format or the appearance of the GUI.
+These settings are stored in the configuration file used to configure a project.

mne_nodes-0.1.0a4/docs/source/index.rst

@@ -0,0 +1,35 @@
+:html_theme.sidebar_secondary.remove:
+
+.. title:: mne-nodes
+
+.. The page title must be in rST for it to show in next/prev page buttons.
+   Therefore we add a special style rule to only this page that hides h1 tags
+
+.. raw:: html
+
+    <style type="text/css">h1 {display:none;}</style>
+
+Welcome to mne-nodes's documentation!
+===========================================
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+
+
+
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`
+
+.. toctree::
+   :hidden:
+
+   Install <install/index>
+   Documentation <documentation/index>
+   API Reference <api/index>
+   Development <development/index>

mne_nodes-0.1.0a4/docs/source/install/index.rst

@@ -0,0 +1 @@
+How to install

mne_nodes-0.1.0a4/mne_nodes/__init__.py

@@ -0,0 +1,35 @@
+"""
+Authors: Martin Schulz <dev@mgschulz.de>
+License: BSD 3-Clause
+GitHub: https://github.com/marsipu/mne-nodes
+"""
+
+import os
+import sys
+
+
+# Global variables to check the platform
+ismac = sys.platform.startswith("darwin")
+iswin = sys.platform.startswith("win32")
+islin = not ismac and not iswin
+
+# Variable to store gui/headless mode, should not be imported directly
+# but accessed via mne_nodes.gui_mode
+gui_mode = True
+
+
+# Check if running in debug mode
+def debug_mode():
+    return os.environ.get("MNENODES_DEBUG", False) == "true"
+
+
+# Keep reference to Qt-objects without parent for tests
+# and to avoid garbage collection
+_widgets = {
+    "main_window": None,
+    "viewer": None,
+    "plot_manager": None,
+    "dialogs": {},
+    "parameter_widgets": {},
+    "color_tester": None,
+}

mne_nodes-0.1.0a4/mne_nodes/__main__.py

@@ -0,0 +1,92 @@
+"""
+Authors: Martin Schulz <dev@mgschulz.de>
+License: BSD 3-Clause
+GitHub: https://github.com/marsipu/mne-nodes
+"""
+
+import argparse
+import logging
+import sys
+
+import qtpy
+from qtpy.QtCore import QTimer, Qt
+from qtpy.QtWidgets import QApplication
+
+import mne_nodes
+from mne_nodes.gui.gui_utils import set_app_font_size, set_app_theme
+from mne_nodes.pipeline.controller import Controller
+from mne_nodes.pipeline.exception_handling import UncaughtHook
+from mne_nodes.pipeline.streams import init_streams, init_logging
+
+app_name = "mne-nodes"
+organization_name = "marsipu"
+domain_name = "https://github.com/marsipu/mne-nodes"
+
+
+def main() -> None:
+    # ToDo: Change Debug mode initialization (command-line, enviroment-variable, settings)
+    init_logging(mne_nodes.debug_mode())
+    logging.info("Starting MNE-Nodes...")
+    # Set gui_mode to true since starting as module always means gui-mode
+    mne_nodes.gui_mode = True
+    # Create QApplication
+    app = QApplication.instance()
+    if app is None:
+        app = QApplication(sys.argv)
+    app.setApplicationName(app_name)
+    app.setOrganizationName(organization_name)
+    app.setOrganizationDomain(domain_name)
+    # For Spyder to make console accessible again
+    app.lastWindowClosed.connect(app.quit)
+
+    # Avoid file-dialog-problems with custom file-managers in linux
+    if mne_nodes.islin:
+        app.setAttribute(Qt.ApplicationAttribute.AA_DontUseNativeDialogs, True)
+
+    # Initialize streams from stdout/stderr into Qt
+    init_streams()
+
+    # Show Qt-binding
+    logging.info(f"Using {qtpy.API_NAME} {qtpy.QT_VERSION}")
+
+    # Initialize Exception-Hook
+    if mne_nodes.debug_mode():
+        logging.info("Debug-Mode is activated")
+    else:
+        qt_exception_hook = UncaughtHook()
+        sys.excepthook = qt_exception_hook.exception_hook
+
+    # Set style and font
+    set_app_theme()
+    set_app_font_size()
+
+    # Initialize controller and main window
+    controller = Controller()
+
+    # Late import of MainWindow, since importing it at the top-level seems to cause Windows fatal access errors when opening dialogs in some cases.
+    from mne_nodes.gui.main_window import MainWindow
+
+    MainWindow(controller)
+
+    # Command-Line interrupt with Ctrl+C possible
+    timer = QTimer()
+    timer.timeout.connect(lambda: None)
+    timer.start(500)
+
+    sys.exit(app.exec())
+
+
+if __name__ == "__main__":
+    # Parse command line arguments
+    parser = argparse.ArgumentParser(
+        prog="MNE-Nodes", description="A GUI with Nodes for MNE-Python"
+    )
+    parser.add_argument(
+        "--nogui", "-n", action="store_true", help="Run headless without GUI"
+    )
+    cli_args = parser.parse_args(sys.argv[1:])
+
+    if cli_args.nogui:
+        mne_nodes.gui_mode = False
+
+    main()