Metadata-Version: 2.4
Name: swc-aeon
Version: 0.2.0
Summary: A package for interfacing with acquired data from Project Aeon experiments.
Author-email: Jai Bhagat <jkbhagatio@gmail.com>, Goncalo Lopes <g.lopes@neurogears.org>, Thinh Nguyen <thinh@datajoint.com>, Chang Huan Lo <changhuan.lo@ucl.ac.uk>, Joseph Burling <joseph@datajoint.com>, Jaerong Ahn <jaerong.ahn@datajoint.com>, Milagros Marin <milagros@datajoint.com>
License-Expression: BSD-3-Clause
Project-URL: Homepage, https://sainsburywellcomecentre.github.io/aeon_docs/
Project-URL: Repository, https://github.com/SainsburyWellcomeCentre/aeon_api
Project-URL: Documentation, https://sainsburywellcomecentre.github.io/aeon_docs/
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: dotmap
Requires-Dist: harp-python>=0.3.0
Requires-Dist: matplotlib
Requires-Dist: numpy>=1.26.4
Requires-Dist: opencv-python
Requires-Dist: pandas>=2.2
Requires-Dist: pydantic>=2.12.4
Requires-Dist: pydantic-yaml>=1.6.0
Provides-Extra: dev
Requires-Dist: pandas-stubs; extra == "dev"
Requires-Dist: pre-commit; extra == "dev"
Requires-Dist: pyright; extra == "dev"
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: pytest-mock; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Dynamic: license-file

# aeon_api

![swc-aeon](https://github.com/SainsburyWellcomeCentre/aeon_api/actions/workflows/swc-aeon.yml/badge.svg?branch=main)
[![swc-aeon_code_coverage](https://codecov.io/gh/SainsburyWellcomeCentre/aeon_api/branch/main/graph/badge.svg?token=973EC1CG03)](https://codecov.io/gh/SainsburyWellcomeCentre/aeon_api)

Project Aeon low-level library for interfacing with acquired data. Contains modules for loading and processing raw data.

## Set-up Instructions

We recommend [uv](https://docs.astral.sh/uv/) for python version, environment, and package dependency management. However, any other tool compatible with the `pyproject.toml` standard should work.

### Install from PyPI

```
uv pip install swc-aeon
```

### Install from source

```
git clone https://github.com/SainsburyWellcomeCentre/aeon_api
cd aeon_api
uv sync --all-extras
```

## Repository Contents

- `.github/workflows/` : GitHub actions workflows for building the environment and running tests
- `aeon/` : Source code for the Aeon Python package
    - `aeon/analysis`: Source code for processing and plotting the raw data
    - `aeon/io`: Source code for loading raw data
    - `aeon/schema`: Core modules for defining data schemas used to load raw data from particular experiments
- `tests/` : API unit tests
    - `tests/data` : Data used by tests
    - `tests/io` : Unit tests for the low-level raw data access API.
    - `tests/schema` : Schemas used to load sample data in test functions.

## Citation Policy

If you use this software, please cite it as below:

D. Campagner, J. Bhagat, G. Lopes, L. Calcaterra, A. G. Pouget, A. Almeida, T. T. Nguyen, C. H. Lo, T. Ryan, B. Cruz, F. J. Carvalho, Z. Li, A. Erskine, J. Rapela, O. Folsz, M. Marin, J. Ahn, S. Nierwetberg, S. C. Lenzi, J. D. S. Reggiani, SGEN group – SWC GCNU Experimental Neuroethology Group. _Aeon: an open-source platform to study the neural basis of ethological behaviours over naturalistic timescales._ Preprint at https://doi.org/10.1101/2025.07.31.664513 (2025)

[![DOI:10.1101/2025.07.31.664513](https://img.shields.io/badge/DOI-10.1101%2F2025.07.31.664513-AE363B.svg)](https://doi.org/10.1101/2025.07.31.664513)
