EventAug is an open-source Python package that provides methods for augmentation of visual event data. This package was developed as part of the Google Summer of Code 2022 program. A summary of information about the project can be found at this webpage.

If you don't have Poetry installed, you can install it with the following command:

pip install poetry

Clone the public repository and enter the working directory:

git clone https://github.com/NeelayS/event_aug
cd event_aug/

To install the basic version of the package:

poetry install --without dev

If you wish to install the development version of the package:

poetry install

If you wish to use the Youtube video downloading functionality of the package, you can additionally run:

poetry install -E youtube

To install the basic version of the package:

pip install git+https://github.com/NeelayS/event_aug.git

To use the YouTube video downloading functionality of the package:

pip install git+https://github.com/NeelayS/event_aug.git#[youtube]

Please refer to the tutorial_ntbks/ directory for usage examples. It contains two IPython notebooks which demonstrate how the package can be used to augment event-camera datasets end-to-end using spike-encoded (custom) videos and Perlin noise.