# HyPyP 🐍〰️🐍
The **Hy**perscanning **Py**thon **P**ipeline
[](https://pypi.org/project/HyPyP/) [](https://github.com/ppsp-team/HyPyP/actions/workflows/Build.yml) <a href="https://hypyp.readthedocs.io"><img src="https://readthedocs.org/projects/hypyp/badge/?version=latest"></a> [](https://opensource.org/licenses/BSD-3-Clause) [](https://discord.gg/zYzjeGj7D6)
⚠️ This software is in beta and thus should be considered with caution. While we have done our best to test all the functionalities, there is no guarantee that the pipeline is entirely bug-free.
📖 See our [paper](https://academic.oup.com/scan/advance-article/doi/10.1093/scan/nsaa141/5919711) for more explanation and our plan for upcoming functionalities (aka Roadmap).
🤝 If you want to help you can submit bugs and suggestions of enhancements in our Github [Issues section](https://github.com/ppsp-team/HyPyP/issues).
🤓 For the motivated contributors, you can even help directly in the development of HyPyP. You will need to install [Poetry](https://python-poetry.org/) (see section below).
## Contributors
Original authors: Florence BRUN, Anaël AYROLLES, Phoebe CHEN, Amir DJALOVSKI, Yann BEAUXIS, Suzanne DIKKER, Guillaume DUMAS
New contributors: Marine Gautier MARTINS, Rémy RAMADOUR, Patrice FORTIN, Ghazaleh RANJBARAN, Quentin MOREAU, Caitriona DOUGLAS, Franck PORTEOUS, Jonas MAGO, Juan C. AVENDANO, Julie BONNAIRE
## Installation
`pip install HyPyP`
## Documentation
HyPyP documentation of all the API functions is available online at [hypyp.readthedocs.io](https://hypyp.readthedocs.io/)
For getting started with HyPyP, we have designed a little walkthrough: [getting_started.ipynb](https://github.com/ppsp-team/HyPyP/blob/master/tutorial/getting_started.ipynb)
## Core API
🛠 [io.py](https://github.com/ppsp-team/HyPyP/blob/master/hypyp/io.py) — Loaders (Florence, Anaël, Ghazaleh, Franck, Jonas, Guillaume)
🧰 [utils.py](https://github.com/ppsp-team/HyPyP/blob/master/hypyp/utils.py) — Basic tools (Amir, Florence, Guillaume)
⚙️ [prep.py](https://github.com/ppsp-team/HyPyP/blob/master/hypyp/prep.py) — Preprocessing (ICA & AutoReject) (Anaël, Florence, Guillaume)
🔠 [analyses.py](https://github.com/ppsp-team/HyPyP/blob/master/hypyp/analyses.py) — Power spectral density and wide choice of connectivity measures (Phoebe, Suzanne, Florence, Ghazaleh, Juan, Guillaume)
📈 [stats.py](https://github.com/ppsp-team/HyPyP/blob/master/hypyp/stats.py) — Statistics (permutations & cluster statistics) (Florence, Guillaume)
🧠 [viz.py](https://github.com/ppsp-team/HyPyP/blob/master/hypyp/viz.py) — Inter-brain visualization (Anaël, Amir, Florence, Guillaume)
🎓 [Tutorials](https://github.com/ppsp-team/HyPyP/tree/master/tutorial) - Examples & documentation (Anaël, Florence, Yann, Ghazaleh, Caitriona, Guillaume)
## fNIRS hyperscanning
🔦 [fnirs/\*.py](https://github.com/ppsp-team/HyPyP/blob/master/hypyp/fnirs) — Functional Near Infrared Spectroscopy hyperscanning features (Patrice)
🌊 [wavelet/\*.py](https://github.com/ppsp-team/HyPyP/blob/master/hypyp/wavelet) — Continuous Wavelet Transform and Wavelet Transform Coherence (Patrice)
📊 [shiny/\*.py](https://github.com/ppsp-team/HyPyP/blob/master/hypyp/app) — Shiny dashboards, install using `poetry install --extras shiny` (Patrice)
## Poetry Installation (Only for Developers and Adventurous Users)
To develop HyPyP, we recommend using [Poetry 2.x](https://python-poetry.org/). Follow these steps:
### 1. Install Poetry:
```bash
pip install poetry
```
### 2. Clone the Repository:
```bash
git clone git@github.com:ppsp-team/HyPyP.git
cd HyPyP
```
### 3. Install Dependencies:
```bash
poetry install
```
Note: By default, dev dependencies (including JupyterLab) are not included in the main dependencies.
To install development dependencies, you can run:
```bash
poetry install --with dev
```
### 4. Launch Jupyter Lab to Run Notebooks:
Instead of entering a shell, launch Jupyter Lab directly within the Poetry environment:
```bash
poetry run jupyter lab
```
## Additional Setup for Poetry
- **Install Poetry Plugins:**
To have full functionality with Poetry, add the following plugins:
```bash
poetry self add poetry-plugin-shell
poetry self add poetry-plugin-export
```
- **VS Code Integration:**
To make the Poetry virtual environment available in VS Code, you might need to set Poetry to create in-project virtual environments. You can do this either by running:
```bash
poetry config virtualenvs.in-project true
```
or by adding the following line to your .bashrc or .zshrc:
```bash
poetry config virtualenvs.in-project true
```
## Child Head Visualization
As of version 0.5.0b5, hypyp now supports visualization of parent-child or adult-child hyperscanning data. This allows for properly scaled and positioned head models when analyzing data from participants of different ages.
To use this functionality, simply set the `children=True` parameter in visualization functions and specify which participant is the child using the `child_head` parameter.
Example:
```python
# Visualize parent-child data (epo1 = parent, epo2 = child)
viz_3D_inter(epo1, epo2, C, threshold=0.95, steps=10, children=True, child_head=True)
```
# License
This project is licensed under the BSD 3-Clause License. See the license for details.
Raw data
{
"_id": null,
"home_page": "https://github.com/ppsp-team/HyPyP",
"name": "hypyp",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.10",
"maintainer_email": null,
"keywords": "hyperscanning, neuroscience, pipeline, statistics, visualization",
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/1d/68/1723fba1d097f0e07690deff6746794ce0f3fca08089cbb24c1add640d55/hypyp-0.5.0b11.tar.gz",
"platform": null,
"description": "# HyPyP \ud83d\udc0d\u3030\ufe0f\ud83d\udc0d\n\nThe **Hy**perscanning **Py**thon **P**ipeline\n\n[](https://pypi.org/project/HyPyP/) [](https://github.com/ppsp-team/HyPyP/actions/workflows/Build.yml) <a href=\"https://hypyp.readthedocs.io\"><img src=\"https://readthedocs.org/projects/hypyp/badge/?version=latest\"></a> [](https://opensource.org/licenses/BSD-3-Clause) [](https://discord.gg/zYzjeGj7D6)\n\n\u26a0\ufe0f This software is in beta and thus should be considered with caution. While we have done our best to test all the functionalities, there is no guarantee that the pipeline is entirely bug-free.\n\n\ud83d\udcd6 See our [paper](https://academic.oup.com/scan/advance-article/doi/10.1093/scan/nsaa141/5919711) for more explanation and our plan for upcoming functionalities (aka Roadmap).\n\n\ud83e\udd1d If you want to help you can submit bugs and suggestions of enhancements in our Github [Issues section](https://github.com/ppsp-team/HyPyP/issues).\n\n\ud83e\udd13 For the motivated contributors, you can even help directly in the development of HyPyP. You will need to install [Poetry](https://python-poetry.org/) (see section below).\n\n## Contributors\n\nOriginal authors: Florence BRUN, Ana\u00ebl AYROLLES, Phoebe CHEN, Amir DJALOVSKI, Yann BEAUXIS, Suzanne DIKKER, Guillaume DUMAS \nNew contributors: Marine Gautier MARTINS, R\u00e9my RAMADOUR, Patrice FORTIN, Ghazaleh RANJBARAN, Quentin MOREAU, Caitriona DOUGLAS, Franck PORTEOUS, Jonas MAGO, Juan C. AVENDANO, Julie BONNAIRE\n\n## Installation\n\n`pip install HyPyP`\n\n## Documentation\n\nHyPyP documentation of all the API functions is available online at [hypyp.readthedocs.io](https://hypyp.readthedocs.io/)\n\nFor getting started with HyPyP, we have designed a little walkthrough: [getting_started.ipynb](https://github.com/ppsp-team/HyPyP/blob/master/tutorial/getting_started.ipynb)\n\n## Core API\n\n\ud83d\udee0 [io.py](https://github.com/ppsp-team/HyPyP/blob/master/hypyp/io.py) \u2014 Loaders (Florence, Ana\u00ebl, Ghazaleh, Franck, Jonas, Guillaume)\n\n\ud83e\uddf0 [utils.py](https://github.com/ppsp-team/HyPyP/blob/master/hypyp/utils.py) \u2014 Basic tools (Amir, Florence, Guillaume)\n\n\u2699\ufe0f [prep.py](https://github.com/ppsp-team/HyPyP/blob/master/hypyp/prep.py) \u2014 Preprocessing (ICA & AutoReject) (Ana\u00ebl, Florence, Guillaume)\n\n\ud83d\udd20 [analyses.py](https://github.com/ppsp-team/HyPyP/blob/master/hypyp/analyses.py) \u2014 Power spectral density and wide choice of connectivity measures (Phoebe, Suzanne, Florence, Ghazaleh, Juan, Guillaume)\n\n\ud83d\udcc8 [stats.py](https://github.com/ppsp-team/HyPyP/blob/master/hypyp/stats.py) \u2014 Statistics (permutations & cluster statistics) (Florence, Guillaume)\n\n\ud83e\udde0 [viz.py](https://github.com/ppsp-team/HyPyP/blob/master/hypyp/viz.py) \u2014 Inter-brain visualization (Ana\u00ebl, Amir, Florence, Guillaume)\n\n\ud83c\udf93 [Tutorials](https://github.com/ppsp-team/HyPyP/tree/master/tutorial) - Examples & documentation (Ana\u00ebl, Florence, Yann, Ghazaleh, Caitriona, Guillaume)\n\n## fNIRS hyperscanning\n\n\ud83d\udd26 [fnirs/\\*.py](https://github.com/ppsp-team/HyPyP/blob/master/hypyp/fnirs) \u2014 Functional Near Infrared Spectroscopy hyperscanning features (Patrice)\n\n\ud83c\udf0a [wavelet/\\*.py](https://github.com/ppsp-team/HyPyP/blob/master/hypyp/wavelet) \u2014 Continuous Wavelet Transform and Wavelet Transform Coherence (Patrice)\n\n\ud83d\udcca [shiny/\\*.py](https://github.com/ppsp-team/HyPyP/blob/master/hypyp/app) \u2014 Shiny dashboards, install using `poetry install --extras shiny` (Patrice)\n\n## Poetry Installation (Only for Developers and Adventurous Users)\n\nTo develop HyPyP, we recommend using [Poetry 2.x](https://python-poetry.org/). Follow these steps:\n\n### 1. Install Poetry:\n\n```bash\n pip install poetry\n```\n\n### 2. Clone the Repository:\n\n```bash\ngit clone git@github.com:ppsp-team/HyPyP.git\ncd HyPyP\n```\n\n### 3. Install Dependencies:\n\n```bash\npoetry install\n```\n\nNote: By default, dev dependencies (including JupyterLab) are not included in the main dependencies.\nTo install development dependencies, you can run:\n\n```bash\npoetry install --with dev\n```\n\n### 4. Launch Jupyter Lab to Run Notebooks:\n\nInstead of entering a shell, launch Jupyter Lab directly within the Poetry environment:\n\n```bash\npoetry run jupyter lab\n```\n\n## Additional Setup for Poetry\n\n- **Install Poetry Plugins:**\n\nTo have full functionality with Poetry, add the following plugins:\n\n```bash\npoetry self add poetry-plugin-shell\npoetry self add poetry-plugin-export\n```\n\n- **VS Code Integration:**\n\nTo make the Poetry virtual environment available in VS Code, you might need to set Poetry to create in-project virtual environments. You can do this either by running:\n\n```bash\npoetry config virtualenvs.in-project true\n```\n\nor by adding the following line to your .bashrc or .zshrc:\n\n```bash\npoetry config virtualenvs.in-project true\n```\n\n## Child Head Visualization\n\nAs of version 0.5.0b5, hypyp now supports visualization of parent-child or adult-child hyperscanning data. This allows for properly scaled and positioned head models when analyzing data from participants of different ages.\n\nTo use this functionality, simply set the `children=True` parameter in visualization functions and specify which participant is the child using the `child_head` parameter.\n\nExample:\n\n```python\n# Visualize parent-child data (epo1 = parent, epo2 = child)\nviz_3D_inter(epo1, epo2, C, threshold=0.95, steps=10, children=True, child_head=True)\n```\n\n# License\n\nThis project is licensed under the BSD 3-Clause License. See the license for details.\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "The Hyperscanning Python Pipeline.",
"version": "0.5.0b11",
"project_urls": {
"Documentation": "https://hypyp.readthedocs.io",
"Homepage": "https://github.com/ppsp-team/HyPyP",
"Repository": "https://github.com/ppsp-team/HyPyP"
},
"split_keywords": [
"hyperscanning",
" neuroscience",
" pipeline",
" statistics",
" visualization"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "282562ad6a579716f978043950de3ea6b521636776725cba9b94945f7fbeb4a4",
"md5": "811c4c5d6ca85be240ab3be7ac3da827",
"sha256": "546b4ff8a529252255c6138972c6e22a79fa4110d406f274f175e7b85551012d"
},
"downloads": -1,
"filename": "hypyp-0.5.0b11-py3-none-any.whl",
"has_sig": false,
"md5_digest": "811c4c5d6ca85be240ab3be7ac3da827",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.10",
"size": 128791,
"upload_time": "2025-07-11T23:06:30",
"upload_time_iso_8601": "2025-07-11T23:06:30.232651Z",
"url": "https://files.pythonhosted.org/packages/28/25/62ad6a579716f978043950de3ea6b521636776725cba9b94945f7fbeb4a4/hypyp-0.5.0b11-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1d681723fba1d097f0e07690deff6746794ce0f3fca08089cbb24c1add640d55",
"md5": "564d2a0719da52e4aa3bc3da737da9c6",
"sha256": "cef727d30aff4fdd05aae5844cae53e1f2fe5e4d1c75c990b70d859b0258456b"
},
"downloads": -1,
"filename": "hypyp-0.5.0b11.tar.gz",
"has_sig": false,
"md5_digest": "564d2a0719da52e4aa3bc3da737da9c6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.10",
"size": 112871,
"upload_time": "2025-07-11T23:06:32",
"upload_time_iso_8601": "2025-07-11T23:06:32.457848Z",
"url": "https://files.pythonhosted.org/packages/1d/68/1723fba1d097f0e07690deff6746794ce0f3fca08089cbb24c1add640d55/hypyp-0.5.0b11.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-11 23:06:32",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ppsp-team",
"github_project": "HyPyP",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "hypyp"
}