Read and write EDF/EDF+ files.
Project description
edfio
edfio is a Python package for reading and writing EDF and EDF+C files.
It requires Python>=3.9 and NumPy>=1.22 and is available on PyPI:
pip install edfio
- Support for EDF and EDF+C, including annotations
- Fast I/O thanks to NumPy - read and write GB-sized files in seconds
- Fail late on read: Non-compliant header fields only raise an exception when the corresponding property is accessed.
- Fail early on write: Trying to create a new non-compliant EDF file raises an exception.
- Object-oriented design and type annotations for IDE autocompletion
- Pure Python implementation and 100% test coverage to simplify contributions
Features
- Read/write from/to files or file-like objects
- Modify signal and recording headers
- Drop EDF+ annotations
- Slice recordings (by seconds or annotation texts)
- Drop individual signals
- Anonymize recordings
Known limitations
- Discontiguous files (EDF+D) are treated as contiguous ones.
- The maximum data record size of 61440 bytes recommended by the EDF specs is not enforced.
- To write an EDF with a non-integer seconds duration, the data record duration has to be manually set to an appropriate value.
- Slicing an EDF to a timespan that is not an integer multiple of the data record duration does not work.
- BDF files (BioSemi) are not supported.
Contributing
Contributions are welcome and highly appreciated. Check out the contributing guidelines to get started.
Usage
Further information is available in the API reference and usage examples.
To read an EDF from a file, use edfio.read_edf
:
from edfio import read_edf
edf = read_edf("example.edf")
A new EDF can be created and written to a file as follows:
import numpy as np
from edfio import Edf, EdfSignal
edf = Edf(
[
EdfSignal(np.random.randn(30 * 256), sampling_frequency=256, label="EEG Fpz"),
EdfSignal(np.random.randn(30), sampling_frequency=1, label="Body Temp"),
]
)
edf.write("example.edf")
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
edfio-0.4.5.tar.gz
(24.5 kB
view details)
Built Distribution
edfio-0.4.5-py3-none-any.whl
(27.5 kB
view details)
File details
Details for the file edfio-0.4.5.tar.gz
.
File metadata
- Download URL: edfio-0.4.5.tar.gz
- Upload date:
- Size: 24.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.4.27
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | b4d8e276899c578cc585126f1c2e130f708eeeb61d9bcd760d6f4c91b87f9423 |
|
MD5 | e20ae27b27a4a3e969cd3fb776b51338 |
|
BLAKE2b-256 | be7167577e0da155a88ad8057ec271b713358e970e9612a6c3bbf34008ecd162 |
File details
Details for the file edfio-0.4.5-py3-none-any.whl
.
File metadata
- Download URL: edfio-0.4.5-py3-none-any.whl
- Upload date:
- Size: 27.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.4.27
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | db1d06fc3288a6395080209bb616277a32fbe9c393ca37b1bed3214683fe16a0 |
|
MD5 | ca141ff2895072b5f6fdea817c685024 |
|
BLAKE2b-256 | 0df41d5a1a433bdddcdc476f64416c3fd07798739deb9408bd052296aead48c4 |