.. image:: https://badge.fury.io/py/pyspike.png :target: http://badge.fury.io/py/pyspike .. image:: https://travis-ci.org/mariomulansky/PySpike.svg?branch=master :target: https://travis-ci.org/mariomulansky/PySpike
PySpike is a Python library for the numerical analysis of spike train similarity. Its core functionality is the implementation of the ISI-distance [#] and SPIKE-distance [#], SPIKE-Synchronization [#], as well as their adaptive generalizations [#]. It provides functions to compute multivariate profiles, distance matrices, as well as averaging and general spike train processing. All computation intensive parts are implemented in C via cython to reach a competitive performance (factor 100-200 over plain Python).
PySpike provides the same fundamental functionality as the SPIKY_ framework for Matlab, which additionally contains spike-train generators, more spike train distance measures and many visualization routines.
All source codes are available on Github <https://github.com/mariomulansky/PySpike>_ and are published under the BSDLicense.
If you use PySpike in your research, please cite our SoftwareX publication on PySpike:
Mario Mulansky, Thomas Kreuz, PySpike - A Python library for analyzing spike train synchrony, Software X 5, 183 (2016) [pdf] <https://drive.google.com/file/d/1vJA5q4eFCd2ASKGN8ANaDNBfQVpWBPXd/view>_
Additionally, depending on the used methods: ISI-distance [1], SPIKE-distance [2], SPIKE-Synchronization [3], or their adaptive generalizations [4], please cite one or more of the following publications:
.. [#] Kreuz T, Haas JS, Morelli A, Abarbanel HDI, Politi A, Measuring spike train synchrony. J Neurosci Methods 165, 151 (2007) [pdf] <https://drive.google.com/file/d/113cr1xUhKe0rMIiFc1vMoIQ7j9noobKW/view>_
.. [#] Kreuz T, Chicharro D, Houghton C, Andrzejak RG, Mormann F, Monitoring spike train synchrony. J Neurophysiol 109, 1457 (2013) [pdf] <https://drive.google.com/file/d/1oppf86V4cBVakPiv6Mbn_WaoKoKWzmIl/view>_
.. [#] Kreuz T, Mulansky M and Bozanic N, SPIKY: A graphical user interface for monitoring spike train synchrony, J Neurophysiol 113, 3432 (2015) [pdf] <https://drive.google.com/file/d/16rdVbJFj7BypaaI10aHpXLk0WJuJ7reM/view>_
.. [#] Satuvuori E, Mulansky M, Bozanic N, Malvestio I, Zeldenrust F, Lenk K, and Kreuz T, Measures of spike train synchrony for data with multiple time-scales, J Neurosci Methods 287, 25 (2017) [pdf] <https://drive.google.com/file/d/1xOepp9WN0luODH9qF6i5vVRimqC9WweA/view>_
With version 0.8.0, Adaptive and Rate Independent algorithms are supported.
With version 0.7.0, support for Python 2 was dropped, PySpike now officially supports Python 3.7, 3.8, 3.9, 3.10.
With version 0.6.0, the spike directionality and spike train order function have been added.
With version 0.5.0, the interfaces have been unified and the specific functions for multivariate computations have become deprecated.
With version 0.2.0, the :code:SpikeTrain class has been introduced to represent spike trains.
This is a breaking change in the function interfaces.
Hence, programs written for older versions of PySpike (0.1.x) will not run with newer versions.
PySpike is available at Python Package Index and this is the easiest way to obtain the PySpike package.
If you have pip installed, just run
.. code:: bash
sudo pip install pyspike
to install pyspike.
PySpike requires numpy as minimal requirement, as well as a C compiler to generate the binaries.
Install from Github sources ...........................
You can also obtain the latest PySpike developer version from the github repository. For that, make sure you have the following Python libraries installed:
In particular, make sure that cython_ is configured properly and able to locate a C compiler, otherwise PySpike will use the much slower Python implementations.
To install PySpike, simply download the source, e.g. from Github, and run the :code:setup.py script:
.. code:: bash
git clone https://github.com/mariomulansky/PySpike.git
cd PySpike
python setup.py build_ext --inplaceThen you can run the tests using the pytest test framework:
.. code:: bash
pytestFinally, you should make PySpike's installation folder known to Python to be able to import pyspike in your own projects.
Therefore, add your :code:/path/to/PySpike to the :code:$PYTHONPATH environment variable.
The following code loads some exemplary spike trains, computes the dissimilarity profile of the ISI-distance of the first two :code:SpikeTrain objects, and plots it with matplotlib:
.. code:: python
import matplotlib.pyplot as plt
import pyspike as spk
spike_trains = spk.load_spike_trains_from_txt("PySpike_testdata.txt",
edges=(0, 4000))
isi_profile = spk.isi_profile(spike_trains[0], spike_trains[1])
x, y = isi_profile.get_plottable_data()
plt.plot(x, y, '--k')
print("ISI distance: %.8f" % isi_profile.avrg())
plt.show()The following example computes the multivariate ISI-, SPIKE- and SPIKE-Sync-profile for a list of spike trains loaded from a text file:
.. code:: python
spike_trains = spk.load_spike_trains_from_txt("PySpike_testdata.txt",
edges=(0, 4000))
avrg_isi_profile = spk.isi_profile(spike_trains)
avrg_spike_profile = spk.spike_profile(spike_trains)
avrg_spike_sync_profile = spk.spike_sync_profile(spike_trains)More examples with detailed descriptions can be found in the tutorial section <http://mariomulansky.github.io/PySpike/#tutorial>_.
===============================================================================
The work on PySpike was supported by the European Comission through the Marie
Curie Initial Training Network Neural Engineering Transformative Technologies (NETT) <http://www.neural-engineering.eu/>_ under the project number 289146.
Python/C Programming:
Scientific Methods:
.. _ISI: http://www.scholarpedia.org/article/Measures_of_spike_train_synchrony#ISI-distance .. _SPIKE: http://www.scholarpedia.org/article/SPIKE-distance .. _SPIKE-Synchronization: http://www.scholarpedia.org/article/Measures_of_spike_train_synchrony#SPIKE_synchronization .. _cython: http://www.cython.org .. _SPIKY: https://thomas-kreuz.complexworld.net/source-codes/spiky .. _BSD_License: http://opensource.org/licenses/BSD-2-Clause