{ "info": { "author": "Matthias Hennig Lab, University of Edinburgh", "author_email": "m.hennig@ed.ac.uk", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "License :: OSI Approved :: GNU General Public License v3 (GPLv3)", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7" ], "description": "# Herding Spikes 2\n\n[![Build Status](https://travis-ci.org/mhhennig/HS2.svg?branch=master)](https://travis-ci.org/mhhennig/HS2)\n[![Gitter chat](https://badges.gitter.im/HerdingSpikes.png)](https://gitter.im/HerdingSpikes)\n\n![Spikes](documentation/pictures/spikes.png)\n\n## Software for high density electrophysiology\n\nThis software provides functionality for the detection, localisation and clustering of spike data from dense multielectrode arrays based on the methods described in the following papers:\n\nJ.-O. Muthmann, H. Amin, E. Sernagor, A. Maccione, D. Panas, L. Berdondini, U.S. Bhalla, M.H. Hennig MH (2015). [Spike detection for large neural populations using high density multielectrode arrays](http://journal.frontiersin.org/article/10.3389/fninf.2015.00028/abstract). Front. Neuroinform. 9:28. doi: 10.3389/fninf.2015.00028.\n\nG. Hilgen, M. Sorbaro, S. Pirmoradian, J.-O. Muthmann, I. Kepiro, S. Ullo, C. Juarez Ramirez, A. Puente Encinas, A. Maccione, L. Berdondini, V. Murino, D. Sona, F. Cella Zanacchi, E. Sernagor, M.H. Hennig (2016). [Unsupervised spike sorting for large scale, high density multielectrode arrays.](http://www.cell.com/cell-reports/fulltext/S2211-1247(17)30236-X) Cell Reports 18, 2521\u20132532. bioRxiv: .\n\nThis implementation is highly efficient, spike detection and localisation runs in real time on recordings from 4,096 channels at 7kHz on a desktop PC. Large recordings with millions of events can be sorted in minutes.\n\nSince we believe publicly funded research code should be free and open, all code is released under GPL-3.0.\n\n### Supported systems \n\n- [3Brain](http://3brain.com/) BIOCAM and BIOCAM X\n- [Neuropixel array](https://www.ucl.ac.uk/neuropixels)\n- [ETH MEA1K](https://www.bsse.ethz.ch/bel/research/cmos-microsystems/microelectrode-systems.html)\n- [128 channel Neuroseeker array](http://neuroseeker.eu/)\n\n## Contributors, alphabetical \n\n- [Matthias Hennig](http://homepages.inf.ed.ac.uk/mhennig/index.html): Spike sorting\n- [Jano Horvath](https://github.com/JanoHorvath): Parameter optimisation\n- [Cole Hurwitz](https://github.com/colehurwitz31): Spike detection, localisation and sorting, C++ code\n- [Oliver Muthmann](mailto:ollimuh@googlemail.com): Spike detection and localisation\n- [Albert Puente Encinas](https://github.com/albertpuente): C++ implementation, optimisation and parallelisation\n- [Martino Sorbaro](http://martinosorb.github.io): Spike sorting, class structure and much of the python code\n- [Cesar Juarez Ramirez](mailto:cesaripn2@gmail.com): Visualisation\n- [Raimon Wintzer](https://github.com/lsIand): GUI and visualisation\n\n## Quick start \n\nThe code has been tested with Python version 3.6. It is essential `numpy` is available before installing.\nThe other dependencies will be installed by the installer.\n\nIf your system does not have Python pre-installed, the [Anaconda distribution](https://www.anaconda.com/download/) may be used.\n\n### All operative systems - Installation via pip\n\nWe suggest you use Anaconda if you don't have a favourite Python installed yet. We also recommend installing the code in a virtual environment (see below in the \"from source\" sections).\n\nA pip distribution is available and can be installed as follows:\n\n pip install numpy scipy\n pip install herdingspikes\n\n**Note:** HerdingSpikes is tested on Python 3.5 and above. It *may* work on Python 3.0-3.4.\n\nTo install from source, clone this repository and follow the instructions below.\n\n### Linux/Mac - from source\n\nWe suggest you install the code in a virtual environment. You can create one by running\n\n python3 -m venv --system-site-packages desired/location/HS2venv\n source desired/location/HS2venv/bin/activate\n\nYou can omit `--system-site-packages` if you don't want to use the local versions of common Python libraries. You will need to `activate` whenever you're using the module.\n\nThe module can automatically be installed, including all dependencies, by running\n\n pip install numpy scipy\n python setup.py install\n\n\n### Windows - from source\n\n#### 1. Creating a Python virtual environment\n\n##### Option 1: GUI\n\nOnce [Anaconda](https://www.anaconda.com/download/#windows) is installed, create and activate a virtual environment called ``HS2env``. This can be done with the ``Anaconda Navigator`` per mouse click. To make sure ``numpy`` and ``Cython`` are available, type\n\n conda install -n C:\\Users\\HS2env numpy\n\n\n##### Option 2: Command line (from source)\n\nAlternatively, open the ``Anaconda Prompt`` and type:\n\n conda search \"^python$\"\n\nThis will display a list of available python versions. Here we choose 3.6.5:\n\n conda create -n C:\\Users\\HS2env python=3.6.5 anaconda\n\nThis environment should be activated every time HS2 is used with the command\n\n conda activate C:\\Users\\HS2env\n\nTo make sure ``numpy`` is available, type\n\n conda install -n C:\\Users\\HS2env numpy\n\n#### 2. Installing a C++ Compiler\n\nHS2 contains fast C++ code, which requires a compiler. If you don't have a C++ compiler installed, the easiest solution is to download and install the Microsoft Visual Studio Build Tools: [https://www.visualstudio.com/downloads/#build-tools-for-visual-studio-2017](https://www.visualstudio.com/downloads/#build-tools-for-visual-studio-2017).\n\n\n#### 3. Obtaining and installing HS2\n\n##### Getting the code\n\n**Either** download and uncompress: [https://github.com/mhhennig/HS2/archive/master.zip](https://github.com/mhhennig/HS2/archive/master.zip)\n\n**Or** install ``git`` from [https://git-scm.com/download/win](https://git-scm.com/download/win). Then open a command prompt and type\n\n git clone https://github.com/mhhennig/HS2.git\n\nThis will create a folder ``HS2`` in the current directory. Note that updates can now be simply retrieved by typing ``git pull``.\n\n##### Install\n\nTo install, go to the HS2 directory, e.g.\n\n cd HS2\n\nand type\n\n python setup.py install\n\nNow HS2 will be available in the current virtual environment.\n\n\n\n## Example code\n\nExample code for the different supported systems is in the folder [notebooks](notebooks). These can be run without installing HS2 system-wide, but requires to run ``python setup.py build_ext --inplace`` in the ``HS2`` directory. Next, run ``jupyter notebook`` and navigate to the directory to try the code. Each notebook will download a short segment of raw data.\n\nGo [here](documentation) for documentation. A worked example for Biocam data is [here](documentation/biocam/BioCam-demo.md).\n\n## Contact\n\nThe herders are based at the School of Informatics, University of Edinburgh. Contact us [here](http://homepages.inf.ed.ac.uk/mhennig/contact/), we are happy to help.", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/mhhennig/HS2", "keywords": "spikes sorting electrophysiology detection", "license": "", "maintainer": "", "maintainer_email": "", "name": "herdingspikes", "package_url": "https://pypi.org/project/herdingspikes/", "platform": "", "project_url": "https://pypi.org/project/herdingspikes/", "project_urls": { "Homepage": "https://github.com/mhhennig/HS2", "Source": "https://github.com/mhhennig/HS2/" }, "release_url": "https://pypi.org/project/herdingspikes/0.3.3/", "requires_dist": null, "requires_python": ">=3.5", "summary": "Efficient spike detection and sorting for dense MEA", "version": "0.3.3" }, "last_serial": 5668634, "releases": { "0.3.0": [ { "comment_text": "", "digests": { "md5": "f0961b3e392b5142e57a0fe8974e77df", "sha256": "491353c9b60260c7ec297aa5c46e5b81358bc52667b49871ea4fe709e58b283d" }, "downloads": -1, "filename": "herdingspikes-0.3.0.tar.gz", "has_sig": false, "md5_digest": "f0961b3e392b5142e57a0fe8974e77df", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 203811, "upload_time": "2019-05-29T16:50:19", "url": "https://files.pythonhosted.org/packages/39/21/f704366142239664a74cc12afc840fca6b2e2cc4c52fe4c842fd5b914144/herdingspikes-0.3.0.tar.gz" } ], "0.3.2": [ { "comment_text": "", "digests": { "md5": "c75b6a60fe011a37b939d5ea1c350c7d", "sha256": "d6fc36081e54d2e37de2c786bfb1ca2fd31021ae35ba8cdab5c56cb05be035bc" }, "downloads": -1, "filename": "herdingspikes-0.3.2-cp35-cp35m-macosx_10_6_x86_64.whl", "has_sig": false, "md5_digest": "c75b6a60fe011a37b939d5ea1c350c7d", "packagetype": "bdist_wheel", "python_version": "cp35", "requires_python": ">=3.5", "size": 481507, "upload_time": "2019-06-24T11:30:54", "url": "https://files.pythonhosted.org/packages/04/17/fb9b268f6a2893a7a470dd623d263f6bcdd79bfec167f1298444b243cf0b/herdingspikes-0.3.2-cp35-cp35m-macosx_10_6_x86_64.whl" }, { "comment_text": "", "digests": { "md5": "f8c548e25fe38018996fb3ff1abeb2dd", "sha256": "264f8571eeb743ffff90a81f01b50e36ee3831d481877bdd4ef7e55d779e8fad" }, "downloads": -1, "filename": "herdingspikes-0.3.2-cp36-cp36m-macosx_10_7_x86_64.whl", "has_sig": false, "md5_digest": "f8c548e25fe38018996fb3ff1abeb2dd", "packagetype": "bdist_wheel", "python_version": "cp36", "requires_python": ">=3.5", "size": 484024, "upload_time": "2019-06-24T11:16:48", "url": "https://files.pythonhosted.org/packages/ff/1a/f45f7b4e779ea7883b75a719721d6cd62f43826719efbba552c38ba9ae03/herdingspikes-0.3.2-cp36-cp36m-macosx_10_7_x86_64.whl" }, { "comment_text": "", "digests": { "md5": "0c9bb895f78b03b0f8ef9b41434c5fea", "sha256": "3c862a43d3471d97bd66225419ae2465ae4bb8b9e659531d4dfb2cea3785874c" }, "downloads": -1, "filename": "herdingspikes-0.3.2-cp37-cp37m-macosx_10_7_x86_64.whl", "has_sig": false, "md5_digest": "0c9bb895f78b03b0f8ef9b41434c5fea", "packagetype": "bdist_wheel", "python_version": "cp37", "requires_python": ">=3.5", "size": 482268, "upload_time": "2019-06-24T09:43:51", "url": "https://files.pythonhosted.org/packages/38/35/bab57e6ed2db16e11420748b468909b508ae1b22d3db0d6477889dbdf399/herdingspikes-0.3.2-cp37-cp37m-macosx_10_7_x86_64.whl" }, { "comment_text": "", "digests": { "md5": "1a8cbc3f5fcc2406c2eb65bd3ae2c292", "sha256": "edefae0cce3629275282d8404827d1d262389d9e90df31c3c33e083bcb11ec7d" }, "downloads": -1, "filename": "herdingspikes-0.3.2.tar.gz", "has_sig": false, "md5_digest": "1a8cbc3f5fcc2406c2eb65bd3ae2c292", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5", "size": 344418, "upload_time": "2019-05-30T14:13:58", "url": "https://files.pythonhosted.org/packages/94/17/2b1732ef01d4c24b5ee22ef70e32b0fff00b61713f41e40dc145315cfd1b/herdingspikes-0.3.2.tar.gz" } ], "0.3.3": [ { "comment_text": "", "digests": { "md5": "56c5721bb3489cf3f8a9c70e622234e6", "sha256": "d7532f4805275ee5a8461e48d75c8bf283188a7342813832a6f6c6a842296144" }, "downloads": -1, "filename": "herdingspikes-0.3.3.tar.gz", "has_sig": false, "md5_digest": "56c5721bb3489cf3f8a9c70e622234e6", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5", "size": 344329, "upload_time": "2019-08-12T20:36:34", "url": "https://files.pythonhosted.org/packages/79/d3/8c6fdc73ce206f14494e9ed06577ce2d56134bd6707d45330cf0ea513451/herdingspikes-0.3.3.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "56c5721bb3489cf3f8a9c70e622234e6", "sha256": "d7532f4805275ee5a8461e48d75c8bf283188a7342813832a6f6c6a842296144" }, "downloads": -1, "filename": "herdingspikes-0.3.3.tar.gz", "has_sig": false, "md5_digest": "56c5721bb3489cf3f8a9c70e622234e6", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5", "size": 344329, "upload_time": "2019-08-12T20:36:34", "url": "https://files.pythonhosted.org/packages/79/d3/8c6fdc73ce206f14494e9ed06577ce2d56134bd6707d45330cf0ea513451/herdingspikes-0.3.3.tar.gz" } ] }