Automatically convert neurophysiology data to NWB
Table of Contents
About
NeuroConv is a Python package for converting neurophysiology data in a variety of proprietary formats to the Neurodata Without Borders (NWB) standard.
Features:
- Reads data from 50 popular neurophysiology data formats and writes to NWB using best practices.
- Extracts relevant metadata from each format.
- Handles large data volume by reading datasets piece-wise.
- Minimizes the size of the NWB files by automatically applying chunking and lossless compression.
- Supports ensembles of multiple data streams, and supports common methods for temporal alignment of streams.
Installation
We always recommend installing and running Python packages in a clean environment. One way to do this is via conda environments:
conda create --name <give the environment a name> --python <choose a version of Python to use>
conda activate <environment name>
To install the latest stable release of neuroconv though PyPI, run:
pip install neuroconv
To install the current unreleased main branch (requires git to be installed in your environment, such was via conda install git), run:
pip install git+https://github.com/catalystneuro/neuroconv.git@main
NeuroConv also supports a variety of extra dependencies that can be specified inside square brackets, such as
pip install "neuroconv[openephys, dandi]"
which will then install extra dependencies related to reading OpenEphys data as well as the usage of the DANDI CLI (such as automatic upload to the DANDI Archive).
You can read more about these options in the main installation guide.
Documentation
See our ReadTheDocs page for full documentation, including a gallery of all supported formats.
Citing NeuroConv
If you use NeuroConv in your research, please cite our paper:
Mayorquin, H., Baker, C., Adkisson-Floro, P., Weigl, S., Trapani, A., Tauffer, L., Rübel, O., & Dichter, B. (2025). NeuroConv: Streamlining Neurophysiology Data Conversion to the NWB Standard. Proceedings of the 24th Python in Science Conference (SciPy 2025). https://doi.org/10.25080/cehj4257
BibTeX
@inproceedings{mayorquin2025neuroconv,
title={NeuroConv: Streamlining Neurophysiology Data Conversion to the NWB Standard},
author={Mayorquin, Heberto and Baker, Cody and Adkisson-Floro, Paul and Weigl, Szonja and Trapani, Alessandra and Tauffer, Luiz and R\"ubel, Oliver and Dichter, Benjamin},
booktitle={Proceedings of the 24th Python in Science Conference},
year={2025},
month={July},
doi={10.25080/cehj4257}
}
License
NeuroConv is distributed under the BSD3 License. See LICENSE for more information.
3 maintainers
Release files for neuroconv 0.10.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| neuroconv-0.10.2.tar.gz | 698.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| neuroconv-0.10.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.6 MB
Release files / neuroconv-0.10.2.tar.gz
| Download URL | neuroconv-0.10.2.tar.gz |
|---|---|
| Size | 698.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5cd4225ac7a5300652cfc075f6312f5b40e0c21c50f0944462442926bd2a787d
|
|
BLAKE2b-256 checksum How to use checksums |
3168fdc90937548b8e55d426cb1eedf90ad55a32b116c2a2e5b54fc0c2123556
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 10, 2026.
Transparency logRelease files / neuroconv-0.10.2-py3-none-any.whl
| Download URL | neuroconv-0.10.2-py3-none-any.whl |
|---|---|
| Size | 873.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ebdc2ddbb4545bcc1d691237ecea9ae9e5b849d52ef9b7bca1801b401a4bc041
|
|
BLAKE2b-256 checksum How to use checksums |
9c845032748b05685b044c5101a9f33b07e8ca858c4ef717b550dcd53ed1e533
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 10, 2026.
Transparency log
