https://github.com/esi-neuroscience/syncopy
Systems Neuroscience Computing in Python: user-friendly analysis of large-scale electrophysiology data
https://github.com/esi-neuroscience/syncopy
analysis brain computational-neuroscience ecog neuroscience spectral-methods systems-neuroscience
Last synced: 8 months ago
JSON representation
Systems Neuroscience Computing in Python: user-friendly analysis of large-scale electrophysiology data
- Host: GitHub
- URL: https://github.com/esi-neuroscience/syncopy
- Owner: esi-neuroscience
- License: bsd-3-clause
- Created: 2020-01-15T15:03:37.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2025-03-06T05:01:06.000Z (over 1 year ago)
- Last Synced: 2025-10-21T19:47:37.664Z (8 months ago)
- Topics: analysis, brain, computational-neuroscience, ecog, neuroscience, spectral-methods, systems-neuroscience
- Language: Python
- Homepage:
- Size: 12 MB
- Stars: 54
- Watchers: 6
- Forks: 16
- Open Issues: 38
-
Metadata Files:
- Readme: README.rst
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Citation: CITATION.cff
Awesome Lists containing this project
README
.. image:: https://raw.githubusercontent.com/esi-neuroscience/syncopy/master/doc/source/_static/syncopy_logo_small.png
:alt: Syncopy-Logo
Systems Neuroscience Computing in Python
========================================
|Conda Version| |PyPi Version| |License| |DOI|
.. |Conda Version| image:: https://img.shields.io/conda/vn/conda-forge/esi-syncopy.svg
:target: https://anaconda.org/conda-forge/esi-syncopy
.. |PyPI version| image:: https://badge.fury.io/py/esi-syncopy.svg
:target: https://badge.fury.io/py/esi-syncopy
.. |License| image:: https://img.shields.io/github/license/esi-neuroscience/syncopy
.. |DOI| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.8191941.svg
:target: https://doi.org/10.5281/zenodo.8191941
|Master Tests| |Master Coverage|
.. |Master Tests| image:: https://github.com/esi-neuroscience/syncopy/actions/workflows/cov_test_workflow.yml/badge.svg?branch=master
:target: https://github.com/esi-neuroscience/syncopy/actions/workflows/cov_test_workflow.yml
.. |Master Coverage| image:: https://codecov.io/gh/esi-neuroscience/syncopy/branch/master/graph/badge.svg?token=JEI3QQGNBQ
:target: https://codecov.io/gh/esi-neuroscience/syncopy
Syncopy aims to be a user-friendly toolkit for *large-scale*
electrophysiology data-analysis in Python. We strive to achieve the following goals:
1. Syncopy is a *fully open source Python* environment for electrophysiology
data analysis.
2. Syncopy is *scalable* and built for *very large datasets*. It automatically
makes use of available computing resources and is developed with built-in
parallelism in mind.
3. Syncopy is *compatible with FieldTrip*. Data and results can be loaded into
MATLAB and Python, and parameter names and function call syntax are as similar as possible.
Syncopy is developed at the
`Ernst Strüngmann Institute (ESI) gGmbH for Neuroscience in Cooperation with Max Planck Society `_
and released free of charge under the
`BSD 3-Clause "New" or "Revised" License `_.
News
-----
* 2024-04, **Pre-print on Syncopy available.** A pre-print paper on Syncopy is now available `here on arxiv, with DOI 10.1101/2024.04.15.589590 `_. Please cite this pre-print if you use Syncopy. In APA style, the citation is: Mönke, G., Schäfer, T., Parto-Dezfouli, M., Kajal, D. S., Fürtinger, S., Schmiedt, J. T., & Fries, P. (2024). *Systems Neuroscience Computing in Python (SyNCoPy): A Python Package for Large-scale Analysis of Electrophysiological Data.* bioRxiv, 2024-04.
Contact
-------
To report bugs or ask questions please use our `GitHub issue tracker `_.
For general inquiries please contact syncopy (at) esi-frankfurt.de.
Installation
============
We recommend to install SynCoPy into a new conda environment:
#. Install the `Anaconda Distribution for your Operating System `_ if you do not yet have it.
#. Start a new terminal.
* You can do this by starting ```Anaconda navigator```, selecting ```Environments``` in the left tab, selecting the ```base (root)``` environment, and clicking the green play button and then ```Open Terminal```.
* Alternatively, under Linux, you can just type ```bash``` in your active terminal to start a new session.
You should see a terminal with a command prompt that starts with ```(base)```, indicating that you are
in the conda ```base``` environment.
Now we create a new environment named ```syncopy``` and install syncopy into this environment:
.. code-block:: bash
conda create -y --name syncopy
conda activate syncopy
conda install -y -c conda-forge esi-syncopy
Getting Started
===============
Please visit our `online documentation `_.
Developer Installation
-----------------------
To get the latest development version, please clone our GitHub repository and change to the `dev` branch. We highly recommend to install into a new conda virtual environment, so that this development version does not interfere with your existing installation.
.. code-block:: bash
git clone https://github.com/esi-neuroscience/syncopy.git
cd syncopy/
conda env create --name syncopy-dev --file syncopy.yml
conda activate syncopy-dev
pip install -e .
We recommend to verify your development installation by running the unit tests. You can skip the parallel tests to save some time, the tests should run in about 5 minutes then:
.. code-block:: bash
python -m pytest -k "not parallel"
You now have a verified developer installation of Syncopy. Please refert to our `contributing guide `_ if you want to contribute to Syncopy.