muniverse-emg 0.1.0__tar.gz

muniverse_emg-0.1.0/.gitignore

@@ -0,0 +1,71 @@
+# Python
+**__pycache__/
+**pytest_cache/
+**mypy_cache/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+.muniverse/
+.claude/
+
+# Virtual Environment
+.env
+.venv
+env/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*.code-workspace
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# macOS
+**/.DS_Store
+
+# Logs
+*.log
+*.sh.e*
+*.sh.o*
+
+# Data folder
+data/
+
+# Singularity image files
+*.sif
+
+# Data files 
+*.hdf5
+*.edf
+*.npy
+*.pkl
+
+
+# Results and configs folder
+**/res/
+**/configs/
+**/outputs/
+
+# Test coverage <temporarily?>
+.coverage

muniverse_emg-0.1.0/LICENSE

@@ -0,0 +1,28 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2024 MUniverse Contributors
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+================================================================================
+
+NOTICE: This project uses NeuroMotion, which is licensed under GNU GPL v3.0.
+As a result, MUniverse is also licensed under GNU GPL v3.0 to comply with
+the copyleft requirements of the GPL license.
+
+This project also integrates with Swarm-Contrastive-Decomposition, which is
+licensed under Creative Commons Attribution-NonCommercial 4.0 International
+Public License. Please refer to the respective licenses for usage terms.
+

muniverse_emg-0.1.0/PKG-INFO

@@ -0,0 +1,230 @@
+Metadata-Version: 2.4
+Name: muniverse-emg
+Version: 0.1.0
+Summary: A modular framework for simulated and experimental EMG dataset generation, motor unit decomposition algorithm benchmarking, and performance evaluation
+Author: Pranav Mamidanna, Thomas Klotz, Dimitrios Halatsis, Irene Mendez Guerra
+License: GPLv3
+Project-URL: Documentation, https://dfarinagroup.github.io/muniverse/
+Project-URL: Repository, https://github.com/dfarinagroup/muniverse.git
+Keywords: EMG,motor unit idendification,blind source separation,validation,benchmarking
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
+Classifier: Topic :: Scientific/Engineering :: Human Machine Interfaces
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: scipy
+Requires-Dist: torch
+Requires-Dist: pandas
+Requires-Dist: scikit-learn
+Requires-Dist: easyDataverse
+Requires-Dist: pyedflib
+Requires-Dist: python-dateutil
+Requires-Dist: bids-validator-deno
+Requires-Dist: pydantic
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: isort; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: jupyter; extra == "dev"
+Requires-Dist: ipykernel; extra == "dev"
+Requires-Dist: matplotlib; extra == "dev"
+Requires-Dist: seaborn; extra == "dev"
+Dynamic: license-file
+
+# MUniverse: Benchmarking Motor Unit Decomposition Algorithms
+
+[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+
+MUniverse is a modular framework for **simulated and experimental EMG dataset generation**, **motor unit decomposition algorithm benchmarking**, and **performance evaluation**. It integrates biomechanical simulation (via *NeuroMotion*), generative models (*BioMime*), standardized formats (e.g. BIDS/Croissant), and FAIR data hosting (Harvard Dataverse).
+
+<p align="center">
+  <img src="https://github.com/dfarinagroup/muniverse/blob/main/docs/static/images/muniverse.png" alt="MUniverse overview" width="600"/>
+</p>
+
+## Features
+
+- 🔬 **Algorithm Benchmarking**: Compare multiple motor unit decomposition algorithms (CBSS, SCD, Upperbound, AE)
+- 📊 **Dataset Generation**: Generate simulated EMG datasets using NeuroMotion and experimental datasets
+- 📁 **FAIR Data**: Access datasets through Harvard Dataverse with BIDS and Croissant format support
+- 🔧 **Containerized Workflows**: Docker and Singularity support for reproducible algorithm execution
+- 📈 **Performance Evaluation**: Comprehensive evaluation metrics and report card generation
+- 📓 **Tutorial Notebooks**: Interactive Jupyter notebooks for dataset loading and algorithm usage
+
+## Installation
+
+### Requirements
+
+- Python 3.11 or higher
+- pip
+
+### Package Installation
+
+MUniverse is distributed as a Python package. To set up the development environment:
+
+1. **Clone the repository:**
+```bash
+git clone https://github.com/dfarinagroup/muniverse.git
+cd muniverse
+```
+
+2. **Create and activate a virtual environment:**
+```bash
+python -m venv .venv
+source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+```
+
+3. **Install the package:**
+```bash
+# Install core dependencies
+pip install -e .
+
+# Install development dependencies (optional)
+pip install -e ".[dev]"
+```
+
+### Docker/Singularity Containers
+
+For algorithm execution, Docker or Singularity containers are available. See the `docker/` directory for container definitions.
+
+## Quick Start
+
+### Loading a Dataset
+
+```python
+from muniverse.datasets import load_dataset
+
+# Load a dataset from Harvard Dataverse
+dataset = load_dataset("neuromotion-test", output_dir="./data")
+```
+
+### Running Decomposition
+
+```python
+from muniverse.algorithms import decompose_recording
+
+# Run decomposition using CBSS algorithm
+results, metadata = decompose_recording(
+    data="path/to/emg_data.edf",
+    method="cbss"
+)
+
+# Or use SCD algorithm (requires container)
+results, metadata = decompose_recording(
+    data="path/to/emg_data.edf",
+    method="scd",
+    container="path/to/muniverse_scd.sif",
+    engine="singularity"
+)
+```
+
+## Available Datasets
+
+All datasets are hosted on [Harvard Dataverse](https://dataverse.harvard.edu/dataverse/muniverse-datasets) and follow FAIR principles:
+
+- **Caillet et al. 2023** - [DOI: 10.7910/DVN/F9GWIW](https://doi.org/10.7910/DVN/F9GWIW)
+- **Avrillon et al. 2024** - [DOI: 10.7910/DVN/L9OQY7](https://doi.org/10.7910/DVN/L9OQY7)
+- **Grison et al. 2025** - [DOI: 10.7910/DVN/ID1WNQ](https://doi.org/10.7910/DVN/ID1WNQ)
+- **Neuromotion-Train** - [DOI: 10.7910/DVN/2UQHTP](https://doi.org/10.7910/DVN/2UQHTP)
+- **Neuromotion-Test** - [DOI: 10.7910/DVN/QYI336](https://doi.org/10.7910/DVN/QYI336)
+- **Hybrid-Tibialis** - [DOI: 10.7910/DVN/YHTGGA](https://doi.org/10.7910/DVN/YHTGGA)
+
+## Supported Algorithms
+
+- **CBSS** - Convolutional Blind Source Separation
+- **SCD** - Swarm Contrastive Decomposition ([GitHub](https://github.com/AgneGris/swarm-contrastive-decomposition))
+- **Upperbound** - Upper bound performance estimation
+- **AE** - Autoencoder-based decomposition
+
+## Documentation (coming soon 🚧)
+
+- 📖 [GitHub Pages Site](https://dfarinagroup.github.io/muniverse/) - Project documentation and overview
+- 📓 [Tutorial Notebooks](notebooks/) - Interactive examples and guides
+- 💻 [Source Code](https://github.com/dfarinagroup/muniverse) - Repository and issue tracking
+- 📊 [Harvard Dataverse](https://dataverse.harvard.edu/dataverse/muniverse-datasets) - Dataset access and metadata
+
+## Project Structure
+
+```
+muniverse/
+├── src/                    # Package source code
+│   └── muniverse/
+│       ├── configs/        # Algorithm and dataset configurations
+│       ├── datasets/       # Dataset loading and simulation utilities
+│       ├── algorithms/     # Decomposition algorithms
+│       ├── evaluation/     # Performance evaluation
+│       └── utils/          # Utility functions
+├── notebooks/              # Tutorial notebooks
+├── scripts/                # Utility scripts
+├── docker/                 # Docker container definitions
+├── docs/                   # GitHub Pages documentation (Coming soon!)
+├── tests/                  # Unit tests
+├── pyproject.toml          # Package configuration
+└── README.md               
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## Contributors 
+
+- [Pranav Mamidanna](https://github.com/pranavm19), [📧](mailto:p.mamidanna22@imperial.ac.uk)
+- [Thomas Klotz](https://github.com/klotz-t), [📧](mailto:thomas.klotz@imsb.uni-stuttgart.de)
+- [Dimitrios Halatsis](https://github.com/dhalatsis)
+- [Irene Mendez Guerra](https://github.com/imendezguerra)
+
+## Acknowledgments
+
+- **NeuroMotion** - Biomechanical simulation framework ([GitHub](https://github.com/shihan-ma/NeuroMotion))
+- **Swarm-Contrastive-Decomposition** - Decomposition algorithm ([GitHub](https://github.com/AgneGris/swarm-contrastive-decomposition))
+- **Harvard Dataverse** - FAIR data hosting platform
+- **BIDS** - Brain Imaging Data Structure standard
+
+## Citation
+
+If you use MUniverse in your research, please cite:
+
+```bibtex
+@inproceedings{NEURIPS2025_dcce2899,
+ author = {Mamidanna, Pranav and Klotz, Thomas and Chalatsis, Dimitrios and Grison, Agnese and Mendez Guerra, Irene and Ma, Shihan and Caillet, Arnault and Avrillon, Simon and Rohl\'{e}n, Robin and Farina, Dario},
+ booktitle = {Advances in Neural Information Processing Systems},
+ editor = {D. Belgrave and C. Zhang and H. Lin and R. Pascanu and P. Koniusz and M. Ghassemi and N. Chen},
+ pages = {},
+ publisher = {Curran Associates, Inc.},
+ title = {MUniverse: A Simulation and Benchmarking Suite for Motor Unit Decomposition},
+ url = {https://proceedings.neurips.cc/paper_files/paper/2025/file/dcce28990bf662c6b916c52cd7e975da-Paper-Datasets_and_Benchmarks_Track.pdf},
+ volume = {38},
+ year = {2025}
+}
+```
+
+### Contact
+
+For questions, issues, or contributions, please:
+- Open an issue on [GitHub](https://github.com/dfarinagroup/muniverse/issues)
+- Contact the maintainers via email (see the *Contributors section* for author emails)
+
+### License
+
+MUniverse is licensed under the **GNU General Public License v3.0** (GPL-3.0).
+
+**Important Licensing Notes:**
+- This project uses **NeuroMotion**, which is licensed under GNU GPL v3.0. As a result, MUniverse is also licensed under GNU GPL v3.0 to comply with the copyleft requirements of the GPL license.
+- This project also integrates with **Swarm-Contrastive-Decomposition**, which is licensed under Creative Commons Attribution-NonCommercial 4.0 International Public License.
+
+See the [LICENSE](LICENSE) file for full details.

muniverse_emg-0.1.0/bids_metadata/avrillon_et_al_2024.json

@@ -0,0 +1,103 @@
+{   
+    "DatasetDescription": {
+        "Name": "MUniverse Avrillon et al 2024",
+        "BIDSVersion": "1.11.1",
+        "DatasetType": "raw",
+        "License": "CC0 BY 4.0",
+        "Authors": [
+            "Simon Avrillon",
+            "Francois Hug",
+            "Roger M. Enoka",
+            "Arnault H. Caillet",
+            "Dario Farina"
+        ],
+        "EthicsApprovals": [
+            "Imperial College London (Study 18IC4685)",
+            "Comite de Protection des Personnes Ouest III (Study 23.00453.000166)"
+        ],
+        "Funding": [
+            "Agence Nationale de la Recherche (ANR-16-IDEX-0007)",
+            "Biotechnology and Biological Sciences Research Council (BB/V00896X)",
+            "Engineering and Physical Sciences Research Council (EP/T020970)",
+            "Agence Nationale de la Recherche (ANR-24-CE17-5805)",
+            "European Research Council (#810346)",
+            "Future project managed by the French National Research Agency (ANR-15-IDEX-01)",
+            "National Multiple Sclerosis Society (RG-2206-39688)"
+        ],
+        "DatasetDOI": "https://doi.org/10.7910/DVN/L9OQY7",
+        "ReferencesAndLinks": [
+            "Avrillon, S., Hug, F., Enoka, R. M., Caillet, A. H., & Farina, D. (2024). The identification of extensive samples of motor units in human muscles reveals diverse effects of neuromodulatory inputs on the rate coding. eLife, 13, eLife.97085.3.",
+            "https://doi.org/10.7554/eLife.97085.3"
+        ],
+        "GeneratedBy": [{
+            "Name": "MUniverse", 
+            "Version": "1.0", 
+            "CodeURL": "https://github.com/dfarinagroup/muniverse/scripts/",
+            "ScriptName": "avrillon2024_to_bids.py",
+            "Description": "Semi-automated conversion of the original data into BIDS format"    
+        }],
+        "SourceDatasets": [{
+            "URL": "https://doi.org/10.6084/m9.figshare.24640944",
+            "Version": "2023-11-27"
+        }]
+    },
+
+    "EMGSidecar": {
+        "SkinPreparation": "The skin was shaved and cleaned with an abrasive pad and water.",
+        "EMGPlacementScheme": "Other",
+        "EMGPlacementSchemeDescription": "Four grids were carefully positioned side-to-side with a 4-mm distance between the electrodes at the edges of adjacent grids. The 256 electrodes were centered to the muscle belly (right tibialis anterior or vastus lateralis) and laid within the muscle perimeter identified through palpation. Two bands damped with water were placed around the ankle as ground (R2) and reference (R1) electrodes.",
+        "EMGReference": "R1",
+        "EMGGround": "R2",
+        "SamplingFrequency": 2048,
+        "PowerLineFrequency": 50,
+        "ElectrodeManufacturer": "OTBioelettronica",
+        "ElectrodeManufacturersModelName": "GR04MM1305",
+        "ElectrodeMaterial": "gold coated",
+        "InterelectrodeDistance": 4,
+        "EMGElectrodeCount": 258,
+        "EMGChannelCount": 256,
+        "MISCChannelCount": 3,
+        "Manufacturer": "OTBioelettronica",
+        "ManufacturersModelName": "Quattrocento",
+        "SoftwareVersions": "OTBioLab+ v.1.5.6.0",
+        "Gain": 150,
+        "SoftwareFilters": "n/a",
+        "HardwareFilters": {
+            "HighPassFilter": {
+                "CutoffFrequency": 10,
+                "Unit": "Hz",
+                "Description": "Analog high-pass filter (-3 dB cutoff)"
+            },
+            "LowPassFilter": {
+                "CutoffFrequency": 500,
+                "Unit": "Hz",
+                "Description": "Analog low-pass filter (-3 dB cutoff)"
+            }
+        },
+        "RecordingType": "continuous",
+        "TaskName": "isometric",
+        "TaskDescription": "Isometric ramp-and-hold contraction",
+        "Instructions": "Follow path provided via visual feedback.",
+        "InstitutionName": "Imperial College London",
+        "InstitutionAddress": "London W12 0BZ, United Kingdom",
+        "InstitutionalDepartmentName": "Department of Bioengineering"
+    },
+
+    "CoordSystemSidecar":{
+        "grid1": {
+            "EMGCoordinateSystem": "Other", 
+            "EMGCoordinateSystemDescription": "x-axis: proximal -> distal; y-axis: medial -> lateral; all local electrode coordinates (per grid) are mapped on a single global coordinate system.",
+            "EMGCoordinateUnits": "mm",
+            "AnchorElectrode": "E12 - Grid1"
+        },
+        "lowerLeg": {
+            "EMGCoordinateSystem": "Other",
+            "EMGCoordinateSystemDescription": "x-axis: proximal -> distal; y-axis: medial -> lateral; the coordinate system is located at the knee joint", 
+            "EMGCoordinateUnits": "percent"
+        }
+    }
+}
+
+
+  
+  

muniverse_emg-0.1.0/bids_metadata/caillet_et_al_2023.json

@@ -0,0 +1,98 @@
+{
+    "DatasetDescription":{
+        "Name": "MUniverse Caillet et al 2023", 
+        "BIDSVersion": "1.11.1", 
+        "DatasetType": "raw", 
+        "License": "CC0 BY 4.0", 
+        "Authors": [
+            "Arnault H. Caillet", 
+            "Simon Avrillon", 
+            "Aritra Kundu", 
+            "Tianyi Yu", 
+            "Andrew T. M. Phillips", 
+            "Luca Modenese", 
+            "Dario Farina"
+            ], 
+        "EthicsApprovals": ["The Ethics Committee at Imperial College London reviewed and approved all procedures and protocols (no. 18IC4685)"], 
+        "Funding": [
+            "European Research Council Synergy Grant NaturalBionicS (Contract #810346)", 
+            "Engineering and Physical Sciences Research Council (EPSRC) Transformative Healthcare", 
+            "Non-Invasive Single Neuron Electrical Monitoring (NISNEM Technology) Grant EP/T020970", 
+            "Biotechnology and Biological Sciences Research Council (BBSRC) 'Neural Commands for Fast Movements in the Primate Motor System' Grant NU-003743"
+            ], 
+        "DatasetDOI": "https://doi.org/10.7910/DVN/F9GWIW",
+        "ReferencesAndLinks": [
+            "Caillet, A. H., Avrillon, S., Kundu, A., Yu, T., Phillips, A. T. M., Modenese, L., & Farina, D. (2023). Larger and Denser: An Optimal Design for Surface Grids of EMG Electrodes to Identify Greater and More Representative Samples of Motor Units. eNeuro, 10(9), ENEURO.0064-23.2023.", 
+            "https://doi.org/10.1523/ENEURO.0064-23.2023"
+            ],
+        "GeneratedBy": [{
+            "Name": "MUniverse", 
+            "Version": "1.0", 
+            "CodeURL": "https://github.com/dfarinagroup/muniverse/scripts/",
+            "ScriptName": "caillet2023_to_bids.py",
+            "Description": "Semi-automated conversion of the original data into BIDS format"    
+        }],
+        "SourceDatasets": [{
+            "URL": "https://doi.org/10.6084/m9.figshare.22149287",
+            "Version": "2023-08-08"
+        }]
+    },    
+
+    "EMGSidecar":{
+        "SkinPreparation": "The skin was shaved, abrased and cleansed with 70 percent ethyl alcohol.", 
+        "EMGPlacementScheme": "Other",
+        "EMGPlacementSchemeDescription": "Four grids were carefully positioned side-to-side with a 4-mm distancebetween the electrodes at the edges of adjacent grids. The 256 electrodes were centered to the muscle belly (right tibialis anterior) and laid within the muscle perimeter identified through palpation. Two bands damped with water were placed around the ankle as ground (R2) and reference (R1) electrodes.", 
+        "EMGReference": "R1",
+        "EMGGround": "R2", 
+        "SamplingFrequency": 2048, 
+        "PowerLineFrequency": 50,  
+        "ElectrodeManufacturer": "OTBioelettronica",
+        "ElectrodeManufacturersModelName": "GR04MM1305",
+        "ElectrodeMaterial": "gold coated",
+        "InterelectrodeDistance": 4, 
+        "EMGElectrodeCount": 258, 
+        "EMGChannelCount": 256, 
+        "MISCChannelCount": 3, 
+        "Manufacturer": "OTBioelettronica", 
+        "ManufacturersModelName": "Quattrocento", 
+        "SoftwareVersions": "OTBioLab+ v.1.5.6.0", 
+        "Gain": 150,
+        "SoftwareFilters": "n/a",
+        "HardwareFilters": {
+            "HighPassFilter": {
+                "CutoffFrequency": 10,
+                "Unit": "Hz",
+                "Description": "Analog high-pass filter (-3 dB cutoff)"
+            },
+            "LowPassFilter": {
+                "CutoffFrequency": 500,
+                "Unit": "Hz",
+                "Description": "Analog low-pass filter (-3 dB cutoff)"
+            }
+        },
+        "RecordingType": "continuous",
+        "TaskName": "Isometric-ankle-dorsiflexion",
+        "TaskDescription": "Trapezoidal contractions at 30 percent and 50 percent MVC",
+        "Instructions": "Follow the requested isometric torque trajetory, which is provided via real-time visual feedback.",        
+        "InstitutionName": "Imperial Collage London", 
+        "InstitutionAddress": "London SW7 2AZ, United Kingdom", 
+        "InstitutionalDepartmentName": "Department of Bioengineering"
+    },
+
+    "CoordSystemSidecar":{
+        "grid1": {
+            "EMGCoordinateSystem": "Other", 
+            "EMGCoordinateSystemDescription": "x-axis: proximal -> distal; y-axis: medial -> lateral; all local electrode coordinates (per grid) are mapped on a single global coordinate system.",
+            "EMGCoordinateUnits": "mm",
+            "ParentCoordinateSystem": "lowerLeg",
+            "AnchorElectrode": "E12 - Grid1",
+            "AnchorCoordinates": [25, 0, 0]
+        },
+        "lowerLeg": {
+            "EMGCoordinateSystem": "Other",
+            "EMGCoordinateSystemDescription": "x-axis: proximal -> distal; y-axis: medial -> lateral; the coordinate system is located at the knee joint", 
+            "EMGCoordinateUnits": "percent"
+        }
+    }
+
+}

muniverse_emg-0.1.0/bids_metadata/grison_et_al_2025.json

@@ -0,0 +1,108 @@
+{   
+    "DatasetDescription": {
+        "Name": "MUniverse Griston et al 2025",
+        "BIDSVersion": "1.11.1", 
+        "DatasetType": "raw",
+        "License": "CC0 BY 4.0",
+        "Authors": [
+            "Agnese Grison",
+            "Irene Mendez Guerra",
+            "Alexander Kenneth Clarke",
+            "Silvia Muceli",
+            "Jaime Ibanez Pereda",
+            "Dario Farina"
+        ],
+        "EthicsApprovals": ["The Ethics Committee at Imperial College London reviewed and approved all procedures and protocols (no. 19IC5640)"],
+        "Funding": [
+            "UK Research and Innovation (UKRI Centre for Doctoral Training in AI for Healthcare grant number EP/S023283/1)",
+            "Huawei Technologies Research & Development (UK) Ltd.",
+            "Engineering and Physical Sciences Research Council (EPSRC) Doctoral Prize Fellowship",
+            "HybridNeuro (HORIZON-WIDERA-2021-ACCESS-03- 101079392)",
+            "ECHOES (ERC Starting Grant 101077693)",
+            "Consolidacion Investigadora grant (CNS2022-135366) funded by MCIN/AEI/10.13039/501100011033",
+            "NextGenerationEU/PRTR",
+            "Non-Invasive Single Neuron Electrical Monitoring (NISNEM Technology) Grant EP/T020970/1)"
+        ],
+        "DatasetDOI": "https://doi.org/10.7910/DVN/ID1WNQ",
+        "ReferencesAndLinks": [
+            "Grison, A., Mendez Guerra, I., Clarke, A. K., Muceli, S., Ibanez Pereda, J., & Farina, D. (2025). Unlocking the full potential of high-density surface EMG: novel non-invasive high-yield motor unit decomposition Journal of Physiology, 603.8 (2025)",
+            "https://doi.org/10.1113/JP287913"
+        ],
+        "GeneratedBy": [{
+            "Name": "MUniverse", 
+            "Version": "1.0", 
+            "CodeURL": "https://github.com/dfarinagroup/muniverse/scripts/",
+            "ScriptName": "grison2025_to_bids.py",
+            "Description": "Semi-automated conversion of the original data into BIDS format"    
+        }]
+    },
+
+    "EMGSidecar": {
+        "SkinPreparation": "The skin was shaved, abrased and cleansed with 70 percent ethyl alcohol.",
+        "EMGPlacementScheme": "Other",
+        "EMGPlacementSchemeDescription": "Two grids were carefully positioned side-to-side with a 4-mm distance between the electrodes at the edges of adjacent grids. The 128 electrodes were centered to the muscle belly (right tibialis anterior) and laid within the muscle perimeter identified through palpation. Two bands damped with water were placed around the ankle as ground (R2) and reference (R1) electrodes.",
+        "ElectrodeManufacturer": "OTBioelettronica",
+        "ElectrodeManufacturersModelName": "GR04MM1305",
+        "ElectrodeMaterial": "gold coated",
+        "InterelectrodeDistance": 4,
+        "EMGReference": "R1",
+        "EMGGround": "R2",
+        "EMGElectrodeCount": 130, 
+        "EMGChannelCount": 128,
+        "MISCChannelCount": 3,
+        "Manufacturer": "OTBioelettronica",
+        "ManufacturersModelName": "Quattrocento",
+        "SoftwareVersions": "OTBioLab+ v.1.5.6.0",
+        "Gain": 150,
+        "SoftwareFilters": "n/a",
+        "HardwareFilters": {
+            "HighPassFilter": {
+                "CutoffFrequency": 10,
+                "Unit": "Hz",
+                "Description": "Analog high-pass filter (-3 dB cutoff)"
+            },
+            "LowPassFilter": {
+                "CutoffFrequency": 500,
+                "Unit": "Hz",
+                "Description": "Analog low-pass filter (-3 dB cutoff)"
+            }
+        },
+        "RecordingType": "continuous",
+        "SamplingFrequency": 10240,
+        "PowerLineFrequency": 50,
+        "TaskName": "Isometric-ankle-dorsiflexion",
+        "TaskDescription": "The participant performed one, two, or three trapezoidal contractions at 10, 15, 20, 25, 30, 35, 40, 50, 60, and 70 percent MVC with 120 s of rest in between, consisting of linear ramps up and down performed at 5 percent per second and a plateau maintained for 20 s up to 30 percent MVC, 15 s for 35 percent and 40 percent MVC, and 10 s from 50 percent to 70 percent MVC. The order of the contractions was randomized.",
+        "Instructions": "Follow path provided via visual feedback.",
+        "InstitutionName": "Imperial Collage London",
+        "InstitutionAddress": "London SW7 2AZ, United Kingdom",
+        "InstitutionalDepartmentName": "Department of Bioengineering"        
+    },
+
+    "CoordSystemSidecar":{
+        "grid1": {
+            "EMGCoordinateSystem": "Other", 
+            "EMGCoordinateSystemDescription": "x-axis: proximal -> distal; y-axis: medial -> lateral; all local electrode coordinates are reported per grid.",
+            "EMGCoordinateUnits": "mm",
+            "ParentCoordinateSystem": "lowerLeg",
+            "AnchorElectrode": "E012",
+            "AnchorCoordinates": [25, 0, 0]
+        },
+        "grid2": {
+            "EMGCoordinateSystem": "Other", 
+            "EMGCoordinateSystemDescription": "x-axis: proximal -> distal; y-axis: medial -> lateral; all local electrode coordinates are reported per grid.",
+            "EMGCoordinateUnits": "mm",
+            "ParentCoordinateSystem": "lowerLeg",
+            "AnchorElectrode": "E116",
+            "AnchorCoordinates": [50, 0, 0]
+        },
+        "lowerLeg": {
+            "EMGCoordinateSystem": "Other",
+            "EMGCoordinateSystemDescription": "x-axis: proximal -> distal; y-axis: medial -> lateral; the coordinate system is located at the knee joint", 
+            "EMGCoordinateUnits": "percent"
+        }
+    }
+}
+
+
+  
+