Skip to main content

Tools and functions for neural data processing and analysis in python

Project description

GH Actions Tests codecov PyPI version Open in Code Ocean License

naplib-python

Tools and functions for neural acoustic data processing and analysis in python. The documentation can be acccessed at the link below. It contains the API reference as well as example notebooks.

Installation

naplib-python is available on PyPi. To install or update this package with pip, run the following command:

pip install naplib

To upgrade the version, run:

pip install --upgrade naplib

API

The basic data structure for storing neural recording data is the Data object, which contains neural recordings and other variables associated with different trials such as stimuli and other metadata. Examples of loading and using this data structure can be found in the documentation and the docs/examples/ folder.

Brain Plotting

In addition to analysis and processing tools, naplib-python contains a suite of visualization tools, including brain plotting for ECoG and intracranial EEG electrodes. The backend can use either pure matplotlib for static plots, or plotly for 3D interactive plots.

Data Structure Schematic

Contributions

naplib-python is built by the Neural Acoustic Processing Lab at Columbia University. We primarily use it for processing neural data coming from electrocorticography (ECoG) and electroencephalography (EEG) along with paired audio stimuli in order to study the auditory cortex. You are free to use the software according to its license, and we welcome contributions if you would like to propose changes, additions, or fixes. See our contribution guide for more details.

Citing naplib-python

If you find naplib-python useful for your research, please cite the following paper (link):

Gavin Mischler, Vinay Raghavan, Menoua Keshishian, & Nima Mesgarani (2023). naplib-python: Neural acoustic data processing and analysis tools in python. Software Impacts, 17, 100541.

Backlog

The following items are ToDo items on the backlog:

  • Look into data parallelization methods for the Data object and associated methods
  • Consider making the Data object a dataclass
  • Implement functionality to write Data objects to MATLAB formats (possibly EEGLab formats)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

naplib-2.1.0-py3-none-any.whl (83.3 MB view details)

Uploaded Python 3

File details

Details for the file naplib-2.1.0-py3-none-any.whl.

File metadata

  • Download URL: naplib-2.1.0-py3-none-any.whl
  • Upload date:
  • Size: 83.3 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.13

File hashes

Hashes for naplib-2.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 cb72de2b74c8427ef133b7fce4f42f5b9f5df3e818bba94d19a1fdedf83e6610
MD5 0546685534b5460e83d0012d76ae3a1c
BLAKE2b-256 6a39c05e79e7775fbcc15b9b7d37452f3cf0ec9333d978d0363460ee20c5db14

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page