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)
Metadata
Release files for naplib 2.6.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| naplib-2.6.0-py3-none-any.whl | Python 3 | none | any | Details for naplib-2.6.0-py3-none-any.whl |
Release files / naplib-2.6.0-py3-none-any.whl
| Download URL | naplib-2.6.0-py3-none-any.whl |
|---|---|
| Size | 83.3 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c61deebe618e94052714352786fd5bbc58d13becbfcc7a19eb40aaf00c7a308b
|
|
BLAKE2b-256 checksum How to use checksums |
c9b9fc147105a7d9921b5e51f7f79a2ed2bc49e639e0db20ef03ea67cebc33fd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.10.13
|
Security for naplib 2.6.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.