Skip to main content

Read and write EDF/EDF+ files.

Project description

edfio

Python PyPI conda-forge License Docs

Checked with mypy Ruff

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


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)

Uploaded Source

Built Distribution

edfio-0.4.5-py3-none-any.whl (27.5 kB view details)

Uploaded Python 3

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

Hashes for edfio-0.4.5.tar.gz
Algorithm Hash digest
SHA256 b4d8e276899c578cc585126f1c2e130f708eeeb61d9bcd760d6f4c91b87f9423
MD5 e20ae27b27a4a3e969cd3fb776b51338
BLAKE2b-256 be7167577e0da155a88ad8057ec271b713358e970e9612a6c3bbf34008ecd162

See more details on using hashes here.

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

Hashes for edfio-0.4.5-py3-none-any.whl
Algorithm Hash digest
SHA256 db1d06fc3288a6395080209bb616277a32fbe9c393ca37b1bed3214683fe16a0
MD5 ca141ff2895072b5f6fdea817c685024
BLAKE2b-256 0df41d5a1a433bdddcdc476f64416c3fd07798739deb9408bd052296aead48c4

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page