Open Neurophysiology Environment
The Open Neurophysiology Environment is a scheme for sharing neurophysiology data in a standardized manner. It is a Python API for searching and loading ONE-standardized data, stored either on a user's local machine or on a remote server.
Please Click here for the main documentation page. For a quick primer on the file naming convention we use, click here.
NB: The API and backend database are still under active development, for the best experience please regularly update the package by running pip install -U ONE-api.
Requirements
ONE runs on Python 3.10 or later, and is tested on the latest Ubuntu and Windows (3.10 and 3.14 only).
Installing
Installing the package via pip typically takes a few seconds. To install, run
pip install ONE-api
Set up
For using ONE with a local cache directory:
from one.api import One
one = One(cache_dir='/home/user/downloads/ONE/behavior_paper')
To use the default setup settings that connect you to the IBL public database:
from one.api import ONE
ONE.setup(silent=True) # Will use default information
one = ONE() # Prompts for your username, then your password
The public database is free to use but needs an account, which you can create at
openalyx.internationalbrainlab.org/signup,
either with an email address or through ORCiD. An ORCiD account has no password: leave the
password prompt blank and paste the API token shown on the database's /me page instead. See
installation and setup for details.
For setting up ONE for a given database e.g. internal IBL Alyx:
from one.api import ONE
one = ONE(base_url='https://alyx.internationalbrainlab.org')
Once you've setup the API for the first time, subsequent calls will use the same parameters:
from one.api import ONE
one = ONE()
To set up ONE for another database and make it the default:
from one.api import ONE
ONE.setup(base_url='https://test.alyx.internationalbrainlab.org', make_default=True)
one = ONE() # Connected to https://test.alyx.internationalbrainlab.org
Using ONE
To search for sessions:
from one.api import ONE
one = ONE()
print(one.search_terms()) # A list of search keyword arguments
# Search session with wheel timestamps from January 2021 onward
eids = one.search(date_range=['2021-01-01',], dataset='wheel.timestamps')
['d3372b15-f696-4279-9be5-98f15783b5bb']
# Search for project sessions with two probes
eids = one.search(data=['probe00', 'probe01'], project='brainwide')
To load data:
from one.api import ONE
one = ONE()
# Load an ALF object
eid = 'a7540211-2c60-40b7-88c6-b081b2213b21'
wheel = one.load_object(eid, 'wheel')
# Load a specific dataset
eid = 'a7540211-2c60-40b7-88c6-b081b2213b21'
ts = one.load_dataset(eid, 'wheel.timestamps', collection='alf')
# Download, but not load, a dataset
filename = one.load_dataset(eid, 'wheel.timestamps', download_only=True)
To share data:
from one.api import One
one = One.setup() # Enter the location of the ALF datasets when prompted
Further examples and tutorials can be found in the documentation.
Release files for ONE-api 3.6.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| one_api-3.6.0.tar.gz | 1.0 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| one_api-3.6.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.1 MB
Release files / one_api-3.6.0.tar.gz
| Download URL | one_api-3.6.0.tar.gz |
|---|---|
| Size | 1.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
59db98aba1d68cec213566743f8ff2e53c29c4b7e1e9bf6ea81a6cd986549233
|
|
BLAKE2b-256 checksum How to use checksums |
9619125a10c610543d2711025df4ef71c654637acfb90dbb8af236f28bfa4c2b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / one_api-3.6.0-py3-none-any.whl
| Download URL | one_api-3.6.0-py3-none-any.whl |
|---|---|
| Size | 1.0 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1b0794c2efa09f2cc71cfbadae80a7ba6c36b507e783dfc63f78bd919d9b2f8a
|
|
BLAKE2b-256 checksum How to use checksums |
63dc1727fc30626a8d1816323aff88cdd17fd915541c526b265a81e5884fabd1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
