<!--
Copyright (c) 2023 Ernst Strüngmann Institute (ESI) for Neuroscience
in Cooperation with Max Planck Society
SPDX-License-Identifier: CC-BY-NC-SA-1.0
-->
# oephys2nwb: Export Open Ephys binary data to NWB 2.x
## Summary
This package can be used to export data saved in
[Open Ephys binary format](https://open-ephys.github.io/gui-docs/User-Manual/Recording-data/Binary-format.html)
(the default for the Open Ephys GUI) to the [NWB 2.0 format](https://www.nwb.org/).
At the time of writing the
[NWBFormat plugin](https://open-ephys.github.io/gui-docs/User-Manual/Recording-data/NWB-format.html)
of Open Ephys only supports the deprecated NWB 1.0 format specification. The present
package is developed and maintained at the
[Ernst Strüngmann Institute (ESI) gGmbH for Neuroscience in Cooperation with Max Planck Society](https://www.esi-frankfurt.de/>)
and released free of charge under the
[BSD 3-Clause "New" or "Revised" License](https://en.wikipedia.org/wiki/BSD_licenses#3-clause_license_(%22BSD_License_2.0%22,_%22Revised_BSD_License%22,_%22New_BSD_License%22,_or_%22Modified_BSD_License%22)).
## Installation
The package can be installed with `pip`
```shell
pip install esi-oephys2nwb
```
To get the latest development version, simply clone our GitHub repository and
(optionally) create a dedicated conda development environment:
```shell
git clone https://github.com/esi-neuroscience/oephys2nwb.git
cd oephys2nwb/
python setup.py --version
conda env create -f oephys2nwb-dev.yml
conda activate oephys2nwb-dev
pip install -e .
```
## Usage
We recommend setting up a dedicated conda environment for `oephys2nwb`. For general
information about conda, please refer to the [official documentation](https://docs.conda.io/en/latest/).
```shell
conda create -n oephys2nwb-env python=3.8 pip
conda activate oephys2nwb-env
pip install esi-oephys2nwb
```
Alternatively, we provide a conda environment file to automatically install all
required dependencies
```shell
wget https://raw.githubusercontent.com/esi-neuroscience/oephys2nwb/main/oephys2nwb.yml
conda env create -f oephys2nwb.yml
conda activate oephys2nwb
```
Once the package is installed the exporter can be used either embedded in Python
code or as a stand-alone command line utility.
### Command Line
Activate the conda environment the package was installed in and invoke the exporter
as follows
```shell
conda activate oephys2nwb-env
python -m oephys2nwb -i /path/to/recordingDir -o /path/to/outputFile.nwb
```
Calling `oephys2nwb` without arguments prints the function help
```shell
python -m oephys2nwb
```
### Python Code
Alternatively, the package can be used like any other Python module
```python
from oephys2nwb import export2nwb
input = "/path/to/recordingDir"
output = "/path/to/outputFile.nwb"
export2nwb(input, output)
```
## Documentation and Contact
To report bugs or ask questions please use our
[GitHub issue tracker](https://github.com/esi-neuroscience/oephys2nwb/issues).
More usage details and background information is available in our
[online documentation](https://esi-oephys2nwb.readthedocs.io/en/latest/).
Raw data
{
"_id": null,
"home_page": "https://github.com/esi-neuroscience/oephys2nwb",
"name": "esi-oephys2nwb",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "",
"author": "Ernst Str\u00fcngmann Institute (ESI) for Neuroscience in Cooperation with Max Planck Society",
"author_email": "it@esi-frankfurt.de",
"download_url": "https://files.pythonhosted.org/packages/e8/bb/c747e4cdd33731ad5d0afeaf720779760237c06339ae0feb807a9e11bf63/esi-oephys2nwb-0.5.tar.gz",
"platform": null,
"description": "<!--\nCopyright (c) 2023 Ernst Str\u00fcngmann Institute (ESI) for Neuroscience\nin Cooperation with Max Planck Society\nSPDX-License-Identifier: CC-BY-NC-SA-1.0\n-->\n\n# oephys2nwb: Export Open Ephys binary data to NWB 2.x\n\n## Summary\n\nThis package can be used to export data saved in\n[Open Ephys binary format](https://open-ephys.github.io/gui-docs/User-Manual/Recording-data/Binary-format.html)\n(the default for the Open Ephys GUI) to the [NWB 2.0 format](https://www.nwb.org/).\nAt the time of writing the\n[NWBFormat plugin](https://open-ephys.github.io/gui-docs/User-Manual/Recording-data/NWB-format.html)\nof Open Ephys only supports the deprecated NWB 1.0 format specification. The present\npackage is developed and maintained at the\n[Ernst Str\u00fcngmann Institute (ESI) gGmbH for Neuroscience in Cooperation with Max Planck Society](https://www.esi-frankfurt.de/>)\nand released free of charge under the\n[BSD 3-Clause \"New\" or \"Revised\" License](https://en.wikipedia.org/wiki/BSD_licenses#3-clause_license_(%22BSD_License_2.0%22,_%22Revised_BSD_License%22,_%22New_BSD_License%22,_or_%22Modified_BSD_License%22)).\n\n## Installation\n\nThe package can be installed with `pip`\n\n```shell\npip install esi-oephys2nwb\n```\n\nTo get the latest development version, simply clone our GitHub repository and\n(optionally) create a dedicated conda development environment:\n\n```shell\ngit clone https://github.com/esi-neuroscience/oephys2nwb.git\ncd oephys2nwb/\npython setup.py --version\nconda env create -f oephys2nwb-dev.yml\nconda activate oephys2nwb-dev\npip install -e .\n```\n\n## Usage\n\nWe recommend setting up a dedicated conda environment for `oephys2nwb`. For general\ninformation about conda, please refer to the [official documentation](https://docs.conda.io/en/latest/).\n\n```shell\nconda create -n oephys2nwb-env python=3.8 pip\nconda activate oephys2nwb-env\npip install esi-oephys2nwb\n```\n\nAlternatively, we provide a conda environment file to automatically install all\nrequired dependencies\n\n```shell\nwget https://raw.githubusercontent.com/esi-neuroscience/oephys2nwb/main/oephys2nwb.yml\nconda env create -f oephys2nwb.yml\nconda activate oephys2nwb\n```\n\nOnce the package is installed the exporter can be used either embedded in Python\ncode or as a stand-alone command line utility.\n\n### Command Line\n\nActivate the conda environment the package was installed in and invoke the exporter\nas follows\n\n```shell\nconda activate oephys2nwb-env\npython -m oephys2nwb -i /path/to/recordingDir -o /path/to/outputFile.nwb\n```\n\nCalling `oephys2nwb` without arguments prints the function help\n\n```shell\npython -m oephys2nwb\n```\n\n### Python Code\n\nAlternatively, the package can be used like any other Python module\n\n```python\nfrom oephys2nwb import export2nwb\n\ninput = \"/path/to/recordingDir\"\noutput = \"/path/to/outputFile.nwb\"\n\nexport2nwb(input, output)\n```\n\n## Documentation and Contact\n\nTo report bugs or ask questions please use our\n[GitHub issue tracker](https://github.com/esi-neuroscience/oephys2nwb/issues).\nMore usage details and background information is available in our\n[online documentation](https://esi-oephys2nwb.readthedocs.io/en/latest/).\n",
"bugtrack_url": null,
"license": "BSD-3",
"summary": "Export binary Open Ephys data to NWB 2.x",
"version": "0.5",
"project_urls": {
"Bug Tracker": "https://github.com/esi-neuroscience/oephys2nwb/issues",
"Documentation": "https://esi-oephys2nwb.readthedocs.io/en/latest/",
"Homepage": "https://github.com/esi-neuroscience/oephys2nwb",
"Source Code": "https://github.com/esi-neuroscience/oephys2nwb"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3e855acdbc9bc94de9c85345a7e8001ed85fc6cf4d71214a420617c3b89d3307",
"md5": "3cd795ac48fe98e850de622942eb9e7f",
"sha256": "7d10e2a441bbaa2d2e9338abb82d94bf9a7961e40d3e6f2010d2acf0512fbbd8"
},
"downloads": -1,
"filename": "esi_oephys2nwb-0.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3cd795ac48fe98e850de622942eb9e7f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 29267,
"upload_time": "2023-10-23T13:49:24",
"upload_time_iso_8601": "2023-10-23T13:49:24.291729Z",
"url": "https://files.pythonhosted.org/packages/3e/85/5acdbc9bc94de9c85345a7e8001ed85fc6cf4d71214a420617c3b89d3307/esi_oephys2nwb-0.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e8bbc747e4cdd33731ad5d0afeaf720779760237c06339ae0feb807a9e11bf63",
"md5": "6c561a81aa5a237e23e14e2fdd0c00b9",
"sha256": "08588b506514d012f4b85a2f6e602f3793ea8bc990a0cbd54e8f29cf8caa88cd"
},
"downloads": -1,
"filename": "esi-oephys2nwb-0.5.tar.gz",
"has_sig": false,
"md5_digest": "6c561a81aa5a237e23e14e2fdd0c00b9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 27404,
"upload_time": "2023-10-23T13:49:25",
"upload_time_iso_8601": "2023-10-23T13:49:25.921728Z",
"url": "https://files.pythonhosted.org/packages/e8/bb/c747e4cdd33731ad5d0afeaf720779760237c06339ae0feb807a9e11bf63/esi-oephys2nwb-0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-23 13:49:25",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "esi-neuroscience",
"github_project": "oephys2nwb",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "esi-oephys2nwb"
}