Metadata-Version: 2.4
Name: befordata
Version: 0.3.8
Summary: BeForData: Python data structures for handling behavioural force data.
Author-email: Oliver Lindemann <lindemann@essb.eur.nl>
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Classifier: License :: OSI Approved :: MIT License
License-File: LICENSE
Requires-Dist: numpy>=2.2.6
Requires-Dist: pandas>=2.3.1
Requires-Dist: scipy>=1.15.3
Requires-Dist: pyarrow>=21.0.0 ; extra == "arrow"
Requires-Dist: sphinx>=8.1 ; extra == "docs"
Requires-Dist: pydata-sphinx-theme>=0.16.0 ; extra == "docs"
Requires-Dist: sphinx_autodoc_typehints>=2.5.0 ; extra == "docs"
Requires-Dist: numpydoc>=1.7 ; extra == "docs"
Requires-Dist: myst_parser>=4.0 ; extra == "docs"
Requires-Dist: matplotlib>=3.10.5 ; extra == "plot"
Project-URL: Home, https://github.com/lindemann09/befordata
Provides-Extra: arrow
Provides-Extra: docs
Provides-Extra: plot

# Behavioural Force Data (BeForData)

**Data structures for handling behavioural force data**


This package provides core classes and utilities for loading, processing, and analysing behavioural force data, such as those collected in experimental psychology or neuroscience. It offers a structured approach to manage epochs and records of force measurements, enabling efficient data manipulation and analysis.

**Features**

- Flexible loading and saving of force data in common formats (e.g., CSV, XDF).
- Efficient slicing and indexing of epochs and records for batch analysis.
- Metadata management for experimental context, including event markers and annotations.
- Utilities for preprocessing, such as filtering and baseline correction.
- Integration with scientific Python libraries (NumPy, pandas) for advanced analysis.

Source code: https://github.com/lindemann09/befordata

Documentation: https://lindemann09.github.io/befordata/

(c) Oliver Lindemann

[![GitHub license](https://img.shields.io/github/license/lindemann09/befordata)](https://github.com/lindemann09/befordata/blob/master/LICENSE) [![PyPI](https://img.shields.io/pypi/v/befordata?style=flat)](https://pypi.org/project/befordata/)


## Main Components

- **BeForRecord**
    Represents a single continuous recording of force data, including metadata such as sampling rate, channel information, and experimental annotations. BeForRecord supports data cleaning, resampling, and extraction of epochs, and provides convenient access to raw and processed force signals.

- **BeForEpochs**
    A container class for managing multiple epochs of force data. Each epoch represents a segment of continuous force measurements, typically corresponding to a trial or experimental condition. BeForEpochs provides methods for slicing, indexing, and batch-processing epochs, as well as for loading and saving epoch data from various formats.


## Typical Workflow

1. Load raw force data into a BeForRecord object.
2. Preprocess and annotate the data as needed.
3. Segment the data into epochs using event markers, creating a BeForEpochs object.


### Install via pip

```
pip install befordata
```

### Julia

A [Julia implementation of BeForData](https://github.com/lindemann09/BeForData.jl) is available as a beta release.


